| name | newrelic-cli-skills |
| version | 1.0.5 |
| description | Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, APM performance triage, deployment markers, alert policy and condition management, notification channel setup, infrastructure monitoring, and agent diagnostics. Use when user asks about application performance, error rates, slow transactions, deployment tracking, alert configuration, or New Relic setup.
|
| metadata | {"openclaw":{"purpose":"New Relic observability skill for both read and targeted write workflows. Reads APM metrics, NRQL query results, alert policies/conditions, incidents, and infrastructure host data from the New Relic API. Write operations in this repo include deployment marker creation plus alert policy, condition, and notification channel creation; the alerts sub-skill also documents alert condition deletion. Helper scripts execute newrelic CLI commands only and should validate untrusted inputs before embedding them in NRQL.\n","requires":{"env":["NEW_RELIC_API_KEY","NEW_RELIC_ACCOUNT_ID"],"binaries":["newrelic"],"notes":"NEW_RELIC_API_KEY must be a User Key (starts with NRAK-).\nNEW_RELIC_ACCOUNT_ID is the numeric account ID from the NR UI.\nSee README.md for CLI installation instructions.\nUse an API key scoped to the minimum required accounts.\n"}}} |
| tags | ["newrelic","observability","apm","monitoring","performance","nrql"] |
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
brew install newrelic-cli
scoop bucket add newrelic-cli https://github.com/newrelic/newrelic-cli.git
scoop install newrelic-cli
newrelic --version
newrelic profile add \
--profile default \
--apiKey $NEW_RELIC_API_KEY \
--accountId $NEW_RELIC_ACCOUNT_ID \
--region US
newrelic profile default --profile default
newrelic profile list
Common One-Liners
newrelic entity search --name "my-app"
newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \
--query "SELECT average(duration) FROM Transaction WHERE appName='my-app' SINCE 1 hour ago"
newrelic apm deployment create \
--applicationId <APP_ID> \
--revision "v1.2.3" \
--description "Feature: user auth"
newrelic diagnose run
Entity Reference
Find entity GUIDs (needed for API calls and deployment markers):
newrelic entity search --name "" --type APPLICATION --domain APM
newrelic entity get --guid <GUID>
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 |
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
References
