Skip to content

Commit 8a13fc6

Browse files
authored
Revise Grafana Cloud integration instructions
Updated the guide to reflect changes in accessing Grafana Cloud credentials and configuring telemetry export for Cloudflare Workers.
1 parent 8123090 commit 8a13fc6

File tree

1 file changed

+13
-16
lines changed

1 file changed

+13
-16
lines changed

src/content/docs/workers/observability/exporting-opentelemetry-data/grafana-cloud.mdx

Lines changed: 13 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Grafana Cloud is a fully managed observability platform that provides visualizat
1212

1313
This guide will walk you through configuring Cloudflare Workers to export OpenTelemetry-compliant traces and logs to your Grafana Cloud stack.
1414

15-
![Grafana Tempo trace view showing a distributed trace for a service with multiple spans including fetch requests, durable object subrequests, and queue operations, with timing information displayed on a timeline](~/assets/images/workers-observability/grafana-traces.png)
15+
![Pre-built Grafana dashboard showing Total requests, request rate (req/sec), and unique request tracking via Ray IDs Log Severity: Breakdown of info, warning, and error logs with color-coded indicators Geographic Distribution: Unique countries, colos, and execution regions](https://storage.googleapis.com/grafanalabs-integration-assets/cloudflare-workers/cloudflare-workers-1.png)
1616

1717
## Prerequisites
1818

@@ -21,26 +21,23 @@ Before you begin, ensure you have:
2121
- An active [Grafana Cloud account](https://grafana.com/auth/sign-up/create-user) (free tier available)
2222
- A deployed Worker that you want to monitor
2323

24-
## Step 1: Access the OpenTelemetry setup guide
24+
## Step 1: Access the Grafana Cloud Credentials
2525

26-
1. Log in to your [Grafana Cloud portal](https://grafana.com/)
26+
1. Log in to your [Grafana Cloud stack](https://grafana.com/)
2727
2. From your organization's home page, navigate to **Connections****Add new connection**
28-
3. Search for "OpenTelemetry" and select **OpenTelemetry (OTLP)**
29-
4. Select **Quickstart** then select **JavaScript**
30-
6. Click **Create a new token**
31-
7. Enter a name for your token (e.g., `cloudflare-workers-otel`) and click **create token**
32-
8. Click on **Close** without copying the token
33-
9. Copy and Save the value for `OTEL_EXPORTER_OTLP_ENDPOINT` and `OTEL_EXPORTER_OTLP_HEADERS` in the `Environment variables` code block as the OTel endpoint and as the Auth header value respectively
34-
28+
3. Search for "Cloudflare" and select **Cloudflare workers**
29+
4. Follow the instructions to create a **Create a new token** and access the grafana Cloud OTLP Credentials for Traces and Logs
30+
* Make sure you note your OTLP endpoint, authorization header name, and authorization header value as these will be used in Step 2
3531

3632
## Step 2: Set up destination
3733
1. Navigate to your Cloudflare account's [Workers Observability](https://dash.cloudflare.com/?to=/:account/workers-and-pages/observability/pipelines) section
3834
2. Click **Add destination** and configure a destination name (e.g. `grafana-tracing`)
39-
3. From Grafana, copy your Otel endpoint, auth header, and auth value
40-
* Your OTEL endpoint will look like `https://otlp-gateway-prod-us-east-2.grafana.net/otlp` (append `/v1/traces` for traces and `/v1/logs` for logs)
41-
* Your custom header should include:
42-
* Your auth header name `Authorization`
43-
* Your auth header value `Basic MTMxxx...`
35+
3. Configuring the Trace and Logs destination:
36+
* For the endpoint, use the OTLP endpoint obtained in Step 1
37+
* Your OTEL endpoint will look like `https://otlp-gateway-prod-us-east-2.grafana.net/otlp` (append `/v1/traces` for traces and `/v1/logs` for logs)
38+
* For authentication, set the:
39+
* Header name as `Authorization`
40+
* Header value to the value of your auth header value from Step 1. Your auth header value will look like `Basic MTMxxx...`
4441

4542
## Step 3: Configure your Worker
4643

@@ -67,7 +64,7 @@ With your destination created in the Cloudflare dashboard, update your Worker's
6764

6865
</WranglerConfig>
6966

70-
After updating your configuration, deploy your Worker for the changes to take effect.
67+
After updating your configuration, deploy your Worker for the changes to take effect. If not using the Grafana Cloud Integration for Cloudflare workers, You can also import the pre-built dashboard from [here](https://github.com/grafana/jsonnet-libs/tree/master/cloudflare-workers-mixin/dashboards)
7168

7269
:::note
7370
It may take a few minutes after deployment for data to appear in Grafana Cloud.

0 commit comments

Comments
 (0)