ログは推測の前に見る証拠(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.logwp-content/debug.log(WP_DEBUG_LOG を有効にしたときだけ)プラグイン・テーマのエラー・警告。調査後は無効化して削除
Webサーバーのアクセスログサーバー管理画面いつ・どのURLに・どのステータス。不正アクセス・404の多いURL・ボット
Webサーバーのエラーログ同上403・.htaccess の誤り・権限
JavaScript Consoleブラウザ DevToolsJSエラー・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 の送信履歴、決済・予約の管理画面外部側で何が起きたか

見方

保存・共有の注意

  • ログには個人情報(IPアドレス、メールアドレス、フォーム入力)、トークン・セッションID・APIキーが含まれることがある。
  • AI・他人・knowledge に渡すときは必要な行だけを抜き出し、機密を伏せる(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。
  • debug.log を公開ディレクトリに放置しない。調査が終わったらデバッグ設定を戻す。
  • ログの保存期間はサーバーごとに違う(数日で消えることも)。調査に必要な分は早めに控える。