ACQUA JOURNAL
WordPressの不具合調査へログを渡すには|時刻・再現・採取範囲・共有と終了の確認表

WordPressの不具合を調査してもらうときは、ログ全文を送る前に、対象URL、操作、発生時刻、期待した結果と実際の結果をそろえてください。ログの文字列だけでは、今回の症状と関係するか、いつから起きているかを判断できない場合があります。
この記事では、企業担当者が残す現象の記録と、制作会社・保守担当が行うログの照合や必要な採取を分けます。公開画面へデバッグ情報を出す、認証や顧客情報を含む記録を公開する、といった方法から始めず、既存の証拠と必要な調査を整理します。
1. ログを集める前に現象を記録する
対象サイトと環境、URLや管理画面、操作、発生日時とタイムゾーン、画面のメッセージを控えます。保存・表示・受付・外部連携のどの仕事が止まるかを記録し、正常な条件があれば並べます。

直前に更新、設定、原稿、契約や配信先を変えていれば、その日時と担当を控えます。入力中の原稿は別に保存し、担当間で同じデータを同時変更しないようにします。調査中に複数の変更を重ねると、どの操作に対応する記録か分かりにくくなります。
サイト全体が使えない場合は停止の影響を確認して保守担当へ連絡します。ログ採取を優先して、復旧判断や新しい受信データの保存を忘れないでください。
2. ブラウザー・通信・サーバーの記録を分ける
ブラウザーのConsole、Networkの要求と応答、サーバーのアクセス・エラー記録、PHPや追加機能の処理記録は、異なる場所の情報です。一つの記録だけで、保存と通知や公開までの全工程を確認できるとは限りません。

ブラウザーではChrome DevTools公式のNetwork説明を参照し、対象の要求先、時刻、状態、応答を確認できます。画面に出るエラーと要求を対応づけ、関係のない広告や別の資源の警告を今回の原因と即断しません。
サーバーや処理記録の場所、保持、権限は契約先と構成で異なります。管理画面へログインできる権限と、サーバーの記録を読める権限は別です。正規の担当へ必要な範囲を依頼してください。
3. 既存の記録から、同じ時刻と操作を探す
既に残っているログを、対象、時刻、識別子、処理名などで照合します。画面とサーバーの時刻表記が異なる場合は、タイムゾーンと差を確認します。似た文字列があるだけで、同じ操作の記録とは判断しません。

| 調査依頼に残すもの | 確認する内容 |
|---|---|
| 環境 | 本番・試験、構成、関係する製品の版 |
| 現象 | URL、操作、期待と実際、業務への影響 |
| 時刻 | 発生日時、タイムゾーン、再現時刻 |
| 記録 | 取得元、対象範囲、識別子、該当部分 |
| 不足 | まだ取れていない工程、必要な権限と担当 |
記録がない場合は、未取得・保持期限切れ・別の保存先などを分けます。「ログに出ないので不具合はない」とせず、今回の条件を記録できる仕組みだったかを確認してください。
4. 追加採取は、必要性と環境を決めてから行う
既存記録だけでは不足する場合は、何を確かめるか、どの環境でどの操作を試すか、誰が判断するかを決めます。WordPress公式のデバッグ説明は、試験環境や保存の準備を促し、デバッグ機能を本番で常用することを推奨していません。

WP_DEBUG、WP_DEBUG_LOG、WP_DEBUG_DISPLAYは同じ設定ではありません。記録を残すことと、公開HTMLへメッセージを出すことを分け、実際の保存先と閲覧制御を確認します。表示を隠す設定だけでは、ログファイルを他人が読めないことの確認にはなりません。
設定変更は保守担当が原本、差分、影響、試験、戻し方を確保して行います。公開サイトに説明のコードを無条件で貼らず、採取期間、容量、個人情報、終了時の扱いまで決めます。試験環境ではデータ・メール・外部連携の隔離を先に確認してください。
5. 再現操作と新しい記録を一組で採る
合意した条件で記録を開始し、対象の操作を一度行い、実際の結果と時刻を控えます。開始前からある警告と、今回の操作で増えた記録を分けます。注文や通知などを伴う再現は、実業務へ混ざらないデータと宛先で進めます。

機能が動いていても警告が出ること、処理が失敗しても公開画面に詳しい情報が出ないことがあります。警告の件数や文字列だけで、緊急度と原因を決めません。必要な機能の結果、記録の対象、コードや環境を調査担当が照合します。
再現できなかった場合は、その条件と結果を記録します。無制限に書き込みや送信を繰り返さず、条件の違いと次に必要な観察を判断してください。
6. 共有は必要部分と、管理された経路を使う
認証情報、Cookie、トークン、顧客情報、内部のパスや業務データが含まれるか確認します。共有用の写しから不要な部分を除き、調査に必要な時刻・処理・関係を残します。原本は権限を限定した保管場所へ置き、公開記事や公開フォーラムへ全文を貼りません。

通信のHARなど、ブラウザーが書き出すファイルも確認対象です。ツールが機密項目を除く設定でも、本文やURLに含まれる業務情報まで不要なものがすべて消えたとは判断しません。共有先、閲覧者、期限、受け取りを担当と確認します。
相談の最初の文章は、対象URL、操作、日時、要約だけで進められる場合があります。必要なファイルや権限の受け渡しは、調査範囲に応じて別に決めてください。
7. 調査終了後に、設定と保存の扱いを戻す
追加した記録の設定、試験用の権限、試験データ、保存先、容量を確認します。必要な証拠は合意した期間で保持し、不要な採取を続けません。公開への露出がないことと、通常の運用へ戻ったことを読み戻してください。

ログを古い順に削除して終わる前に、必要な調査証拠や契約上の保持、担当の承認を確認します。調査の結論、実施した修正、検収結果、残る未確認を記録します。
修正が必要な場合は、その対象と戻し方を別に合意します。ログを集めたこと、原因候補を挙げたこと、修正と検収が終わったことは別の進捗です。保守の確認票へ必要な担当と次の観察を引き継ぎます。
8. 現象の記録と、技術調査を分担する
企業担当者は困る仕事、操作、日時、直前の変更と現在の結果を整理します。制作会社や保守担当は、必要な記録の取得元、権限、再現、保存と共有、原因候補と検収を扱います。更新担当がすべての設定を書き換える必要はありません。

AcquaにはWordPressの不具合調査、既存実装の修正、合意した試験・公開確認を相談できます。企業向けWeb制作・運用と制作会社向けWordPress実装・既存修正で現在の範囲を確認してください。
相談窓口にはURL、操作、時刻、期待と実際、調査済みの範囲をお知らせください。支援後は現象に対応する証拠、調査結果と残る課題、実装を直した場合の検収、記録の保管期限と次の担当が分かる状態を目指します。ログ採取だけで不具合が解消したとは報告しません。
ログ全文を送る方が早いですか?
必要な範囲と機密を確認します。最初は現象の要約を渡し、ファイルの共有経路を調査担当と決めます。
公開画面にエラーを表示すべきですか?
一般の閲覧者へデバッグ情報を出す方法から始めません。必要な記録と保存先の保護を担当が確認します。
警告があるなら、それが原因ですか?
今回の時刻と操作、実際の結果を照合します。以前からの警告や別処理の記録を分けて調査してください。
ログに何もなければ正常ですか?
記録の対象と保持を確認します。未取得や別の保存先の場合もあり、機能の結果と別に判断します。