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

> **Deprecation Notice:** The component type has been renamed from `grafanacloud` to `grafana_cloud`
> to follow the OpenTelemetry snake\_case naming convention.
> The old name `grafanacloud` still works but is deprecated and will be removed in a future release.
> Please update your configuration to use `grafana_cloud`.

## 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:
  grafana_cloud/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, grafana_cloud/connector]

    metrics:
      receivers: [otlp, grafana_cloud/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: ["k8s.node.name", "host.id", "k8s.node.uid"]
    ## @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:
  grafana_cloud:
    host_identifiers: ["mycompany.myHostAttribute", "k8s.node.name", "host.id", "k8s.node.uid"]
    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
grafana_cloud:

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

***

*Last generated: 2026-10-05*