SkillHub

newrelic-cli-skills

v1.0.2

Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, APM performance triage, deployment markers, alert management, infrastructure monitoring, and agent diagnostics. Use when user asks about application performance, error rates, slow transactions, deploym...

Sourced from ClawHub, Authored by Vince Lozada

Installation

Please help me install the skill `newrelic-cli-skills` from SkillHub official store. npx skills add vince-winkintel/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 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
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash

# 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

Variable Description
NEW_RELIC_API_KEY User key (NRAK-...)
NEW_RELIC_ACCOUNT_ID Numeric account ID
NEW_RELIC_REGION US or EU

Sub-Skills

Sub-skill When to use
apm/ Performance triage, slow transactions, error analysis
nrql/ Custom queries, dashboards, ad-hoc data exploration
deployments/ Mark releases, correlate deploys with performance
alerts/ Alert policies, conditions, notification channels
infrastructure/ Host metrics, CPU/memory, process monitoring
diagnostics/ Agent health, config validation, connectivity

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