# Grafana Cloud

### Description

This Grafana Cloud destination can be used to send metrics, logs, and traces to a Grafana Cloud instance.

### Supported Types

| Logs | Metrics | Traces | Bindplane Collector |
| ---- | ------- | ------ | ------------------- |
| ✓    | ✓       | ✓      | `v1.36.0`           |

### Prerequisites

In order for the Bindplane Collector to send data to Grafana Cloud, it needs to be configured with a valid Access Policy token, OTLP endpoint, and Grafana Cloud instance ID.

#### Access Policy Token

An Access Policy needs to be created with the correct permissions, which can be done in the Cloud Portal. Navigate to "Access Policies" underneath the "Security" section and choose "Create Access Policy".

Name the new policy something descriptive and choose the "Realm" that best fits your use case. Under "Scopes" select the "Write" permission for the kind(s) of telemetry being exported to Grafana Cloud.

On the card of the newly created Access Policy, select "Add Token". Give this token a descriptive name and select the expiration date that best fits. Note that the Bindplane Collector will need to be reconfigured with a new Access Policy token when the current one expires. The token value that appears next is what is needed for configuration.

For more information, see this Grafana Cloud [documentation](https://grafana.com/docs/grafana-cloud/security-and-account-management/authentication-and-permissions/access-policies/create-access-policies/).

#### OTLP Endpoint and Instance ID

<figure><img src="/files/GvVIAcwm7tPQKRWpkP3u" alt="Bindplane docs - Grafana Cloud - image 1"><figcaption></figcaption></figure>

These two values can be found in the same place. On the home page of your instance's Cloud Portal there should be an "OpenTelemetry" card. Click the "Configure" button and on the next page you can find the OTLP Endpoint and Instance ID for your Grafana Cloud instance. Copy these values and use them for configuring this destination.

For more information, see this Grafana Cloud [documentation](https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/#manual-opentelemetry-setup-for-advanced-users).

### Configuration

<table><thead><tr><th width="238.109375">Field</th><th>Description</th></tr></thead><tbody><tr><td>Choose Telemetry Type</td><td>Select which types of telemetry to export to Grafana Cloud.</td></tr><tr><td>OTLP Endpoint</td><td>The URL to send OTLP data to. Can be found in the Cloud Portal under the OpenTelemetry card.</td></tr><tr><td>Grafana Cloud Instance ID</td><td>The ID for your Grafana Cloud instance. Can be found in the Cloud Portal under the OpenTelemetry card.</td></tr><tr><td>Cloud Access Policy Token</td><td>A token created for an Access Policy in Grafana Cloud. The Access Policy needs write permission for the telemetry being sent.</td></tr><tr><td>Compression</td><td>Compression algorithm to use when sending data to Grafana Cloud.</td></tr></tbody></table>

### Supported Retry and Queuing Settings

This destination supports the [retry settings](/configuration/bindplane-otel-collector/retry-on-failure.md), the [sending queue settings](/configuration/bindplane-otel-collector/sending-queue.md), and the [persistent queue settings.](/configuration/bindplane-otel-collector/persistent-queue.md)

| Sending Queue | Persistent Queue | Retry on Failure |
| ------------- | ---------------- | ---------------- |
| ✓             | ✓                | ✓                |

### Example Configuration

This example configuration is sending just metrics to Grafana Cloud. The endpoint, instance ID, and token are configured for our Grafana Cloud instance. Also compression is enabled with gzip and retry on failure, sending queue, and the persistent queue and enabled with default values.

**Web Interface**

<figure><img src="/files/Dodt0UNqJ8bvzznB4iJ0" alt="Bindplane docs - Grafana Cloud - image 2"><figcaption></figcaption></figure>

<figure><img src="/files/eB1aTieo3lntbgR5DeWM" alt="Bindplane docs - Grafana Cloud - image 3"><figcaption></figcaption></figure>

**Standalone Destination**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Destination
metadata:
  id: grafana_cloud
  name: grafana_cloud
spec:
  type: grafana_cloud
  parameters:
    - name: telemetry_types
      value: ['Logs', 'Metrics', 'Traces']
    - name: endpoint
      value: 'https://otlp-gateway-prod-us-central-0.grafana.net/otl'
    - name: instance_id
      value: '123456'
    - name: token
      value: 'some_access_policy_token'
    - name: compression
      value: gzip
    - name: retry_on_failure_enabled
      value: true
    - name: sending_queue_enabled
      value: true
    - name: persistent_queue_enabled
      value: true
    - name: persistent_queue_storage_extension
      value: 
        type: file_storage_persistent_queue
        parameters:
          - name: persistent_queue_directory
            value: ${OIQ_OTEL_COLLECTOR_HOME}/storage
          - name: timeout
            value: 1
          - name: persistent_queue_fsync
            value: true
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/integrations/destinations/grafana-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.