---
title: APM settings in Kibana
description: 
url: https://www.elastic.co/elastic/docs-builder/docs/3167/reference/kibana/configuration-reference/apm-settings
products:
  - Kibana
applies_to:
  - Elastic Cloud Hosted: Generally available
  - Self-managed Elastic deployments: Generally available
---

# 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.
<definitions>
</definitions>

## 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.
<definitions>
  <definition term="xpack.apm.maxSuggestions">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of suggestions fetched in autocomplete selection boxes.
Datatype: `int`
Default: `100`
  </definition>
  <definition term="xpack.apm.serviceMapFingerprintBucketSize">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of unique transaction combinations sampled for generating service map focused on a specific service.
Datatype: `int`
Default: `100`
  </definition>
  <definition term="xpack.apm.serviceMapFingerprintGlobalBucketSize">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of unique transaction combinations sampled for generating the global service map.
Datatype: `int`
Default: `100`
  </definition>
  <definition term="xpack.apm.serviceMapEnabled">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Set to `false` to disable service maps.
Datatype: `bool`
Default: `true`
  </definition>
  <definition term="xpack.apm.serviceMapTraceIdBucketSize">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of trace IDs sampled for generating service map focused on a specific service.
Datatype: `int`
Default: `65`
  </definition>
  <definition term="xpack.apm.serviceMapTraceIdGlobalBucketSize">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of trace IDs sampled for generating the global service map.
Datatype: `int`
Default: `6`
  </definition>
  <definition term="xpack.apm.serviceMapMaxTracesPerRequest">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of traces per request for generating the global service map.
Datatype: `int`
Default: `50`
  </definition>
  <definition term="xpack.apm.ui.enabled">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Set to `false` to hide the APM app from the main menu.
Datatype: `bool`
Default: `true`
  </definition>
  <definition term="xpack.apm.ui.maxTraceItems">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Maximum number of child items displayed when viewing trace details.
Datatype: `int`
Default: `5000`
  </definition>
  <definition term="xpack.observability.annotations.index">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Index name where Observability annotations are stored.
Datatype: `string`
Default: `observability-annotations`
  </definition>
  <definition term="xpack.apm.metricsInterval">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Sets a `fixed_interval` for date histograms in metrics aggregations.
Datatype: `int`
Default: `30`
  </definition>
  <definition term="xpack.apm.agent.migrations.enabled">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Set to `false` to disable cloud APM migrations.
Datatype: `bool`
Default: `true`
  </definition>
  <definition term="xpack.apm.indices.error">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all error indices.
Datatype: `string`
Default: `logs-apm*,apm-*,traces-*.otel-*`
  </definition>
  <definition term="xpack.apm.indices.onboarding">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all onboarding indices.
Datatype: `string`
Default: `apm-*`
  </definition>
  <definition term="xpack.apm.indices.span">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all span indices.
Datatype: `string`
Default: `traces-apm*,apm-*,traces-*.otel-*`
  </definition>
  <definition term="xpack.apm.indices.transaction">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all transaction indices.
Datatype: `string`
Default: `traces-apm*,apm-*,traces-*.otel-*`
  </definition>
  <definition term="xpack.apm.indices.metric">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all metrics indices.
Datatype: `string`
Default: `metrics-apm*,apm-*,metrics-*.otel-*`
  </definition>
  <definition term="xpack.apm.indices.sourcemap">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Matcher for all source map indices.
Datatype: `string`
Default: `apm-*`
  </definition>
  <definition term="xpack.apm.autoCreateApmDataView">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

Set to `false` to disable the automatic creation of the APM data view when the APM app is opened.
Datatype: `bool`
Default: `true`
  </definition>
  <definition term="xpack.apm.latestAgentVersionsUrl">
    <supported-on>Elastic Cloud Hosted: Generally available, Self-managed Elastic deployments: Generally available</supported-on>

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`
  </definition>
</definitions>