# Amazon ECS サービスアクションイベント
<a name="ecs_service_events"></a>

Amazon ECS は、詳細タイプ **ECS サービスアクション**のサービスアクションイベントを送信します。コンテナインスタンスおよびタスク状態変更イベントとは異なり、サービスアクションイベントの `details` レスポンスフィールドにバージョン番号は含まれません。次に、Amazon ECS サービス アクションイベントの EventBridge ルールを作成するために使用されるイベントパターンを示します。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Getting started with EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)」を参照してください。

```
{
    "source": [
        "aws.ecs"
    ],
    "detail-type": [
        "ECS Service Action"
    ]
}
```

Amazon ECS は、`INFO`、`WARN`、`ERROR` イベントタイプのイベントを送信します。以下はサービスアクションイベントです。

## `INFO` イベントタイプのサービスアクションイベント
<a name="ecs_service_events_info_type"></a>

`SERVICE_STEADY_STATE`  
サービスは正常であり、目的のタスクの数であるため、安定した状態に達します。サービススケジューラは定期的にステータスを報告するため、このメッセージを複数回受信する場合があります。

`TASKSET_STEADY_STATE`  
タスクセットは正常で、目的のタスクの数であるため、定常状態に達します。

`CAPACITY_PROVIDER_STEADY_STATE`  
サービスに関連付けられたキャパシティープロバイダーが定常状態に達します。

`SERVICE_DESIRED_COUNT_UPDATED`  
サービススケジューラが、サービスまたはタスクセットに対して計算された目的のカウントを更新するとき。このイベントは、目的のカウントがユーザーによって手動で更新されるときには送信されません。

`TASKS_STOPPED`  
サービスが実行中のタスクを停止しました。

`SERVICE_DEPLOYMENT_IN_PROGRESS`  
サービスデプロイが進行中です。サービスデプロイは、ロールバックまたは新しいサービスリビジョンのいずれかです。

`SERVICE_DEPLOYMENT_COMPLETED`  
サービスデプロイが定常状態であり、完了しています。サービスデプロイは、ロールバック、または更新されたサービスリビジョンのデプロイのいずれかです。

## `WARN` イベントタイプのサービスアクションイベント
<a name="ecs_service_events_warn_type"></a>

`SERVICE_TASK_START_IMPAIRED`  
サービスは一貫してタスクを正常に起動することができません。

`SERVICE_DISCOVERY_INSTANCE_UNHEALTHY`  
サービス検出を使用するサービスに、異常なタスクが含まれています。サービススケジューラは、サービスレジストリ内のタスクが正常でないことを検出します。

`VPC_LATTICE_TARGET_UNHEALTHY`  
VPC Lattice を使用するサービスが、VPC Lattice のターゲットの 1 つに異常を検出しました。

## `ERROR` イベントタイプのサービスアクションイベント
<a name="ecs_service_events_error_type"></a>

`SERVICE_DAEMON_PLACEMENT_CONSTRAINT_VIOLATED`  
`DAEMON` サービススケジューラ戦略を使用するサービス内のタスクは、サービスの配置制約戦略を満たさなくなりました。

`ECS_OPERATION_THROTTLED`  
Amazon ECS API スロットルの制限により、サービススケジューラが調整されました。

`SERVICE_DISCOVERY_OPERATION_THROTTLED`  
AWS Cloud Map API スロットルの制限により、サービススケジューラが調整されました。これは、サービス検出を使用するように設定されたサービスで発生する可能性があります。

`SERVICE_TASK_PLACEMENT_FAILURE`  
サービススケジューラがタスクを配置できません。原因は、`reason` フィールドに説明されます。  
このサービスイベントが生成される一般的な原因は、タスクを配置するためのクラスターでリソースが不足しているためです。例えば、使用可能なコンテナインスタンスに CPU またはメモリ容量が不足しているか、使用可能なコンテナインスタンスがない場合などです。もう 1 つの一般的な原因は、Amazon ECS コンテナエージェントがコンテナインスタンスで切断され、スケジューラがタスクを配置できない場合です。

