| name | newrelic |
| id | newrelic |
| description | New Relic observability integration for running NRQL queries, checking alert issues, and searching entities via NerdGraph during RCA investigations |
| category | observability |
| connection_check | {"method":"get_token_data","provider_key":"newrelic","required_field":"api_key"} |
| tools | ["query_newrelic"] |
| index | Observability platform -- NRQL queries, alert issues, entity search via NerdGraph |
| rca_priority | 3 |
| allowed-tools | query_newrelic |
| metadata | {"author":"aurora","version":"1.0"} |
New Relic Integration
Overview
New Relic integration for querying observability data during Root Cause Analysis. New Relic is a REMOTE service. Use ONLY the query_newrelic API tool. All data is accessed via NerdGraph with resource_type parameter.
Instructions
Tool Usage
query_newrelic(resource_type=TYPE, query=QUERY, time_range=RANGE, limit=N)
Resource Types
'nrql' -- Run NRQL queries. query=NRQL string e.g. "SELECT count(*) FROM Transaction WHERE error IS true FACET appName"'issues' -- Active alert issues. query=state filter (ACTIVATED, CREATED, CLOSED)'entities' -- Search monitored entities (APM apps, hosts). query=entity name or filter
NRQL Tips
- Event types:
Transaction, TransactionError, SystemSample, Log, Span, ProcessSample
- Use
FACET for grouping results by field
- Use
TIMESERIES for trends over time
- Use
SINCE for time range (auto-injected from time_range if not present)
- Use
LIMIT to cap results (auto-injected if not present)
- Only SELECT/FROM/WHERE/FACET queries are supported (no mutating operations)
Common NRQL Queries
- Error count:
SELECT count(*) FROM TransactionError WHERE appName='X' SINCE 1 hour ago TIMESERIES
- CPU usage:
SELECT average(cpuPercent) FROM SystemSample FACET hostname SINCE 30 minutes ago
- Error logs:
SELECT count(*) FROM Log WHERE level = 'ERROR' FACET service SINCE 1 hour ago
- Slow transactions:
SELECT average(duration) FROM Transaction WHERE appName='X' FACET name SINCE 1 hour ago
- Throughput:
SELECT rate(count(*), 1 minute) FROM Transaction FACET appName SINCE 1 hour ago TIMESERIES
Entity Search
- Search by name:
query_newrelic(resource_type='entities', query='production-api')
- Filter by type:
query_newrelic(resource_type='entities', query='production-api|APPLICATION')
