Configuration and Discovery

The following sections describe how to configure and discover New Relic services for monitoring by SL1 using the New Relic: APM PowerPack:

Prerequisites for Monitoring New Relic Services

To configure the SL1 system to monitor New Relic services using the New Relic: APM PowerPack, you must first have the following information about the New Relic services that you want to monitor for each account and sub-account:

A New Relic REST API key. To generate the REST API key, go to the Account Settings page for your New Relic account.
The username and password for your New Relic service.
Insights Query Key. This is optional. Add this to the credential if you want to discover infrastructure groups used for server monitoring. You can generate this from your Insights account.

NOTE: Ensure that you do not have the New Relic: APM Pro PowerPack installed before installing the New Relic: APM PowerPack. These PowerPacks are not compatible. If you have the New Relic: APM Pro PowerPack installed, it will need to be uninstalled prior to installing the New Relic: APM PowerPack. The historical data from the New Relic: APM Pro PowerPack will be deleted when it is uninstalled.

Creating a SOAP/XML Credential for New Relic

To configure SL1 to monitor New Relic services, you must create a SOAP/XML credential. This credential allows the Dynamic Applications in the New Relic: APM PowerPack to communicate with your New Relic service.

NOTE: If you are using an SL1 system prior to version 11.1.0, the new user interface does not include the Duplicate option for sample credential(s). ScienceLogic recommends that you use the classic user interface and the Save As button to create new credentials from sample credentials. This will prevent you from overwriting the sample credential(s).

To define a SOAP/XML credential:

Go to the Credentials page (Manage > Credentials).
Locate the New Relic | Proxy Example credential, then click its Actions icon () and select Duplicate. A copy of the credential, called New Relic | Proxy Example - copy appears.
Click the Actions icon () for the credential copy and select Edit. The Edit Credential modal page appears.

Supply values in the following fields:

Name. Type a new name for your Meraki credential.

All Organizations. Toggle on (blue) to align the credential to all organizations, or toggle off (gray) and then select one or more specific organizations from the What organization manages this service? drop-down field to align the credential with those specific organizations.
Timeout (ms). Keep the default value.

Content Encoding.Keep the default value.
Method. Keep the default value.

HTTP Version. Keep the default value.
URL. Leave this field as the default ("https://api.newrelic.com").

HTTP Auth User. Type your New Relic API key in this field.

HTTP Auth Password. Leave this field blank.

Embedded Password [%P]. Type the Insights Query Key in this field if you want to discover infrastructure groups for server monitoring. If you do not have an Insights account, leave this field blank.
Embed Value [%1]. Type the ID number for your New Relic account.
Embed Value [%3]. To collect data with New Relic object tags, you must enter a New Relic user key into this field. New Relic user keys begin with "NRAK-" followed by an alpha-numeric value. Leave this field blank if you do not wish to collect tags.

Click Save & Close.

Creating a SOAP/XML Credential for New Relic in the SL1 Classic User Interface

To configure a SOAP/XML credential to access New Relic:

Go to the Credential Management page (System > Manage > Credentials).
Locate the New Relic | Proxy Example credential, and then click its wrench icon (). The Edit SOAP/XML Credential modal page appears.

Enter values in the following fields:

Basic Settings

Profile Name. Type a new name for the credential.

URL. Leave this field as the default ("https://api.newrelic.com").
HTTP Auth User. Type your New Relic API key in this field.
HTTP Auth Password. Leave this field blank.

SOAP Options

Embedded Password [%P]. Type the Insights Query Key in this field if you want to discover infrastructure groups for server monitoring. If you do not have an Insights account, leave this field blank.
Embed Value [%1]. Type the ID number for your New Relic account.
Embed Value [%3]. To collect data with New Relic object tags, you must enter a New Relic user key into this field. New Relic user keys begin with "NRAK-" followed by an alpha-numeric value. Leave this field blank if you do not wish to collect tags.

NOTE: There are several system-defined tags that are automatically applied by New Relic. To avoid duplicate data, SL1 does not collect these tags and will collect only user-defined tags.

For all other fields, use the default values.
Click the Save As button.

Discovering New Relic Component Devices

To model and monitor your New Relic devices, you must run a discovery session to discover your New Relic services.

If you have multiple New Relic accounts and sub-accounts to discover, follow the steps in the Discovering Additional New Relic Accounts section.

NOTE: The PowerPack does not model applications with "reporting: false" statuses.

Several minutes after the discovery session has completed, the Dynamic Applications in the New Relic: APM PowerPack should automatically align to the services and then discover, model, and monitor the remaining New Relic component devices.

To discover the New Relic service that you want to monitor, perform the following steps:

On the Devices page () or the Discovery Sessions page (Devices > Discovery Sessions), click the Add Devices button. The Select page appears:

Click the Unguided Network Discovery button. Additional information about the requirements for discovery appears in the General Information pane to the right.

Click Select. The Add Devices page appears:
Complete the following fields:

