Configure Service Graph Connector for Observability - Datadog using guided setup

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 6 min. de leitura

    • Pull in data from Datadog into your Configuration Management Database (CMDB).

    Antes de Iniciar

    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 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, 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 store app, which is automatically installed.
    • The CMDB CI class models store app, which is automatically installed. See CMDB CI Class Models app.
    • 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.
    • 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 on the ServiceNow Store.
    Nota:
    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: admin

    Role required: SGC-Admin (sn_cmdb_int_util.sgc_admin) or admin
    Nota:
    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.

    Procedimento

    1. Navigate to All > Service Graph Connectors > Observability Datadog > Setup.
    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 NameConnection name field, enter a name for the authenticationconnection.

          For example, Datadog credentials.

          Nota:
          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 Authentication KeyApplication key field, enter the authentication keyapplication 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.
      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.
      3. Opcional: 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.
      4. Configure the Datadog connection settings.
        1. In the Configure the Connection section of the Datadog Integration with CMDB page, select Continue.
        2. For the Configure the Connection task, select Configure.
        3. Review the fields and in the Host field, enter the Datadog base URL or IP address.
        4. Update the Protocol field if you’re using anything other than https.
        5. Leave the Base path field as is.
        6. Click Update.
        7. Set the Configure the Connection task to complete by clicking Mark as Complete.

        For more information about the Datadog API, see the Datadog Developer documentation.

    4. Configure a user account for the Datadog and CMDB integration.
      1. Create the Datadog CMDB integration user account by completing the User form.
        1. In the Datadog CMDB integration user account section of the Datadog Integration with CMDB page, select Get Started.
        2. For the Create a Datadog CMDB integration user task, select Configure.
        3. Review the fields on the User form, enter the Datadog CMDB integration user account details, and set a password for the user account.
        4. Click Update.
        5. Set the Create a Datadog CMDB integration user task to complete by clicking Mark as Complete.
      2. Assign the cmdb_import_api_admin role to the Datadog CMDB integration user.
        1. In the Datadog CMDB integration user account section of the Datadog Integration with CMDB page, select Continue.
        2. For the Assign role to the Datadog CMDB user task, select Configure.
        3. In the User ID column of the Users list, select the Datadog CMDB integration user ID you created in the earlier step 4.a.
        4. In the Roles related list, click Edit.
        5. On the Edit Members form, move the cmdb_import_api_admin role from the available roles in the Collection column to the Roles List column.
        6. Click Save.
        7. Click Update.
        8. Set the Assign role to the Datadog CMDB user task to complete by clicking Mark as Complete.

          Ensure the custom model categories are mapped to predefined categories for proper synchronization.

    5. Configure the ServiceNow tile on Datadog and enable the Datadog CMDB integration.
      1. Configure the ServiceNow tile on Datadog.
        1. Log in to your Datadog account.
        2. Select the Integrations tab.
        3. Search for and select the ServiceNow tile.
        4. Add the ServiceNow instance name in the format https://<instance name>.service-now.com/.
        5. Add the name and password for the Datadog CMDB integration user account and click Submit.

        For more information, see the Datadog documentation.

        Nota:
        After you have configured the ServiceNow tile on Datadog, in the guided setup for Service Graph Connector for Observability - Datadog, go to the Configure Datadog tile and enable integration section of the Datadog Integration with CMDB page and set the Configure the ServiceNow tile in Datadog task to complete by clicking Mark as Complete.
      2. Enable the Datadog CMDB integration on your ServiceNow instance.
        1. In the Configure Datadog tile and enable integration section of the Datadog Integration with CMDB page, select Continue.
        2. For the Enable the integration on ServiceNow task, select Configure.
        3. On the System Property form, fill in the fields to create the sn_datadog_integra.datadog_enabled system property and set its value to true.

          For more information, see Add a system property.

        4. Click Submit.
        5. Set the Enable the integration on ServiceNow task to complete by clicking Mark as Complete.
    6. 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.
        Tabela 1. New record form
        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.
      5. Select Submit.
      6. Populate the Datadog Webhooks list by selecting the Synchronize Monitors related link on the Datadog Webhook page.
        Nota:
        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.
      8. On the Datadog Monitors page, select the Webhook Active check box, and then select Update.
      9. Repeat steps 6.g and 6.h 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.
    7. Set up scheduled import jobs.
      1. Navigate to All > Service Graph Connectors > Observability Datadog > Import 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.

      4. Select Update.