IntenseWebs/grafana
3
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2024-12-30 10:47:30 -06:00
Code Issues Packages Projects Releases Wiki Activity

[DOC] Update span filters doc for Tempo data source (#90771)

Browse Source
This commit is contained in:
Kim Nylander 2024-07-22 14:10:31 -04:00 committed by GitHub
parent 771933bd74
commit edb7ecef70
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 29 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/sources/datasources/tempo/span-filters.md
View File

@ -61,7 +61,12 @@ refs:
destination: /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/
---
# Span Filters
# Span filters
When working with traces, especially those comprising a vast number of spans, pinpointing specific spans of interest can be a daunting task.
This is where span filtering comes in.
Located above the trace view, span filters allow you to refine the spans displayed based on specific criteria.
Whether you’re looking to identify spans from a certain service, those exceeding a particular duration, or spans tagged with specific attributes, span filtering streamlines the process.
Using span filters, you can filter your spans in the trace timeline viewer. The more filters you add, the more specific are the filtered spans.
@ -74,6 +79,27 @@ You can add one or more of the following filters:
- Duration
- Tags (which include tags, process tags, and log fields)
To only show the spans you have matched, select the `Show matches only` toggle.
{{< youtube id="VP2XV3IIc80" >}}
<!-- Adding these in case they are needed. -->
## Use span filters
You can access span filters from within the trace view. You can add one or more filters.
The more filters you add, the more specific data that you are filtering.
1. Expand a trace to view individual spans.
1. Select a span to view the span details.
1. Select **Span Filters** to display the available filters.
![Locate span filters in trace view](/media/docs/grafana/data-sources/tempo-span-filters-find.gif)
Query results in the span view update as you select filters.
### Show matches only
For a more focused view, the **Show matches only** toggle ensures only the spans meeting your criteria are displayed. This is particularly useful when sifting through thousands of spans, allowing you to zero in on those that truly matter.
For instance, if you’re keen on understanding why a specific request is lagging, or if you’re on the hunt for spans without a certain tag, span filtering is your go-to tool.
It even lets you search for spans based on specific tag keys, like cluster.
### Remove a filter
To remove a filter, select the **X** next to the line item.