New Relic CLI Skills

Quick Decision Tree

Performance issue reported? → apm/SKILL.md

Need to query data with NRQL? → nrql/SKILL.md

Recording a deployment? → deployments/SKILL.md

Alert management? → alerts/SKILL.md

Infrastructure/host issues? → infrastructure/SKILL.md

Agent not reporting? → diagnostics/SKILL.md

Setup & Auth

# Install (manual or package manager)
# macOS (Homebrew)
brew 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   # or EU

newrelic profile default --profile default

# Verify
newrelic profile list

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

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 specific entity details
newrelic entity get --guid <GUID>

# List all hosts
newrelic entity search --name "" --type HOST

Environment Variables

Sub-Skills

Scripts

References

• references/nrql-patterns.md — Common NRQL query patterns
• references/performance-triage.md — Step-by-step triage guide