Grafana

Grafana is an open-source visualization and monitoring platform that lets you create customizable dashboards and analyze observability data from multiple sources. This guide explains how to integrate ThousandEyes metrics with Grafana using OpenTelemetry.

For more information about sending metrics to Grafana using OpenTelemetry, see Grafana Cloud: Send data using OpenTelemetry Protocol (OTLP).

Step 1: Create a new Connection

To send data to Grafana, you’ll need to create a connection. Follow these steps to create a Grafana connection:

1. In the Grafana Cloud platform, go to Connections.

2. Click Add new connection.

3. Search for OpenTelemetry Collector.

4. Scroll to the Generate OpenTelemetry Collector Configuration step.

5. Enter an Access Policy token name.

6. Click Create token.

7. Copy the generated OpenTelemetry Collector Configuration for future use.

Step 2: Create an Integration

Create an Integration Using the ThousandEyes UI

1. Log in to your account on the ThousandEyes platform and go to Manage > Integration 1.0.

2. Click +New Integration and select OpenTelemetry Integration.

3. Enter a Name for the integration.

4. Set the Target to HTTP.

5. For the Endpoint URL, enter the endpoint from your generated OpenTelemetry Collector Configuration in step 1 and add /v1/metrics to the end of your endpoint url. For example, https://otlp-gateway-prod-us-central-0.grafana.net/otlp/v1/metrics.

   
6. For Preset Configurations, select Grafana.

7. For Auth Type, select Basic.

8. Enter the username and password from your OpenTelemetry Collector Configuration.

9. For the OpenTelemetry Signal, select Metric.

10. For the Data Model Version, select v1.

11. Select a test. For more information on creating a test, see General Setup Instructions.

12. Click Save to complete the integration setup.

You have now successfully integrated your ThousandEyes data with Grafana.

Manage Integrations in the UI

For more information on managing OpenTelemetry integrations, including listing, editing, and deleting integrations, see Manage Integrations Using the UI - Integrations 1.0.

Create an Integration Using the ThousandEyes API

For a programmatic integration, use the following API command:

curl -v -XPOST https://api.thousandeyes.com/v7/stream -H "Content-Type: application/json" -H \
"Authorization: Bearer $BEARER_TOKEN" -d '{
  "type": "opentelemetry",
  "testMatch": [{
    "id": "281474976717575",
    "domain": "cea"
  }],
  "endpointType": "http",
  "streamEndpointUrl": "{STREAM_ENDPOINT_URL}",
  "customHeaders": {
    "Authorization": "Basic $(echo -n $GRAFANA_USER:$GRAFANA_PASSWORD | base64)"
  },
  "dataModelVersion": "v1"
}'

Replace $GRAFANA_USER, $GRAFANA_PASSWORD and {STREAM_ENDPOINT_URL} with the correct values for your Grafana instance.

ThousandEyes Dashboard in Grafana

To access the ThousandEyes Dashboard in Grafana, visit the official Grafana dashboard page ThousandEyes Dashboard on Grafana.