Semantic Conventions
Semantic conventions are a crucial part of observability data collection, providing consistent attribute naming across your entire telemetry dataset. Dash0's semantic conventions extend the OpenTelemetry standard with additional attributes that enhance your observability experience.
Semantic Conventions Reference
This reference document details the Dash0-specific semantic conventions for resources, spans, logs and metrics to help you maximize the value of your observability data. These attributes are automatically derived from your incoming telemetry data, enabling enhanced filtering, intelligent grouping, AI-powered insights, and improved visualization capabilities without requiring manual instrumentation changes to your code.
Resource Attributes
Resource attributes describe the entity producing the telemetry data. These attributes help you identify and categorize the sources of your telemetry. See our dedicated documentation on resource equality to learn more about resource classification and identity.
| Attribute | Description | Examples |
|---|---|---|
dash0.resource.id | Unique identifier for the resource in Dash0, based on the resource equality rules. | 12958705279560104980 |
dash0.resource.type | Type classification of the resource, based on the resource equality rules. | k8s.pod, host, vercel.project |
dash0.resource.name | Human-readable name for the resource | |
dash0.auth.token | Auth token used to transmit telemetry about this resource. Note: Only the first few characters of the auth token are stored. | abcdef1 |
Span Attributes
Span attributes provide context for distributed tracing data, helping you understand the nature and details of operations within your system. The underlying rules for naming and typing, specifically for operations, are described within our operation naming document.
| Attribute | Description | Examples |
|---|---|---|
dash0.span.name | Dash0-normalized name for the span, which may differ from the original span name | SELECT … FROM my-table WHERE … |
dash0.span.type | Classification of the span type in Dash0's taxonomy | http, rpc, database, messaging |
dash0.operation.name | Name of the logical operation this span is part of | GET /articles/<article-id> |
dash0.operation.type | Type classification of the operation. | http, rpc, database, messaging |
Log Attributes
Log attributes enrich log data with additional context and AI-enhanced information to make troubleshooting faster and more effective.
| Attribute | Description | Examples |
|---|---|---|
dash0.log.processor.type | Type of log processor that handled this log entry | json |
dash0.log.template | Log AI inferred log template with variables replaced by placeholders | [Batch <batch_id>] Reconciling batch of <topic_count> topics |
dash0.log.attribute.<key> | Log attributes automatically extracted through log AI | dash0.log.attribute.topic_count=10 |
Last updated: March 23, 2025