はじめに

本番でトラブルが起きたとき、いちばん信頼できるのはコードでも仕様書でもなく、ログです。
でも、そのログ、ちゃんと「未来の自分が読める」ようになってますか？

この記事では、私がGMO決済やAWS SES、Webhook周りのトラブルを何度も経験した中で、思ったことを共有します。

結論　

「誰かのためにログを残す」と思うと、抽象的で形式的になります。

あのときの通知、何が届いて、何をしたのか。
なぜこの状態になっているのか。
ログがなければ再現も検証もできません。

「このとき本当にCANCEL来てた？」が後から100%出てくる。

保存してなければ「こうだったかも」でしか話ができず、詰む。

同じOrderIDに対して、

みたいな流れは決済やメール送信でよくある。
でも「それがあった」とわかるのは、すべての通知を時系列で残していたから。

こういうログは、未来の自分からすると存在しないのと同じ。
ここから特定できることもあるとは思いますが綺麗に残したいですね。

1週間後、1ヶ月後に見返してすぐ状況がつかめるかを基準に設計する。