onboarding-summary

APM オンボーディングの概要

トリガー

次の場合にこのスキルを呼び出します。

• verify-ssi のすべての手順が完了している
• troubleshoot-ssi のすべてのチェックで問題が解決している
• ユーザーが「すべて正常に動作していますか？」「ステータスを表示して」「APM の設定が完了していることを確認して」と尋ねた

検証またはトラブルシューティングのチェックに失敗しているものが残っている場合は、このスキルを呼び出さないでください。先に問題を解決してください。

---

実行前に解決するコンテキスト

変数	解決方法
AGENT_NAMESPACE	Datadog Agent がインストールされている名前空間
APP_NAMESPACE	アプリケーションの名前空間
APP_LABEL	Deployment マニフェストの spec.selector.matchLabels.app を確認します
CLUSTER_NAME	datadog-agent.yaml の spec.global.clusterName
SERVICE_NAME	Deployment の tags.datadoghq.com/service ラベル
ENV	Deployment の tags.datadoghq.com/env ラベル
DD_SITE	datadog-agent.yaml の spec.global.site

---

前提条件

Claude で実行

pup auth status --site <DD_SITE>

トークンが有効な場合は、次に進みます。

エラー：認証されていません。

Claude で実行

pup auth login --site <DD_SITE>

OAuth 用のブラウザータブが開きます。そこでログインを完了してください。コマンドが終了すると、Claude が処理を続行します。

---

現在の確認データを収集する

以下をすべて実行します。それぞれの結果が最終レポートの各行に反映されます。

Claude で実行

# Agent pod count and status
kubectl get pods -n <AGENT_NAMESPACE> \
  -l app.kubernetes.io/component=agent \
  --no-headers

# SSI instrumentation config live in cluster
kubectl get datadogagent datadog -n <AGENT_NAMESPACE> \
  -o jsonpath='{.spec.features.apm.instrumentation}'

# Init container confirmed in app pod spec
kubectl get pod -l app=<APP_LABEL> -n <APP_NAMESPACE> \
  -o jsonpath='{.items[0].spec.initContainers[*].name}'

# Service visible and traced in APM
DD_SITE=<DD_SITE> pup apm services list --env <ENV> --from 1h

# Traces arriving in the last hour
DD_SITE=<DD_SITE> pup traces search --query "service:<SERVICE_NAME>" --from 1h --limit 5

enable-dsm で DSM を有効にした場合のみ：

# DSM pipeline data for the service
DD_SITE=<DD_SITE> pup metrics query \
  --query "avg:data_streams.latency{service:<SERVICE_NAME>,env:<ENV>} by {pathway_type}" \
  --from 15m --to now

---

レポートを提示する

現在のコマンド出力からすべての値を入力します。プレースホルダーを未入力のままにしないでください。値を確認できない場合は、その行を失敗としてマークし、troubleshoot-ssi へのリンクを記載します。

---

APM のオンボーディングが完了しました

チェック	詳細	ステータス
Datadog Agent	<AGENT_NAMESPACE> で <N> 個の Pod が Running	OK
SSI の有効化	名前空間 <APP_NAMESPACE>、言語 <LANGUAGE> v<MAJOR_VERSION> を対象にしています	OK
Init コンテナの注入	Pod 仕様に datadog-lib-<language>-init があります	OK
トレーサーからのレポート	<SERVICE_NAME> が pup apm services list に isTraced: true として表示されています	OK
APM サービスの表示	環境 <ENV> の <SERVICE_NAME>	OK
トレースの到着	直近 1 時間に <N> 件のトレースが見つかりました	OK
Data Streams（有効な場合のみ）	<SERVICE_NAME> の data_streams.latency シリーズ、または「最初のメッセージを待機中」	OK

---

Datadog のサービス — クリックして開きます：

実際の値に置き換えて各 URL を作成します。プレースホルダーを含む URL は表示しないでください。

ビュー	URL
サービス概要	https://app.<DD_SITE>/apm/services/<SERVICE_NAME>?env=<ENV>
トレースエクスプローラー	https://app.<DD_SITE>/apm/traces?query=service:<SERVICE_NAME>%20env:<ENV>
サービスマップ	https://app.<DD_SITE>/apm/map?env=<ENV>&service=<SERVICE_NAME>
Agent フリート	https://app.<DD_SITE>/fleet-automation
Data Streams（有効な場合のみ）	https://app.<DD_SITE>/data-streams

---

セキュリティ上の制約

• 生の API キーをファイルやチャットメッセージに書き込まないでください