CloudTrail 见解insightDetails元素 - Amazon CloudTrail
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

CloudTrail 见解insightDetails元素

Amazon CloudTrail Insights 事件记录包括与其JSON结构中其他 CloudTrail 事件不同的字段,有时称为有效载荷。 CloudTrail Insights 事件记录包括一个insightDetails块,其中包含有关 Insights 事件底层触发器的信息,例如事件源、用户身份、用户代理、历史平均值或基线、统计数据、API名称以及该事件是 Insights 事件的开始还是结束。insightDetails 数据块包含以下信息。

  • state - 事件是开始还是结束见解事件。该值可以是 StartEnd

    从:1.07

    Optional (可选):False

  • eventSource-作为异常活动来源的 Amazon 服务端点,例如ec2.amazonaws.com

    从:1.07

    Optional (可选):False

  • eventName-Insights 事件的名称,通常API是异常活动来源的名称。

    从:1.07

    Optional (可选):False

  • insightType - 见解事件的类型。该值可以是 ApiCallRateInsight 和/或 ApiErrorRateInsight

    从:1.07

    Optional (可选):False

  • insightContext -

    有关 Amazon 工具(称为用户代理)、用户和角色(称为IAM用户身份)以及与为生成 Insights 事件而 CloudTrail 分析的事件关联的错误代码的信息。此元素还包括统计信息,显示了 Insights 事件中的异常活动与基准或正常活动对比的情况。

    从:1.07

    Optional (可选):False

    • statistics-包括以下数据:在基准时段内测得的账户对主题API的通话或出错的典型平均比率、Insights 事件第一分钟触发 Insights 事件的平均呼叫或错误率、Insights 事件的持续时间(以分钟为单位)以及基线测量周期的持续时间(以分钟为单位)。

      从:1.07

      Optional (可选):False

      • baseline-在账户的 Insights 事件主题的基准持续时间内,每分钟平均API调API用或出错次数,计算得出在 Insights 事件开始前七天内。

        从:1.07

        Optional (可选):False

      • insight -

        对于起始的 Insights 事件,此值是异常活动开始期间每分钟平均API调用次数或错误数。对于已结束的 Insights 事件,此值是异常活动持续时间内每分钟的平均API呼叫或错误数。

        从:1.07

        Optional (可选):False

      • insightDuration-Insights 事件的持续时间,以分钟为单位(从主题上异常活动开始到结束的时间段API)。 insightDuration出现在开始和结束的 Insights 事件中。

        从:1.07

        Optional (可选):False

      • baselineDuration-基准期(测量受试者正常活动的时间段API)的持续时间,以分钟为单位。 baselineDuration至少在 Insights 事件发生前七天(10080 分钟)。此字段同时出现在开始和结束见解事件中。baselineDuration 测量的结束时间始终是见解事件的开始。

        从:1.07

        Optional (可选):False

    • attributions - 此数据块包含有关与异常活动和基准活动相关的用户身份、用户代理和错误代码的信息。在见解事件 attributions 数据块中捕获最多五个用户身份、五个用户代理和五个错误代码,按活动计数的平均值,从最高到最低的降序排列。

      从:1.07

      Optional (可选):True

      • attribute - 包含属性类型。值可以是 userIdentityArnuserAgenterrorCode

        • userIdentityArn-一个区块,显示在异常活动和基准时段内导致API通话或错误的前五名 Amazon 用户或IAM角色。另请参阅 CloudTrail 录制内容 中的 userIdentity

          从:1.07

          Optional (可选):False

          • insight-一个区块,显示在异常活动期间拨API打的电话的前五名用户身份ARNs,按从最大到最小的降序排列。API它还显示了用户身份在异常活动期间API拨打的平均呼叫次数。

            从:1.07

            Optional (可选):False

            • value-导致在ARN异常活动期间API拨打电话的前五名用户身份之一。

              从:1.07

              Optional (可选):False

            • average-value 现场用户身份在异常活动期间每分钟API调用或出错的次数。

              从:1.07

              Optional (可选):False

          • baseline-一个区块,显示在正常活动期间ARNs导致API呼叫或错误最多的前五名用户身份。它还显示用户身份在正常活动期间记录的平均API呼叫或错误数。

            从:1.07

            Optional (可选):False

            • value-ARN 在正常活动期间导致API呼叫或错误的前五名用户身份之一。

              从:1.07

              Optional (可选):False

            • average-现场用户身份在 Insights 活动开始之前的七天内,每分钟API调用或错误的历史平均value值。

              从:1.07

              Optional (可选):False

        • userAgent-一个方块,显示了在异常活动和基准时段内,用户身份是用来API促成通话的前五个 Amazon 工具。这些工具包括 Amazon Web Services Management Console Amazon CLI、或 Amazon SDKs。另请参阅 CloudTrail 录制内容 中的 userAgent

          从:1.07

          Optional (可选):False

          • insight-一个区块,显示在异常活动期间促成API呼叫的前五名用户代理,按从最大呼API叫次数到最小的降序排列。它还显示了用户代理在异常活动期间记录的平均API呼叫或错误数。

            从:1.07

            Optional (可选):False

            • value-在异常活动期间促成API通话的前五名用户代理之一。

              从:1.07

              Optional (可选):False

            • average-value 现场用户代理在异常活动期间每分钟记录的API呼叫或错误数。

              从:1.07

              Optional (可选):False

          • baseline-一个方块,显示在正常活动期间对拨打的API呼叫贡献最大的前五名用户代理。它还显示了用户代理在正常活动期间记录的平均API呼叫或错误数。

            从:1.07

            Optional (可选):False

            • value-导致正常活动期间记录的API呼叫或错误的前五名用户代理之一。

              从:1.07

              Optional (可选):False

            • average-现场用户代理在 Insights 活动开始之前的七天内,每分钟API调用或错误的历史平均value值。

              从:1.07

              Optional (可选):False

        • errorCode-一个区块,显示在异常活动和基准时段内API呼叫中出现的前五个错误代码,按从最大API呼叫次数到最小的降序排列。另请参阅 CloudTrail 录制内容 中的 errorCode

          从:1.07

          Optional (可选):False

          • insight-一个区块,显示在异常活动期间拨打的API呼叫中出现的前五个错误代码,按从最大关联API呼叫数到最小的降序排列。它还显示了异常活动期间发生错误的平均API呼叫数。

            从:1.07

            Optional (可选):False

            • value-在异常活动期间拨打的API呼叫中出现的前五个错误代码之一,例如AccessDeniedException

              如果触发见解事件的任何调用都不会导致错误,则此值为 null

              从:1.07

              Optional (可选):False

            • average-在异常活动期间每分钟针对该value字段错误代码的API呼叫次数。

              如果错误代码值为 null,并且 insight 数据块中没有其他错误代码,则 average 的值与表现见解事件总体的 statistics 数据块中的值相同。

              从:1.07

              Optional (可选):False

          • baseline-一个方块,显示在正常活动期间拨打的API呼叫中出现的前五个错误代码。它还显示了用户代理在正常活动期间API拨打的平均呼叫数。

            从:1.07

            Optional (可选):False

            • value-正常活动期间拨打的API呼叫中出现的前五个错误代码之一,例如AccessDeniedException

              从:1.07

              Optional (可选):False

            • average-value 字段中错误代码在 Insights 活动开始之前的七天内,每分钟API调用或错误的历史平均值。

              从:1.07

              Optional (可选):False

