Structured Logging - CI/CD用語集の定義

構造化ロギングは、自由形式のテキスト行ではなく、名前付きフィールドを持つ機械解析可能なレコード(通常はJSON)としてログエントリを出力するため、ログを確実にフィルタ、集約、クエリできます。

なぜ構造化が役立つのか

{"level":"error","build_id":42,"duration_ms":1830}のようなフィールドはインデックス化して検索できますが、単純な文字列Build 42 failed after 1830msは壊れやすいregexによる解析を必要とします。構造化ログはdashboardやアラートに直接供給されます。

CIのdebuggingにおいて

テストやdeployのstepから構造化ログを出力すると、生の出力をスクロールする代わりに、失敗したCIのrunを正確なリクエスト、build id、commitと相関させられます。

関連ガイド