> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# New Relic

> Full-stack observability platform

## Overview

Connect New Relic to give TierZero access to your application performance data, logs, metrics, and traces. TierZero queries New Relic during investigations using NRQL to analyze service health and correlate events.

## Prerequisites

* Access to your New Relic account
* Permission to create User API keys

## Setup Instructions

### Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to New Relic

### Step 2: Create a User API Key

1. In New Relic, go to **API Keys** (under your profile)
2. Click **Create a key**
3. Select **User** as the key type
4. Name it (e.g., "TierZero Integration")
5. Click **Create**
6. Copy the generated key

### Step 3: Enter Credentials

1. Paste the User API key into TierZero
2. Select your New Relic account ID
3. Click **Connect**

## What TierZero Accesses

* **Applications**: APM application health and performance
* **Metrics**: Custom and system metrics via NRQL queries
* **Logs**: Log entries and attributes
* **Traces and spans**: Distributed tracing data and span attributes
* **Transactions**: Transaction-level performance data
* **Dashboards**: Imported resource context

## Integration Resources

After connecting New Relic, TierZero uses these resource catalogs:

* **applications.json**: List of New Relic applications
* **dashboards.json**: Imported dashboards
* **logs\_attrs.json**: Log attributes
* **metrics.json**: Available metrics
* **spans\_attrs.json**: Span attributes
* **transactions\_attrs.json**: Transaction attributes

## Security

* TierZero uses a User API key for NRQL queries
* Read-only access to your observability data
* Keys are encrypted at rest
* Revoke by deleting the API key in New Relic

## Troubleshooting

### NRQL Query Errors

* Verify the User API key is valid and has not expired
* Check that the account ID is correct
* Ensure the queried data exists in your New Relic account
