This is an automated email from the ASF dual-hosted git repository.
wusheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking.git
The following commit(s) were added to refs/heads/master by this push:
new 4742a3062c polish TraceQL service docs (#13804)
4742a3062c is described below
commit 4742a3062c6ec5fa9ab77f72dfa8280a1fef4ee4
Author: Wan Kai <[email protected]>
AuthorDate: Wed Apr 8 15:08:46 2026 +0800
polish TraceQL service docs (#13804)
---
docs/en/api/traceql-service.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/api/traceql-service.md b/docs/en/api/traceql-service.md
index 6a72fdaf30..b9a5a4c5fa 100644
--- a/docs/en/api/traceql-service.md
+++ b/docs/en/api/traceql-service.md
@@ -3,7 +3,9 @@ TraceQL ([Trace Query
Language](https://grafana.com/docs/tempo/latest/traceql/))
TraceQL Service exposes Tempo Querying HTTP APIs including TraceQL expression
system and OpenTelemetry Protocol (OTLP) trace format.
Third-party systems or visualization platforms that already support Tempo and
TraceQL (such as Grafana), could obtain traces through TraceQL Service.
-SkyWalking supports two types of traces: SkyWalking native traces and
Zipkin-compatible traces. The TraceQL Service converts both trace formats to
OpenTelemetry Protocol (OTLP) format to provide compatibility with Grafana
Tempo and TraceQL queries.
+SkyWalking supports two types of traces: SkyWalking native traces and
Zipkin-compatible traces. The TraceQL Service converts both trace formats to
[Tempo's
format](https://github.com/grafana/tempo/blob/main/pkg/tempopb/tempo.proto)
+to provide compatibility with Grafana Tempo and TraceQL queries. Since the
trace detail part of Tempo's format (`Trace` message) reuses [OTLP
Trace](https://opentelemetry.io/docs/reference/specification/protocol/)
definitions,
+the conversion descriptions below refer to OTLP field names (e.g., span kind,
status code).
> **Note**: SkyWalking native trace support in TraceQL is based on the [Query
> Traces V2
> API](https://skywalking.apache.org/docs/main/next/en/api/query-protocol/#trace-v2)
> (`queryTraces` / `hasQueryTracesV2Support`).
> Currently, only **BanyanDB** storage implements this API. Other storage
> backends (e.g. Elasticsearch, MySQL, PostgreSQL) do not support it.
