Skip to content

配信ログ

メール1通ごとの配信状況を検索・参照することができます。

メールが届いていないなどの問い合わせがあった際に、迅速にそのメールの状況を調査することができます。Customers Mail Cloudは、4つの配信ステータスでメールの送信状態を管理しています。

メモ

配信ログの保持期間は、40日間です。これより古いログは参照できません。

ログを参照する

  1. 管理コンソールの「配信レポート」タブをクリックします。

  2. 左側のリストから対象のサーバ構成を選択します。 APIユーザーごとのログを表示する場合は、サーバ構成の「＋」をクリックしてリストを展開し、対象のAPIユーザーを選択します。

  3. 「配信ログ」タブをクリックします。

    配信ログ

  4. 宛先メールアドレス、または、その一部を入力し、「検索」ボタンをクリックすると該当するメールの配信ステータスを表示します。

    表示項目 説明
    時刻 配信ステータスを記録した時刻を表示します。
    宛先アドレス 宛先メールアドレスを表示します。
    件名 メールヘッダにある件名を表示します。
    ステータス queued, succeeded, deferred, failed のいずれかを表示します。詳細は配信ステータスを参照ください。

  5. 宛先アドレスのリンクをクリックすると詳細情報を示すダイアログが表示されます。

    配信詳細ダイアログ

    表示項目 説明
    時刻 配信ステータスを記録した時刻を表示します。
    ステータス 配信ステータスを表示します。
    差出人アドレス メールヘッダにあるFromアドレスを表示します。
    Return-Path バウンスメールが返却されるメールアドレスを表示します。
    宛先アドレス メールの宛先アドレスを表示します。
    件名 メールヘッダにある件名を表示します。
    メッセージID メールヘッダにある Message-Id を表示します。
    X-Api-Data メールヘッダにある X-Api-Data を表示します。
    リレー元IP このメールのリレー元サーバーと通信した際に記録したIPアドレスを表示します。
    送信IP このメールを宛先サーバーに送信する際に使用したIPアドレスを表示します。
    フィルタ このメールを送信する際に使用した配信速度設定のフィルタ名を表示します。
    応答メッセージ 宛先サーバーから応答されたSMTPメッセージを表示します。応答メッセージは配信ステータスが failed, deferred の場合に表示します。

配信ログは以下のパラメータで検索することができます。

パラメータ 説明
日付 送信ログを検索する日を YYYY-MM-DD 形式で指定します。
このパラメータは必須です。
時間帯 送信ログを検索する時間帯を指定します。
ステータス 検索対象とする配信ステータスを指定します。
宛先アドレス 入力された宛先メールアドレスを部分一致で検索します。

メモ

検索結果が100件を超える場合、最初の100件を表示します。検索条件に宛先アドレス、時間帯、ステータスを指定し検索対象データを絞り込んでください。

メモ

検索結果が10件を超える場合ページングします。検索結果一覧の右上にあるページャーを操作して参照してください。

ログをダウンロードする

「ダウンロード」ボタンをクリックすると配信ログの検索結果をCSVファイル形式でダウンロードすることができます。

ダウンロードダイアログ

注意

配信ログのダウンロード機能は、お客様情報保護の観点から、デフォルトでは無効となっております。
有効化をご希望の場合は、サポート窓口までお問い合わせください。「グループ管理者」アカウントに対してダウンロード権限を付与いたします。

なお、本機能を有効化した場合、「配信レポート」のエラーログ、「配信停止」等のダウンロード機能も併せて有効化されます。

「ダウンロード」以外のログ取得の方法について

Transaction API を利用してログを取得することも可能です。

以下項目を入力します。

項目 必須 説明
パスワード Yes ダウンロードするパスワード付き暗号化ZIPファイルのパスワード入力します。

メモ

100件以上の検索結果がある場合でも全件数のデータがダウンロードできます。 CSVファイルの文字コードは UTF-8、改行コードは、LF となります。

CSVファイルには以下の項目が出力されます。

項目名 説明
created 配信ステータスを記録した日時
messageId 送信したメールのヘッダにある Message-Id
status 配信ステータスの数値
sourceIp メールのリレー元サーバーと通信した際に記録したIPアドレス
senderIp メールを宛先サーバに送信する際に使用したIPアドレス
returnPath メールを送信するときに使用したエンベロープFromアドレス
from 送信したメールのヘッダにあるFromアドレス
to 送信したメールのToアドレス
subject 送信したメールの件名
apiData メール送信元アプリケーションが付与した X-Api-Data のヘッダ値
reason 宛先サーバーから応答されたSMTPメッセージまたはバウンスメールの内容