Grafana OpenTelemetry Semantic Conventions

<!-- toc -->

• Adding new attributes
• Attribute Groups
  • grafana.datasource
    • grafana.datasource.request
• k8s
  • grafana.plugin

<!-- tocstop -->

Adding new attributes

1. Add a new attribute to a new or existing attribute group in model/registry.
2. Add a reference to the new attribute in a new or existing attribute group in model/trace.
3. If you are adding a new attribute group, add a new semconv HTML comment tag to the README.md file with the name of the new attribute group.
4. Run make all to update the generated files.

For more information:

• Semantic Convention generator + Docker
• OpenTelemetry Semantic Conventions (these can be used as a reference)

Attribute Groups

grafana.datasource

<!-- semconv trace.grafana.datasource -->

Attribute	Type	Description	Examples	Requirement Level	Stability
grafana.datasource.type	string	The datasource type.	prometheus; loki; grafana-github-datasource	Recommended
grafana.datasource.uid	string	The datasource unique identifier.	abcdefg-123456	Recommended

<!-- endsemconv -->

grafana.datasource.request

<!-- semconv trace.grafana.datasource.request -->

Attribute	Type	Description	Examples	Requirement Level	Stability
grafana.datasource.request.query_count	int	The number of queries in the request.	3	Recommended

<!-- endsemconv -->

k8s

<!-- semconv trace.k8s -->

Attribute	Type	Description	Examples	Requirement Level	Stability
k8s.dataplaneservice.name	string	The name of the DataPlaneService.	v0alpha1.prometheus.grafana.app	Recommended

<!-- endsemconv -->

grafana.plugin

<!-- semconv trace.grafana.plugin -->

Attribute	Type	Description	Examples	Requirement Level	Stability
grafana.plugin.id	string	The plugin ID.	prometheus; loki; grafana-github-datasource	Recommended
grafana.plugin.source.class	string	The plugin source class.	core	Recommended
grafana.plugin.type	string	The plugin type.	datasource	Recommended

<!-- endsemconv -->