AWS CDK CLI テレメトリを設定する

CDK CLI バージョン

CLI バージョン (x.y.z)

これを収集すると、データをバージョン別に分割し、問題のあるバージョンを特定するのに役立ちます。

"2.1100.0"

インストール ID

CLI コマンドを実行するローカルマシンに保存されているランダム UUID

これにより、エラーの影響を受ける個別のユーザーの数を見積もることができます。各一意のマシンには、UUID V4 を介してランダムに生成される独自のインストール ID があります。

"881d3281-2811-4c86-b7b6-4a8a621cf6f2"

セッション ID

各 CLI コマンド呼び出しで生成されるランダム UUID

これにより、同じコマンドから発生するすべてのイベントを識別できます。

"c47e3d55-bc20-406b-a02a-e0285dd63230"

Event ID

セッション ID とカウンター

これにより、セッション内の各イベントに一意の識別子が作成されます。

"c47e3d55-bc20-406b-a02a-e0285dd63230:0"

リージョン

AWS リージョン

これは、データをリージョン固有の問題と区別するのに役立ちます。

"us-east-1"

タイムスタンプ

データがテレメトリエンドポイントに送信された (クライアントによって生成された) 時間

これにより、時系列グラフを生成できます。

"2025-12-12T00:00:00.000Z"

イベントの状態

イベントの「結果」。指定できる値は「成功」、「失敗」、「中止」です

これにより、各 CLI コマンドのエラー率を追跡し、顧客から報告される前に潜在的なリグレッションを警告できます。

"SUCCESS"

イベントタイプ

データを生成するイベントタイプの識別子

これは、コマンド実行で複数のイベントが発生する可能性があるために発生したイベントの種類を識別する列挙型です。

"SYNTH"

コマンドパス

CLI に入力され、フリーテキストが編集されたコマンドとプロパティ

コマンドパラメータに加えて、この情報は、発生したイベントの動作を決定するのに役立ちます。これにより、爆発半径と発生した問題の原因を特定できます。

["cdk", "deploy", "$STACK1"]

コマンドのパラメーター

CLI に入力され、フリーテキストが編集されたオプションのパラメータ

コマンドパスに加えて、この情報は、発生したイベントの動作を判断するのに役立ちます。これにより、爆発半径と、 によって発生する問題の原因を特定できます。

{
  all: true,
  concurrency: 4
}

設定

CLI コマンドに影響する可能性のある追加のパラメータ (例: cdk.context.json または cdk.json / のコンテキスト値~/.cdk.json)。フリーテキストは編集されます。

これにより、 CLI の動作に影響する可能性のあるすべてのパラメータを包括的に把握できるため、デバッグが容易になります。

{
  context: {
    "@aws-cdk/core:explicitStackTags": true
  }
}

オペレーティングシステム

使用中のオペレーティングシステム

これにより、特定のオペレーティングシステムにのみ影響する問題をデバッグできます。

{
  platform: "linux",
  release: "5.15.0-1019-aws",
}

CI/CD

CLI コマンドが CI/CD 環境から呼び出されているかどうか

これにより、CI/CD 環境に固有の問題を特定できます。

false

ノードバージョン

環境で使用されているノードバージョン

これにより、発生したノード固有の問題をデバッグできます。

"v22.0.0"

時間

ミリ秒単位のイベントの長さ

これにより、特定のイベントにかかる時間のパターンに気づくことができます。

{ total: 300 }

カウンタ

CDK アプリと CLI 実行から派生したさまざまなカウンターメトリクス

CFN リソース数などの (ただしこれらに限定されない) 統計のカウントがデプロイ期間にどのように影響するかをモニタリングします。

{
  resourceCount: 25,
  errorCount: 0,
  warningCount: 2,
}

依存関係

関連する AWS の依存関係とそのバージョン

aws-cdk-lib、jsii、projen など、CLI の結果に影響を与える可能性のある AWS の依存関係を追跡する予定です。特定の AWS 所有のライブラリへの依存関係のみを収集します。

[{ "aws-cdk-lib": "2.232.0"}]

エラー名

エラーが発生した場合のエラーの名前。

管理しているエラー名のみを記録するため、繰り返し発生するエラータイプを特定するのに役立ちます。

"ToolkitError"

以下のメトリクスには明示的なオプトインが必要であり、現在収集されていません。

エラーメッセージ

エラーが発生した場合に返されるエラーメッセージ。フリーフォームテキストの編集

[オプトインが必要] エラーメッセージをキャプチャすると、エラーが発生したデータをより頻繁に集計し、個々のユースケースで発生した問題をデバッグするのに役立ちます。

現在収集されていません

エラースタックトレース

エラーが発生した場合のエラーメッセージのスタックトレース。フリーフォームテキストの編集

[オプトインが必要] スタックトレースは個々のデバッグ目的に役立ち、発生する可能性のある問題を再現するために必要です。

現在収集されていません

エラーログ

エラーが発生した場合に失敗した CLI コマンドのログ。フリーフォームテキストの編集

[オプトインが必要] エラーログは、 CLI に表示される問題のデバッグと再現にも役立ちます。

現在収集されていません