Insights イベント構造の概要と例 - ActionTrail - Alibaba Cloud ドキュメントセンター

このトピックでは、Insights イベントの主要なフィールドと例について説明します。

主要フィールド

名前	説明
eventVersion	Insights イベント形式のバージョン。現在のバージョンは 1 です。
eventType	イベントタイプ。値は `ActionTrailInsight` で、インサイトイベントであることを示します。
eventCategory	イベントのカテゴリ。値は `Insight` であり、Insights イベントを示します。
eventId	イベント ID。
eventTime	イベントが生成された時刻 (UTC)。
acsRegion	イベントが発生したリージョン。
recipientAccountId	イベントを受信する Alibaba Cloud アカウント ID。
sharedEventId	Insights イベントに関連する管理イベントの ID。
insightDetails	Insights イベントの詳細。詳細については、「InsightDetails のフィールド」をご参照ください。

表 1. InsightDetails のフィールド

名前	説明
state	Insights イベントの状態。
insightType	Insights イベントのタイプ。有効な値は次のとおりです。 IpInsight：異常な IP アドレス呼び出しイベント。 ApiCallRateInsight：異常な API 呼び出しレートイベント。 ApiErrorRateInsight：異常な API エラー率イベント。 AkInsight：異常な AccessKey 呼び出しレートイベント。 PolicyChangeInsight：権限変更イベント。 PasswordChangeInsight：パスワード変更イベント。 TrailConcealmentInsight：トレイル隠蔽イベント。
insightObject	Insights イベントの分析対象。値は insightType によって異なります。 `insightType` が `IpInsight` の場合、値は IP アドレスです。 `insightType` が `ApiCallRateInsight` の場合、値は製品名またはイベント名です。 `insightType` が `ApiErrorRateInsight` の場合、値は製品名、イベント名、またはエラーコードです。 `insightType` が `AkInsight` の場合、値は AccessKey ID です。 `insightType` が `PolicyChangeInsight`、`PasswordChangeInsight`、または `TrailConcealmentInsight` の場合、値は製品名です。
insightContext	Insights イベントに関する追加情報。詳細については、「insightContext のフィールド」をご参照ください。

表 2. insightContext のフィールド

名前

説明

attributions

複数ディメンションからの集約および分析結果。

詳細については、「attributions のフィールド」をご参照ください。

statistics

統計分析結果。

詳細については、「statistics のフィールド」をご参照ください。

表 3. attributions のフィールド

名前	説明
attribution	複数ディメンションからの集約および分析結果。情報はイベントタイプによって異なります。 `IpInsight` イベントの場合、属性は `userAgent`、`principalId`、`apiRelated`、`errorCode` です。 `ApiCallRateInsight` イベントの場合、属性は `userAgent`、`principalId`、`errorCode` です。 `ApiErrorRateInsight` イベントの場合、属性は `userAgent` と `principalId` です。 `AkInsight` イベントの場合、属性は `userAgent`、`apiRelated`、`ipRelated`、`errorCode` です。 `PolicyChangeInsight`、`PasswordChangeInsight`、および `TrailConcealmentInsight` イベントの場合、属性は `{ProductName}/{EventName}/{AttributeName}` 形式の複合文字列です。例：`Actiontrail/DeleteTrail/userAgent`。
insight	Insights イベントの測定データ。
baseline	Insights イベントのベースラインデータ。

表 4. statistics のフィールド

名前	説明
insight	Insights イベントの測定データ。
insightDuration	Insights イベントの期間 (分)。単位は分です。
baseline	Insights イベントのベースラインデータ。
baselineDuration	ベースラインの期間 (分)。単位は分です。
insightCount	Insights イベントの期間中に発生した管理イベントの数。

例

IpInsight

