翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# データイベントの集約
<a name="aggregating-data-events"></a>

データイベントでは、リソース上またはリソース内で実行されたリソースオペレーションについての情報が得られます。これらのイベントは、データプレーンオペレーションとも呼ばれます。データイベントは、多くの場合、高ボリュームのアクティビティです。

データイベントの集約を有効にすると、大量の個々のイベントを処理することなく、大量のデータアクセスパターンを効率的にモニタリングできます。この機能により、データイベントが 5 分の要約に自動的に統合され、アクセス頻度、エラー率、最もよく使用されるアクションなどの主要な傾向が表示されます。例えば、数千の個々の S3 バケットアクセスイベントを処理して使用パターンを理解する代わりに、トップユーザーとアクションを示す統合概要を受け取ります。

新しい証跡を作成するとき、またはデータイベントを収集する既存の証跡を更新するときに、データイベントの集約を有効にできます。3 つのout-of-the-boxテンプレートの 1 つまたはすべてを選択して、データイベントを集約できます。
+ **API **アクティビティ: 実行された API コールに基づいて、データイベントの概要を 5 分間取得します。これを使用して、頻度、発信者、ソースなど、API の使用パターンを理解します。
+ リソースのアクティビティパターンを取得するための AWS リソース**アクセス**。これを使用して、 AWS リソースへのアクセス方法、5 分間のウィンドウでアクセスされる回数、リソースにアクセスするユーザー、実行されるアクションを理解します。
+ **ユーザー** アカウントで API コールを行う IAM プリンシパルに基づいてアクティビティパターンを取得するアクション。

## コンソールを使用してデータイベントの集計を有効にする
<a name="aggregating-data-events-console"></a>

証跡の集計を有効にするには、証跡を作成または更新し、証跡のイベントをログに記録するようにデータイベントを設定するときに、まずデータイベントのログ記録を選択します。次に、イベント集約の設定ステップで、以下のスクリーンショットに示すように、集約テンプレートドロップダウンから **API アクティビティ**や**リソースアクセス**などのテンプレートを選択できます。

![\[API アクティビティとリソースアクセスオプションが選択された集約テンプレートドロップダウンを示す CloudTrail コンソールのスクリーンショット\]](http://docs.aws.amazon.com/ja_jp/awscloudtrail/latest/userguide/images/Enable-Aggregation-console.png)


## を使用してデータイベントの集計を有効にする AWS CLI
<a name="aggregating-data-events-cli"></a>

を使用してイベントを集約するように証跡を設定できます AWS CLI。

証跡がデータイベントを集約しているかどうかを確認するには、 `get-event-configurations` コマンドを実行します。

```
aws cloudtrail get-event-configuration --region us-east-1 --trail-name TrailName
```

コマンドは、証跡の集約設定を返します。

イベント集約を有効にする前に、証跡を作成し、その中にデータイベントを設定する必要があります。

証跡でイベント集約を有効にするには、以下のステップに従います。証跡は、 `API_ACTIVITY`および 集約テンプレートに基づいてイベントを`RESOURCE_ACCESS`集約します。

```
aws cloudtrail put-event-configuration --region us-east-1 --trail TrailName \
--aggregation-configurations \
'[
    {
        "EventCategory": "Data",
        "Templates":
        [
            "API_ACTIVITY",
            "RESOURCE_ACCESS"
        ]
    }
]'
```

### 例: API\$1ACTIVITY 集計イベント
<a name="aggregating-data-events-api-activity-example"></a>

テンプレートの集計イベントの例を次に示します`API_ACTIVITY`。

```
{
    "eventVersion": "1.0",
    "accountId": "111122223333",
    "eventId": "62759c1a-6248-48e1-a6b3-d5fb7e6c4bc0",
    "eventCategory": "Aggregated",
    "eventType": "AwsAggregatedEvent",
    "awsRegion": "us-west-2",
    "eventSource": "s3.amazonaws.com",
    "timeWindow":
    {
        "windowStart": "2025-11-17T19:20:00Z",
        "windowEnd": "2025-11-17T19:25:00Z",
        "windowSize": "PT5M"
    },
    "summary":
    {
        "primaryDimension":
        {
            "dimension": "eventName",
            "statistics":
            [
                {
                    "name": "PutObject",
                    "value": 1000
                }
            ],
            "aggregationType": "Count"
        },
        "details":
        [
            {
                "dimension": "resourceARN",
                "statistics":
                [
                    {
                        "name": "arn:aws:s3:::bucket-1",
                        "value": 800
                    },
                    {
                        "name": "arn:aws:s3:::bucket-2",
                        "value": 150
                    },
                    {
                        "name": "arn:aws:s3:::bucket-3",
                        "value": 50
                    }
                ],
                "aggregationType": "Count"
            }
        ]
    }
}
```

### 例: RESOURCE\$1ACCESS 集計イベント
<a name="aggregating-data-events-resource-access-example"></a>

テンプレートの集計イベントの例を次に示します`RESOURCE_ACCESS`。

```
{
    "eventVersion": "1.0",
    "accountId": "111122223333",
    "eventId": "2ed87efa-45c1-412d-bc38-7e0879faa6df",
    "eventCategory": "Aggregated",
    "eventType": "AwsAggregatedEvent",
    "awsRegion": "us-west-2",
    "eventSource": "s3.amazonaws.com",
    "timeWindow":
    {
        "windowStart": "2025-11-17T19:20:00Z",
        "windowEnd": "2025-11-17T19:25:00Z",
        "windowSize": "PT5M"
    },
    "summary":
    {
        "primaryDimension":
        {
            "dimension": "resourceARN",
            "statistics":
            [
                {
                    "name": "arn:aws:s3:::bucket-1",
                    "value": 800
                }
            ],
            "aggregationType": "Count"
        },
        "details":
        [
            {
                "dimension": "eventName",
                "statistics":
                [
                    {
                        "name": "PutObject",
                        "value": 800
                    }
                ],
                "aggregationType": "Count"
            }
        ]
    }
}
```