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 エージェントがレポートしていませんか？ → 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/	エージェントの健全性、設定の検証、接続性
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 — 手順に沿ったトリアージガイド