Skip to main content

​
Grafanacloud Connector

Status 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-13