Setup
Open the OpenTelemetry integration
In Courier, go to Channels (or Integrations) and open the OpenTelemetry integration.
Choose authorization
Set Authorization type to match your provider:
- Basic — enter your username and password. Used by providers like Grafana Cloud.
- Bearer Token — enter your API key or token. Used by providers that accept bearer tokens.
Set your OTLP endpoint
Enter your provider’s OTLP endpoint URL in OTLP endpoint. For example:
- Grafana Cloud:
https://otlp-gateway-<region>.grafana.net/otlp - Self-hosted collector:
https://otel-collector.example.com:4318
Optional: Set paths for metrics and logs
If your endpoint uses custom paths, fill in Metrics path and Logs path. Common defaults are
/v1/metrics and /v1/logs. Leave blank to use the endpoint defaults.Configuration reference
| Field | Required | Description |
|---|---|---|
| Enabled | — | Toggle the integration on or off. |
| Authorization type | Yes | Basic or Bearer Token. |
| Username | When using Basic | Username for Basic auth (e.g. Grafana Cloud Instance ID). |
| Password | When using Basic | Password for Basic auth (e.g. Grafana Cloud API token). |
| Bearer token | When using Bearer | API key or token for Bearer auth. |
| OTLP endpoint | Yes | Your provider’s OTLP endpoint URL. |
| Metrics path | No | Custom path for metrics (e.g. /v1/metrics). |
| Logs path | No | Custom path for logs (e.g. /v1/logs). |
What gets exported
Courier sends logs and metrics over the OTLP protocol. For the full list of available metrics (message delivery, automations, account events, etc.), see Observability.Grafana Cloud OTel setup guide
Courier connects directly to Grafana Cloud using Basic auth. No OTel Collector or proxy is required.Step 1: Get your credentials
- Sign in to the Grafana Cloud Portal.
- Select your stack and click Configure on the OpenTelemetry tile.
- Note your Instance ID (a numeric value) and your OTLP endpoint URL (e.g.
https://otlp-gateway-prod-us-east-0.grafana.net/otlp). - Generate a Cloud API token with
metrics:writeandlogs:writescopes.
Step 2: Configure Courier
In the Courier dashboard, open the OpenTelemetry integration and enter:| Field | Value |
|---|---|
| Enabled | On |
| Authorization type | Basic |
| Username | Your Instance ID |
| Password | Your Cloud API token |
| OTLP endpoint | https://otlp-gateway-<region>.grafana.net/otlp |
| Metrics path | (leave blank) |
| Logs path | (leave blank) |
Step 3: Verify
- In Grafana Cloud, go to Explore.
- Select your Mimir data source and filter for
{service_name="courier"}. - Switch to Loki to confirm logs are arriving.