Name. Type a unique name for this discovery session. This name is displayed in the list of discovery sessions on the Discovery Sessions tab.
Description. Optional. Type a short description of the discovery session. You can use the text in this description to search for the discovery session on the Discovery Sessions tab.
Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices.

Click Next. The Credentials page of the Add Devices wizard appears:

On the Credentials page, locate and select the SOAP/XML credentials you created for the New Relic service.

Click Next. The Discovery Session Details page of the Add Devices wizard appears:

Complete the following fields:

List of IPs/Hostnames. Type "api.newrelic.com".

Which collector will monitor these devices?. Select an existing collector to monitor the discovered devices. Required.
Run after save. Select this option to run this discovery session as soon as you click Save and Close.

In the Advanced options section, click the down arrow icon () to complete the following fields:

Discover Non-SNMP. Enable this setting.
Model Devices. Enable this setting.

Click Save and Close to save the discovery session. The Discovery Sessions page (Devices > Discovery Sessions) displays the new discovery session.
If you selected the Run after save option on this page, the discovery session runs, and the Discovery Logs page displays any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page includes a link to the Device Investigator page for the discovered device.

Discovering New Relic Component Devices in the SL1 Classic User Interface

To model and monitor your New Relic devices, you must run a discovery session to discover your New Relic services.

If you have multiple New Relic accounts and sub-accounts to discover, follow the steps in the Discovering Additional New Relic Accounts section.

NOTE: The PowerPack does not model applications with "reporting: false" statuses.

To discover the New Relic service that you want to monitor, perform the following steps:

Go to the Discovery Control Panel page (System > Manage > Classic Discovery).
In the Discovery Control Panel, click the Create button.

The Discovery Session Editor page appears. In the Discovery Session Editor page, define values in the following fields:

Name. Type a name for the discovery session.
IP Address/Hostname Discovery List. Type "api.newrelic.com".

Other Credentials. Select the SOAP/XML credentials you created for the New Relic service.
Discover Non-SNMP. Select this checkbox.
Model Devices. Select this checkbox.

Optionally, you can enter values in the other fields on this page. For more information about the other fields on this page, see the Discovery & Credentials section.
Click the Save button to save the discovery session and then close the Discovery Session Editor window.
The discovery session you created appears at the top of the Discovery Control Panel page. Click its lightning bolt icon () to run the discovery session.
The Discovery Session window appears. When the device is discovered, click the device icon () to view the Device Properties page for each device.

Discovering Additional New Relic Accounts

If you have already discovered a New Relic account and want to discover additional New Relic accounts, you must create a credential for each account you want to discover, edit the New Relic device template for each new account, and then create a virtual device to which you will align the template.

Create Credentials

Using the steps outlined in the Creating a SOAP/XML Credential for New Relic section, create a credential for each additional New Relic account you want to discover.

Edit the Device Template

A device template allows you to save a device configuration and apply it to multiple devices. The New Relic: APMPowerPack includes the "New Relic Virtual Device Template Example". You must configure a device template for each additional New Relic account you want to discover.

If you configure this device template correctly, once you align the template to the New Relic virtual device, SL1 will use the device template to automatically align the New Relic discovery Dynamic Applications and start collecting data.

To configure the New Relic device template:

Go to the Configuration Templates page (Devices > Templates, or Registry > Devices > Templates in the SL1 classic user interface).

Locate the "New Relic Virtual Device Template Example" and click its wrench icon (). The Device Template Editor page appears.
Click the Dyn Apps tab. The Editing Dynamic Application Subtemplates page appears.

Complete the following fields:

Template Name. Type a new name for the device template.
Credentials. Select the SOAP/XML credential that you created for the New Relic account.

Click the next Dynamic Application listed in the Subtemplate Selection section on the left side of the page and then select the New Relic SOAP/XML credential in the Credentials field.
Repeat step 5 until the you have selected the New Relic SOAP/XML credential in the Credentials field for all of the Dynamic Applications listed in the Subtemplate Selection section.
Click Save As.

You must rename the sample New Relic Virtual Device Template Example and click Save As to save it. If you do not rename the device template, then your device template will be overwritten the next time you upgrade the New Relic: APMPowerPack.

Create a Virtual Device

To discover an additional New Relic account, you must create a virtual device that represents the New Relic account. A virtual device is a user-defined container that represents a device or service that cannot be discovered by SL1. You can use the virtual device to store information gathered by policies or Dynamic Applications.

To create a virtual device that represents your New Relic account:

Go to the Device Manager page (Devices > Device Manager, or Registry > Devices > Device Manager in the SL1 classic user interface).

Click the Actions button and select Create Virtual Device from the menu. The Virtual Device modal page appears:

Complete the following fields:

Device Name. Type a name for the virtual device.

Organization. Select the organization for this device. The organization you associate with the device limits the users that will be able to view and edit the device. Typically, only members of the organization will be able to view and edit the device.
Device Class. Select New Relic, Inc. | Service Device.
Collector. Select the collector group that will monitor the device.

