newrelic-cli-skills

New Relic CLI 技能

快速决策树

收到性能问题报告？ → apm/SKILL.md 需要使用 NRQL 查询数据？ → nrql/SKILL.md AI/LLM 应用、令牌、错误、提示词或响应遥测？ → aimonitoring/SKILL.md 要记录部署？ → deployments/SKILL.md 要检查警报或事件？ → alerts/SKILL.md 基础设施/主机问题？ → infrastructure/SKILL.md Agent 未上报？ → diagnostics/SKILL.md 用户、群组、角色、权限或访问授权？ → iam/SKILL.md

---

设置与身份验证

# 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

要以结构化格式发现配置文件，请显式传入 --format JSON。isDefault 字段用于标识已持久化的默认配置文件，且配置文件名称的输出不带终端装饰。 它不一定表示当前生效的凭据：全局 --profile 标志可以选择其他配置文件，而 NEW_RELIC_API_KEY、NEW_RELIC_ACCOUNT_ID、NEW_RELIC_REGION 和 NEW_RELIC_LICENSE_KEY 会覆盖相应的已存储配置文件字段。

---

常用单行命令

# 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

---

实体参考

查找实体 GUID（API 调用和部署标记需要）：

# 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

---

环境变量

变量	说明
NEW_RELIC_API_KEY	用户密钥（NRAK-...）
NEW_RELIC_ACCOUNT_ID	数字型账户 ID
NEW_RELIC_REGION	US、EU、JP、GOV 或 FEDRAMP（FEDRAMP 是 GOV 的别名）

---

子技能

子技能	使用场景
apm/	性能排查、慢事务、错误分析
nrql/	自定义查询、仪表板、临时数据探索
aimonitoring/	AI/LLM 应用、令牌用量、错误、提示词、响应和遥测
deployments/	标记版本发布，将部署与性能相关联
alerts/	只读事件遥测和实体警报严重程度
infrastructure/	主机指标、CPU/内存、进程监控
diagnostics/	Agent 健康状况、配置验证、连接状态
iam/	用户、群组、成员关系、角色、权限和访问授权

脚本

脚本	用途
scripts/check-performance.sh	快速检查所有应用的运行状况
scripts/deployment-marker.sh	记录部署事件
scripts/top-slow-transactions.sh	查找最慢的 10 个事务
scripts/error-report.sh	显示近期错误及堆栈跟踪

参考资料

• references/nrql-patterns.md — 常见 NRQL 查询模式
• references/performance-triage.md — 逐步排查指南