2018-04-20 21:13:37 +02:00
|
|
|
[role="xpack"]
|
|
|
|
[[apm-settings-kb]]
|
2019-02-11 17:17:25 +01:00
|
|
|
=== APM settings in Kibana
|
2018-04-20 21:13:37 +02:00
|
|
|
++++
|
2019-02-11 17:17:25 +01:00
|
|
|
<titleabbrev>APM settings</titleabbrev>
|
2018-04-20 21:13:37 +02:00
|
|
|
++++
|
|
|
|
|
2020-04-15 16:54:26 +02:00
|
|
|
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.
|
2020-01-09 01:44:56 +01:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[apm-indices-settings-kb]]
|
2020-06-08 23:46:26 +02:00
|
|
|
==== APM indices
|
2020-01-09 01:44:56 +01:00
|
|
|
|
|
|
|
// This content is reused in the APM app documentation.
|
|
|
|
// Any changes made in this file will be seen there as well.
|
|
|
|
// tag::apm-indices-settings[]
|
|
|
|
|
|
|
|
Index defaults can be changed in Kibana. Navigate to *APM* > *Settings* > *Indices*.
|
|
|
|
Index settings in the APM app take precedence over those set in `kibana.yml`.
|
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
image::settings/images/apm-settings.png[APM app settings in Kibana]
|
|
|
|
|
|
|
|
// end::apm-indices-settings[]
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[general-apm-settings-kb]]
|
2019-02-11 17:17:25 +01:00
|
|
|
==== General APM settings
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2019-12-16 22:50:55 +01:00
|
|
|
// This content is reused in the APM app documentation.
|
|
|
|
// Any changes made in this file will be seen there as well.
|
|
|
|
// tag::general-apm-settings[]
|
|
|
|
|
2020-01-09 01:44:56 +01:00
|
|
|
If you'd like to change any of the default values,
|
2020-03-16 15:58:16 +01:00
|
|
|
copy and paste the relevant settings into your `kibana.yml` configuration file.
|
2020-04-15 16:54:26 +02:00
|
|
|
Changing these settings may disable features of the APM App.
|
2020-01-09 01:44:56 +01:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
[cols="2*<"]
|
|
|
|
|===
|
|
|
|
| `xpack.apm.enabled`
|
|
|
|
| Set to `false` to disable the APM app. Defaults to `true`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `xpack.apm.ui.enabled` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Set to `false` to hide the APM app from the menu. Defaults to `true`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `xpack.apm.ui.transactionGroupBucketSize`
|
2020-07-15 08:41:57 +02:00
|
|
|
| Number of top transaction groups displayed in the APM app. Defaults to `1000`.
|
2018-12-08 07:57:53 +01:00
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `xpack.apm.ui.maxTraceItems` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Maximum number of child items displayed when viewing trace details. Defaults to `1000`.
|
2019-08-07 09:17:57 +02:00
|
|
|
|
2020-05-20 23:35:46 +02:00
|
|
|
| `xpack.observability.annotations.index`
|
|
|
|
| Index name where Observability annotations are stored. Defaults to `observability-annotations`.
|
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `apm_oss.indexPattern` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| The index pattern used for integrations with Machine Learning and Query Bar.
|
|
|
|
It must match all apm indices. Defaults to `apm-*`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `apm_oss.errorIndices` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Matcher for all {apm-server-ref}/error-indices.html[error indices]. Defaults to `apm-*`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `apm_oss.onboardingIndices`
|
|
|
|
| Matcher for all onboarding indices. Defaults to `apm-*`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `apm_oss.spanIndices` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Matcher for all {apm-server-ref}/span-indices.html[span indices]. Defaults to `apm-*`.
|
2018-08-01 15:24:34 +02:00
|
|
|
|
2020-05-19 00:22:49 +02:00
|
|
|
| `apm_oss.transactionIndices` {ess-icon}
|
2020-05-04 17:22:40 +02:00
|
|
|
| Matcher for all {apm-server-ref}/transaction-indices.html[transaction indices]. Defaults to `apm-*`.
|
2019-11-13 08:54:18 +01:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `apm_oss.metricsIndices`
|
|
|
|
| Matcher for all {apm-server-ref}/metricset-indices.html[metrics indices]. Defaults to `apm-*`.
|
2019-11-13 08:54:18 +01:00
|
|
|
|
2020-05-04 17:22:40 +02:00
|
|
|
| `apm_oss.sourcemapIndices`
|
|
|
|
| Matcher for all {apm-server-ref}/sourcemap-indices.html[source map indices]. Defaults to `apm-*`.
|
|
|
|
|
|
|
|
|===
|
2019-11-13 08:54:18 +01:00
|
|
|
|
2019-12-16 22:50:55 +01:00
|
|
|
// end::general-apm-settings[]
|