New Relic

Integration-logo

ReleaseIQ provides you seamless integration with that of a powerful full-stack data analysis platform for all your software’s metrics and events – New Relic.

ReleaseIQ provides out of the box integration with NewRelic to provide the following features:

  • Send Pipeline execution events to NewRelic as custom events.
  • Verify deployment of application.

To enable the use of the above features in ReleaseIQ pipelines, a NewRelic instance must be configured in ReleaseIQ for secured access from the ReleaseIQ agent.

Steps to configure NewRelic with ReleaseIQ:

  1. Login to ReleaseIQ portal with your username and password.
  2. Click on the “Admin” tab
  3. In the Settings screen, select “Observability”
  4. In Observability settings, provide details shown below for secured access to NewRelic.
  • Select Tool Type as “NewRelic”
  • Enter Account Id  
  • Enter User key and License key

On Saving the settings, the connection to NewRelic from the ReleaseIQ agent is verified. On successful verification of settings, it is available for use in ReleaseIQ pipelines.

NewRelic Custom Events:

In the ReleaseIQ Pipeline Composer screen, create New Pipeline or select the pipeline where you want to send custom events to the NewRelic tool.

  • Click the “Notification” check box, in which step information has to be sent as an event to NewRelic. Below are the steps you can configure to send events.
  • Builder
  • Deployer
  • Auto/Manual Test
  • Custom
  • External Pipelines
  • “Notify on” checkbox is to configure on which status event has to be sent.
  • Select mode as “Send event to observability tool”
  • Select NewRelic tool name configured in the observability settings page.
  • Save the pipeline.

Explore how it works:
Configure your NewRelic settings in the ReleaseIQ platform.

New Relic Observability

Figure 1

Once you configure the settings, NewRelic tool name will be available under Send events to observability tool checkbox verification. You can configure notification events as shown in Figure 2.

New Relic Pipeline Composer Notifications

Figure 2

Once a commit passes the event notification configured stage, information about the pipeline stage will be sent as an event to NewRelic. You can view events and create dashboards by running queries in NewRelic queryBuilder UI for RIQ Events eventType.

NewRelic Deployment Verification:

In the ReleaseIQ Pipeline Composer screen, create New Pipeline or select the pipeline where you want to verify the deployments using the NewRelic tool.

  • Select Deployer step of the Pipeline, in the deployer options configuration panel click on the “Deployment Verification” check box to open the Deployment Verification popup window.
  • In the Deployment Verification popup window, select NewRelic in External Insights.

Then configure the following:

  • Select the duration for listening to Events. Varies from 1 min to a max of 24 Hours.
  • In Tool Name, select name of NewRelic settings previously configured
  • Select one or more policies available in NewRelic instance
  • Select one or more Conditions available in NewRelic instance
  • Optionally, select the checkbox to allow the pipeline to proceed on deployment failures.
  • Save the pipeline.

Explore how it works:

Configure your NewRelic settings in the ReleaseIQ platform, if not previously done.

Once you configure the settings click on the Deployment Verification check box, deployment verification popup will be opened.

New Relic Pipeline Verification

Figure 3

Configure external insights configuration for NewRelic deployment verification as shown below.

New Relic Insight Configuration

Figure 4

Save the settings and update the pipeline.

During the Pipeline run, the NewRelic verification is automatically triggered immediately after deployment. NewRelic performs the verification as per the configuration in ReleaseIQ pipeline.

If Deployment Verification is successful, then a green color icon will appear at the bottom of Deploy Step.

New Relic Commits

Figure 5

When Deployment Verification is failed, then a red color icon will appear at the bottom of Deploy Step indicating that there are some critical violations that occurred in the configured policies within a given duration.

Deployment Verification

Figure 6

When we click on the failed Deployment verification icon, we can view Deployment Verification Results.

Deployment Verification

Figure 7

On completion of NewRelic deployment verification, the pipeline proceeds or fails based on the deployment verification configuration and results.

New Relic Dashboard Included

As our integration posts information back to New Relic on the Deployments, we have created this Dashboard in the Quickstart.

New Relic Dashboard

You can explore more about New Relic integration with ReleaseIQ by Clicking here