Mail Manager 記錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Mail Manager 記錄可讓您詳細了解 Mail Manager 操作。記錄功能會根據您設定的規則集和規則，透過訊息處理，追蹤從輸入端點的初始接收到的訊息流程。

Mail Manager 提供下列資源的記錄：

Mail Manager 會使用 Amazon CloudWatch Logs 服務交付日誌，而日誌可以交付到下列任何目的地：CloudWatch Logs、Amazon S3 或 Amazon Data Firehose。

設定 Mail Manager 日誌交付

工作日誌交付包含三個元素：

本節將說明如何建立這些物件，以及使用 Mail Manager 記錄所需的必要許可。

先決條件

設定 Mail Manager 記錄之前，請確定：

所需的許可

您將需要如 Amazon CloudWatch Logs 使用者指南的 記錄 中所述，設定 提供的日誌許可，該記錄需要額外的許可 【V2】 區段，並套用對應至您交付目的地的許可：

此外，Mail Manager 需要下列使用者許可才能設定日誌交付：

{
    "Version": "2012-10-17", 
    "Statement": [
        {
           "Sid": "AllowSesMailManagerLogDelivery",
           "Effect": "Allow", 
            "Action": [
                "ses:AllowVendedLogDeliveryForResource"
           ],
           "Resource" [
               "arn:aws:ses:us-east-1:1234567890:mailmanager-ingress-point/inp-xxxxx",
               "arn:aws:ses:us-east-1:1234567890:mailmanager-rule-set/rs-xxxx"
           ]
       }
    ]
}

在 SES 主控台中啟用記錄

若要使用主控台啟用 Mail Manager 資源的記錄：

使用 CloudWatch Logs API 啟用記錄

若要使用 CloudWatch Logs API 啟用 Mail Manager 資源的記錄，您需要：

您可以在 Amazon CloudWatch Logs 使用者指南的 日誌中，檢視 IAM 角色和許可政策的範例，其中包含您特定日誌目的地所需的所有必要許可，這些許可需要額外許可 【V2】 區段，並遵循日誌目的地的 IAM 角色和許可政策範例，包括允許更新特定日誌目的地資源，例如 CloudWatch Logs、S3 或 Firehose。

解譯日誌

日誌可用於在 Mail Manager 處理接收的訊息時，獲得對接收訊息流程的其他洞見。

下節詳細說明每個資源日誌的不同欄位。

傳入端點日誌

日誌會依訊息產生。

{
  "resource_arn": "arn:aws:ses:us-east-1:1234567890:mailmanager-ingress-point/inp-xxxxx",
  "event_timestamp": 1728562395042,
  "ingress_point_type": "OPEN" | "AUTH",
  "ingress_point_name": "MyIngressPoint",
  "message_id": "0000llcki1jmushh817gr586f963a5inhkvnh81",
  "message_size_bytes": 100000,
  "rule_set_id": "rs-xxxx",
  "sender_ip_address": "1.2.3.4",
  "smtp_mail_from": "someone@domain.com",
  "smtp_helo": "domain.com",
  "tls_protocol": "TLSv1.2",
  "tls_cipher_suite": "TLS_AES_256_GCM_SHA384",
  "recipients": ["me@mydomain.com", "you@mydomain.com", "they@mydomain.com"],
  "ingress_point_metadata": { // only applies to AUTH Ingress Endpoint
       "password_version": "",
       "secrets_manager_arn": ""
  }
}

CloudWatch Logs Insights 查詢範例

來自 sender@domain.com 的查詢訊息：

fields @timestamp, @message, @logStream, @log
| filter smtp_mail_from like /sender@domain.com/
| sort @timestamp desc
| limit 10000

查詢大小大於 5000 位元組的訊息：

fields @timestamp, @message, @logStream, @log
| filter message_size_bytes > 5000
| sort @timestamp desc
| limit 10000

規則集日誌

日誌是針對每個動作的每個訊息產生。這表示每當規則集中規則中的動作處理訊息時，就會產生日誌記錄：

{
   "resource_arn": "arn:aws:ses:us-east-1:1234567890:mailmanager-rule-set/rs-xxxx",
   "event_timestamp": 1732298258254,
   "message_id": "0000llcki1jmushh817gr586f963a5inhkvnh81",
   "rule_set_name": "MyRuleSet",
   "rule_name": "MyRule",
   "rule_index": 1,
   "recipients_matched": ["recipient1@domain.com", "recipient2@domain.com"],
   "action_metadata": {
       "action_name": "WRITE_TO_S3" | "DROP" | "RELAY" | "DELIVER_TO_MAILBOX" | etc.,
       "action_index": 2,
       "action_status": "SUCCESS" | "FAILURE" | "IN_PROGRESS",
       "action_failure": "Access denied"
   }
}

此外，如果訊息的規則條件不相符，也就是說，訊息不會由規則處理，單一日誌會發佈至 ，指出訊息已由規則集處理，但沒有對其執行任何動作：

{
   "resource_arn": "arn:aws:ses:us-east-1:1234567890:mailmanager-rule-set/rs-xxxx",
   "event_timestamp": 1732298258254,
   "message_id": "0000llcki1jmushh817gr586f963a5inhkvnh81",
   "rule_set_name": "MyRuleSet",
   "rule_name": "MyRule",
   "rule_index": 1,
   "recipients_matched": [],
}

CloudWatch Logs Insights 查詢範例

查詢特定訊息 ID （顯示通過規則集的訊息流程）：

fields @timestamp, @message, @logStream, @log
| filter message_id = 'message-id-123'
| sort @timestamp desc
| limit 10000

查詢失敗的 WRITE_TO_S3 動作：

fields @timestamp, @message, @logStream, @log
| filter action_metadata.action_name = 'WRITE_TO_S3'
    and action_metadata.action_status = 'FAILURE'
| sort @timestamp desc
| limit 10000

查詢規則集的第二個規則未處理的訊息 （訊息不符合規則的條件）：

fields @timestamp, @message, @logStream, @log
| filter recipients_matched = '[]'
    and rule_index = 2
| sort @timestamp desc
| limit 10000