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 Moogsoft Cloud Events API.

When to use the New Relic plugin

Moogsoft offers two convenient mechanisms for integration with New Relic.

  • Use the New Relic plugin with the Moogsoft Collector, when you:

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

    • Can install a Moogsoft Collector on a host in your environment and it will act as a proxy.

  • Use the Moogsoft New Relic Integration :

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

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

Install a Moogsoft Collector

To use the Moogsoft New Relic plugin, you need to install a Moogsoft Collector and select the New Relic plugin:

  1. Install the Moogsoft 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 Moogsoft 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 a 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 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 Moogsoft, 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 Moogsoft.

    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 Moogsoft 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.

Discover more

In this section: