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 Grafana Cloud and others.
- Bearer Token: enter your API key or token.
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 metrics and logs paths
If your endpoint uses custom paths, fill in Metrics path and Logs path. Common defaults are
/v1/metrics and /v1/logs. Leave both blank to use the endpoint defaults.6
Save
Click Complete. Courier starts exporting logs and metrics to your platform.
Configuration reference
What gets exported
Courier sends logs and metrics over the OTLP protocol. For the full list of metrics, see .Grafana Cloud OTel setup guide
Courier connects directly to Grafana Cloud using Basic auth. No OTel Collector or proxy 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 (numeric) 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
Open the OpenTelemetry integration in Courier and enter:
Click Complete to save.
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.