Skip to main content
Export Courier logs and metrics to any OpenTelemetry-compatible (OTel) observability platform by configuring the OpenTelemetry integration in the Courier dashboard. Courier supports both Basic auth and Bearer Token authorization, so you can connect directly to most providers without an OTel Collector or proxy.

​
Setup

1

Open the OpenTelemetry integration

In Courier, go to Channels (or Integrations) and open the OpenTelemetry integration.
2

Enable the integration

Turn the Enabled toggle on.
3

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.
4

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
5

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.
6

Save

Click Complete. Courier will begin exporting logs and metrics to your platform.

​
Configuration reference

Use HTTPS and dedicated credentials for the Courier integration so you can rotate or revoke them without affecting other services.

​
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

  1. Sign in to the Grafana Cloud Portal.
  2. Select your stack and click Configure on the OpenTelemetry tile.
  3. Note your Instance ID (a numeric value) and your OTLP endpoint URL (e.g. https://otlp-gateway-prod-us-east-0.grafana.net/otlp).
  4. Generate a Cloud API token with metrics:write and logs:write scopes.

​
Step 2: Configure Courier

In the Courier dashboard, open the OpenTelemetry integration and enter: Click Complete to save.

​
Step 3: Verify

  1. In Grafana Cloud, go to Explore.
  2. Select your Mimir data source and filter for {service_name="courier"}.
  3. Switch to Loki to confirm logs are arriving.
Data should appear within a few minutes of enabling the integration.