Skip to main content
skillsmp

Menu

newrelic-cli-skills

Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, AI Monitoring telemetry, 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 or AI application telemetry, application performance, error rates, slow transactions, deployment tracking, incident inspection, New Relic setup, users, groups, roles, permissions, or access grants.

Jump to installReview files

Source facts

Repository
vince-winkintel/newrelic-cli-skills
Last source activity
October 8, 2026 at 13:25
Detected SKILL.md language
English
Stars
0
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
newrelic-cli-skills
version
1.0.9
description
Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, AI Monitoring telemetry, 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 or AI application telemetry, application performance, error rates, slow transactions, deployment tracking, incident inspection, New Relic setup, users, groups, roles, permissions, or access grants.
metadata
{"openclaw":{"purpose":"New Relic observability skill for both read and targeted write workflows. Reads APM metrics, NRQL query results, AI Monitoring events (including potentially sensitive prompt/response content and tool inputs), incidents, entity alert severity, and infrastructure host data from the New Relic API. The documented New Relic CLI has no alerts command tree, so alert and incident workflows in this repo are read-only. Write operations include deployment marker creation. IAM workflows add user/group CRUD, membership changes, and access-grant creation/revocation; require explicit confirmation before IAM writes and verify each write by reading the target back. Helper scripts execute newrelic CLI commands only and should validate untrusted inputs before embedding them in NRQL.\n","requires":{"env":"[Truncated]","binaries":"[Truncated]","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.\nIAM writes also require organization-level authorization for the user associated\nwith the key: Authentication domain manager or Organization manager for\nusermanagement, and Organization manager for accessmanagement grant writes.\nAdministrative user-management access requires a core or full platform user.\n"}}}
tags
["newrelic","observability","apm","monitoring","performance","nrql","ai-monitoring","iam"]
# New Relic CLI Skills ## Quick Decision Tree **Performance issue reported?** → [`apm/SKILL.md`](apm/SKILL.md) **Need to query data with NRQL?** → [`nrql/SKILL.md`](nrql/SKILL.md) **AI/LLM application, token, error, prompt, or response telemetry?** → [`aimonitoring/SKILL.md`](aimonitoring/SKILL.md) **Recording a deployment?** → [`deployments/SKILL.md`](deployments/SKILL.md) **Inspecting alerts or incidents?** → [`alerts/SKILL.md`](alerts/SKILL.md) **Infrastructure/host issues?** → [`infrastructure/SKILL.md`](infrastructure/SKILL.md) **Agent not reporting?** → [`diagnostics/SKILL.md`](diagnostics/SKILL.md) **Users, groups, roles, permissions, or access grants?** → [`iam/SKILL.md`](iam/SKILL.md) --- ## Setup & Auth ```bash # 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 ```bash # 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): ```bash # 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/`](apm/SKILL.md) | Performance triage, slow transactions, error analysis | | [`nrql/`](nrql/SKILL.md) | Custom queries, dashboards, ad-hoc data exploration | | [`aimonitoring/`](aimonitoring/SKILL.md) | AI/LLM applications, token usage, errors, prompts, responses, and telemetry | | [`deployments/`](deployments/SKILL.md) | Mark releases, correlate deploys with performance | | [`alerts/`](alerts/SKILL.md) | Read-only incident telemetry and entity alert severity | | [`infrastructure/`](infrastructure/SKILL.md) | Host metrics, CPU/memory, process monitoring | | [`diagnostics/`](diagnostics/SKILL.md) | Agent health, config validation, connectivity | | [`iam/`](iam/SKILL.md) | Users, groups, memberships, roles, permissions, and access grants | ## Scripts | Script | Purpose | |---|---| | [`scripts/check-performance.sh`](scripts/check-performance.sh) | Quick health check across all apps | | [`scripts/deployment-marker.sh`](scripts/deployment-marker.sh) | Record a deployment event | | [`scripts/top-slow-transactions.sh`](scripts/top-slow-transactions.sh) | Find the 10 slowest transactions | | [`scripts/error-report.sh`](scripts/error-report.sh) | Recent errors with stack traces | ## References - [`references/nrql-patterns.md`](references/nrql-patterns.md) — Common NRQL query patterns - [`references/performance-triage.md`](references/performance-triage.md) — Step-by-step triage guide
View on GitHub
Back to searchBack to installation