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.

OTLP Endpoint and Instance ID

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.

Configuration

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

Supported Retry and Queuing Settings

This destination supports the following retry and queuing settings:

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

Standalone Destination

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