New Relic CLI Skills
Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries and organization-scoped macros, AI Monitoring telemetry and datasets, APM performance triage, deployment markers, read-only alert and incident inspection, infrastructure monitoring, agent diagnostics, and identity/access administration. Use when user asks about LLM token usage, AI application telemetry or datasets, application performance, error rates, slow transactions, deployment tracking, incident inspection, New Relic setup, users, groups, roles, permissions, or access grants.
New Relic CLI Skills
Quick Decision Tree
Performance issue reported? → apm/SKILL.md
Need to query data or manage organization-scoped NRQL macros? → nrql/SKILL.md
AI/LLM telemetry, datasets, or dataset versions? → aimonitoring/SKILL.md
Recording a deployment? → deployments/SKILL.md
Inspecting alerts or incidents? → alerts/SKILL.md
Infrastructure/host issues? → infrastructure/SKILL.md
Agent not reporting? → diagnostics/SKILL.md
Users, groups, roles, permissions, or access grants? → iam/SKILL.md
Setup & Auth
# Install (manual or package manager)
# macOS (Homebrew)
brew install newrelic-cli
# Windows (Scoop)
scoop bucket add newrelic-cli https://github.com/newrelic/newrelic-cli.git
scoop install newrelic-cli
# Or manually download a release archive from:
# https://github.com/newrelic/newrelic-cli/releases
# Extract it, place the `newrelic` binary on your PATH, then verify with:
newrelic --version
# Configure profile
newrelic profile add \
--profile "default" \
--apiKey $NEW_RELIC_API_KEY \
--accountId $NEW_RELIC_ACCOUNT_ID \
--region US # US, EU, JP, GOV, or FEDRAMP (alias for GOV)
newrelic profile default --profile "default"
# Verify
newrelic profile list --format JSON
For structured profile discovery, pass --format JSON explicitly. The isDefault
field identifies the persisted default profile, and profile names are emitted without
terminal decoration. It does not necessarily identify the effective credentials: the
global --profile flag can select another profile, while NEW_RELIC_API_KEY,
NEW_RELIC_ACCOUNT_ID, NEW_RELIC_REGION, and NEW_RELIC_LICENSE_KEY override the
corresponding stored profile fields.
Common One-Liners
# Search for an entity by name
newrelic entity search --name "my-app"
# Run a NRQL query
newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \
--query "SELECT average(duration) FROM Transaction WHERE appName='my-app' SINCE 1 hour ago"
# Record a deployment
newrelic apm deployment create \
--applicationId <APP_ID> \
--revision "v1.2.3" \
--description "Feature: user auth"
# Discover diagnostic CLI flags without launching nrdiag.
# Before any diagnose run (even --list-suites), follow diagnostics/SKILL.md:
# explicit download/execution approval; separate authorization for data upload.
newrelic diagnose run --help
# Find applications reporting AI Monitoring telemetry
newrelic aimonitoring application search
Entity Reference
Find entity GUIDs (needed for API calls and deployment markers):
# List all APM apps
newrelic entity search --name "" --type APPLICATION --domain APM
# Get APM application details
newrelic apm application get --guid <GUID>
# List all hosts
newrelic entity search --name "" --type HOST
Environment Variables
| Variable | Description |
|---|---|
NEW_RELIC_API_KEY | User key (NRAK-...) |
NEW_RELIC_ACCOUNT_ID | Numeric account ID |
NEW_RELIC_REGION | US, EU, JP, GOV, or FEDRAMP (FEDRAMP is an alias for GOV) |
Sub-Skills
| Sub-skill | When to use |
|---|---|
apm/ | Performance triage, slow transactions, error analysis |
nrql/ | Custom queries, dashboards, ad-hoc exploration, and approval-gated organization macros |
aimonitoring/ | AI/LLM telemetry, dataset discovery/version inventory, and approval-gated deletion |
deployments/ | Mark releases, correlate deploys with performance |
alerts/ | Read-only incident telemetry and entity alert severity |
infrastructure/ | Host metrics, CPU/memory, process monitoring |
diagnostics/ | CLI profile/connectivity validation, agent reporting, and approval-gated nrdiag suites |
iam/ | Users, groups, memberships, roles, permissions, and access grants |
Scripts
| Script | Purpose |
|---|---|
scripts/check-performance.sh | Quick health check across all apps |
scripts/deployment-marker.sh | Record a deployment event |
scripts/top-slow-transactions.sh | Find the 10 slowest transactions |
scripts/error-report.sh | Recent errors with stack traces |
References
references/nrql-patterns.md— Common NRQL query patternsreferences/performance-triage.md— Step-by-step triage guide
Related skills
- Downloads
- 2.4kAll time
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.12
- License
- MIT-0
