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 the Ingestion Services > Collectors tab.

  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 & AI in the top menu and click Channels.

  2. Click Create a new notification channel.

  3. Select channel type Webhook and add a channel name.

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

    http://myhost.domain.com:8084

  5. Create a custom header with:

    1. Name = Content-Type

    2. Value = application/json

  6. Click Create channel.

  7. To verify that the channel is set up correctly, click Send a test notification.

  8. Add the notification to the New Relic policy associated with the alerts you want to send to Incident Management.

    1. Click Notifications channels > Add notification channels.

    2. Click Webhook > Moogsoft > Update policy.

    3. Check that you received a Success banner.

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: