Dockerman Docs
Homelab

診断バンドル

コンテナまたは Compose スタックの inspect、events、logs、stats をワンクリックで zip 化します。

診断バンドルは、コンテナまたは Compose スタックのデバッグ材料を 1 つの .zip にまとめます。共有、issue への投稿、自分用の控えに使えます。

バンドルの内容

manifest.json
system.json
events.json
inspect.json
logs.txt
stats.json
ファイル内容
manifest.json生成タイムスタンプ、Dockermanバージョン、ホストタイプ、ファイルインベントリ、編集カウント、発生したエラー
system.jsonDocker バージョンとシステム情報。レジストリのユーザー名は消去されますが、一般的なシークレット除去は行いません。
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 スタックでは、バンドルが大きくなります。サイズを抑えるには短い時間ウィンドウを使ってください。