Documentation Index
Fetch the complete documentation index at: https://otel.fyi/llms.txt
Use this file to discover all available pages before exploring further.
Grafanacloud Connector
Available in: contrib
Maintainers: @rlankfo, @jcreixell
Source: opentelemetry-collector-contrib
Overview
Overview
The Grafana Cloud Connector (grafanacloudconnector) is a connector component that can analyze telemetry in pipelines to generate usage metrics for the following Grafana Cloud products:
- Application Observability
Usage
connectors:
grafanacloud/connector:
extensions:
basicauth/grafana_cloud:
client_auth:
username: "${env:GRAFANA_CLOUD_INSTANCE_ID}"
password: "${env:GRAFANA_CLOUD_API_KEY}"
exporters:
otlphttp/grafana_cloud:
endpoint: "${env:GRAFANA_CLOUD_OTLP_ENDPOINT}"
auth:
authenticator: basicauth/grafana_cloud
service:
pipelines:
traces:
receivers: [otlp]
exporters: [otlphttp/grafana_cloud, grafanacloud/connector]
metrics:
receivers: [otlp, grafanacloud/connector]
exporters: [otlphttp/grafana_cloud]
In this example configuration, usage metrics for Grafana Cloud Application Observability are derived from incoming spans.
Configuration
connectors:
grafanacloud/connector:
## @param host_identifiers List of span attributes used to identify the host running the workloads.
## The first matching attribute is used.
# host_identifiers: ["host.id", "k8s.node.uid", "k8s.node.name"]
## @param metrics_flush_interval Interval at which host metrics are flushed.
## Valid values are between 15s and 5m.
# metrics_flush_interval: 60s
Example configuration for the component
connectors:
grafanacloud:
host_identifiers: ["mycompany.myHostAttribute", "host.id", "k8s.node.uid", "k8s.node.name"]
metrics_flush_interval: 60s
This connector will generate a host info metric based on the first host_identifiers resource attribute found on spans. The rest are skipped. Valid flush intervals are between 15s and 5m.
Configuration
Example Configuration
# default configuration
grafanacloud:
# custom configuration
grafanacloud/custom:
host_identifiers:
- k8s.node.name
- host.name
- host.id
metrics_flush_interval: 30s
Last generated: 2026-04-20