{
      "eventId": "493C2E32-F83B-4267-8050-314C8E77094A",
      "eventCategory": "Insight",
      "sharedEventId": "5A72E7C7-95A8-4213-9AA1-6138492977A3",
      "eventVersion": "1",
      "eventTime": "2023-07-24T03:27:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 2,
                  "value": "JavaSDK Revision:9760a99 Version:0.43.3 JavaVersion:1.8.0_212 CLT(0.43.2 : 9226976); Linux(169.254.224.20/cn-hangzhou-99x4c3iojty1by1bb6x3if2****)"
                }
              ],
              "attribute": "userAgent"
            },
            {
              "insight": [
                {
                  "average": 2,
                  "value": "28413042062885****"
                }
              ],
              "attribute": "principalId"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "MaxCompute/JobChange"
                },
                {
                  "average": 1,
                  "value": "MaxCompute/InsertJob"
                }
              ],
              "attribute": "apiRelated"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "ODPS-0130071"
                },
                {
                  "average": 1,
                  "value": "null"
                }
              ],
              "attribute": "errorCode"
            }
          ],
          "statistics": {
            "insight": {
              "average": 2,
              "predict": 0
            },
            "insightDuration": 1,
            "baseline": {
              "threshold": 0.6
            },
            "insightCount": 2
          }
        },
        "sourceIpAddress": "22.17.XX.XX",
        "state": "Start",
        "insightType": "IpInsight"
      },
      "acsRegion": "cn-hangzhou",
      "eventType": "ActionTrailInsight"
    }

ApiCallRateInsight

{
      "eventId": "2AA62459-79F4-4AA4-B729-F6C90369E91F",
      "eventCategory": "Insight",
      "sharedEventId": "5A3499B4-5446-40B3-87BF-7D1603CA4ED0",
      "eventVersion": "1",
      "eventTime": "2023-07-25T00:31:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 364,
                  "value": "JavaSDK Revision:046519a Version:0.40.14 JavaVersion:1.8.0_212 DATAX"
                }
              ],
              "attribute": "userAgent",
              "baseline": [
                {
                  "average": 526.2147,
                  "value": "JavaSDK Revision:046519a Version:0.40.14 JavaVersion:1.8.0_212 DATAX"
                },
                {
                  "average": 125.13071,
                  "value": "JavaSDK Revision:dc3569f Version:0.40.4 JavaVersion:1.8.0_212 DATAX"
                },
                {
                  "average": 0.13817,
                  "value": "JavaSDK Revision:046519a Version:0.40.14 JavaVersion:1.8.0_112 DATAX"
                },
                {
                  "average": 0.03728,
                  "value": "JavaSDK Revision:dc3569f Version:0.40.4 JavaVersion:1.8.0_112 DATAX"
                },
                {
                  "average": 0.04539,
                  "value": "others"
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 364,
                  "value": "21781321968501****"
                }
              ],
              "attribute": "principalId",
              "baseline": [
                {
                  "average": 651.50726,
                  "value": "21781321968501****"
                },
                {
                  "average": 0.04539,
                  "value": "29645888701658****"
                },
                {
                  "average": 0.01359,
                  "value": "116214297662****"
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 364,
                  "value": "null"
                }
              ],
              "attribute": "errorCode",
              "baseline": [
                {
                  "average": 651.5663,
                  "value": "null"
                }
              ]
            }
          ],
          "statistics": {
            "baselineDuration": 6036,
            "insight": {
              "average": 364
            },
            "insightDuration": 1,
            "baseline": {
              "average": 8.35901
            }
          }
        },
        "state": "Start",
        "insightType": "ApiCallRateInsight",
        "insightObject": "MaxCompute/UploadTable"
      },
      "acsRegion": "cn-shanghai",
      "eventType": "ActionTrailInsight"
    }

ApiErrorRateInsight

