本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为以下各项配置亚马逊SNS通知 CloudTrail
当您向 Amazon S3 存储桶 CloudTrail 发布新的日志文件时,您会收到通知。您可以使用亚马逊简单通知服务 (AmazonSNS) 管理通知。
通知是可选的。如果您需要通知,则可以配置 CloudTrail 为每当发送新的日志文件时,向 Amazon SNS 主题发送更新信息。要接收这些通知,您可以使用 Amazon 订SNS阅该主题。作为订阅者,您可以将更新发送到亚马逊简单队列服务 (AmazonSQS) 队列,这使您能够以编程方式处理这些通知。
配置 CloudTrail 为发送通知
在 CloudTrail 控制台上,您可以在创建或更新跟踪时启用SNS通知传送选项,将跟踪配置为使用 Amazon SNS 主题。如果您选择使用新主题,则会为您 CloudTrail 创建 Amazon SNS 主题并附上相应的策略,以便该主题 CloudTrail 有权发布该主题。
使用 Amazon CLI,您可以通过为--sns-topic-name
参数指定值来创建或更新跟踪以使用 Amazon SNS 主题。
创建SNS主题名称时,名称必须满足以下要求:
-
介于 1 到 256 个字符之间
-
包含大写和小写ASCII字母、数字、下划线或连字符
当您为应用于所有区域的跟踪配置通知时,来自所有区域的通知都将发送到您指定的亚马逊SNS主题。如果您有一个或多个区域特定的跟踪,须为每个区域分别创建一个主题,并单独订阅每个主题。
要接收通知,请订阅 CloudTrail 使用SNS的一个或多个亚马逊主题。您可以使用亚马逊SNS控制台或亚马逊SNSCLI命令执行此操作。有关更多信息,请参阅《亚马逊简单通知服务开发者指南》中的订阅亚马逊SNS主题。
注意
CloudTrail 当日志文件写入 Amazon S3 存储桶时会发送通知。有效账户可以生成大量通知。如果您使用电子邮件或进行订阅SMS,则可能会收到大量消息。我们建议您使用亚马逊简单队列服务 (AmazonSQS) 进行订阅,该服务允许您以编程方式处理通知。有关更多信息,请参阅《亚马逊简单SQS队列服务开发者指南》中的为亚马逊队列订阅亚马逊SNS主题(控制台)。
Amazon SNS 通知由一个包含Message
字段的JSON对象组成。此 Message
字段列出了日志文件的完整路径,如以下示例所示:
{ "s3Bucket": "amzn-s3-demo-bucket","s3ObjectKey": ["AWSLogs/123456789012/CloudTrail/us-east-2/2013/12/13/123456789012_CloudTrail_us-west-2_20131213T1920Z_LnPgDQnpkSKEsppV.json.gz"] }
如果多个日志文件都传输到了 Amazon S3 存储桶,则一条通知中可能包括多个日志,如以下示例所示:
{ "s3Bucket": "amzn-s3-demo-bucket", "s3ObjectKey": [ "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2215Z_kpaMYavMQA9Ahp7L.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2210Z_zqDkyQv3TK8ZdLr0.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2205Z_jaMVRa6JfdLCJYHP.json.gz" ] }
如果您选择通过电子邮件接收通知,则电子邮件的正文将包含 Message
字段的内容。有关JSON结构的信息,请参阅《亚马逊简单通知服务开发者指南》中的 Fanout to Amazon SQS 队列。只有该Message
字段显示 CloudTrail 信息。其他字段包含来自 Amazon SNS 服务的信息。
如果您使用创建跟踪 CloudTrail API,则可以通过CreateTrail
或UpdateTrail
操作指定要 CloudTrail 向其发送通知的现有 Amazon SNS 主题。您必须确保该主题存在,并且该主题具有允许 CloudTrail 向其发送通知的权限。请参阅 针对 CloudTrail 的 Amazon SNS 主题策略。
其他资源
有关亚马逊SNS主题和订阅这些主题的更多信息,请参阅《亚马逊简单通知服务开发者指南》。