メニュー
Amazon Simple Email Service
開発者ガイド

AWS CloudTrail を使用して Amazon SES API 呼び出しのログを記録する

Amazon SES は、ご利用の AWS アカウントの Amazon SES により、またはこれらの代わりに行われる API 呼び出しをキャプチャし、指定した Amazon S3 バケットにログファイルを渡すサービスである CloudTrail と統合されています。CloudTrail は、Amazon SES コンソールまたは Amazon SES API から行われた API 呼び出しをキャプチャします。CloudTrail によって収集された情報を使用して、Amazon SES に対してどのようなリクエストが行われたか (リクエストの実行元 IP アドレス、実行者、実行日時など) を判断できます。CloudTrail を設定して有効にする方法など、詳細については、AWS CloudTrail User Guide を参照してください。

CloudTrail での Amazon SES 情報

AWS アカウントで CloudTrail のログ記録を有効にすると、Amazon SES アクションのサブセットに対する API 呼び出しがログファイルに記録されます。Amazon SES レコードは、他の AWS サービスレコードと一緒にログファイルに記録されます。CloudTrail は、期間とファイルサイズに基づいて、新しいファイルをいつ作成して書き込むかを決定します。

以下のアクションがサポートされています。

各ログエントリには、誰がリクエストを生成したかに関する情報が含まれます。ログのユーザー ID 情報は、リクエストが、ルートまたは IAM ユーザーの認証情報を使用して送信されたか、ロールまたはフェデレーティッドユーザーの一時的なセキュリティ認証情報を使用して送信されたか、あるいは AWS の別のサービスによって送信されたかを確認するのに役立ちます。詳細については、CloudTrail Event ReferenceuserIdentity フィールドを参照してください。

ログファイルは無期限に保管できますが、ログファイルを自動的にアーカイブまたは削除するように Amazon S3 ライフサイクルルールを定義することもできます。 デフォルトでは Amazon S3 のサーバー側の暗号化 (SSE) を使用して、ログファイルが暗号化されます。

ログファイルの配信時にすぐにアクションを実行する場合、新しいログファイルの配信時に CloudTrail により Amazon SNS 通知を発行することを選択できます。詳細については、「Amazon SNS 通知の構成」を参照してください。

また、複数の AWS リージョンと複数の AWS アカウントからの Amazon SES ログファイルを 1 つの Amazon S3 バケットに集約することもできます。詳細については、「CloudTrail ログファイルの単一の Amazon S3 バケットへの集約」を参照してください。

Amazon SES ログファイルエントリの概要

CloudTrail ログファイルには、複数の JSON 形式イベントで構成される 1 つ以上のログエントリを記録できます。ログエントリは任意の送信元からの単一のリクエストを表し、リクエストされたアクション、パラメータ、アクションの日時などに関する情報を含みます。ログエントリは、特定の順序になるように生成されるわけではありません。つまり、パブリック API 呼び出しの順序付けられたスタックトレースではありません。

CloudTrail ログの例を次に示します。

{ "Records": [ { "awsRegion": "us-west-2", "eventID": "0ffa308d-1467-4259-8be3-c749753be325", "eventName": "DeleteIdentity", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "50b87bfe-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identity": "amazon.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "17bb827a-dc8c-4156-90b1-c214e1d135c9", "eventName": "DeleteVerifiedEmailAddress", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:57:15Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "c29fb5c1-ac08-11e4-8ff5-a56a3119e253", "requestParameters": { "emailAddress": "user@example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "0b311e38-b5c6-43b3-9a39-5fbf0c2d0d99", "eventName": "GetIdentityDkimAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "50f92e80-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "bf695be8-1c67-45b0-8f10-fd56afee09dd", "eventName": "GetIdentityNotificationAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:50Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5133ed92-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "8f9aed63-b03a-4d30-a880-33ae0c6b7786", "eventName": "GetIdentityVerificationAttributes", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:57:16Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "c2d23773-ac08-11e4-8ff5-a56a3119e253", "requestParameters": { "identities": [ "example.com" ] }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "60ef4f01-9826-4fb4-828e-8c36dda81f40", "eventName": "GetSendQuota", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:03:27Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "a0760648-ac09-11e4-8ff5-a56a3119e253", "requestParameters": null, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "0fe5eef3-0c28-4480-808e-307b21404a78", "eventName": "GetSendStatistics", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51644c64-ab23-11e4-9106-5b36376f9d12", "requestParameters": null, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "6eb8178e-69c3-4a93-8af0-2a5a0f5f209e", "eventName": "ListIdentities", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:03:27Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "a0a4de7a-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "identityType": "Domain", "maxItems": 10 }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "a18a9745-d06a-43e9-aad0-8eee4de50f48", "eventName": "ListVerifiedEmailAddresses", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51ad8a66-ab23-11e4-9106-5b36376f9d12", "requestParameters": null, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "da975f45-e68b-4499-8e3f-31a89140e0c9", "eventName": "SetIdentityDkimEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:01:24Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5731c4ab-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "dkimEnabled": true, "identity": "example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "5d817126-dadb-436f-b480-f9843289f487", "eventName": "SetIdentityFeedbackForwardingEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51dd4cf8-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "forwardingEnabled": true, "identity": "example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "5d817126-dadb-436f-b480-f9843289f487", "eventName": "SetIdentityHeadersInNotificationsEnabled", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:51Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "51dd4cf8-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "enabled": true, "identity": "example.com", "notificationType": "Bounce" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "1a31fd43-55ba-4ce7-b3fe-55659e8144c0", "eventName": "SetIdentityNotificationTopic", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:59:21Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "0d553aac-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "identity": "example.com", "notificationType": "Bounce", "snsTopic": "arn:aws:sns:us-west-2:123456789100:MyTopic" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "aec73edb-6dac-4503-81bb-cca1102f959e", "eventName": "VerifyDomainDkim", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:52Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "52215ada-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "domain": "example.com" }, "responseElements": { "dkimTokens": [ "3r2ultrqtelopya3v2apjulcvz7z5n5o", "yexya47xmy5f3j3e7vgm6pcrcmayu6nu", "wtlduqduorhmb2vdt2m53yqlcj2m6tpw" ] }, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "33b3e2eb-7ba3-460b-a127-a5f4cedb4469", "eventName": "VerifyDomainIdentity", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T00:59:21Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "0d9c2ebe-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "disableEmailNotifications": false, "domain": "example.com" }, "responseElements": { "verificationToken": "pmBGN/7MjnfhTKUZ06Enqq1PeGUaOkw8lGhcfwefcHU=" }, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "eb2e1616-2b7b-4cd2-b6dc-29f83fc1789f", "eventName": "VerifyEmailAddress", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-02T21:34:53Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "5265ddec-ab23-11e4-9106-5b36376f9d12", "requestParameters": { "emailAddress": "user@example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } }, { "awsRegion": "us-west-2", "eventID": "5613b0ff-d6c6-4526-9b53-a603a9231725", "eventName": "VerifyEmailIdentity", "eventSource": "ses.amazonaws.com", "eventTime": "2015-02-04T01:05:33Z", "eventType": "AwsApiCall", "eventVersion": "1.02", "recipientAccountId": "111122223333", "requestID": "eb2ff803-ac09-11e4-8ff5-a56a3119e253", "requestParameters": { "emailAddress": "user@example.com" }, "responseElements": null, "sourceIPAddress": "192.0.2.0", "userAgent": "aws-sdk-java/unknown-version", "userIdentity": { "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "accountId": "111122223333", "arn": "arn:aws:iam::111122223333:root", "principalId": "111122223333", "type": "Root" } } ] }