Skip to main content

New Relic plugin

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

When to use the New Relic plugin

Incident Management offers two convenient mechanisms for integration with New Relic.

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

    • Don’t want to make direct outbound calls from your environment.

    • Can install an Incident Management Collector on a host in your environment and it will 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.

Install an Incident Management Collector

To use the Incident Management New Relic plugin, you need to install an Incident Management Collector and select the New Relic plugin:

  1. Install the Incident Management Collector on a host within your secure network, as the plugin does not use authentication.

  2. Navigate to the Integrations > Ingestion Services > Collector tab to configure and enable collector plugins.

    Do not go directly to the Plugins tab, to configure the plugin, as the plugin needs to be associated with a specific collector to work properly.

You can set up a collector plugin when you download a new collector, or any time thereafter when configuring an existing collector. For more information about how to select a plugin to enable, see Install the Incident Management Collector.

Configure and enable the New Relic plugin

When you click on the New Relic plugin in the Plugins tab, the pop-up panel provides links to install an Incident Management Collector or configure the New Relic plugin. The recommend procedure, after you install your collector is to:

  1. Navigate to the Ingestion Services > Collector tab.

  2. Click a specific Incident Management Collector. If you have more than one collector, select from the list of collectors.

  3. Click the New Relic plugin 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 the Incident Management, you also need to 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 about configuring NewRelic, see 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 on Create channel.

  7. To verify that the channel is set up correctly, click on 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 incidents and alerts in your Incident Management UI.

  • Check the Collector Logs on the Collectors panel to help troubleshoot your installation and configuration.

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

In this section: