---
title: "New Relic integration"
description: "This document describes how to track and visualize analytical data across all of your jobs on CircleCI with New Relic."
platform: "Cloud, Server"
doc_version: "Server"
last_updated: "2026-10-07"
---

> For current CircleCI product defaults, deprecated patterns, and Cloud/Server differences, see [AGENTS.md](https://circleci.com/docs/AGENTS.md).
>
> For the complete documentation index and site structure, see [llms.txt](https://circleci.com/docs/llms.txt).

# New Relic integration

This page describes how to connect Insights data with [New Relic](https://newrelic.com/).

## Overview

The [New Relic CircleCI integration](https://newrelic.com/instant-observability/circleci) allows you to view analytical data about your CircleCI jobs within the New Relic monitoring stack.

## Integration

Complete the following steps to set up a CircleCI webhook to forward your logs to New Relic. For more information, refer to the New Relic CircleCI [installation docs](https://docs.newrelic.com/docs/logs/forward-logs/circleci-logs/).

1.  Log in to the CircleCI web app.
    
2.  Access one of your CircleCI projects.
    
3.  Open **Project settings**.
    
4.  In the project settings sidebar, select **Webhooks**.
    
5.  Select **Add webhook**.
    
6.  Complete the following fields:
    
    *   **Webhook name**: give your webhook an identifiable name, for example, `New Relic CI Visibility`.
        
    *   **Receiver URL**: Use New Relic’s **Logs endpoint**. Use the region you set for your New Relic account.
        
        Replace `YOUR_LICENSE_KEY` with your New Relic license key, which you can [retrieve from the UI or API](https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/#manage-license-key).
        
        **US**: `https://log-api.newrelic.com/log/v1?Api-Key=YOUR_LICENSE_KEY`
        
        **EU**: `https://log-api.eu.newrelic.com/log/v1?Api-Key=YOUR_LICENSE_KEY`
        
    *   **Events**: Select **Workflow Completed** or **Job Completed**, depending on the type of event you want to trigger the log push.
        
    *   Enable the check: **Certificate verifications**.
        
    
7.  Select **Add Webhook** to save the new webhook.
    
8.  If you have set up your receiving API or third-party service, click **Test ping event** to create a test event.