示例 insightDetails 数据块

以下是 Insights 事件的 Insights 事件insightDetails块示例,该事件在 Application Auto Scaling API CompleteLifecycleAction 被调用次数异常时发生。有关完整见解事件的示例,请参阅 洞察活动

此示例来自开始见解事件,通过 "state": "Start" 表示。attributions区块中显示了调用与 Insights 事件APIs关联的排名靠前的用户身份CodeDeployRole3、、和,以及他们对此 Insights 事件的平均API通话费率以及该CodeDeployRole1角色的基准。CodeDeployRole1 CodeDeployRole2attributions区块还显示用户代理是codedeploy.amazonaws.com,这意味着顶级用户身份使用 Amazon CodeDeploy 控制台来运行API呼叫。

因为没有与为了生成见解事件而分析的事件相关的错误代码(值为 null),错误代码的 insight 平均值与整个见解事件的总体 insight 平均值相同,显示在 statistics 数据块中。

"insightDetails": { "state": "Start", "eventSource": "autoscaling.amazonaws.com", "eventName": "CompleteLifecycleAction", "insightType": "ApiCallRateInsight", "insightContext": { "statistics": { "baseline": { "average": 0.0000882145 }, "insight": { "average": 0.6 }, "insightDuration": 5, "baselineDuration": 11336 }, "attributions": [ { "attribute": "userIdentityArn", "insight": [ { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1", "average": 0.2 }, { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole2", "average": 0.2 }, { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole3", "average": 0.2 } ], "baseline": [ { "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1", "average": 0.0000882145 } ] }, { "attribute": "userAgent", "insight": [ { "value": "codedeploy.amazonaws.com", "average": 0.6 } ], "baseline": [ { "value": "codedeploy.amazonaws.com", "average": 0.0000882145 } ] }, { "attribute": "errorCode", "insight": [ { "value": "null", "average": 0.6 } ], "baseline": [ { "value": "null", "average": 0.0000882145 } ] } ] } }