Skip to main content

New Relic plugin

The New Relic plugin receives JSON event data on the specified port and address, then forwards it to the APEX AIOps Incident Management Events API.

When to use the New Relic plugin

Incident Management offers two mechanisms for integration with New Relic.

  • Use the New Relic plugin with the APEX AIOps Incident Management Collector, when you:

    • Prefer to avoid making direct outbound calls from your environment.

    • Can install an Incident Management Collector on a host in your environment to act as a proxy.

  • Use the Incident Management New Relic Integration:

    • To ingest events from New Relic and send them to Incident Management with automatic mapping.

    • When you can configure your New Relic instance to authenticate against an Incident Management endpoint to send data to Incident Management. This integration does not require an Incident Management Collector and you can use authentication.

Configure and enable the New Relic plugin

When you click the New Relic plugin on the Plugins tab, the pop-up panel provides links to install an Incident Management Collector or configure the New Relic plugin.

You must have a collector installed to use the New Relic plugin. See Install a Linux or MacOS collector or Install a Windows OS collector for instructions on setting up a new collector.

The recommend procedure, after you install your collector is to:

  1. Navigate to Inbound Integrations > Collectors.

  2. Select a specific Incident Management Collector.

  3. On the Plugins tab, click the New Relic plugin tile and provide the configuration parameters in the pop-up panel.

Parameter Configuration:

  1. From the New Relic Plugin > Configuration tab, define the following parameters:

    • Address— Provide the IP Address where you want the plugin to receive alerts from the New Relic Webhook. Use the IP address of the host where you installed the collector.

    • Port — Provide the port number where you want the plugin to receive alerts from the New Relic Webhook. The default is set to port 8084.

  2. Toggle the Enable option on when you are ready to start plugin data ingestion.

  3. You can now set up a New Relic Webhook to send data to the collector plugin, as described in the following section.

Configure New Relic to send data to the plugin

To ingest data into Incident Management, you must also configure New Relic to send event data to the New Relic plugin. You can do this before or after you enable the plugin. For more help with configuring New Relic, see the New Relic documentation.

  1. Log in to New Relic and click Alerts in the left-hand menu.

  2. Select Webhook to create a new webhook.

  3. For the Endpoint Url, enter the URL for your plugin configuration, followed by a colon and the port number. For example:

    http://myhost.domain.com:8084

  4. Save the webhook.

  5. Create a new workflow and add the default (initial) policy.

  6. In the Notify section of the workflow, attach the webhook you created.

  7. To verify that the configuration is set up correctly, select the webhook and click Send a test notification.

  8. Confirm that the test alert appears in the Incident Management UI.

    Note

    The default webhook message template is no longer supported due to the transition to workflows. You must use the classic notification template referenced in the New Relic migration documentation.

Note

For more information about notification channels and alert policies in New Relic, see docs.newrelic.com.

Validate the New Relic plugin Integration

To validate the integration, you have the following options:

  • To see if New Relic has succeeded in transmitting data to the plugin, check for incidents and alerts in Incident Management.

  • Check the Collector Logs for the collector configured for New Relic for information to help troubleshoot your installation and configuration.

  • Send a test notification when you create a New Relic channel.

In this section: