kibana/docs/apm/traces.asciidoc
Brandon Morelli 3ced121be0
[APM] UX text review (#161400)
## Summary

@gchaps and I met to review text on some APM UI pages. Outcomes:

1. Service **m**ap or Service **M**ap — there is inconsistency in the
APM UI with how we refer to Service maps. In some cases, we use title
case (Service Map). In others, we use sentence case (Service map). As
per the [EUI writing
guidelines](https://eui.elastic.co/#/guidelines/writing/guidelines#capitalization),
we should use title case for product features.
2. Storage **e**xplorer or Storage **E**xplorer — same story here. We
use title case sometimes and sentence case others. We should use title
case as this is a product feature.
3. Various text enhancements and changes.
2023-07-07 07:41:46 -07:00

36 lines
1.6 KiB
Text

[role="xpack"]
[[traces]]
=== Traces
TIP: Traces link together related transactions to show an end-to-end performance of how a request was served
and which services were part of it.
In addition to the Traces overview, you can view your application traces in the <<spans,trace sample timeline waterfall>>.
*Traces* displays your application's entry (root) transactions.
Transactions with the same name are grouped together and only shown once in this table.
If you're using <<distributed-tracing,distributed tracing>>,
this view is key to finding the critical paths within your application.
By default, transactions are sorted by _Impact_.
Impact helps show the most used and slowest endpoints in your service -- in other words,
it's the collective amount of pain a specific endpoint is causing your users.
If there's a particular endpoint you're worried about, select it to view its
<<transaction-details,transaction details>>.
[role="screenshot"]
image::apm/images/apm-traces.png[Example view of the Traces overview in APM app in Kibana]
[float]
[[trace-explorer]]
==== Trace explorer
preview::[]
**Trace explorer** is an experimental top-level search tool that allows you to query your traces using <<kuery-query,Kibana Query Language (KQL)>> or {ref}/eql.html[Event Query Language (EQL)].
Curate your own custom queries, or use the <<service-maps,**Service Map**>> to find and select edges to automatically generate queries based on your selection:
[role="screenshot"]
image::apm/images/trace-explorer.png[Trace explorer]
Enable **Trace explorer** in <<apm-labs,APM Labs>> or in <<observability-apm-trace-explorer-tab,{kib} advanced settings>>.