Skip to main content

Workflow: Schema Exploration & Attribute Discovery

Discovering indexed span attributes and translating Kubernetes workload metadata into canonical OpenTelemetry TraceQL filters.


Step 1: Discover Available Attribute Names

List all indexed attribute keys grouped across scopes (resource, span, intrinsic, event, link):

tempo_get_attribute_names(scope="all")

Step 2: Enumerate Distinct Attribute Values

Inspect the distinct values populated for a specific attribute key:

tempo_get_attribute_values(name="http.status_code")

Step 3: Check Kubernetes Semantic Mappings

Retrieve canonical mappings between Kubernetes metadata concepts and OpenTelemetry trace attributes:

tempo_get_k8s_attribute_map()

Canonical Mapping Reference:

Kubernetes ConceptOpenTelemetry Trace Attribute
Namespacek8s.namespace.name
Pod Namek8s.pod.name
Deploymentk8s.deployment.name
Containerk8s.container.name
Nodek8s.node.name
Serviceservice.name