Skip to main content
Export Courier logs and metrics to any OpenTelemetry-compatible observability platform (e.g. Grafana, or your own collector) by configuring the OpenTelemetry integration in the Courier dashboard.

​
Setup

Configure the integration in the Courier dashboard so Courier can send telemetry to your OTLP endpoint.
1

Open the OpenTelemetry integration

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

Enable the integration

Turn the Enabled toggle on so Courier starts exporting logs and metrics to your endpoint.
3

Choose authorization

Set Authorization type to Bearer Token (or the type required by your collector). If using Bearer Token, paste your token into the Bearer token field. Use the (where is it?) link in the UI for guidance on obtaining the token from your observability provider.
4

Set your OTLP endpoint

Enter your collector or backend URL in OTLP endpoint, for example: https://otel-collector.example.com:4318 Use the host and port of your OpenTelemetry collector or your provider’s OTLP endpoint.
5

Optional: Set paths for metrics and logs

If your endpoint uses custom paths, fill in Metrics path (optional) and Logs path (optional). Common defaults are /v1/metrics and /v1/logs. Leave them blank if your endpoint uses standard OTLP paths.
6

Save

Click Complete to save. Courier will start sending logs and metrics to your observability platform via OpenTelemetry.

​
Configuration reference

FieldRequiredDescription
Enabled—Toggle to turn the integration on or off.
Authorization typeYesHow to authenticate (e.g. Bearer Token).
Bearer tokenWhen using BearerSecret used to authenticate with your OTLP endpoint.
OTLP endpointYesBase URL of your OpenTelemetry collector or provider (e.g. https://otel-collector.example.com:4318).
Metrics path (optional)NoPath for metrics (e.g. /v1/metrics). Omit to use the endpoint default.
Logs path (optional)NoPath for logs (e.g. /v1/logs). Omit to use the endpoint default.
Pro Tip: Use HTTPS and a dedicated token for the Courier integration so you can rotate or revoke it without affecting other services.

​
What gets exported

Courier sends logs and metrics over the OTLP protocol. For the list of metrics (e.g. message delivery, automations, account events), see Observability.