使用 Amazon CLI 记录 Insights 事件 - Amazon CloudTrail
使用 Amazon CLI 记录跟踪记录的 Insights 事件
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用 Amazon CLI 记录 Insights 事件

您可以使用 Amazon CLI 配置跟踪和事件数据存储以记录 Insights 事件。

注意

要针对 API 调用率记录 Insights 事件，跟踪必须记录 write 管理事件。要针对 API 错误率记录 Insights 事件，跟踪必须记录 read 或 write 管理事件。

使用 Amazon CLI 记录跟踪记录的 Insights 事件

要返回跟踪的当前 Insights 选择器，请运行 get-insight-selectors 命令。

aws cloudtrail get-insight-selectors --trail-name TrailName

以下示例响应显示了名为 insights-trail 的跟踪的 Insights 选择器。

{
    "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/insights-trail",
    "InsightSelectors": [
        {
            "InsightType": "ApiCallRateInsight"
        },
        {
            "InsightType": "ApiErrorRateInsight"
        }
    ]
}

如果跟踪未启用 Insights，则 get-insight-selectors 命令将返回以下错误消息：调用 GetInsightSelectors 操作时出现错误 (InsightNotEnabledException)：Trail arn:aws:cloudtrail:us-east-1:123456789012:trail/trailName 未启用 Insights。Edit the trail settings to enable Insights, and then try the operation again.”

要将跟踪配置为记录 Insights 事件，请运行 put-insight-selectors 命令。以下示例说明如何配置跟踪以包含 Insights 事件。Insights 选择器值可以是 ApiCallRateInsight 和/或 ApiErrorRateInsight。

aws cloudtrail put-insight-selectors --trail-name TrailName --insight-selectors '[{"InsightType": "ApiCallRateInsight"},{"InsightType": "ApiErrorRateInsight"}]'

以下结果显示为跟踪配置的 Insights 事件选择器。

{
  "TrailARN": "arn:aws:cloudtrail:us-east-1:123456789012:trail/TrailName",
  "InsightSelectors":
      [
         {
            "InsightType": "ApiErrorRateInsight"
         },
         {
            "InsightType": "ApiCallRateInsight"
         }
      ]
 }