Connecting Knock to your Datadog account

You can use the Knock + Datadog integration to stream workflow, channel, and message metrics from your Knock account to your Datadog account. With this you can:

  • Set up custom Datadog monitors and dashboards to track your Knock workflows & channels
  • Get up-to-the-minute data on workflows triggered and messages delivered
  • Monitor events ingested and actions triggered from event platforms like Segment and Rudderstack

What this integration does

This integration will send a stream of metrics as they happen from your Knock account to your Datadog account. Metrics are prefixed knock.* and include success and failure codes. Metrics are tagged (where applicable) by:

  • Environment
  • Workflow key
  • Workflow exec mode
  • Channel or workflow step type
  • Integration source type
  • Error reason

Please refer to your Datadog pricing agreement for information on how custom metrics sent to Datadog are priced for your account.

At this time there is no way to selectively enable specific metrics, however metrics will only be emitted to Datadog for features that you are actively using in Knock.

Installing the integration

  1. Visit the integrations page in your Knock dashboard, and click the "Extensions" tab
  2. Click "Configure Datadog"
  3. Enter a Datadog API Key from Datadog's API Keys page (we recommend creating a dedicated key just for Knock)
  4. Pick the correct site for your Datadog account (visit Datadog's docs for more information)
  5. Click "Connect"

Dashboard starter kit

Get started with our Datadog dashboard starter kit to start monitoring Knock metrics with just a few clicks:

  1. Visit Datadog's dashboard list and click "New Dashboard"
  2. Give it a name and click "New Dashboard"
  3. Click the gear icon in the corner of the dashboard and choose "Import dashboard JSON..."
  • You may need to close the "Add Widgets" tray to see the gear icon
  1. Click the button below to copy the dashboard JSON, and paste it into the Datadog dashboard page when prompted.

The Knock Datadog Dashboard in action

Reported metrics

knock.message_delivered.totalcountHow many messages have been delivered, segmented by `channel` and `workflow` key.
knock.message_delivered_retryable_error.totalcountHow many deliveries ended in a retryable failure, segmented by `channel` and `workflow` key.
knock.message_delivered_error.totalcountHow many deliveries ended in failure (not retryable), segmented by `channel` and `workflow` key.
knock.workflow_recipient_run.totalcountHow many workflow recipient runs have been started, segmented by `workflow` key and `exec_mode`.
knock.workflow_recipient_run_error.totalcountHow many errors were experienced during a workflow recipient run, segmented by `workflow` key, `exec_mode`, `step_type`, and the error `reason`. A workflow recipient run can report more than one error.
knock.integration_event_received.totalcountHhe raw number of events received by Knock from an [integration source](https://docs.knock.app/integrations/sources/overview), segmented by `source_type`.
knock.integration_action_run.totalcountHow many actions were triggered by received events, segmented by `source_type` and `action`.
knock.integration_action_run_error.totalcountHow many actions failed to run, segmented by `source_type` and `action`.
  • All metrics are segmented by environment name (e.g. production, development)
  • For each of the error cases, the Knock dashboard can provide more insights into specific failures (e.g. misconfigured workflow, channel, or integration action)

Uninstalling the integration

  1. Visit the integrations page in your Knock dashboard, and click the "Extensions" tab
  2. Click the "Disconnect" button for the Datadog extension, and then click "Confirm"
  3. If you created a dedicated Datadog API key for Knock, you can now delete the key from Datadog's API Keys page