--- sourceDocument: Australia ServiceNow AI Platform Capabilities sourceDocumentLink: https://www.servicenow.com/docs/r/servicenow-platform Release : - australia ft:locale : - en-US ft:publication_title : - Australia ServiceNow AI Platform Capabilities ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Configure the connector # Configure Service Graph Connector for Observability - Datadog {#ariaid-title1} * Release version: Australia * * Updated March 12, 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read Pull in data from Datadog into your Configuration Management Database (CMDB). ## Before you begin To use this Service Graph Connector, you need a subscription to a Subscription Unit that is based in the IT Operations Management (ITOM) Visibility application or in the ITOM Discovery application. As defined in the section titled "Managed IT Resource Types" in [ServiceNow Subscription Unit Overview](https://www.servicenow.com/products/entitlements-packages.html) for your subscription, for managed IT resources that are created or modified in the CMDB by this Service Graph Connector, but that aren't yet managed by [ITOM Visibility or ITOM Discovery](https://www.servicenow.com/docs/access?context=itom-license-module&version=australia&pubname=australia-it-operations-management&ft:locale=en-US), these resources will increase Subscription Unit consumption from that application. Review your current Subscription Unit consumption within ITOM Visibility or ITOM Discovery to ensure available capacity. Dependencies and requirements: * The [Integration Commons for CMDB](https://www.servicenow.com/docs/eNRvwxlXe1MvEh~3MtTKAQ "The Integration Commons for CMDB application contains the CMDB Integrations Dashboard and a set of Robust Transform Engine (RTE) transforms and script includes.") store app, which is automatically installed. * The CMDB CI class models store app, which is automatically installed. See [CMDB CI Class Models app](https://www.servicenow.com/docs/darqAyORPOpoURCcjTGVXA "The CMDB contains base-system classes that store data about configuration items (CIs). The CMDB CI Class Models ServiceNow Store app adds class models that extend the CMDB class hierarchy, including class descriptions, identification rules, identifier entries, and dependent relationships if applicable."). * The ITOM Discovery License plugin (com.snc.itom.discovery.license). You must activate this plugin. * ITOM Licensing plugin (com.snc.itom.license). For more information, see [Request Discovery](https://www.servicenow.com/docs/access?context=t_ActivateTheDiscoveryPlugin&version=australia&pubname=australia-it-operations-management&ft:locale=en-US). * The Datastream Action plugin (com.glide.hub.action_type.datastream), which is automatically installed. * Observability Commons for CMDB (sn_observability), which is only required for event ingestion. This must be installed prior to installing the connector for Event Management to work. For more information, see [Observability Commons for CMDB](https://store.servicenow.com/sn_appstore_store.do#!/store/application/97e04562072020107add6a77c4a9351a) on the ServiceNow Store. {#sgc-configure-datadog-integration__ul_igl_nfr_sqb} Note: If you have an earlier version of the Service Graph Connector for Observability - Datadog, then don't migrate data from the old connector. You must uninstall the previous version and run the new integration. Role required: SGC-Admin (sn_cmdb_int_util.sgc_admin) or admin Note: The admin user role is required to run background scripts and to provide access to global tables to the SGC-Admin user. For information about the user roles for Service Graph Connectors, see [Service Graph Connector user roles](https://www.servicenow.com/docs/llR5whccV6~8Oi~Q_e8~xQ#cmdb-sgc-intro__section_ett_spp_4hc). ## Procedure 1. Navigate to AllService Graph ConnectorsObservability DatadogSetup. 2. On the Getting started page, select Get Started. 3. Configure the authentication credentials and the host name to send requests to the Datadog API. 1. Configure your Datadog credentials. 1. In the Configure the Connection section of the Datadog Integration with CMDB page, select Get Started. 2. For the Configure the Credentials task, select Configure. 3. In the Connection name field, enter a name for the connection. Note: Do not modify the name of the default connection. 4. In the Connection URL field, enter the base URL or IP address for Datadog. 5. In the API key field, enter the Datadog API token. 6. In the Application key field, enter the application key used for connecting to the Datadog API. 7. Select Update. 8. Set the Configure the Credentials task to complete by selecting Mark as Complete. {#sgc-configure-datadog-integration__ol_hfg_3gy_prb} 2. Test the connection. 1. For the Test Connection task, select Configure. 2. Test the connection by selecting the Test Connection related link. Testing the connection might take a few moments. The page is refreshed to show the test results. 3. When the Status field is set to Success, select Update. If any of the tests have errors, follow the suggestions for remediation. 4. Set the Test Connection task to complete by selecting Mark as complete. {#sgc-configure-datadog-integration__ol_hnn_xyx_rfc} 3. **Optional:** Add a filter for the SGO-Datadog Hosts \[sn_datadog_integra_datadog_hosts\] data source. 1. For the Create Hosts Filter task, select Configure. 2. Enter a comma-separated list of host tags in `key:value` format in the Value field to define a filter for pulling host data from Datadog. For example, datadog:monitored,env:production. 3. Select Update. 4. Set the Create Hosts Filter task to complete by selecting Mark as complete. {#sgc-configure-datadog-integration__ol_dhj_wzx_rfc} {#sgc-configure-datadog-integration__datadog-alias} {#sgc-configure-datadog-integration__datadog-alias} 4. Configure the webhook and monitors for Observability Datadog. 1. In the Configure Observability section of the Datadog Integration with CMDB page, select Get started. 2. For the Configure the Webhooks and Monitors task, select Configure. 3. In the Datadog Webhooks list, select New to add a Datadog webhook. 4. Fill in the fields. {#sgc-configure-datadog-integration__table_ctf_lpz_nwb__entry__2} | Field | Description | |-|-| | Name | Name of the Datadog webhook. | | Connection Alias | Search for and select the connection and credential alias that you created in step [3](https://www.servicenow.com/docs/l5MCnLOzXmOis05l6pwYsA#sgc-configure-datadog-integration__datadog-alias). | [Table 1. New record form] {#sgc-configure-datadog-integration__table_ctf_lpz_nwb} 5. Select Submit. 6. Populate the Datadog Webhooks list by selecting the Synchronize Monitors related link on the Datadog Webhook page. Note: In the Datadog Webhooks list, don't select New to add a monitor as this option is not used in this scenario. 7. In the Name column of the Datadog Webhooks list, select a monitor. {#sgc-configure-datadog-integration__substep-datadog-monitor1} {#sgc-configure-datadog-integration__substep-datadog-monitor1} 8. On the Datadog Monitors page, select the Webhook Active check box, and then select Update. {#sgc-configure-datadog-integration__substep-datadog-monitor2} {#sgc-configure-datadog-integration__substep-datadog-monitor2} 9. Repeat steps [4.g](https://www.servicenow.com/docs/l5MCnLOzXmOis05l6pwYsA#sgc-configure-datadog-integration__substep-datadog-monitor1) and [4.h](https://www.servicenow.com/docs/l5MCnLOzXmOis05l6pwYsA#sgc-configure-datadog-integration__substep-datadog-monitor2) for all the monitors in the Datadog Webhooks list. 10. On the Datadog Webhook page, select Update to save your changes. 11. Set the Configure the Webhooks and Monitors task to complete by selecting Mark as Complete. {#sgc-configure-datadog-integration__substeps_jqr_lmz_nwb} 5. Set up scheduled import jobs. 1. Navigate to AllService Graph ConnectorsObservability DatadogImport Schedules. 2. Select the name of the scheduled import that you want to activate. 3. On the Scheduled Data Import form, verify the field values for the scheduled job and select the Active check box. For more information, see [Schedule a data import](https://www.servicenow.com/docs/access?context=t_ScheduleADataImport&version=australia&pubname=australia-integrate-applications&ft:locale=en-US#table_r53_5hm_xp). 4. Select Update. {#sgc-configure-datadog-integration__substeps_twb_wsw_4gc} **Related concepts** * [Service Graph Connector for Observability - Datadog](https://www.servicenow.com/docs/vKIW9Gi~0JXwiDFyucQg7Q "Use the Service Graph Connector for Observability - Datadog to ingest CMDB data from a Datadog installation using REST APIs. Push events from Datadog into ServiceNow with Event Management.") * [Accessing the connection details of Service Graph Connector for Observability - Datadog](https://www.servicenow.com/docs/hmk3MK6GoMrjNwhChr3fyg#sgc-datadog-conn "You can access the connection details of the Service Graph Connector for Observability - Datadog in a single view using the common connection framework (CCF) included within the Integration Commons for CMDB (sn_cmdb_int_util) store app.") **Related reference** * [CMDB classes targeted in Service Graph Connector for Observability - Datadog](https://www.servicenow.com/docs/D6BxExd37UlOt3v9N19FKA "When you complete setting up the connection, the data is automatically pulled from Datadog. The data is saved in target tables.") *[\>]: and then