- Kibana Guide: other versions:
- What is Kibana?
- What’s new in 8.3
- Kibana concepts
- Quick start
- Set up
- Install Kibana
- Configure Kibana
- Alerting and action settings
- APM settings
- Banners settings
- Enterprise Search settings
- Fleet settings
- i18n settings
- Logging settings
- Logs settings
- Metrics settings
- Monitoring settings
- Reporting settings
- Search sessions settings
- Secure settings
- Security settings
- Spaces settings
- Task Manager settings
- Telemetry settings
- URL drilldown settings
- Start and stop Kibana
- Access Kibana
- Securing access to Kibana
- Add data
- Upgrade Kibana
- Configure security
- Configure reporting
- Configure logging
- Configure monitoring
- Command line tools
- Production considerations
- Discover
- Dashboard and visualizations
- Canvas
- Maps
- Build a map to compare metrics by country or region
- Track, visualize, and alert on assets in real time
- Map custom regions with reverse geocoding
- Heat map layer
- Tile layer
- Vector layer
- Plot big data
- Search geographic data
- Configure map settings
- Connect to Elastic Maps Service
- Import geospatial data
- Troubleshoot
- Reporting and sharing
- Machine learning
- Graph
- Alerting
- Observability
- APM
- Security
- Dev Tools
- Fleet
- Osquery
- Stack Monitoring
- Stack Management
- REST API
- Get features API
- Kibana spaces APIs
- Kibana role management APIs
- User session management APIs
- Saved objects APIs
- Data views API
- Index patterns APIs
- Alerting APIs
- Action and connector APIs
- Cases APIs
- Import and export dashboard APIs
- Logstash configuration management APIs
- Machine learning APIs
- Short URLs APIs
- Get Task Manager health
- Upgrade assistant APIs
- Kibana plugins
- Troubleshooting
- Accessibility
- Release notes
- Developer guide
APM app settings
editAPM app settings
editYou do not need to configure any settings to use the APM app. It is enabled by default.
APM Indices
editThe 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
.
Starting in version 8.2.0, APM indices are Kibana Spaces-aware; Changes to APM index settings will only apply to the currently enabled space. See Control access to APM data for more information.

General APM settings
editIf 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.maxServiceEnvironments
-
Maximum number of unique service environments recognized by the UI. Defaults to
100
. -
xpack.apm.serviceMapFingerprintBucketSize
-
Maximum number of unique transaction combinations sampled for generating service map focused on a specific service. Defaults to
100
. -
xpack.apm.serviceMapFingerprintGlobalBucketSize
-
Maximum number of unique transaction combinations sampled for generating the global service map. Defaults to
100
. -
xpack.apm.serviceMapEnabled
-
Set to
false
to disable service maps. Defaults totrue
. -
xpack.apm.serviceMapTraceIdBucketSize
-
Maximum number of trace IDs sampled for generating service map focused on a specific service. Defaults to
65
. -
xpack.apm.serviceMapTraceIdGlobalBucketSize
-
Maximum number of trace IDs sampled for generating the global service map. Defaults to
6
. -
xpack.apm.serviceMapMaxTracesPerRequest
-
Maximum number of traces per request for generating the global service map. Defaults to
50
. -
xpack.apm.ui.enabled
-
Set to
false
to hide the APM app from the main menu. Defaults totrue
. -
xpack.apm.ui.transactionGroupBucketSize
-
Number of top transaction groups displayed in the APM app. Defaults to
1000
. -
xpack.apm.ui.maxTraceItems
-
Maximum number of child items displayed when viewing trace details. Defaults to
1000
. -
xpack.observability.annotations.index
-
Index name where Observability annotations are stored. Defaults to
observability-annotations
. -
xpack.apm.searchAggregatedTransactions
-
Enables Transaction histogram metrics. Defaults to
auto
so the UI will use metric indices over transaction indices for transactions if aggregated transactions are found. When set toalways
, additional configuration in APM Server is required. When set tonever
and aggregated transactions are not used.See Configure transaction metrics for more information.
-
xpack.apm.metricsInterval
-
Sets a
fixed_interval
for date histograms in metrics aggregations. Defaults to30
. -
xpack.apm.agent.migrations.enabled
-
Set to
false
to disable cloud APM migrations. Defaults totrue
. -
xpack.apm.indices.error
-
Matcher for all error indices. Defaults to
logs-apm*,apm-*
. -
xpack.apm.indices.onboarding
-
Matcher for all onboarding indices. Defaults to
apm-*
. -
xpack.apm.indices.span
-
Matcher for all span indices. Defaults to
traces-apm*,apm-*
. -
xpack.apm.indices.transaction
-
Matcher for all transaction indices. Defaults to
traces-apm*,apm-*
. -
xpack.apm.indices.metric
-
Matcher for all metrics indices. Defaults to
metrics-apm*,apm-*
. -
xpack.apm.indices.sourcemap
-
Matcher for all source map indices. Defaults to
apm-*
. -
xpack.apm.autoCreateApmDataView
-
Set to
false
to disable the automatic creation of the APM data view when the APM app is opened. Defaults totrue
.
On this page