# EC2 Fast Launch のモニタリング
<a name="win-fast-launch-monitor"></a>

このセクションでは、EC2 Fast Launch が有効になっているアカウントで Amazon EC2 Windows Server AMI をモニタリングする方法について説明します。

## EventBridge を使用して、EC2 Fast Launch の状態の変更をモニタリングする
<a name="win-monitor-fast-launch-events"></a>

EC2 Fast Launch が有効になっている Windows AMI の状態が変わると、Amazon EC2 は `EC2 Fast Launch State-change Notification` イベントを生成します。次に、Amazon EC2 は Amazon EventBridge (旧 Amazon CloudWatch Events) に送信します。

状態変更イベントに応じて、1 つ以上のアクションをトリガーする EventBridge ルールを作成できます。例えば、EC2 Fast Launch が有効になったことを検出し、次のアクションを実行する、EventBridge ルールを作成できます｡
+ サブスクライバーに通知するメッセージを Amazon SNS トピックに送信します。
+ 何らかのアクションを実行する、Lambda 関数を呼び出します。
+ 状態変更データを Amazon Data Firehose に送信し、分析します。

EventBridge ルールの作成の詳細については、*Amazon EventBridge ユーザーガイド*の「[イベントに反応する Amazon EventBridge ルールの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください 。

**状態変更イベント**  
EC2 Fast Launch 機能では、ベストエフォートベースで JSON 形式の状態変更イベントを発行します。Amazon EC2 は、ほぼリアルタイムにイベントを EventBridge に送信します。このセクションでは、イベントフィールドについて説明し、イベントのフォーマットの例を示します。

**`EC2 Fast Launch State-change Notification`**

**imageId**  
EC2 Fast Launch の状態が変更された AMI を特定します。

**resourceType**  
事前プロビジョニングに使用するリソースのタイプ。サポートされている値は `snapshot` です。デフォルト値は `snapshot` です。

**state**  
指定された AMI に対する EC2 Fast Launch 機能の現在の状態。有効な値には次のようなものがあります。  
+ **enabling** – 対象 AMI に対する EC2 Fast Launch 機能が有効になり、Amazon EC2 が事前プロビジョニングプロセス用のスナップショットの作成を開始します。
+ **enabling-failed** – AMI に対して EC2 Fast Launch を初めて有効にしたときに、問題が発生して事前プロビジョニングプロセスが失敗しました。これは、事前プロビジョニングのプロセス中いつでも発生する可能性があります。
+ **有効** – EC2 Fast Launch 機能が有効になっています。Amazon EC2 が、新しく有効になった EC2 Fast Launch AMI に対して事前プロビジョニングされた最初のスナップショットを作成するとすぐに、この状態は `enabled` に変わります。AMI が既に有効になっており、再度事前プロビジョニングを行うと、状態の変更が直ちに行われます。
+ **enabled-failed** – この状態は、EC2 Fast Launch AMI での事前プロビジョニングプロセスが今回が初めてでない場合にのみ適用されます。これは、EC2 Fast Launch 機能を無効にしてから再度有効にした場合や、初回の事前プロビジョニングが完了した後に設定の変更やその他のエラーがあった場合に発生する可能性があります。
+ **disabling** – AMI の所有者がその AMI に対し EC2 Fast Launch 機能を無効にし、Amazon EC2 がクリーンアッププロセスを開始しました。
+ **無効** – EC2 Fast Launch 機能は無効になっています。Amazon EC2 がクリーンアッププロセスを完了するとすぐに状態は `disabled` に変わります。
+ **disabling-failed** - 問題が発生したため、クリーンアッププロセスが失敗しました。これは事前にプロビジョニングされたスナップショットの一部がアカウントに残っている可能性があることを意味します。

**StateTransitionReason**  
EC2 Fast Launch AMI の状態が変更された理由。

**注記**  
このイベントメッセージのすべてのフィールドは必須です。

次の例は、新しく有効になった EC2 Fast Launch AMI が、最初のインスタンスを起動して事前プロビジョニングプロセスを開始したところを示しています。この時点で、状態は `enabling` です。Amazon EC2 が事前にプロビジョニングされた最初のスナップショットを作成すると、状態は `enabled` に変わります。

```
{
	"version": "0",
	"id": "01234567-0123-0123-0123-012345678901",
	"detail-type": "EC2 Fast Launch State-change Notification",
	"source": "aws.ec2",
	"account": "123456789012",
	"time": "2022-08-31T20:30:12Z",
	"region": "us-east-1",
	"resources": [
		"arn:aws:ec2:us-east-1:123456789012:image/ami-123456789012"
	],
	"detail": {
		"imageId": "ami-123456789012",
		"resourceType": "snapshot",
		"state": "enabling",
		"stateTransitionReason": "Client.UserInitiated"
	}
}
```

## CloudWatch で EC2 Fast Launch メトリクスをモニタリングする
<a name="win-monitor-fast-launch-metrics"></a>

EC2 Fast Launch が有効になっている Amazon EC2 AMI は、Amazon CloudWatch にメトリクスを送信します。AWS マネジメントコンソール、AWS CLI、または API を使用して、EC2 Fast Launch が CloudWatch に送信するメトリクスを一覧表示できます。`AWS/EC2` 名前空間には、次の EC2 Fast Launch メトリクスが含まれます。


| メトリクス | 説明 | 
| --- | --- | 
| NumberOfAvailableFastLaunchSnapshots | EC2 Fast Launch が有効になっている AMI あたりの使用可能な事前プロビジョニングされたスナップショットの数。 | 
| NumberOfInstancesFastLaunched | 事前プロビジョニングされたスナップショットから起動された EC2 Fast Launch が有効になっている AMI あたりのインスタンスの数。 | 
| NumberOfInstancesNotFastLaunched | 起動時に使用可能な事前プロビジョニングされたスナップショットがないためにコールドブートになった、EC2 Fast Launch が有効になっている AMI あたりのインスタンスの数。 | 
| FastLaunchSnapshotUsedToRefillStartTime | Amazon EC2 が、既存のスナップショットを使用した後に別のスナップショットを作成するために、EC2 Fast Launch が有効になっている AMI から新しいイメージを起動したときのタイムスタンプ。 | 
| FastLaunchSnapshotCreationTime | Amazon EC2 がインスタンスを起動し、EC2 Fast Launch が有効になっている AMI のスナップショットを作成するのにかかった時間を測定します。 |