`SERVICE_TASK_CONFIGURATION_FAILURE`  
設定エラーのため、サービススケジューラがタスクを配置できません。原因は、`reason` フィールドに説明されます。  
このサービスイベントが生成される一般的な原因は、タグがサービスに適用されてはいるが、ユーザーまたはロールがリージョンで新しい Amazon リソースネーム (ARN) 形式にオプトインしていないためです。詳細については、「[Amazon リソースネーム (ARN) と ID](ecs-account-settings.md#ecs-resource-ids)」を参照してください。もう 1 つの一般的な原因は、Amazon ECS が提供されたタスク IAM ロールを継承できなかったことです。

`SERVICE_HEALTH_UNKNOWN`  
サービスがタスクのヘルスデータを記述できませんでした。

`SERVICE_DEPLOYMENT_FAILED`  
サービスデプロイが定常状態に達しませんでした。これは、CloudWatch がトリガーされたとき、またはサーキットブレーカーがサービスデプロイの失敗を検出したときに発生します。

**Example サービス定常状態イベント**  
サービス定常状態イベントは、次の形式で配信されます。EventBridge パラメータの詳細については、「*Amazon EventBridge ユーザーガイド*」の「[EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。  

```
{
    "version": "0",
    "id": "af3c496d-f4a8-65d1-70f4-a69d52e9b584",
    "detail-type": "ECS Service Action",
    "source": "aws.ecs",
    "account": "111122223333",
    "time": "2019-11-19T19:27:22Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
    ],
    "detail": {
        "eventType": "INFO",
        "eventName": "SERVICE_STEADY_STATE",
        "clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
        "createdAt": "2019-11-19T19:27:22.695Z"
    }
}
```

**Example キャパシティープロバイダー定常状態イベント**  
キャパシティプロバイダーの定常状態イベントは、次の形式で配信されます。  

```
{
    "version": "0",
    "id": "b9baa007-2f33-0eb1-5760-0d02a572d81f",
    "detail-type": "ECS Service Action",
    "source": "aws.ecs",
    "account": "111122223333",
    "time": "2019-11-19T19:37:00Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
    ],
    "detail": {
        "eventType": "INFO",
        "eventName": "CAPACITY_PROVIDER_STEADY_STATE",
        "clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
        "capacityProviderArns": [
            "arn:aws:ecs:us-west-2:111122223333:capacity-provider/ASG-tutorial-capacity-provider"
        ],
        "createdAt": "2019-11-19T19:37:00.807Z"
    }
}
```

**Example サービスタスク開始障害イベント**  
サービスタスク開始障害イベントは、次の形式で配信されます。  

```
{
    "version": "0",
    "id": "57c9506e-9d21-294c-d2fe-e8738da7e67d",
    "detail-type": "ECS Service Action",
    "source": "aws.ecs",
    "account": "111122223333",
    "time": "2019-11-19T19:55:38Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
    ],
    "detail": {
        "eventType": "WARN",
        "eventName": "SERVICE_TASK_START_IMPAIRED",
        "clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
        "createdAt": "2019-11-19T19:55:38.725Z"
    }
}
```

**Example サービスタスク配置失敗イベント**  
サービスタスク配置失敗イベントは、次の形式で配信されます。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。  
次の例では、タスクは `FARGATE_SPOT` キャパシティープロバイダーを使用しようとしましたが、サービススケジューラは Fargate Spot キャパシティーを取得できませんでした。  

```
{
    "version": "0",
    "id": "ddca6449-b258-46c0-8653-e0e3a6d0468b",
    "detail-type": "ECS Service Action",
    "source": "aws.ecs",
    "account": "111122223333",
    "time": "2019-11-19T19:55:38Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
    ],
    "detail": {
        "eventType": "ERROR",
        "eventName": "SERVICE_TASK_PLACEMENT_FAILURE",
        "clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
        "capacityProviderArns": [
            "arn:aws:ecs:us-west-2:111122223333:capacity-provider/FARGATE_SPOT"
        ],
        "reason": "RESOURCE:FARGATE",
        "createdAt": "2019-11-06T19:09:33.087Z"
    }
}
```
次の EC2 の例では、コンテナインスタンス `2dd1b186f39845a584488d2ef155c131` でタスクを起動しようとしたが、CPU が不十分なため、サービススケジューラがタスクを実行できませんでした。  

```
{
  "version": "0",
  "id": "ddca6449-b258-46c0-8653-e0e3a6d0468b",
  "detail-type": "ECS Service Action",
  "source": "aws.ecs",
  "account": "111122223333",
  "time": "2019-11-19T19:55:38Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
  ],
  "detail": {
    "eventType": "ERROR",
    "eventName": "SERVICE_TASK_PLACEMENT_FAILURE",
    "clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
    "containerInstanceArns": [
    "arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131"
    ],
    "reason": "RESOURCE:CPU",
    "createdAt": "2019-11-06T19:09:33.087Z"
  }
}
```