Skip to content

Commit

Permalink
Add blog post links to rel notes (#4057)
Browse files Browse the repository at this point in the history
  • Loading branch information
knylander-grafana authored Sep 5, 2024
1 parent 2db5412 commit 70df7bb
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 12 deletions.
8 changes: 3 additions & 5 deletions docs/sources/tempo/release-notes/v2-6.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,21 +7,19 @@ weight: 30

# Version 2.6 release notes

The Tempo team is pleased to announce the release of Tempo 2.5.
The Tempo team is pleased to announce the release of Tempo 2.6.

This release gives you:

* Additions to the TraceQL language, including the ability to search by span events, links, and arrays
* Additions to TraceQL metric query-types including a compare function and the ability to do instant queries (which will return faster than range queries).
* Performance and stability enhancements

<!-- add link when blog is live
Read the [Tempo 2.6 blog post](https://grafana.com/blog/2024/06/03/grafana-tempo-2.5-release-vparquet4-streaming-endpoints-and-more-metrics/) for more examples and details about these improvements.
-->
Read the [Tempo 2.6 blog post](https://grafana.com/blog/2024/09/05/grafana-tempo-2.6-release-performance-improvements-and-new-traceql-features/) for more examples and details about these improvements.

These release notes highlight the most important features and bugfixes. For a complete list, refer to the [Tempo changelog](https://github.com/grafana/tempo/releases).

<!-- add video from blog {{< youtube id=" " >}} -->
{{< youtube id="aIDkPJ_e3W4" >}}

## Features and enhancements

Expand Down
16 changes: 9 additions & 7 deletions docs/sources/tempo/traceql/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,22 +66,20 @@ Queries select sets of spans and filter them through a pipeline of aggregators a

## Selecting spans

In TraceQL, curly brackets `{}` always select a set of spans from the current trace. They are commonly paired with a condition to reduce the spans being passed in.
In TraceQL, curly brackets `{}` always select a set of spans from the current trace.
They are commonly paired with a condition to reduce the spans being passed in.

TraceQL differentiates between two types of span data: intrinsics, which are fundamental to spans, and attributes, which are customizable key-value pairs.
You can use intrinsics and attributes to build filters and select spans.

{{< youtube id="aIDkPJ_e3W4" >}}

Intrinsic fields are fundamental to scopes.
Intrinsics are inherently present, as opposed to other key-value pairs (attributes) that are added by a developer.

Intrinsics are always indicated using a `<scope>:`.
Refer to the Intrinsics table for all current intrinsics.

Custom attributes are prefixed with <scope>. such as `span.`, `resource.` , `link.`, or `event`.
Resource has no intrinsic values.
It only has custom attributes.
The `trace` scope is only an intrinsic and doesn't have any custom attributes at the trace level.

Intrinsics example:
```
{ span:name = "foo" }
Expand All @@ -90,6 +88,11 @@ Intrinsics example:
{ link:traceID = "1234" }
```

Custom attributes are prefixed with `<scope>.`, such as `span.`, `resource.` , `link.`, or `event`.
Resource has no intrinsic values.
It only has custom attributes.
The `trace` scope is only an intrinsic and doesn't have any custom attributes at the trace level.

Attributes example:
```
{ span.foo = "bar" }
Expand Down Expand Up @@ -138,7 +141,6 @@ This example searches all Kubernetes clusters called `service-name` that have a
{ resource.k8s.cluster.name="service-name" && trace:rootName !~ ".*perf.*"}
```


### Attribute fields

TraceQL has four different attribute scopes: span attributes, resource attributes, event attributes, and link attributes.
Expand Down

0 comments on commit 70df7bb

Please sign in to comment.