newrelic-cli-skills

New Relic CLI Skills

Quick Decision Tree

Performance issue reported? → apm/SKILL.md Need to query data with NRQL? → nrql/SKILL.md AI/LLM application, token, error, prompt, or response telemetry? → 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"

# Run diagnostics
newrelic diagnose run

# 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 data exploration
aimonitoring/	AI/LLM applications, token usage, errors, prompts, responses, and telemetry
deployments/	Mark releases, correlate deploys with performance
alerts/	Read-only incident telemetry and entity alert severity
infrastructure/	Host metrics, CPU/memory, process monitoring
diagnostics/	Agent health, config validation, connectivity
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 patterns
• references/performance-triage.md — Step-by-step triage guide