2020-04-15 16:54:26 +02:00
|
|
|
[role="xpack"]
|
2019-06-14 21:25:46 +02:00
|
|
|
[[filters]]
|
|
|
|
=== Filters
|
|
|
|
|
2020-04-15 16:54:26 +02:00
|
|
|
++++
|
|
|
|
<titleabbrev>Filter data</titleabbrev>
|
|
|
|
++++
|
|
|
|
|
2021-03-18 13:53:51 +01:00
|
|
|
Global filters are ways you can filter data across the APM app based on a specific
|
|
|
|
time range or environment. They are available in the Services, Transactions, Errors,
|
|
|
|
Metrics, and Traces views, and any filter applied will persist as you move between pages.
|
2019-06-14 21:25:46 +02:00
|
|
|
|
|
|
|
[role="screenshot"]
|
2019-09-25 11:10:01 +02:00
|
|
|
image::apm/images/global-filters.png[Global filters available in the APM app in Kibana]
|
2019-06-14 21:25:46 +02:00
|
|
|
|
2021-03-18 13:53:51 +01:00
|
|
|
[NOTE]
|
|
|
|
=====
|
|
|
|
If you prefer to use advanced queries on your data to filter on specific pieces
|
|
|
|
of information, see <<advanced-queries,Query your data>>.
|
|
|
|
=====
|
2019-06-14 21:25:46 +02:00
|
|
|
|
2021-03-18 13:53:51 +01:00
|
|
|
[[global-time-range]]
|
|
|
|
==== Global time range
|
2019-06-14 21:25:46 +02:00
|
|
|
|
2021-03-18 13:53:51 +01:00
|
|
|
The <<set-time-filter,global time range filter>> in {kib} restricts APM data to a specific time period.
|
2019-06-14 21:25:46 +02:00
|
|
|
|
|
|
|
[[environment-selector]]
|
2021-03-18 13:53:51 +01:00
|
|
|
==== Service environment filter
|
2019-06-14 21:25:46 +02:00
|
|
|
|
|
|
|
The environment selector is a global filter for `service.environment`.
|
2021-03-18 13:53:51 +01:00
|
|
|
It allows you to view only relevant data and is especially useful for separating development from production environments.
|
2019-06-14 21:25:46 +02:00
|
|
|
By default, all environments are displayed. If there are no environment options, you'll see "not defined".
|
|
|
|
|
|
|
|
Service environments are defined when configuring your APM agents.
|
2020-04-15 16:54:26 +02:00
|
|
|
It's vital to be consistent when naming environments in your agents.
|
2021-03-18 13:53:51 +01:00
|
|
|
To learn how to configure service environments, see the specific agent documentation:
|
2019-06-14 21:25:46 +02:00
|
|
|
|
2020-02-11 20:43:03 +01:00
|
|
|
* *Go:* {apm-go-ref}/configuration.html#config-environment[`ELASTIC_APM_ENVIRONMENT`]
|
|
|
|
* *Java:* {apm-java-ref}/config-core.html#config-environment[`environment`]
|
2021-02-18 20:06:13 +01:00
|
|
|
* *.NET:* {apm-dotnet-ref}/config-core.html#config-environment[`Environment`]
|
2020-02-11 20:43:03 +01:00
|
|
|
* *Node.js:* {apm-node-ref}/configuration.html#environment[`environment`]
|
2021-02-18 20:06:13 +01:00
|
|
|
* *PHP:* {apm-php-ref}/configuration-reference.html#config-environment[`environment`]
|
2020-02-11 20:43:03 +01:00
|
|
|
* *Python:* {apm-py-ref}/configuration.html#config-environment[`environment`]
|
|
|
|
* *Ruby:* {apm-ruby-ref}/configuration.html#config-environment[`environment`]
|
|
|
|
* *Real User Monitoring:* {apm-rum-ref}/configuration.html#environment[`environment`]
|