diff --git a/docs/reference/api-documentation.md b/docs/reference/api-documentation.md index 90c8920fa..80036d9af 100644 --- a/docs/reference/api-documentation.md +++ b/docs/reference/api-documentation.md @@ -248,7 +248,7 @@ If the value is numerical or boolean, then it will be sent to the server as a JS String values longer than 1024 characters will be truncated. Labels are indexed in Elasticsearch as keyword fields. ::::{tip} -Before using labels, ensure you understand the different types of [metadata](docs-content://solutions/observability/apps/metadata.md) that are available. +Before using labels, ensure you understand the different types of [metadata](docs-content://solutions/observability/apm/metadata.md) that are available. :::: @@ -267,7 +267,7 @@ Non-indexed means the data is not searchable or aggregatable in Elasticsearch, a The value can be of any type that can be encoded using `encoding/json`. ::::{tip} -Before using custom context, ensure you understand the different types of [metadata](docs-content://solutions/observability/apps/metadata.md) that are available. +Before using custom context, ensure you understand the different types of [metadata](docs-content://solutions/observability/apm/metadata.md) that are available. :::: diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index 667c12045..d44079f8b 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -7,7 +7,7 @@ mapped_pages: Adapt the Elastic APM Go agent to your needs with one of the following methods—​listed in descending order of precedence: -1. [APM Agent Configuration via Kibana](docs-content://solutions/observability/apps/apm-agent-central-configuration.md) (supported options are marked with [![dynamic config](images/dynamic-config.svg "") ](#dynamic-configuration)) +1. [APM Agent Configuration via Kibana](docs-content://solutions/observability/apm/apm-agent-central-configuration.md) (supported options are marked with [![dynamic config](images/dynamic-config.svg "") ](#dynamic-configuration)) 2. In code, using the [Tracer Config API](/reference/api-documentation.md#tracer-config-api) 3. Environment variables @@ -20,7 +20,7 @@ To simplify development and testing, the agent defaults to sending data to the E Configuration options marked with the ![dynamic config](images/dynamic-config.svg "") badge can be changed at runtime when set from a supported source. -The Go Agent supports [Central configuration](docs-content://solutions/observability/apps/apm-agent-central-configuration.md), which allows you to fine-tune certain configurations via the APM app. This feature is enabled in the Agent by default, with [`ELASTIC_APM_CENTRAL_CONFIG`](#config-central-config). +The Go Agent supports [Central configuration](docs-content://solutions/observability/apm/apm-agent-central-configuration.md), which allows you to fine-tune certain configurations via the APM app. This feature is enabled in the Agent by default, with [`ELASTIC_APM_CENTRAL_CONFIG`](#config-central-config). ## Configuration formats [_configuration_formats] @@ -98,7 +98,7 @@ The secret token is sent as plain-text in every request to the server, so you sh | --- | --- | --- | | `ELASTIC_APM_API_KEY` | | "A base64-encoded string" | -This base64-encoded string is used to ensure that only your agents can send data to your APM server. The API key must be created using the APM Server [command line tool](docs-content://solutions/observability/apps/api-keys.md). +This base64-encoded string is used to ensure that only your agents can send data to your APM server. The API key must be created using the APM Server [command line tool](docs-content://solutions/observability/apm/api-keys.md). ::::{warning} The API Key is sent as plain-text in every request to the server, so you should also secure your communications using HTTPS. Unless you do so, your API Key could be observed by an attacker. @@ -155,7 +155,7 @@ This feature is fully supported in the APM Server versions >= 7.5. The name of the environment this service is deployed in, e.g. "production" or "staging". -Environments allow you to easily filter data on a global level in the APM app. It’s important to be consistent when naming environments across agents. See [environment selector](docs-content://solutions/observability/apps/filter-application-data.md#apm-filter-your-data-service-environment-filter) in the APM app for more information. +Environments allow you to easily filter data on a global level in the APM app. It’s important to be consistent when naming environments across agents. See [environment selector](docs-content://solutions/observability/apm/filter-data.md#apm-filter-your-data-service-environment-filter) in the APM app for more information. ::::{note} This feature is fully supported in the APM app in Kibana versions >= 7.2. You must use the query bar to filter for a specific environment in versions prior to 7.2. @@ -458,7 +458,7 @@ This environment variable will be ignored if a logger is configured programatica | --- | --- | | `ELASTIC_APM_CENTRAL_CONFIG` | `true` | -Activate APM Agent central configuration via Kibana. By default the agent will poll the server for agent configuration changes. This can be disabled by changing the setting to `false`. See [APM Agent central configuration](docs-content://solutions/observability/apps/apm-agent-central-configuration.md) for more information. +Activate APM Agent central configuration via Kibana. By default the agent will poll the server for agent configuration changes. This can be disabled by changing the setting to `false`. See [APM Agent central configuration](docs-content://solutions/observability/apm/apm-agent-central-configuration.md) for more information. ::::{note} This feature requires APM Server v7.3 or later. @@ -473,7 +473,7 @@ This feature requires APM Server v7.3 or later. | Environment | Default | | `ELASTIC_APM_USE_ELASTIC_TRACEPARENT_HEADER` | `true` | -To enable [distributed tracing](docs-content://solutions/observability/apps/traces.md), the agent adds trace context headers to outgoing HTTP requests made with [module/apmhttp](/reference/builtin-modules.md#builtin-modules-apmhttp). These headers (`traceparent` and `tracestate`) are defined in the [W3C Trace Context](https://www.w3.org/TR/trace-context-1/) specification. +To enable [distributed tracing](docs-content://solutions/observability/apm/traces.md), the agent adds trace context headers to outgoing HTTP requests made with [module/apmhttp](/reference/builtin-modules.md#builtin-modules-apmhttp). These headers (`traceparent` and `tracestate`) are defined in the [W3C Trace Context](https://www.w3.org/TR/trace-context-1/) specification. When this setting is `true`, the agent will also add the header `elastic-apm-traceparent` for backwards compatibility with older versions of Elastic APM agents. diff --git a/docs/reference/index.md b/docs/reference/index.md index 1ea79bf18..990a72019 100644 --- a/docs/reference/index.md +++ b/docs/reference/index.md @@ -24,5 +24,5 @@ In addition to capturing events like those mentioned above, the agent also colle ## Additional Components [additional-components] -APM Agents work in conjunction with the [APM Server](docs-content://solutions/observability/apps/application-performance-monitoring-apm.md), [Elasticsearch](docs-content://get-started/index.md), and [Kibana](docs-content://get-started/the-stack.md). The [APM Guide](docs-content://solutions/observability/apps/application-performance-monitoring-apm.md) provides details on how these components work together, and provides a matrix outlining [Agent and Server compatibility](docs-content://solutions/observability/apps/apm-agent-compatibility.md). +APM Agents work in conjunction with the [APM Server](docs-content://solutions/observability/apm/index.md), [Elasticsearch](docs-content://get-started/index.md), and [Kibana](docs-content://get-started/the-stack.md). The [APM Guide](docs-content://solutions/observability/apm/index.md) provides details on how these components work together, and provides a matrix outlining [Agent and Server compatibility](docs-content://solutions/observability/apm/apm-agent-compatibility.md). diff --git a/docs/reference/log-correlation.md b/docs/reference/log-correlation.md index 89bdbab4c..d4cd5144c 100644 --- a/docs/reference/log-correlation.md +++ b/docs/reference/log-correlation.md @@ -5,7 +5,7 @@ mapped_pages: # Log correlation [log-correlation-ids] -[Log correlation](docs-content://solutions/observability/apps/logs.md) allows you to navigate to all logs belonging to a particular trace and vice-versa: for a specific log, see in which context it has been logged and which parameters the user provided. +[Log correlation](docs-content://solutions/observability/apm/logs.md) allows you to navigate to all logs belonging to a particular trace and vice-versa: for a specific log, see in which context it has been logged and which parameters the user provided. In order to correlate logs from your app with transactions captured by the Elastic APM Go Agent, your logs must contain one or more of the following identifiers: diff --git a/docs/reference/upgrading.md b/docs/reference/upgrading.md index 4d3721c23..aa081c272 100644 --- a/docs/reference/upgrading.md +++ b/docs/reference/upgrading.md @@ -10,7 +10,7 @@ Upgrades between minor versions of the agent, like from 1.1 to 1.2 are always ba Before upgrading the agent, be sure to review the: * [Agent release notes](/release-notes/index.md) -* [Agent and Server compatibility chart](docs-content://solutions/observability/apps/apm-agent-compatibility.md) +* [Agent and Server compatibility chart](docs-content://solutions/observability/apm/apm-agent-compatibility.md) ## End of life dates [end-of-life-dates]