アプリのログをどこに出すか

レン

自作のアプリのログ、どこに出すのが正解なの？

プロクラ

運用の形によって答えが変わるよ。大きく3つの選択肢があって、それぞれ向き不向きがある。まず自分の構成に合うものを選ぼう。

選択肢1：ファイルに書く

• 分かりやすく、後から読みやすい
• 自動で分割・削除する設定が必要（放置すると膨らむ)
• 書き込む先の権限を、実行ユーザーに合わせる必要がある
• コンテナで動かす場合は、消えないよう外に置く配慮が要る

選択肢2：標準出力へ出す

プロクラ

アプリはただ出力するだけで、それをどこへ保存するかは外側の仕組みに任せる、という考え方だよ。コンテナやサービス管理の仕組みと相性がいい。

• アプリ側が出力先を気にしなくてよい
• サービス管理の仕組みが受け取り、まとめて記録してくれる
• コンテナでは、これが標準的なやり方
• 受け取る側で、保存期間や容量の上限を設定する

選択肢3：システムのログへ送る

• 他のサービスのログと同じ場所にまとまる
• 時系列で突き合わせやすい
• 別のサーバーへ転送する仕組みにも乗せやすい
• アプリ側で対応が必要

プロクラ

個人のサーバーで、systemdでアプリを動かしているなら、標準出力へ出すのがいちばん楽だよ。保存も分割も、外側が面倒を見てくれる。

書いてはいけない情報

ウィルスン

…エラーの詳細をログに残すのは良い習慣だ。ただ、そこに認証情報まで書いてくれると、ワタシは読むだけで済むのでね。

• パスワード、APIキー、トークン
• データベースの接続情報
• 利用者の個人情報（必要な範囲を超えて記録しない）
• エラーの詳細を出すときは、含まれる内容を確認する

プロクラ

3つめは、記録すること自体に責任が生じる点も意識してね。個人情報を含むログを溜め込めば、その管理も必要になる。保存期間を決めて、古いものは消そう。

後から役に立つ書き方

• いつ・何が起きたかを、1行で分かる形にする
• 重要度を分ける（情報・警告・エラー）
• エラーには、原因を追える情報を含める
• 正常時に大量に出さない（本当の異常が埋もれる）

レン

標準出力に出して、外側に任せる。それが一番楽そうだね。

アクセスログとの使い分け

プロクラ

Webサーバーが記録するアクセスログと、アプリが出すログは役割が違うよ。両方あって初めて、何が起きたかを追える。

• アクセスログ: 誰がどのURLに来て、どう応答したか
• アプリのログ: その中で、何を判断し、どこで失敗したか
• 時刻で突き合わせられるよう、記録の形式を揃える
• エラーの調査では、両方を並べて見ることになる

プロクラ

3つめのために、サーバーの時刻が正確であることが前提になる。時刻がずれていると、突き合わせができなくなるよ。