Creating New Relic connections

Creating New Relic connections

To create a New Relic connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Data and tool connections page, click Add connection.

4. From the list of available connections, find and click the New Relic tile.

   Note: If you do not immediately see the connection that you want to create, you can filter the tiles by type of connection. Click the type of connection that you want in the Category section.

5. On the side-panel, review the instructions and when ready to continue, click Connect.

6. On the Add connection page, define the general connection details:

   • Name: Enter the display name of your connection.

   • Description (optional): Type in a description for the connection.

   • Endpoint: Enter an endpoint for the connection.

   • Access token: Enter an access token for the connection. You can create or obtain the access token from the API Keys section in your New Relic account.

   • Deployment options: Select one of the options, Local or Remote. Local deploys the connection in the same cluster where Cloud Pak for Watson AIOps is installed. Alternatively, Remote deploys it in your chosen location.

     Note: If you select Remote, after adding the connection, you are provided with a bootstrap command to finish the deployment.

7. Click Test Connection. If successful, a Test succeeded message is displayed.

8. Click Next.

9. Enter the following Collect metric data to defines how you want to collect metric data:

   • Enable data collection: Set Enable data collection to on. However, if you disable data collection, a new connection is created, but metrics are not collected.

   • Select application: Select one or more applications from the list to see their associated metrics in the filter table. The filter table displays all the associated metrics of the selected applications.

   • Search and select the required metrics from the filter table: Search through all the metrics and select the metrics from the table. By default, all metrics are selected. To remove a selected metric, search to locate it and clear its corresponding checkbox. You can also click Cancel to remove all selected metrics or Select all to reselect them.

   • Aggregation interval (minutes): Enter a value in minutes. The value represents the time interval for live or historical data collection. The default value is 5 minutes.

     Note: If aggregation interval is less than 60 minutes, IBM Cloud Pak® for Watson AIOps collects only a maximum of past 8 days of historical data. This is because the connector aggregates data in hourly periods, instead of the time you enter, when the data request time range is older than 8 days. For more information about aggregation interval, see the New Relic documentation.

   • Select historical or live data collection. Note: If you choose to collect only live data, you cannot collect historical data after the live data collection starts.

     • Live data collection: To collect live data, complete the following steps:

       • Only live data once the connection is established: Select the checkbox.

       • Scheduler run time (minutes): Enter a value in minutes. The value represents the frequency at which data is collected for live metrics. The default value is 5 minutes.

     • Historical data collection: To collect historical data, complete the following steps:

       • Start date and time: Select the start date from the calendar and enter the time in the hh:mm format (hours and minutes).

         Note: The start date must not exceed 31 days from the present as the maximum time period for historical data collection is 31 days. The recommended time period is two weeks.

       • Time zone: Select your time zone from the dropdown list.

       • End date and time: Click Add end date and select a date from the calendar. Also, enter the time in the hh:mm format (hours and minutes). If you want to remove an end date, click Remove end date.

         Note: If you do not set an end date, IBM Cloud Pak for Watson AIOps collects historical data from the specified start date and continues with live data collection. You cannot collect historical data after the live data collection starts.

       • Scheduler run time (minutes): Enter a value in minutes. The value represents the frequency at which data is collected for live metrics. The default value is 5 minutes.

         Note: Scheduler run time is only applicable to live mode. You must configure the scheduler run time only if you do not add an end date as the connector will continue to run in live mode after historical mode.

10. Click Done.

For more information about performance considerations for metric data collection, see Performance considerations for metric data collection.

Enabling and disabling New Relic connections

If you didn't enable your data collection during creation, you can enable your connection afterward. You can also disable a previously enabled connection the same way. To enable or disable a created connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Manage connections tab of the Data and tool connections page, click the New Relic connection type.

4. Click the connection that you want to enable or disable.

5. Go to the Collect metric data section. Set Enable data collection to On or Off to enable or disable data collection. Disabling data collection for a connection does not delete the connection.

You enabled or disabled your connection. For more information about deleting a connection, see Deleting New Relic connections.

Editing New Relic connections

After you create your connection, you can edit it. To edit a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the New Relic connection type on the Manage connections tab of the Data and tool connections page.

4. On the New Relic connections page, click the name of the connection that you want to edit. Alternatively, you can click the options menu (three vertical dots) for the connection and click Edit. The connection configuration opens.

5. Edit your connection as required. Click Save when you are done editing.

You edited your connection.

Deleting New Relic connections

If you no longer need your New Relic connection and want to delete it entirely, you can delete the connection from the console.

To delete a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the New Relic connection type on the Manage connections tab of the Data and tool connections page.

4. On the New Relic connections page, click the options menu (three vertical dots) for the connection that you want to delete and click Delete.

5. Enter the name of the connection to confirm that you want to delete your connection. Then, click Delete.

Your connection is deleted.