Set up scheduled import jobs to pull in data from New Relic into your 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 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.
  • 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.
Note: If you have an earlier version of the Service Graph Connector for Observability - New Relic, then don’t migrate data from the old connector. You must uninstall the previous version and run the new integration.

Role required: admin

Procedure

  1. Ensure that the application scope is set to the Service Graph Connector for Observability - New Relic application by using the application picker.
    For more information, see Application picker.
  2. Navigate to All > Service Graph Connectors > New Relic > Setup.
  3. On the Getting started page, select Get Started.
  4. Configure the authentication credentials to send requests to the New Relic application.
    1. Configure your New Relic connection and credentials.
      1. In the Configure the Connection section of the New Relic Integration with CMDB page, select Get Started.
      2. For the Configure connection and credentials task, select Configure.
      3. On the Connections page of the Workflow Studio, select Configure for the NewRelicConnectionAlias connection that is available by default.
      4. On the form, review and modify the fields.
        Table 1. Configure Connection form
        Field Description
        Connection Information
        Connection Name Name to uniquely identify the connection record. For example, NewRelicConnectionAlias.
        Connection URL Base URL to connect to the New Relic application in the following format: 
        https://api.newrelic.com/graphql
        Note: This field is automatically set to the URL to connect to the NerdGraph API in the New Relic application. Leave the field value as is.
        Credential Information
        API Key NerdGraph API token used for authentication on the New Relic application.
        Account ID Account ID associated with the New Relic credential.
      5. Select Configure Connection.
        Note: The Service Graph Connector for Observability - New Relic supports connection to a single New Relic instance only. So, you can use the single default connection only.
      6. Return to the Configure the connection task page using the back button for your browser.
      7. Set the Configure connection and credentials task to complete by clicking Mark as Complete.
    2. Test the NerdGraph API connection to import data from the New Relic application.
      1. In the Configure the Connection section of the New Relic Integration with CMDB page, select Continue.
      2. For the Test Connection task, select Configure.
      3. Click the Test Load 20 Records related link.

        The Test Connection dialog box opens displaying the import progress.

      4. When the progress state changes to Complete, click X to close the Test Connection dialog box and return to the setup.
      5. Set the Test Connection task to complete by clicking Mark as Complete.
  5. Configure the webhooks for Observability New Relic and turn on alerts for unmatched configuration items (CIs).
    1. Configure the webhooks for Observability New Relic.
      1. In the Configure Observability section of the New Relic Integration with CMDB page, select Get started.
      2. For the Configure the webhooks task, select Configure.
      3. In the SG-New Relic Webhooks list, click New to add a New Relic webhook.
      4. On the form, fill in the fields.
        Table 2. New record form
        Field Description
        Name Name of the New Relic webhook.
        Connection Alias Search for and select the connection and credential alias you created in step 4.
      5. Click Submit.
      6. Set the Configure the webhooks task to complete by clicking Mark as Complete.
    2. Enable alerts for configuration items (CIs) that aren’t available in the CMDB.
      1. In the Configure Observability section of the New Relic Integration with CMDB page, select Continue.
      2. For the Turn on alerts for unmatched CI task, select Configure.
      3. On the System Property form, fill in the fields to create the sn_newrelic_integ.alerts_for_unmatched_ci.enabled system property and set its value to true.

        For more information, see Add a system property.

      4. Click Submit.
      5. Set the Turn on alerts for unmatched CI task to complete by clicking Mark as Complete.
  6. Configure the scheduled jobs to import data from the New Relic application.
    1. In the Set up scheduled data imports section of the New Relic Integration with CMDB page, select Get started.
    2. For the Configure Scheduled Data Imports task, select Configure.
    3. Select the scheduled job that you want to activate.
    4. On the Scheduled Data Import form, verify the field values for the scheduled job.
      For more information, see Schedule a data import.
    5. Click Update.
    6. Repeat the steps 6.c to 6.e for each scheduled job for data import.
    7. Click X to close the Configure Scheduled Data Imports window and return to the setup page.
    8. Set the Configure Scheduled Data Imports task to complete by clicking Mark as Complete in the guided setup.