使用 Amazon CloudTrail 记录 Amazon MQ API 调用 - Amazon MQ
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用 Amazon CloudTrail 记录 Amazon MQ API 调用

Amazon MQ 与 Amazon CloudTrail 集成,该服务提供用户、角色或Amazon服务调用 Amazon MQ 的记录。CloudTrail 将与 Amazon MQ 代理和配置相关的 API 调用作为事件捕获,包括来自 Amazon MQ 控制台的调用和来自 Amazon MQ API 的代码调用。有关 CloudTrail 的更多信息,请参阅《Amazon CloudTrail 用户指南》。

注意

CloudTrail 不会记录与 ActiveMQ 操作(例如,发送和接收消息)或 ActiveMQ Web 控制台相关的 API 调用。要记录与 ActiveMQ 操作相关的信息,您可以配置 Amazon MQ 以将常规日志和审计日志发布到 Amazon CloudWatch Logs

使用 CloudTrail 所收集的信息,可以确定向 Amazon MQ API 发出的特定请求、请求者的 IP 地址、请求者的身份、请求的日期和时间等。如果您配置了跟踪,则可以使 CloudTrail 事件持续传送到 Amazon S3 存储桶。如果没有配置跟踪,则可以在 CloudTrail 控制台中的事件历史记录中查看最新事件。有关更多信息,请参阅《Amazon CloudTrail 用户指南》https://docs.amazonaws.cn/awscloudtrail/latest/userguide/中的创建跟踪概述

CloudTrail 中的 Amazon MQ 信息

创建Amazon账户时,会启用 CloudTrail。当发生受支持的 Amazon MQ 事件时,该事件会记录在 CloudTrail 事件中,并与其他Amazon服务事件一同保存在事件历史记录中。您可以查看、搜索和下载 Amazon 账户的最新事件。有关更多信息,请参阅《Amazon CloudTrail 用户指南》中的使用 CloudTrail 事件历史记录查看事件

通过跟踪,CloudTrail 可将日志文件传送至 Amazon S3 存储桶。您可以创建跟踪以持续记录 Amazon 账户中的事件。默认情况下,在使用 Amazon Web Services Management Console创建跟踪时,此跟踪将应用于所有 Amazon 区域。此跟踪记录所有Amazon区域中的事件,并将日志文件传送至指定的 Amazon S3 存储桶。您还可以配置其他Amazon服务,进一步分析在 CloudTrail 日志中收集的事件数据并采取措施。有关更多信息,请参阅 Amazon CloudTrail 用户指南 中的以下主题:

Amazon MQ 支持将以下 API 的请求参数和响应作为事件记录在 CloudTrail 日志文件中:

注意

当您重新启动代理时,会记录 RebootBroker 日志文件。在维护窗口期间,服务会自动重新启动,并且不会记录 rebootBroker 日志文件。

重要

对于以下 API 的 GET 方法,将会记录请求参数,但会掩蔽响应:

对于以下 API,通过星号 (data) 隐藏了 password*** 请求参数:

每个事件或日志条目都包含有关请求者的信息。此信息可帮助您确定以下内容:

  • 请求是使用根用户凭证还是 用户凭证发出的?

  • 请求是使用角色还是联合身份用户的临时安全凭证发出的?

  • 请求是否由其他 Amazon 服务发出?

有关更多信息,请参阅《Amazon CloudTrail 用户指南》中的 CloudTrail userIdentity 元素

示例 Amazon MQ 日志文件条目

跟踪是一种配置,可用于将事件作为日志文件传送到指定的 Amazon S3 存储桶。CloudTrail 日志文件包含一个或多个日志条目。

事件表示来自任何源的单个请求,其中包括有关对 Amazon MQ API 的请求、请求者的 IP 地址、请求者的身份、请求的日期和时间等的信息。

以下示例说明 CreateBroker API 调用的 CloudTrail 日志条目。

注意

因为 CloudTrail 日志文件不是公用 API 的有序堆栈跟踪,所以它们不会按任何特定顺序列出信息。

{ "eventVersion": "1.06", "userIdentity": { "type": "IAMUser", "principalId": "AKIAIOSFODNN7EXAMPLE", "arn": "arn:aws:iam::111122223333:user/AmazonMqConsole", "accountId": "111122223333", "accessKeyId": "AKIAI44QH8DHBEXAMPLE", "userName": "AmazonMqConsole" }, "eventTime": "2018-06-28T22:23:46Z", "eventSource": "amazonmq.amazonaws.com", "eventName": "CreateBroker", "awsRegion": "us-west-2", "sourceIPAddress": "203.0.113.0", "userAgent": "PostmanRuntime/7.1.5", "requestParameters": { "engineVersion": "5.15.9", "deploymentMode": "ACTIVE_STANDBY_MULTI_AZ", "maintenanceWindowStartTime": { "dayOfWeek": "THURSDAY", "timeOfDay": "22:45", "timeZone": "America/Los_Angeles" }, "engineType": "ActiveMQ", "hostInstanceType": "mq.m5.large", "users": [ { "username": "MyUsername123", "password": "***", "consoleAccess": true, "groups": [ "admins", "support" ] }, { "username": "MyUsername456", "password": "***", "groups": [ "admins" ] } ], "creatorRequestId": "1", "publiclyAccessible": true, "securityGroups": [ "sg-a1b234cd" ], "brokerName": "MyBroker", "autoMinorVersionUpgrade": false, "subnetIds": [ "subnet-12a3b45c", "subnet-67d8e90f" ] }, "responseElements": { "brokerId": "b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9", "brokerArn": "arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9" }, "requestID": "a1b2c345-6d78-90e1-f2g3-4hi56jk7l890", "eventID": "a12bcd3e-fg45-67h8-ij90-12k34d5l16mn", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }