診断バンドル
コンテナまたは Compose スタックの inspect、events、logs、stats をワンクリックで zip 化します。
診断バンドルは、コンテナまたは Compose スタックのデバッグ材料を 1 つの .zip にまとめます。共有、issue への投稿、自分用の控えに使えます。
バンドルの内容
| ファイル | 内容 |
|---|---|
manifest.json | 生成タイムスタンプ、Dockermanバージョン、ホストタイプ、ファイルインベントリ、編集カウント、発生したエラー |
system.json | Docker バージョンとシステム情報。レジストリのユーザー名は消去されますが、一般的なシークレット除去は行いません。 |
events.json | 選択された時間ウィンドウとターゲットコンテナでフィルタリングされたDockerイベント |
inspect.json | コンテナ、イメージ、ネットワーク、ボリュームの inspect データ。デフォルトではコンテナ config の Env リストで名前が一致した値だけを除去します。State.Health を含みます。 |
logs.txt | 選択された時間ウィンドウ内のタイムスタンプ付きコンテナログ |
stats.json | 時系列ストアからのリソース使用サンプル(利用可能な場合は生の5秒サンプル、長期間の場合は5分集計にフォールバック、時系列データが利用できない場合は現在のスナップショット) |
Compose スタックが対象なら、スタック内のコンテナごとに 1 つのサブディレクトリが入ります。
バンドルの生成
コンテナのアクションメニューを開き、診断バンドルを選択します。
Composeスタックのオーバーフローメニューを開き、診断バンドルを選択します。
Spotlight を開き、「diagnostic bundle」を検索してから対象を選びます。
時間ウィンドウを選択
logs、events、statsを含める期間を選択します。長いウィンドウは大きなバンドルを生成します。
マスキング設定を確認
TOKEN、PASSWORD、SECRET、KEY、CREDENTIAL、またはAUTH(大文字小文字を区別しない)に一致する環境変数は、デフォルトで***REDACTED***に置き換えられます。生の値が必要な場合はマスキングをオフにしてください。
保存場所を選択
ローカルファイルシステム上で.zipファイルを保存する場所を選択します。
生成を待つ
進行状況インジケーターがバンドル生成の状態を表示します。単一コンテナなら、通常 10 秒未満で完了します。
結果を開く
生成後、Finderに表示(macOS)または同等の操作で、保存したファイルへジャンプします。
機密データのマスキング
デフォルトでは、以下のパターンに一致する環境変数の値は***REDACTED***に置き換えられます:
(?i)(TOKEN|PASSWORD|SECRET|KEY|CREDENTIAL|AUTH)これはバンドル内の inspect.json に適用されます。自分のデバッグに生の値が必要なら、バンドルダイアログでマスキングをオフにできます。
除去範囲は限定的です。イメージの環境変数、ラベル、コマンド、マウントパス、ネットワークとボリュームの inspect、コンテナログにはシークレットや非公開パスが残る可能性があります。共有前にすべてのファイルを確認してください。
ヒント
- GitHub issues やコミュニティフォーラムで助けを求めるときは、診断バンドルを付けてください。構造化されているので、相手がセットアップを把握しやすくなります。
- バンドル内の stats は、バックグラウンドタスクスケジューラ が時系列データを集めている前提です。スケジューラを最近有効にしただけなら、stats は現在のスナップショットだけのことがあります。
- コンテナが多い Compose スタックでは、バンドルが大きくなります。サイズを抑えるには短い時間ウィンドウを使ってください。