Instrumentation quality
The Instrumentation Quality page reports on the completeness of your instrumentation and recommends steps to improve it and get more value out of the knowledge graph.
To access the report, select the Quality report tab for an entity in the entity catalog. If there are issues, the tab displays a number that indicates how many there are.
The following screenshot shows a summary of the instrumentation and progress to complete instrumentation. The report highlights specific issues with links to this documentation for instructions to resolve.
Add the missing service.namespace attribute
The knowledge graph uses the service.namespace attribute to filter and group by a service’s namespace.
To address this issue, edit these attributes in your instrumentation setup.
Avoid slashes in service name and namespace attributes
Avoid using slashes (/) in the service.name or service.namespace attributes. People often use slashes to namespace services. The OpenTelemetry specification has a specific namespace attribute. If you use the namespace attribute correctly, you can benefit from advanced group and filter features in the knowledge graph.
To address this issue, edit these attributes in your instrumentation setup.
Add missing Kubernetes attributes
If you use Kubernetes, include the k8s.cluster.name, k8s.namespace.name, and k8s.pod.name resource attributes to link Application and Kubernetes Observability and gain additional insights and easier workflows between the two products.
The easiest way to address this issue is to use the recommended Grafana Kubernetes Monitoring Helm chart.
Alternatively for advanced use cases, manually set up Grafana Alloy or an OpenTelemetry Collector with the k8sattributeprocessor activated.
Send missing logs for your service
Your service is missing logs. Send logs to help you debug and monitor your service.
To capture and send your application logs to Grafana Cloud, use one of the following methods:
- Use the recommended instrumentation set up for the knowledge graph
- Send logs to Loki or the OTLP endpoint
Send missing profiles for your service
Your service is missing profiles. Send profiling information to help you debug and monitor your service.
To capture and send your application profile data to Grafana Cloud, instrument your application for profiling data.
Add missing billing telemetry metric
Your service is missing the traces_host_info metric used to correctly calculate knowledge graph billing.
To address this issue, refer to knowledge graph host-hours pricing documentation to learn how to add the required metric.
