[DOC] Updated TraceQL doc with an example for arrays (#4661)

(cherry picked from commit 09c608c)
grafana · Feb 6, 2025 · 0f9931f · 0f9931f
1 parent 0fae42f
commit 0f9931f
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/docs/sources/tempo/setup/upgrade.md b/docs/sources/tempo/setup/upgrade.md
@@ -107,6 +107,7 @@ This change may increase data usage and network traffic, which can impact cloud
 
 If you notice increased network traffic or issues, check the gRPC compression settings.
 
+For instructions how to enable gRPC compression, refer to [gRPC compression configuration](https://grafana.com/docs/tempo/<TEMPO_VERSION>/configuration/#grpc-compression) for more information.
 For instructions how to enable gRPC compression, refer to [gRPC compression configuration](https://grafana.com/docs/tempo/<TEMPO_VERSION>/configuration/#grpc-compression) for more information.
 
 ### Added, updated, removed, or renamed configuration parameters

diff --git a/docs/sources/tempo/traceql/_index.md b/docs/sources/tempo/traceql/_index.md
@@ -128,6 +128,23 @@ It's a convenient request to identify misconfigurations and leaks across product
 { resource.deployment.environment = "production" } && { resource.deployment.environment = "staging" }
 ```
 
+### Find traces with arrays
+
+TraceQL automatically queries data contained in arrays.
+Support for arrays is available in vParquet4 and on.
+
+If `span.foo` is an array and contains the value `bar`, then it will be found by this query.
+
+```
+{ span.foo = "bar" }
+```
+
+You can use regular expressions to match multiple values of array `{span.http.request.header.Accept=~"application.*"}` and get all values of the array with `.*` regular expression.
+
+```
+{span.http.request.header.Accept=~".*"}
+```
+
 ### Use structural operators
 
 Find traces that include the `frontend` service, where either that service or a downstream service includes a span where an error is set.