diff --git a/docs/apm/bottlenecks.asciidoc b/docs/apm/bottlenecks.asciidoc index 167d4b81b6c40..fbde3e9ddcbd6 100644 --- a/docs/apm/bottlenecks.asciidoc +++ b/docs/apm/bottlenecks.asciidoc @@ -12,7 +12,7 @@ You can think of transactions as the highest level of work you’re measuring wi As an example, a transaction could be a request to your server, a batch job, or a custom transaction type. * {apm-overview-ref-v}/errors.html[*Errors*] contain information about the original exception that occurred or about a log created when the exception occurred. -Each of these information types have a specific page associated with them in the APM UI. +Each of these information types have a specific page associated with them in the APM app. These various pages display the captured data in curated charts and tables that allow you to easily compare and debug your applications. For example, you can see information about response times, requests per minute, and status codes per endpoint. diff --git a/docs/apm/filters.asciidoc b/docs/apm/filters.asciidoc index d7eab35723fb8..d95205026f5e9 100644 --- a/docs/apm/filters.asciidoc +++ b/docs/apm/filters.asciidoc @@ -1,21 +1,29 @@ [[filters]] === Filters -Global filters are ways you can filter your data within the APM UI. +APM provides two different ways you can filter your data within the APM App: + +* <> +* <> + +[[global-filters]] +==== Global filters + +Global filters are ways you can filter any and all data across the APM app. They are available in the Services, Transactions, Errors, Metrics, and Traces views, and any filter applied will persist as you move between pages. [role="screenshot"] -image::apm/images/global-filters.png[Global filters available in the APM UI in Kibana] +image::apm/images/global-filters.png[Global filters available in the APM app in Kibana] [float] -==== Global time range +===== Global time range The <> in {kib} restricts APM data to a specific time period. [float] [[query-bar]] -==== Query bar +===== Query bar The query bar is a powerful data query feature. Similar to the query bar in {kibana-ref}/discover.html[Discover], @@ -27,7 +35,7 @@ See <> for more information and sample queries. [float] [[environment-selector]] -==== Service environment filter +===== Service environment filter The environment selector is a global filter for `service.environment`. It allows you to view only relevant data, and is especially useful for separating development from production environments. @@ -46,3 +54,19 @@ v|*Go:* {apm-go-ref}/configuration.html#config-environment[`ELASTIC_APM_ENVIRONM *Ruby:* {apm-ruby-ref}/configuration.html#config-environment[`environment`] *Real User Monitoring:* {apm-rum-ref}/configuration.html#environment[`environment`] |=== + +[[contextual-filters]] +==== Contextual filters + +Local filters are ways you can filter your specific APM data on each individual page. +The filters shown are relevant to your data, and will persist between pages, +but only where they are applicable -- they are typically most useful in their original context. +As an example, if you select a host on the Services overview, then select a transaction group, +the host filter will still be applied. + +These filters are very useful for quickly and easily removing noise from your data. +With just a click, you can filter your transactions by the transaction result, +host, container ID, and more. + +[role="screenshot"] +image::apm/images/local-filter.png[Local filters available in the APM app in Kibana] \ No newline at end of file diff --git a/docs/apm/getting-started.asciidoc b/docs/apm/getting-started.asciidoc index 454faae974c79..8f1265b73a8f4 100644 --- a/docs/apm/getting-started.asciidoc +++ b/docs/apm/getting-started.asciidoc @@ -15,7 +15,7 @@ To set up the correct index pattern, simply click *Load Kibana objects* at the bottom of the Setup Instructions. After you install an Elastic APM agent library in your application, -the application automatically appears in the APM UI in {kib}. +the application automatically appears in the APM app in {kib}. No further configuration is required. [role="screenshot"] diff --git a/docs/apm/images/apm-distributed-tracing.png b/docs/apm/images/apm-distributed-tracing.png index ba9b308d22760..127ac1559e2c3 100644 Binary files a/docs/apm/images/apm-distributed-tracing.png and b/docs/apm/images/apm-distributed-tracing.png differ diff --git a/docs/apm/images/apm-error-group.png b/docs/apm/images/apm-error-group.png index accf911eabe81..621df834b8bc0 100644 Binary files a/docs/apm/images/apm-error-group.png and b/docs/apm/images/apm-error-group.png differ diff --git a/docs/apm/images/apm-errors-overview.png b/docs/apm/images/apm-errors-overview.png index 3394b473eecae..fcc5819623e10 100644 Binary files a/docs/apm/images/apm-errors-overview.png and b/docs/apm/images/apm-errors-overview.png differ diff --git a/docs/apm/images/apm-geo-ui.jpg b/docs/apm/images/apm-geo-ui.jpg new file mode 100644 index 0000000000000..5b80e1e7a8f0c Binary files /dev/null and b/docs/apm/images/apm-geo-ui.jpg differ diff --git a/docs/apm/images/apm-metrics.png b/docs/apm/images/apm-metrics.png index 2b6df92c12fd6..a75702ad570d0 100644 Binary files a/docs/apm/images/apm-metrics.png and b/docs/apm/images/apm-metrics.png differ diff --git a/docs/apm/images/apm-services-overview.png b/docs/apm/images/apm-services-overview.png index 1651c0efdf697..19068ce8f69db 100644 Binary files a/docs/apm/images/apm-services-overview.png and b/docs/apm/images/apm-services-overview.png differ diff --git a/docs/apm/images/apm-span-detail.png b/docs/apm/images/apm-span-detail.png index 60c97ee7528c9..884b716fc43d0 100644 Binary files a/docs/apm/images/apm-span-detail.png and b/docs/apm/images/apm-span-detail.png differ diff --git a/docs/apm/images/apm-traces.png b/docs/apm/images/apm-traces.png index 455662f69f790..ba3bbff482af3 100644 Binary files a/docs/apm/images/apm-traces.png and b/docs/apm/images/apm-traces.png differ diff --git a/docs/apm/images/apm-transaction-response-dist.png b/docs/apm/images/apm-transaction-response-dist.png index d4d4b17d7d5ac..6f902a6428bf3 100644 Binary files a/docs/apm/images/apm-transaction-response-dist.png and b/docs/apm/images/apm-transaction-response-dist.png differ diff --git a/docs/apm/images/apm-transaction-sample.png b/docs/apm/images/apm-transaction-sample.png index 7aea77f4cfcfc..b707ad7c76f09 100644 Binary files a/docs/apm/images/apm-transaction-sample.png and b/docs/apm/images/apm-transaction-sample.png differ diff --git a/docs/apm/images/apm-transactions-overview.png b/docs/apm/images/apm-transactions-overview.png index fee65a00b3607..160255cd7bc03 100644 Binary files a/docs/apm/images/apm-transactions-overview.png and b/docs/apm/images/apm-transactions-overview.png differ diff --git a/docs/apm/images/local-filter.png b/docs/apm/images/local-filter.png new file mode 100644 index 0000000000000..faac5c143a7d8 Binary files /dev/null and b/docs/apm/images/local-filter.png differ diff --git a/docs/apm/index.asciidoc b/docs/apm/index.asciidoc index a3c99a7cc0b89..7eb7278cf0358 100644 --- a/docs/apm/index.asciidoc +++ b/docs/apm/index.asciidoc @@ -7,7 +7,7 @@ Elastic Application Performance Monitoring (APM) automatically collects in-depth performance metrics and errors from inside your applications. -The **APM** page in {kib} is provided with the basic license. It +The **APM** app in {kib} is provided with the basic license. It enables developers to drill down into the performance data for their applications and quickly locate the performance bottlenecks. diff --git a/docs/apm/transactions.asciidoc b/docs/apm/transactions.asciidoc index 260c7a6f59031..e70587baa65ea 100644 --- a/docs/apm/transactions.asciidoc +++ b/docs/apm/transactions.asciidoc @@ -52,6 +52,20 @@ For further details, including troubleshooting and custom implementation instruc refer to the documentation for each {apm-agents-ref}[APM Agent] you've implemented. ==== +[[rum-transaction-overview]] +==== RUM Transaction overview + +The transaction overview page is customized for the JavaScript RUM Agent. +This page highlights things like *page load times*, *transactions per minute*, and even the *average page load duration distribution by country*. + +[role="screenshot"] +image::apm/images/apm-geo-ui.jpg[average page load duration distribution] + +This data is available due to the geo-ip and user agent pipelines being enabled by default, +which allows for the capture of geo-location and user agent data. +These visualizations make it easy for you to visualize performance information about your +end users' experience based on their location. + [[transaction-details]] ==== Transaction details