Package codes.grow.packages.tempo
package codes.grow.packages.tempo
Grow Codes SDK for Grafana Tempo.
TempoClient: health, ping, server version and the query API (TempoQueryClient: traces by id, TraceQL search, tags, tag values, TraceQL metrics).TraceQL: TraceQL builder with escaping.TempoTracing: OpenTelemetry setup with the Tempo OTLP exporter preset and tenant header.
Shared building blocks live in core (errors, transport, redaction); the tracing
helpers and adapters in tracing; in-memory fakes and the conformance runner in
testing.
-
ClassDescriptionBuild information from
GET /api/status/buildinfo.Options ofTempoQueryClient.getTrace(String, GetTraceOptions): a time window that narrows the backend blocks Tempo searches (sent as epoch seconds).An exemplar span behind a metrics series (labels includetrace:id).One sample of a TraceQL metrics series.One series of a TraceQL metrics query.Window and resolution ofTempoQueryClient.traceQLMetrics(String, MetricsRange): eitherstart/endorsince(a window ending now), plus an optionalstepand exemplar count.Builder ofMetricsRange.Converts the OTLP JSON that Tempo returns for a trace by id (protobuf JSON: ids in base64, times as decimal nanosecond strings, enums as names) into the normalizedSpanmodel.Request ofTempoQueryClient.search(SearchRequest): a TraceQL query plus window and limits.Builder ofSearchRequest.Result ofTempoQueryClient.search(SearchRequest).One span of a search spanset.Options ofTempoQueryClient.searchTags(SearchTagsOptions).Builder ofSearchTagsOptions.Builder ofSearchTagValuesOptions.One trace found byTempoQueryClient.search(SearchRequest).Spans and errors of one service in a search hit.Spans of one trace that matched a search.Attribute scope accepted byTempoQueryClient.searchTags(SearchTagsOptions).One tag value fromTempoQueryClient.searchTagValues(String, SearchTagValuesOptions).Client for Grafana Tempo's HTTP API (port 3200): health, ping, version and the query API throughTempoClient.query().Builder that configures and creates a client in one chain.Immutable configuration of aTempoClient(SPEC section 2.2).Builder of the configuration.Client for Tempo's HTTP query API (port 3200).OpenTelemetry tracing that exports to Grafana Tempo over OTLP (SPEC section 5), built on the official OpenTelemetry Java SDK.Tempo tracing settings whose unset fields come from the environment, then Tempo defaults.Builder ofTempoTracingConfig; every field is optional.Immutable TraceQL query builder with escaping.