> ## 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

> OpenTelemetry connector for Grafanacloud

# Grafanacloud Connector

![Status](https://img.shields.io/badge/status-alpha-red)

**Available in:** `contrib`

**Maintainers:** [@rlankfo](https://github.com/rlankfo), [@jcreixell](https://github.com/jcreixell)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/grafanacloudconnector)

## 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

```yaml theme={null}
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

```yaml theme={null}
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

```yaml theme={null}
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

```yaml theme={null}
# default configuration
grafanacloud:

# custom configuration
grafanacloud/custom:
  host_identifiers:
    - k8s.node.name
    - host.name
    - host.id
  metrics_flush_interval: 30s
```

***

*Last generated: 2026-07-06*