WP Cerberメール通知のトラブルシューティング
English version: Troubleshooting WP Cerber Email Notifications
WP Cerberからの通知が届かない場合、メール診断機能を使うと、プラグインが通知を送信しようとした際に何が起こったのかを特定できます。これは、テストメールは届くのにセキュリティアラートやスケジュールされたレポートが届かない場合に特に役立ちます。
メール診断機能は、WP Cerberによるメール送信試行を記録します。他のWordPressプラグインからのメッセージを追跡したり、メッセージが受信者の受信トレイに届いたことを確認したりするものではありません。また、診断機能を有効にしても、メール配信設定が変更されたり、通知制限が解除されたりすることはありません。
始める前に
影響を受ける通知を確認してください
通知が有効になっていること、および受信者が正しいことを確認してください。アクティビティアラートの場合は、条件、メールチャネル、有効期限、および通知制限を確認してください。ロックアウト通知の場合は、設定されているロックアウトしきい値と1時間あたりのアラート制限を確認してください。記録されたセキュリティイベントは、必ずしもメール送信を必要とするわけではありません。
プラグインがアップロードフォルダを変更していないか確認してください。
まず、プラグイン、テーマ、またはカスタマイズによってローカルアップロードフォルダが制御されているかどうかを確認してください。フォルダを選択できる設定がある場合は、互換性を確認する必要があります。一部の設定では、WP Cerberが診断ログと隔離ファイルの追跡を失い、ファイルがディスク上に残っていてもダッシュボードからアクセスできなくなる場合があります。このような設定を使用している場合、または不明な場合は、メール診断をオフにしてください。
wp-config.phpのUPLOADSまたは WordPress のupload_pathオプションで既に設定されている固定のアップロード場所自体は、この問題の原因にはなりません。他のプラグインがそれを上書きしてしまう可能性があります。
1. メール診断を有効にする
上記のアップロードフォルダのチェックが完了したら、サイトのwp-config.phpファイルのコピーを保存します。既存のPHPセクション内に、 wp-settings.phpを読み込む行の上に、次の行を追加します。
define ( 'CERBER_MAIL_DEBUG' , true );
ファイルに既にCERBER_MAIL_DEBUGが定義されている場合は、別の定義を追加するのではなく、その値をtrueに変更してください。
2. テスト通知を送信する
WP Cerber Notificationsの設定を開き、 「ロックアウト通知」の横にある「クリックしてテストを送信」をクリックします。テストメールが届いたかどうか、そして送信時刻を記録してください。メールが届かなかった場合は、迷惑メールフォルダを含め、送信先のメールボックスを確認し、WP Cerberが表示するエラーをメモしてください。
次に、実際に欠落している通知に関する記録を収集します。ダッシュボードのテストが成功したとしても、アクティビティアラートが条件を満たしたこと、スケジュールされたレポートが実行されたこと、またはリクエストで以前に作成された通知が同じ送信経路をたどったことが確認されるわけではありません。
断続的なアラートの場合は、次の関連イベントを観察するために必要な期間だけ診断を有効にしてください。対応するエントリを見つけられるように、時刻とタイムゾーンを記録しておいてください。テストと影響を受ける通知の間でメール設定を変更しないでください。変更すると結果の比較が難しくなります。
記録を作成するために、サイトを攻撃したり、意図的にアクセスを遮断したりする必要はありません。安全にイベントを再現する方法がない場合は、自然に発生するのを待ちましょう。
3. 診断ログを確認する
WP Cerber → ツール → 診断ログに移動し、テストと影響を受けた通知を記録した時間帯付近の[MAIL]とマークされたエントリを探してください。ファイルが必要な場合は「ログをダウンロード」を使用するか、関連するエントリをテキストとしてコピーしてください。テキストは完全な記録を保持し、長い行のスクリーンショットよりも確認が容易です。
各エントリはexplainという一文で始まります。これは、送信試行の内容を平易な英語で要約したものです。それに続く技術的な項目は、サポート担当者が調査に使用するものです。
以下の例は説明のためのものです。診断ログによって追加される日付と時刻の接頭辞を除いた、各エントリの[MAIL]部分を示しています。
例:ダッシュボードのテスト
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:20:00Z rid=EXAMPLETEST01 type=lockout dispatch=direct cwd=inside_abspath pwd=none cwd_send=inside_abspath pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
例:リクエスト完了時に送信されるロックアウト通知
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:25:00Z rid=EXAMPLEALERT02 type=lockout event=708 dispatch=shutdown cwd=abspath pwd=none cwd_send=root pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
どちらの例の呼び出しも成功しました。送信パスと作業ディレクトリのカテゴリが異なるため、テスト結果と実際の通知を比較するのに役立ちますが、メッセージが届かなかった理由を特定することはできません。
時刻を比較する際は、 tsフィールドを使用してください。tsフィールドは常にUTC(協定世界時)であり、末尾のZで示されます。診断ログの個別の日付と時刻の接頭辞には、異なるタイムゾーンが使用される場合があります。
4. 結果を理解する
result=ok受信者への配信を保証するものではありません。これは、WordPress のメール関数がその呼び出しに対して成功を返したことを意味します。WordPress は、メール関数のドキュメントでこの違いについて説明しています。explain テキストの「WordPress が成功を報告しましexplain 」についても同様で、 explainで失敗した試行は、失敗の原因を特定しません。
| あなたが見るもの | それはあなたに何を伝えているのか | 次にすべきこと |
|---|---|---|
result=error |
その呼び出しは失敗しました。 | 記録と、WP Cerberによって表示された関連するメールエラーを保存してください。 |
result=okですが、メッセージがありません |
送信機能は正常に完了しました。メールボックスへの受信確認はまだ完了していません。 | ウェブサイトのメールを送信するプロバイダー(ホスティングサービスまたはSMTPサービス)に、 ts (UTC)付近の送信ログを確認してもらうよう依頼してください。送信先のメールアドレスを非公開で伝え、送信が成功したかどうか、そしてその後どうなったかを尋ねてください。 |
| テストは到着するが、影響を受ける通知は | この2つのシナリオは、異なる結果をもたらす。 | 両方の記録を収集し、どちらの通知が欠落しているかを特定してください。 |
一致する[MAIL]エントリはありません |
ログには、想定された試行に対する結果が記録されていません。 | バージョン、有効化時間、通知条件、および制限事項を確認してください。ダッシュボードのテストで記録が生成されるかどうかを確認してください。 |
同じridを持つ複数のエントリー |
複数の録音された通話は、同一の依頼に関するものです。 | 記載事項はまとめて保管してください。必ずしも重複配送を表しているとは限りません。 |
設定やレート制限により、送信試行が妨げられる場合があります。ログの書き込みができなかった場合、またはメール機能が戻る前に実行が停止した場合にも、記録が欠落することがあります。記録がないからといって、ホスティングプロバイダがメッセージをブロックしたとは限りません。既知のテストで記録がない場合は、サポートにご連絡ください。
5. 記録の収集後、診断機能をオフにする
関連する試行をキャプチャしたら、既存の定義を次のように変更します。
define ( 'CERBER_MAIL_DEBUG' , false );
追加した行を削除することもできます。2つ目の定義は追加しないでください。サポート担当者がサイトの固定ストレージパスを設定してくれた場合は、その設定をそのままにしておいてください。
これにより、新しいメール診断エントリは作成されなくなります。既存のレコードは診断ログに残ります。共有ログ(他のWP Cerber機能からのエントリを含む)をクリアする「ログのクリア」を使用する前に、必要なデータを保存してください。
6. サポート担当者に関連情報を共有する
お使いのバージョンのチャンネルを選択してください:
- WP Cerber Professional: WP Cerber サポートポータルでプライベートチケットを開いてください。
- 無料版: WP Cerberコミュニティフォーラムでトピックを作成してください。
以下の詳細を含めてください。
- お使いのWP Cerberのバージョンと、表示されていない通知の内容を教えてください。
- お届け予定時刻(お客様のタイムゾーンを含む)
- ダッシュボードのテストが届いたかどうか。
- 関連する
[MAIL]エントリ。 - WP CerberのSMTP設定を使用する場合でも、他のWordPressメールプラグインを使用する場合でも。
WP Cerberでメールエラーが表示された場合は、その内容をプライベートチケットに含めてください。公開トピックでは、エラーが発生したことを記載するだけで、ユーザーやアカウントを特定できるような詳細情報の投稿は避けてください。
セキュリティ通知の場合、関連するアクティビティログのエントリも役立ちます。アクティビティログのエントリにはIPアドレスやユーザー名が含まれている可能性があるため、非公開で共有してください。エントリを見つけるには、メールレコードのridをコピーし、アクティビティログを開いて[詳細]をクリックし、 [リクエストID]に入力して[フィルタ]をクリックします。RID とは何か、そしてその使用方法については、[RID]を参照してください。
このガイドで説明する新しい[MAIL]行には、メールアドレス、IP アドレス、件名、メッセージ本文、認証情報、および生のファイルシステム パスは含まれていません。これらの個々の行は、公開フォーラムのトピックで共有できます。関連する[MAIL]行のみをコピーし、他のデータを含む周囲のログ エントリやスクリーンショットは含めないでください。
完全な診断ログのエクスポートには、他のWP Cerber機能からのエントリが含まれる場合があるため、非公開で共有してください。無料版をご利用の場合、スタッフからアクティビティログのエントリまたは完全なエクスポートを要求された場合は、共有する前に非公開での送信方法を尋ねてください。パスワードやwp-config.phpファイル全体を含めないでください。受信者のアドレスは、必要な場合にのみプライベートチャネルを通じて共有してください。
参照フィールド
すべてのフィールドをデコードしなくても、レコードをサポート担当者と共有できます。より詳細に確認したい場合は、このリファレンスで追加のコンテキストを説明しています。
| 分野 | 意味 |
|---|---|
explain |
recipient 、 recipients 、 attempt 、 smtp 、 result各フィールドから構成される、試行の要約(1文)。メール機能が報告した内容とWP CerberのSMTP判定について説明しており、メッセージが配信されたかどうかは示していません。 |
ts |
メール送信機能が呼び出される直前のUTC時刻。 |
rid |
WP Cerberのリクエスト識別子。同じリクエストからのレコードを関連付けるために使用されます。メールのメッセージIDではありません。 |
type |
通知の種類。一般的な値にはlockout 、 send_alert 、 report 、 scan 、 generic 、 2faなどがあります。認識されない種類は、 otherとして表示されます。 |
event |
ロックアウトが発生した理由またはアクティビティコード(利用可能な場合)。これはメールのエラーコードではありません。 |
dispatch |
通知がメール機能に届いた経緯については、以下の表をご覧ください。 |
cwd / cwd_send |
通知が準備された時点、およびメール送信直前のPHPの作業ディレクトリのカテゴリ。 |
pwd / pwd_send |
サーバーのPWD環境変数のカテゴリは、上記2箇所で設定できます。この変数は設定されていない場合もあれば、PHPの実際の作業ディレクトリと異なる場合もあります。 |
recipient / recipients |
受信者の通知内での位置と、通知の受信者数。メールアドレスは記録されません。 |
attempt |
受信者への最初の呼び出しの場合はinitial 、同じ受信者への呼び出しが失敗した場合にWP Cerberが再試行する場合はretryします。WP CerberはSMTP設定が有効になっている場合にのみ再試行します。 |
smtp |
WP Cerber による SMTP 呼び出しに関する独自の決定。以下の表を参照してください。 |
result |
メール呼び出しの戻り値に基づいて、 okまたはerror 。 |
該当するコードが指定されていない場合、 eventフィールドは省略されます。ダッシュボードのテストでは省略されることがあります。ただし、 event存在しないからといって、それ自体がテストメッセージであるとは限りません。
パスを送信しています
dispatch |
意味 |
|---|---|
direct |
WP Cerberは、以下のいずれの段階にも延期することなく、通知を送信しました。 |
plugins_loaded |
通知は事前に準備され、WordPressがplugins_loaded段階に達した時点で送信されました。 |
shutdown |
通知は事前に準備され、PHPリクエストの完了時にコールバックによって送信されました。これはサーバーがシャットダウンした、あるいはリクエストが失敗したことを意味するものではありません。 |
これらの値はWP Cerberの送信経路を示しています。SMTPサーバーを特定したり、メールプロバイダーの配信キューを説明したりするものではありません。特に、 directはSMTPが使用されたかどうかを示しません。
SMTPの決定
smtp |
意味 |
|---|---|
enabled |
WP Cerberは、その呼び出しにSMTP設定を適用します。 |
disabled |
WP Cerber は SMTP 設定を適用しません。これは、SMTP 設定が無効になっているか、WP Cerber Professional が必要となるためです。 |
bypassed |
SMTP設定は有効になっていますが、WP Cerberは同じリクエスト内で以前に失敗した呼び出しの後、今回の呼び出しではSMTP設定をスキップします。 |
この項目はWP Cerberの設定のみを反映しています。他のプラグインによってWordPressのメッセージ送信方法が変更される可能性もあるため、 enabled表示は、設定されたSMTPサーバーが使用されたことを証明するものではありません。
ディレクトリカテゴリ
ログには、実際のパスを記録する代わりにカテゴリが使用されます。
| 価値 | 意味 |
|---|---|
root |
ファイルシステムのルート/ 。 |
abspath |
WordPressのインストールディレクトリ。 |
inside_abspath |
WordPressのインストールディレクトリ内にあるディレクトリ。 |
outside_abspath |
WordPressのインストールディレクトリ外にあるディレクトリ。 |
none |
値が利用できないか、空欄です。 |
pwd=noneやdispatch=shutdownそれ自体ではエラーではありません。cwd cwd=abspathに続いてcwd_send=rootといった変更は送信環境に関する有用な証拠となりますが、配信失敗を証明するものではありません。また、カテゴリの一致はパスの一致を保証するものではなく、呼び出し前のスナップショットにはメール関数やそのフック内で行われた変更は反映されません。
PHPのopen_basedir制限が設定されているサーバーでは、シンボリックリンクを介してWordPressディレクトリに到達する現在PWDパスは、 outside_abspathとして分類される場合があります。サポート担当者は、エントリを確認する際にこの制限を考慮に入れることができます。
1つの通知で複数のレコードが生成される理由
記録された通話ごとに結果が異なります。複数の受信者や既存のSMTPフォールバックによって、1つの通知に対して複数のレコードが生成される場合があります。また、1つのリクエストから複数の通知が生成されることもあります。
例えば、受信者が2人でSMTPサーバーに到達できない場合、以下のような3つのレコードが生成されます(技術的なフィールドは省略してここに示します)。
[MAIL] explain="The email attempt for recipient 1 of 2 failed with WP Cerber SMTP enabled." ... recipient=1 recipients=2 attempt=initial smtp=enabled result=error
[MAIL] explain="WordPress reported success for the retry to recipient 1 of 2 without WP Cerber SMTP settings." ... recipient=1 recipients=2 attempt=retry smtp=bypassed result=ok
[MAIL] explain="WordPress reported success for recipient 2 of 2 without WP Cerber SMTP settings." ... recipient=2 recipients=2 attempt=initial smtp=bypassed result=ok
SMTP接続の試行は失敗し、その後の2回の呼び出しはいずれもWP CerberのSMTP設定なしで行われました。SMTPサーバーが復旧した、あるいはメッセージが届いたことを示す証拠は一切ありません。
受信者番号は通知ごとにリセットされ、メールアドレスは意図的に省略されるため、位置だけではどのアドレスが使用されたかはわかりません。問題を報告する際は、 errorの後に「 okが続く場合でも、関連するすべてのエントリを保持してください。
既知の問題:ローカルアップロードフォルダの変更
この問題は、プラグイン、テーマ、またはカスタマイズによって、WP Cerberが初期リクエスト時と通常のダッシュボードリクエスト時で異なるローカルアップロードのベースフォルダを認識するサイトに影響します。たとえば、プラグインによっては、読み込み後にのみそのフォルダが変更される場合があります。
WP Cerber はアップロード場所を使用して共有ストレージフォルダを検索します。既存のフォルダが別の場所に見つからない場合、WP Cerber は新しいフォルダを作成し、古いフォルダを見失う可能性があります。古いファイルはディスク上に残りますが、隔離されたファイルは隔離ページから消え、そこから復元できなくなる場合があります。診断レコードも別のフォルダに保存される可能性があります。
wp-config.phpのUPLOADSまたはupload_pathオプションで設定された固定の場所は、それ自体ではこの起動時の不整合の原因にはなりません。プラグインやカスタマイズによって後から上書きされる可能性があります。同様に、プラグインの local-folder 設定は、サイトに影響があるという証拠ではなく、その動作を確認するためのものです。これらは既存の設定例であり、アップロード設定を変更するための指示ではありません。
お使いの環境設定に影響が出る可能性がある場合は、メール診断をオフにしてサポートにお問い合わせください。その際、アップロード先の場所を制御するプラグイン、テーマ、またはカスタマイズの名前をお知らせください。
既存のwp-cerber-*フォルダとその内容はすべてそのままにしておいてください。移動、名前変更、削除は行わないでください。アップロードプラグインの設定を変更したり、推測で保存先パスを指定したりしないでください。正しい設定では、WP Cerberが既に使用しているフォルダを保持する必要があります。
影響を受けるサイトで診断機能が既に有効になっている場合は、ストレージの場所を確認する間は診断機能を無効にしてください。ただし、これによりWP Cerberが以前のフォルダに接続できるようになるわけではありません。WP Cerberの他の機能によって、ストレージの問題が引き続き発生する可能性があります。