grafana/pkg/semconv/README.md

Grafana OpenTelemetry Semantic Conventions

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

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

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

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

k8s

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

grafana.plugin

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