diff --git a/solutions/observability/apm/apm-agent-central-configuration.md b/solutions/observability/apm/apm-agent-central-configuration.md index 8a2a8fb776..c32211a83e 100644 --- a/solutions/observability/apm/apm-agent-central-configuration.md +++ b/solutions/observability/apm/apm-agent-central-configuration.md @@ -1,5 +1,5 @@ --- -navigation_title: Centrally configure APM agents in Kibana +navigation_title: Centrally configure APM agents mapped_pages: - https://www.elastic.co/guide/en/observability/current/apm-agent-configuration.html applies_to: @@ -9,20 +9,24 @@ products: - id: apm --- -# APM agent central configuration [apm-agent-configuration] +# APM Agent Central Configuration [apm-agent-configuration] -APM Agent configuration allows you to fine-tune your APM agent configuration from within the Applications UI. Changes are automatically propagated to your APM agents, so there’s no need to redeploy. +APM Agent Central Configuration allows you to fine-tune your APM agents from within the Applications UI. Changes are automatically propagated to your agents, so there’s no need to redeploy. -To get started, choose the services and environments you wish to configure. The Applications UI will let you know when your APM agents have applied your configurations. +To get started, select the services and environments you want to configure. The Applications UI lets you know when your APM agents have applied your configurations. :::{image} /solutions/images/observability-apm-agent-configuration.png -:alt: APM Agent configuration in Kibana +:alt: APM central configuration in Kibana :screenshot: ::: +::::{important} +To configure EDOT SDKs through APM Agent Central Configuration, refer to [EDOT SDKs Central Configuration](edot-sdks-central-configuration.md). +:::: + ## Precedence [_precedence] -Configurations set from the Applications UI take precedence over configurations set locally in each APM agent. However, if APM Server is slow to respond, is offline, reports an error, etc., APM agents will use local defaults until they’re able to update the configuration. For this reason, it is still essential to set custom default configurations locally in each of your APM agents. +Configurations set from the Applications UI take precedence over configurations set locally in each APM agent or EDOT SDK. However, if APM Server is slow to respond, is offline, reports an error, etc., agents and SDKs will use local defaults until they’re able to update the configuration. For this reason, it is still essential to set custom default configurations locally in each of your APM agents and EDOT SDKs. ## Supported configurations [_supported_configurations] @@ -64,5 +68,8 @@ Real User Monitoring (RUM) agent For most users, APM agent configuration should work out-of-the-box. If you run into trouble, it may be because you’re not using the {{es}} output, or because your {{es}} credentials don’t have sufficient privileges. -See [configure APM agent configuration](/solutions/observability/apm/configure-apm-agent-central-configuration.md) to learn how to configure APM Server to avoid these problems. +Refer to [configure APM agent configuration](/solutions/observability/apm/configure-apm-agent-central-configuration.md) to learn how to configure APM Server to avoid these problems. +::::{note} +You can't configure APM agents through the EDOT Collector. Use APM Server for that purpose. +:::: diff --git a/solutions/observability/apm/collect-application-data.md b/solutions/observability/apm/collect-application-data.md index d58d670fae..bc8c809edc 100644 --- a/solutions/observability/apm/collect-application-data.md +++ b/solutions/observability/apm/collect-application-data.md @@ -33,7 +33,7 @@ Use Elastic APM agents or an OpenTelemetry language SDK to instrument a service | --- | --- | --- | | **Support level** | Fully supported for available languages | Fully supported | | **Data protocol** | [OpenTelemetry protocol (OTLP)](https://opentelemetry.io/docs/specs/otel/protocol/) | Elastic protocol | -| **Central configuration** | Currently not supported | Supported
*Refer to* [*APM agent central configuration*](/solutions/observability/apm/apm-agent-central-configuration.md) | +| **Central configuration** | {applies_to}`product: preview` Supported
*Refer to* [*Central configuration*](opentelemetry://reference/central-configuration.md) | Supported
*Refer to* [*APM agent central configuration*](/solutions/observability/apm/apm-agent-central-configuration.md) | ### Availability [apm-collect-data-availability] diff --git a/solutions/observability/apm/configure-apm-agent-central-configuration.md b/solutions/observability/apm/configure-apm-agent-central-configuration.md index df7a122d09..9e6aca6070 100644 --- a/solutions/observability/apm/configure-apm-agent-central-configuration.md +++ b/solutions/observability/apm/configure-apm-agent-central-configuration.md @@ -1,5 +1,5 @@ --- -navigation_title: APM agent central configuration +navigation_title: Configure APM Agent Central Configuration mapped_pages: - https://www.elastic.co/guide/en/observability/current/apm-configure-agent-config.html applies_to: @@ -9,18 +9,21 @@ products: - id: apm --- -# Configure APM agent central configuration [apm-configure-agent-config] +# Configure APM Agent Central Configuration [apm-configure-agent-config] ::::{note} ![supported deployment methods](/solutions/images/observability-binary-yes-fm-yes.svg "") APM agent central configuration is supported by all APM Server deployment methods, but some options are only supported for APM Server binary users. - :::: -APM agent central configuration allows you to fine-tune your APM agents from within the Applications UI. Changes are automatically propagated to your APM agents, so there’s no need to redeploy your applications. +APM Agent Central Configuration allows you to fine-tune your APM agents from within the Applications UI. Changes are automatically propagated to your agents, so there’s no need to redeploy your applications. + +To learn more about this feature, see [APM Agent Central Configuration](/solutions/observability/apm/apm-agent-central-configuration.md). -To learn more about this feature, see [APM agent central configuration](/solutions/observability/apm/apm-agent-central-configuration.md). +::::{note} +To configure EDOT SDKs through APM Agent Central Configuration, refer to [EDOT SDKs Central Configuration](opentelemetry://reference/central-configuration.md). +:::: ## APM agent configuration options [_apm_agent_configuration_options] diff --git a/solutions/observability/apm/edot-sdks-central-configuration.md b/solutions/observability/apm/edot-sdks-central-configuration.md new file mode 100644 index 0000000000..3cf2d179b5 --- /dev/null +++ b/solutions/observability/apm/edot-sdks-central-configuration.md @@ -0,0 +1,52 @@ +--- +navigation_title: Centrally configure EDOT SDKs +applies_to: + deployment: + ess: preview 9.1 + stack: preview 9.1 + serverless: unavailable + +products: + - id: observability + - id: kibana + - id: edot-collector +--- + +# Central Configuration for EDOT SDKs [edot-sdks-central-configuration] + +APM Agent Central Configuration allows you to fine-tune your EDOT SDKs from within the Applications UI. Changes are automatically propagated to your SDKs, so there’s no need to redeploy. + +To get started, select the services and environments you want to configure. The Applications UI lets you know when your EDOT SDKs have applied your configurations. + +::::{important} +To configure EDOT SDKs through APM Agent Central Configuration, refer to [EDOT SDKs Central Configuration](edot-sdks-central-configuration.md). +:::: + +## Precedence [_precedence] + +Configurations set from the Applications UI take precedence over configurations set locally in each EDOT SDK. If the EDOT Collector is offline, reports an error, or is slow to respond, EDOT SDKs use local defaults until they’re able to update the configuration. + +## Supported configurations [_supported_configurations] + +Each EDOT SDK has a list of supported configurations. After selecting a Service name and environment in the Applications UI, a list of all supported configuration options, including descriptions and default values, will be displayed. + +Supported configurations are also tagged with the ![dynamic config](/solutions/images/observability-dynamic-config.svg "") badge in each EDOT SDK’s configuration reference: + +| Language/Platform | EDOT SDK | Configuration Reference | +| --- | --- | --- | +| Android | EDOT Android SDK | [Configuration reference](opentelemetry://reference/edot-sdks/android/configuration.md) | +| iOS | EDOT iOS SDK | [Configuration reference](opentelemetry://reference/edot-sdks/ios/configuration.md) | +| Java | EDOT Java SDK | [Configuration reference](opentelemetry://reference/edot-sdks/java/configuration.md) | +| Node.js | EDOT Node.js SDK | [Configuration reference](opentelemetry://reference/edot-sdks/nodejs/configuration.md) | +| PHP | EDOT PHP SDK | [Configuration reference](opentelemetry://reference/edot-sdks/php/configuration.md) | +| Python | EDOT Python SDK | [Configuration reference](opentelemetry://reference/edot-sdks/python/configuration.md) | + +## EDOT configuration [_edot_configuration] + +EDOT SDK configuration is an optional feature. To activate it, refer to [EDOT SDK Central Configuration](edot-sdks-central-configuration.md). + +Refer to the [EDOT reference](opentelemetry://reference/central-configuration.md) to learn how to activate central configuration for EDOT SDKs. + +::::{note} +You can't configure APM agents through the EDOT Collector. Use APM Server for that purpose. Refer to [Configure APM agent configuration](/solutions/observability/apm/configure-apm-agent-central-configuration.md) for more details. +:::: diff --git a/solutions/toc.yml b/solutions/toc.yml index d714ed2e37..4d612e000e 100644 --- a/solutions/toc.yml +++ b/solutions/toc.yml @@ -134,6 +134,7 @@ toc: children: - file: observability/apm/upstream-opentelemetry-collectors-language-sdks.md - file: observability/apm/collect-metrics.md + - file: observability/apm/edot-sdks-central-configuration.md - file: observability/apm/limitations.md - file: observability/apm/attributes.md - file: observability/apm/data-stream-routing.md