ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意
要点
原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
「たぶん○○が原因」と直し始める前に、ログで何が起きたかを確認する(障害対応の基本(いきなり直さず症状を切り分ける14の確認順))。
どのログを見るか
| ログ | 場所 | 分かること |
|---|---|---|
| PHPエラーログ | サーバー管理画面のエラーログ、logs/ など | 500・白画面の原因ファイルと行(WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ)) |
| WordPress debug.log | wp-content/debug.log(WP_DEBUG_LOG を有効にしたときだけ) | プラグイン・テーマのエラー・警告。調査後は無効化して削除 |
| Webサーバーのアクセスログ | サーバー管理画面 | いつ・どのURLに・どのステータス。不正アクセス・404の多いURL・ボット |
| Webサーバーのエラーログ | 同上 | 403・.htaccess の誤り・権限 |
| JavaScript Console | ブラウザ DevTools | JSエラー・CORS・Mixed Content(DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない)) |
| Network / APIレスポンス | DevTools Network、サーバー側の記録 | ステータスとエラー本文(DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ)、APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか)) |
| メールのログ・エラーメール | SMTPプラグインのログ、MAILER-DAEMON | 送信失敗の理由(WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない)) |
| Claude Code の出力・作業ファイル | 会話の出力、scratchpad、作業ログ、ページ一覧.csv などの状態ファイル | どこまで実行したか・何が失敗したか(作業の再開方法(途中停止・API Error・コンテキスト切れのあと)) |
| サービスの管理画面の履歴 | Webhook の送信履歴、決済・予約の管理画面 | 外部側で何が起きたか |
見方
- 時刻で絞る: 障害が起きた時刻の前後だけを見る。時刻のタイムゾーン(UTCか日本時間か)に注意。
- 最初のエラーを見る: 後のエラーは連鎖で出ていることが多い。
- 同じエラーの件数と、いつから出始めたか(直前変更との関係 → 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス))。
- ログがない=問題がない、ではない(記録が無効・場所違いのことがある)。
保存・共有の注意
- ログには個人情報(IPアドレス、メールアドレス、フォーム入力)、トークン・セッションID・APIキーが含まれることがある。
- AI・他人・knowledge に渡すときは必要な行だけを抜き出し、機密を伏せる(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。
- debug.log を公開ディレクトリに放置しない。調査が終わったらデバッグ設定を戻す。
- ログの保存期間はサーバーごとに違う(数日で消えることも)。調査に必要な分は早めに控える。