Skip to main content

​
Setup

1

Create a Datadog account

Create a Datadog account if you don’t have one.
2

Generate an API key

Generate a Datadog API key.
3

Add the API key in Courier

Open the in Courier and enter the API key you generated.
4

Verify the Datadog site parameter

Check that the Datadog site parameter matches the URL of your Datadog instance.
5

Add tags (optional)

Use the Tags field to tag everything Courier emits. Courier sends them as Datadog ddtags, so you can filter metrics and logs by environment or team.
The Datadog integration is forward-only. Courier starts emitting metrics when you activate it. It does not backfill historical data.

​
Dashboard

Download the Courier Datadog dashboard to monitor Courier inside Datadog. Download Dashboard JSON
Datadog Dashboard

Datadog Dashboard

​
Available Datadog metrics

Datadog’s Metrics Without Limits lets you configure a tag blocklist to cut cardinality and cost. You’re still billed for ingestion, at a lower rate.

​
Account metrics

  • courier.account.created
  • courier.account.deleted
  • courier.account.updated

​
Account user relationship metrics

  • courier.account.user.added
  • courier.account.user.removed
  • courier.account.user.updated

​
Audience metrics

  • courier.audience.matched
  • courier.audience.unmatched

​
Automation metrics

  • courier.automation.invoked
  • courier.automation.throttled
  • courier.automation.digest.triggered
  • courier.automation.batch.triggered
  • courier.automation.fetch-data-step.errored
  • courier.automation.ai-step.completed
  • courier.automation.ai-step.errored

​
Channel metrics

  • courier.email.delivered
  • courier.email.error
  • courier.email.sent
  • courier.email.undeliverable
  • courier.sms.delivered
  • courier.sms.error
  • courier.sms.sent
  • courier.sms.undeliverable
  • courier.push.delivered
  • courier.push.error
  • courier.push.sent
  • courier.push.undeliverable
  • courier.direct_message.delivered
  • courier.direct_message.error
  • courier.direct_message.sent
  • courier.direct_message.undeliverable
  • courier.inbox.delivered
  • courier.inbox.error
  • courier.inbox.sent
  • courier.inbox.undeliverable
  • courier.webhook.delivered
  • courier.webhook.error
  • courier.webhook.sent
  • courier.webhook.undeliverable
  • courier.banner.delivered
  • courier.banner.error
  • courier.banner.sent
  • courier.banner.undeliverable

​
Debug metric

  • courier.debug

​
Inbox metrics

  • courier.inbox.connection_attempt
  • courier.inbox.connection_error
  • courier.inbox.reconnection_attempt
  • courier.inbox.notification_attempt

​
List metrics

  • courier.list.subscribed
  • courier.list.unsubscribed
  • courier.list.subscribe.failed

​
Message metrics

  • courier.message.canceled
  • courier.message.clicked.details
  • courier.message.delivered
  • courier.message.digested
  • courier.message.filtered
  • courier.message.received
  • courier.message.sent
  • courier.message.throttled
  • courier.message.total.clicked
  • courier.message.total.opened
  • courier.message.undeliverable
  • courier.message.unique.clicked
  • courier.message.unique.opened
  • courier.message.unique.sent
  • courier.message.unmapped
  • courier.message.unroutable

​
User metrics

  • courier.user.created
  • courier.user.deleted
  • courier.user.unsubscribed
  • courier.user.updated
  • courier.user.update.failed

​
Logs

Courier also forwards delivery logs to Datadog’s log intake for your site (https://http-intake.logs.<your-datadog-site>/api/v2/logs). Each entry carries the message, its level, and any tags from the Tags field, so you can match a log line to the metric that reported it. No extra setup is needed. The same API key and site parameter cover both.

​
Troubleshooting