APM settings in Kibana

These settings allow the APM app to function, and specify the data that it surfaces. Unless you've customized your setup, you do not need to configure any settings to use the APM app. It is enabled by default.

APM indices

The APM app uses data views to query APM indices. To change the default APM indices that the APM app queries, open the APM app and select Settings > Indices. Index settings in the APM app take precedence over those set in kibana.yml.

APM indices are Kibana space-aware; changes to APM index settings will only apply to the currently enabled space.

General APM settings

If you'd like to change any of the default values, copy and paste the relevant settings into your kibana.yml configuration file. Changing these settings may disable features of the APM App.

xpack.apm.maxSuggestions

Supported on: Elastic Cloud Hosted lets you manage and configure one or more deployments of the versioned Elastic Stack, hosted on Elastic Cloud. Availability Generally available This functionality is generally available and ready for production usage. Self-managed deployments are Elastic Stack deployments managed without the assistance of an orchestrator. Availability Generally available This functionality is generally available and ready for production usage. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Maximum number of suggestions fetched in autocomplete selection boxes.

Datatype: int

Default: 100

xpack.apm.serviceMapFingerprintBucketSize

Maximum number of unique transaction combinations sampled for generating service map focused on a specific service.

Datatype: int

Default: 100

xpack.apm.serviceMapFingerprintGlobalBucketSize

Maximum number of unique transaction combinations sampled for generating the global service map.

Datatype: int

Default: 1000

xpack.apm.serviceMapEnabled

Set to false to disable service maps.

Datatype: bool

Default: true

xpack.apm.serviceMapTraceIdBucketSize

Maximum number of trace IDs sampled for generating service map focused on a specific service.

Datatype: int

Default: 65

xpack.apm.serviceMapTraceIdGlobalBucketSize

Maximum number of trace IDs sampled for generating the global service map.

Datatype: int

Default: 6

xpack.apm.serviceMapMaxTracesPerRequest

Maximum number of traces per request for generating the global service map.

Datatype: int

Default: 50

xpack.apm.ui.enabled

Set to false to hide the APM app from the main menu.

Datatype: bool

Default: true

xpack.apm.ui.maxTraceItems

Maximum number of child items displayed when viewing trace details.

Datatype: int

Default: 5000

xpack.observability.annotations.index

Index name where Observability annotations are stored.

Datatype: string

Default: observability-annotations

xpack.apm.metricsInterval

Sets a fixed_interval for date histograms in metrics aggregations.

Datatype: int

Default: 30

xpack.apm.agent.migrations.enabled

Set to true to enable cloud APM migrations.

Datatype: bool

Default: false

xpack.apm.indices.error

Matcher for all error indices.

Datatype: string

Default: logs-apm*,apm-*,logs-*.otel-*

xpack.apm.indices.onboarding

Matcher for all onboarding indices.

Datatype: string

Default: apm-*

xpack.apm.indices.span

Matcher for all span indices.

Datatype: string

Default: traces-apm*,apm-*,traces-*.otel-*

xpack.apm.indices.transaction

Matcher for all transaction indices.

Datatype: string

Default: traces-apm*,apm-*,traces-*.otel-*

xpack.apm.indices.metric

Matcher for all metrics indices.

Datatype: string

Default: metrics-apm*,apm-*,metrics-*.otel-*

xpack.apm.indices.sourcemap

Matcher for all source map indices.

Datatype: string

Default: apm-*

xpack.apm.autoCreateApmDataView

Set to false to disable the automatic creation of the APM data view when the APM app is opened.

Datatype: bool

Default: true

xpack.apm.searchAggregatedTransactions The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 7.10 This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Controls the search strategy used for transactions. When set to auto, Kibana uses aggregated transactions if available and falls back to individual transactions. Set to always to force the use of aggregated transactions, or never to always query individual transactions.

Datatype: enum

Default: auto

Options:

auto
always
never

xpack.apm.latestAgentVersionsUrl

Supported on: Self-managed deployments are Elastic Stack deployments managed without the assistance of an orchestrator. Availability Generally available This functionality is generally available and ready for production usage. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Specifies the URL of a self hosted file that contains latest agent versions. Set to '' to disable requesting latest agent versions.

Datatype: string

Default: https://apm-agent-versions.elastic.co/versions.json