Click Add to create the virtual device.
In the Device Manager page (Devices > Device Manager, or Registry > Devices > Device Manager in the SL1 classic user interface), select the checkbox () for the virtual device that you just created.
Click the Select Actions drop-down and select MODIFY By Template from the menu and click Go.
In the Device Template Editor, use the Template drop-down to select the device template that you created for the New Relic account and click the Apply button.
Click the Confirm button to save your changes.

Verifying Discovery and Dynamic Application Alignment

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

After discovery has completed, go to the Devicespage and click the device for the New Relic service. From the Device Investigator page for the New Relic service, click the Collections tab. The Dynamic Application Collections page appears.
All applicable Dynamic Applications for the service are automatically aligned during discovery.

It can take several minutes after the discovery session has completed for Dynamic Applications to appear in the Dynamic Application Collections page.

You should see the following Dynamic Applications aligned to the New Relic service:

New Relic: APM Discovery & Collection Cache
New Relic: APM Events
New Relic: APM Infrastructure Group Discovery

If the listed Dynamic Applications have not been automatically aligned during discovery, or you want to align more Dynamic Applications, you can align them manually. To do so, perform the following steps:

Click the Edit button, and then select Align Dynamic App. The Align Dynamic Application window appears.
Click Choose Dynamic Application. The Choose Dynamic Application window appears.
Select the Dynamic Application you want to align and click Select. The name of the selected Dynamic Application appears in the Align Dynamic Application window.
If a default credential is listed below the Dynamic Application and you want to use that credential, skip ahead to step 7. Otherwise, uncheck the box next to the credential name.
Click Choose Credential. The Choose Credential window appears.
Select the credential for the Dynamic Application and click the Select button. The name of the selected credential appears in the Align Dynamic Application window.
Click the Align Dynamic App button. When the Dynamic Application is successfully aligned, it is added to the Collections tab, and a confirmation message appears at the bottom of the tab.
Repeat steps 1-7 for any other unaligned Dynamic Applications.

Verifying Discovery and Dynamic Application Alignment in the SL1 Classic User Interface

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

After discovery has completed, click the device icon for the New Relic service (). From the Device Properties page for the New Relic service, click the Collections tab. The Dynamic Application Collections page appears.
All applicable Dynamic Applications for the service are automatically aligned during discovery.

It can take several minutes after the discovery session has completed for Dynamic Applications to appear in the Dynamic Application Collections page.

You should see the following Dynamic Applications aligned to the New Relic service:

New Relic: APM Discovery & Collection Cache
New Relic: APM Events
New Relic: APM Infrastructure Group Discovery

Click the Action button, and then select Add Dynamic Application. The Dynamic Application Alignment page appears:

In the Dynamic Applications field, select the Dynamic Application you want to align.
In the Credentials field, select the credential specified in the table. To view details about the credentials, see the section on Nexus credentials.
Click the Save button.
Repeat steps 1-4 for any other unaligned Dynamic Applications.

Relationships with Other Types of Component Devices

Additionally, the Dynamic Applications in the New Relic: APM PowerPack can automatically build relationships between New Relic devices and other associated devices:

If you discover Linux devices using the Dynamic Applications in the Linux Base Pack PowerPack version 102 or later, SL1 will automatically create relationships between New Relic devices and Linux servers.
If you discover Windows servers using the Dynamic Applications in the Microsoft Base Pack PowerPack version 107 or later, SL1 will automatically create relationships between New Relic devices and Windows servers.
If you discover Windows servers using the Dynamic Applications in the Microsoft: Windows Server PowerPack version 108 or later, SL1 will automatically create relationships between New Relic devices and Windows servers.

Viewing New Relic Component Devices

In addition to the Devices page, you can view the New Relic service and all associated component devices in the following places in the user interface:

The Device Investigator Map page (click Map in the Device Investigator page) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-clicking any of the listed devices reloads the page to make the selected device the primary device

The Device Components page (Devices > Device Components) displays a list of all root devices and component devices discovered by SL1 in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with a New Relic service, find the New Relic device and click its plus icon (+).

The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. SL1 also updates each map with the latest status and event information. To view the map for a New Relic service, go to Classic Maps > Device Maps > Components, and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Views.

Viewing New Relic Component Devices in the SL1 Classic User Interface

In addition to the Device Manager page (Registry > Devices > Device Manager), you can view the New Relic service and all associated component devices in the following places in the user interface:

The Device View modal page (click the bar-graph icon [] for a device, then click the Topology tab) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-click to select any listed device. This reloads the page to make the selected device the primary device.

NOTE: When you discover multiple New Relic accounts and sub-accounts, the top level device is shown as "api", which you can change as desired. The figure below shows that we have two different accounts discovered, as well as New Relic servers.

The Device Components page (Registry > Devices > Device Components) displays a list of all root devices and component devices discovered by SL1 in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with a New Relic service, find the service and click its plus icon (+):

The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map for a New Relic service, go to the Component Map page and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Views.