Skip to main content

​
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 via Integration Resources

​
Integration Resources

After connecting New Relic, configure Integration Resources:
  • 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