Datadog Integration

Monitor your syncs in Datadog
With Census's Datadog integration, you can centralize your monitoring and alerting within one tool. Census will emit metrics and events that help you understand the health of your data pipelines, alert on anomalies, and manage incidents.
The Datadog integration is accessible for Platform Plan accounts. If you would like to enable this integration and are not on the Platform Plan, please contact us at [email protected].

Set up

To set up your Datadog integration:
  1. 1.
    Navigate to your workspace's Settings > Integrations tab.
  2. 2.
    Click to configure your Datadog integration for this workspace.
  3. 3.
    Authenticate with your Datadog account via OAuth.
You're done! Metrics and events will start flowing to Datadog with every sync.
Datadog's Approved Partner Integration Dashboard for Census Observability
To view a dashboard of recommended, actionable reports on top of your Census Datadog metrics -- you may take advantage of Census's listing on the Datadog Integrations marketplace.
  1. 1.
    Log into your Datadog account.
  2. 2.
    Head to the Integrations tab, and search for Census.
  3. 3.
    Click to "Install" the Integration.
  4. 4.
    Navigate to your list of dashboards. You'll now see the dashboard "Census Sync Observability" available in your account!
Any data previously sent through the integration will populate these reports.

Metrics and Events

Census sends the following to Datadog:


  • census.syncs.sync_completed - the number of syncs that have completed over a time window
  • census.syncs.rows_processed - the volume of rows processed in your syncs, useful for anomaly detection


  • census.syncs.completed - this event allows for alerting and incident management flows if the sync fails, and includes the sync's failure reason.


  • workspace_id - your workspace's immutable ID associated with the metric / event
  • workspace_name - your workspace's name associated with the metric / event
  • sync_id - your sync's immutable ID, also searchable in the Management API and Sync Logs
  • sync_behavior - how the sync is updating your destination's records (e.g. upsert, update, mirror)
  • destination_type - the destination you're updating with a sync (e.g. Salesforce, Google Sheets, ...)
  • destination_object - the object you're updating within the destination (e.g. Account, User, ...)
  • is_full_sync - a boolean flag to indicate whether or not this sync is expected to be a full sync because either a user requested it or the sync is backfilling a newly added column
For the census.syncs.sync_completed metric only:
  • status - whether the sync was a success or failure
For the census.syncs.rows_processed metric only:
  • type - containing the following potential values
    • changed - new or updated records that Census will try to sync
    • deleted - the number of removed records that Census will try to delete if the sync behavior is "mirror"
    • invalid - the number of records with a duplicate or NULL identifier in the sync