【コード哲学エッセイ】 ログは証拠じゃなく、 未来の自分との対話だ

可観測性が残す優しい記録

深夜。
アラートが鳴って、画面が赤く染まる。
手指が冷たくなるのは、気温のせいだけじゃありません。

ログビューアを開いた瞬間、頭のなかで裁判が始まる。

「いつ」
「誰が」
「どこで」

錯覚してしまうのです。
ログは上司への説明資料だと。

でも止まってほしくないのは本番のサービスであって、未来の自分の自尊心じゃない。
僕があとから読み返す相手は、ほとんどの場合、明日の僕です。

証拠は冷たい。 対話はまだ暖かい

ログという言葉には、つい裁きの匂いがついてまわります。
監査、コンプライアンス、インシデント報告。
どれも大事です。
でも現場の感覚として、ログはもっと泥だらけで生々しいです。

エラーのスタックトレース。
タイムアウトの秒数。
外部 API が返した、意味の分からないコード。

それらは誰かを有罪にするためにあるより、状況を共有するためにあるべきだと僕は思うようにしました。

証拠は、できあがったあとに並べる大理石の床みたいに硬い。
対話は、まだ続いている部屋のなかの空気みたいに柔らかい。

ログを後から読むとは、過去の自分にインタビューすることに近いのです。
「あのとき、君は何を見ていた？」と。

未来の自分が沈黙しないために

コミットログが日記なら、アプリのログは現場のあいづちに近いです。
リクエストがどこを通ったか、どこで息が詰まったか。

リポジトリの歴史とは別に、runtime は一秒単位で局面が変わる。
だからこそ、観測できるようにしておくというのは、未来の自分への手すりを増やすことなのだと感じます。

たとえば、相関 ID を一本通すだけでも、世界は狭くなる。
「このエラーとこの遅延は、同じ旅の出来事だ」とわかる。

ダッシュボードの折れ線が急に尖る。
それは攻撃でもなく、ただの温度変化かもしれない。
でも温度が読めないまま夜を越えるほうが、よっぽど怖い。

可観測性という言葉は難しく聞こえるけれど、本質はシンプルです。
沈黙を減らすこと。

優しい記録とは恥を晒すことじゃない

もちろん、ログに詩を書けとは言いません。
個人情報を垂れ流せとも言いません。

言いたいのは、ログを反省文にしないということです。
「自分が悪かった」と結論を急がなくていい。
まず何が見えたかを丁寧に残す。

フリーランスの現場では、一人で見る時間が長いぶん、ログが独り言になりがちです。
独り言でも、声のトーンは選べる。

脅しではなく、報告。
断定ではなく、観測。

そう書いたログは、半年後の自分を責めない。
「あのとき、ここまで見えていたんだ」と、肩を並べてくれるのです。

ログの向こう側にいるのは、 ほぼいつも自分だ

インシデントが終わったあと、ポストモーテムを書く夜。
僕はいつも、最初にログを見返します。

そこに残っているのは、たいていの場合、僕自身の迷いの痕跡です。
タイムアウトを延ばした判断。
レート制限を甘く見た楽観。
「あとで直す」と書いた TODO の利息。

それでも、ログが対話の記録であるなら、責め合いは終わります。
代わりに、次の一行が書ける。

次はここを観測しよう。
次はここに手すりをつけよう。

可観測性は、完美な監視カメラじゃない。
未来の自分が夜道でつまずいたとき、足元を照らす灯りに近いです。

ひとりごと

吃音のある僕にとって、言葉はいつだって観測対象でした。
うまく言えなかった瞬間の空気感まで、あとから思い出そうとすると粗が出る。

だからこそログを書くときは、誰かを説得する文体より、あとから自分が読んで安心する文体を選びたい。
それがエンジニアとしての僕のささやかな優しさの形です。

みなさんのログが、証拠ではなく対話の記録でありますように。

あわせて読みたい

▼ リポジトリの言葉としてのログを読みたいときに

Git の歴史に残すコミットと、本番で流れるログは別物でありながら、どちらも未来の自分への手紙として綴られます。

▼ エラーを人格ではなく境界として捉えたいときに

ログが拾うのは「誰のせい」より「どこで境界が崩れたか」のほうです。
エラーを裁く対象ではなく、設計の輪郭を示す案内役として読む視点がつきます。

▼ テストとログを、未来への祈りとして並べて考えたいときに

壊れる前に気づく設計と壊れたあとに見える設計は、同じ優しさの裏表です。

次の一歩を一緒に決める作戦会議室へ

オブザーバビリティの設計や、障害時の切り分けフローを現場で使える形まで落とし込みたい方もいると思います。

作戦会議室では、テンプレやツールの話を具体的に分け合える場所にしたいです。
必要なときだけ、覗いてみてください。

参加する