360 Secure SkillHub
360 安全技能中心

New Relic CLI Skills

用于通过 newrelic CLI 查询和管理 New Relic 可观测性数据，覆盖 NRQL、APM 性能分诊、AI 监控、部署标记、只读告警与事件、基础设施、代理诊断及 IAM 读写；需要 newrelic 二进制和 API Key/账户 ID。

vince-winkintel
vince-winkintel
热度 46.35
最近更新 2026-10-08 21:31:21
分类：数据依赖：代码执行 / 第三方 API应用场景：DevOps / 数据处理 / 报告撰写 / 自动化脚本 ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add newrelic-cli-skills
Metadata
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":["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.\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 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