{
      "eventId": "D8A2E554-6030-4759-AC86-39D9A6657141",
      "eventCategory": "Insight",
      "sharedEventId": "1D5E87F8-74BD-4602-A46F-15D121A40076",
      "eventVersion": "1",
      "eventTime": "2023-07-24T05:55:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 10,
                  "value": "pre-actiontrail.console.alibabacloud.com"
                }
              ],
              "attribute": "userAgent",
              "baseline": [
                {
                  "average": 0.00128,
                  "value": "actiontrail.console.alibabacloud.com"
                },
                {
                  "average": 0.00035,
                  "value": "pre-actiontrail.console.alibabacloud.com"
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 10,
                  "value": "29228928693846****"
                }
              ],
              "attribute": "principalId",
              "baseline": [
                {
                  "average": 0.00055,
                  "value": "29228928693846****"
                },
                {
                  "average": 0.00036,
                  "value": "22849585603625****"
                },
                {
                  "average": 0.00029,
                  "value": "20760722332912****"
                },
                {
                  "average": 0.00024,
                  "value": "28162628619075****"
                },
                {
                  "average": 0.00018,
                  "value": "others"
                }
              ]
            }
          ],
          "statistics": {
            "baselineDuration": 82210,
            "insight": {
              "average": 10
            },
            "insightDuration": 1,
            "baseline": {
              "average": 0.00081
            }
          }
        },
        "state": "Start",
        "insightType": "ApiErrorRateInsight",
        "insightObject": "Actiontrail/GetTrailStatus/TrailNotFoundException"
      },
      "acsRegion": "cn-shanghai",
      "eventType": "ActionTrailInsight"
    }

AkInsight

{
      "eventId": "36DD0E98-00C4-42F5-9FE9-6E4EDCD69C0B",
      "eventCategory": "Insight",
      "sharedEventId": "7E31028F-9C6F-4BDF-83C7-68A70930CEBD",
      "eventVersion": "1",
      "eventTime": "2023-07-24T20:06:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 194,
                  "value": "Tunnel C++ SDK, ee4d58de889e126667fdc13608058f3487596b72."
                }
              ],
              "attribute": "userAgent",
              "baseline": [
                {
                  "average": 0.44587,
                  "value": "Tunnel C++ SDK, ee4d58de889e126667fdc13608058f3487596b72."
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 194,
                  "value": "MaxCompute/DownloadTable"
                }
              ],
              "attribute": "apiRelated",
              "baseline": [
                {
                  "average": 0.44587,
                  "value": "MaxCompute/DownloadTable"
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 194,
                  "value": "null"
                }
              ],
              "attribute": "errorCode",
              "baseline": [
                {
                  "average": 0.44587,
                  "value": "null"
                }
              ]
            },
            {
              "insight": [
                {
                  "average": 194,
                  "value": "Internal"
                }
              ],
              "attribute": "ipRelated",
              "baseline": [
                {
                  "average": 0.44587,
                  "value": "Internal"
                }
              ]
            }
          ],
          "statistics": {
            "baselineDuration": 9976,
            "insight": {
              "average": 194
            },
            "insightDuration": 1,
            "baseline": {
              "average": 0.2066
            }
          }
        },
        "state": "Start",
        "insightType": "AkInsight",
        "insightObject": "LTAI****************"
      },
      "acsRegion": "cn-shanghai",
      "eventType": "ActionTrailInsight"
    }

PasswordChangeInsight、PolicyChangeInsight、および TrailConcealmentInsight

{
      "eventId": "B0DB3701-3438-41D4-9AA5-CABE8F20AEE0",
      "eventCategory": "Insight",
      "sharedEventId": "1003F2A8-B4B4-4AFC-8F3C-07FD45886F47",
      "eventVersion": "1",
      "eventTime": "2023-07-24T05:55:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 1,
                  "value": "pre-actiontrail.console.alibabacloud.com"
                }
              ],
              "attribute": "Actiontrail/DeleteTrail/userAgent"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "null"
                }
              ],
              "attribute": "Actiontrail/DeleteTrail/accessKeyId"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "29228928693846****"
                }
              ],
              "attribute": "Actiontrail/DeleteTrail/principalId"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "null"
                }
              ],
              "attribute": "Actiontrail/DeleteTrail/errorCode"
            },
            {
              "insight": [
                {
                  "average": 1,
                  "value": "Internal"
                }
              ],
              "attribute": "Actiontrail/DeleteTrail/ipRelated"
            }
          ]
        },
        "state": "Start",
        "insightType": "TrailConcealmentInsight",
        "insightObject": "Actiontrail"
      },
      "acsRegion": "cn-shanghai",
      "eventType": "ActionTrailInsight"
    }