EventBridge ルールを設定して AWS Health のイベントに関する通知を送信する
アカウント内の AWS Health イベントに関する通知を受け取るための EventBridge ルールを作成することができます。AWS Health に対するイベントルールを作成する前に、以下を完了しておきます。
-
EventBridge のイベント、ルール、ターゲットに精通しておいてください。詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge とは」、および「New EventBridge – Track and Respond to Changes to Your AWS Resources
」(新しい EventBridge – リソースへの変更を追跡して対応する) を参照してください。 -
イベントのルールで使用するターゲットを作成する。
AWS Health の EventBridge ルールを作成するには
Amazon EventBridge コンソール (https://console.aws.amazon.com/events/
) を開きます。 -
AWS リージョン を変更するには、ページの右上隅にあるリージョンセレクターを使用します。AWS Health イベントを追跡するリージョンを選択します。
-
ナビゲーションペインで ルール] を選択します。
-
[Create rule] (ルールを作成) を選択します。
-
[Define rule detail] (ルールの詳細を定義) ページで、ルールの名前と説明を入力します。
-
[Event bus] (イベントバス) と [Rule type] (ルールタイプ) のデフォルト値を維持して、[Next] (次へ) を選択します。
-
イベントパターンを構築 ページの イベントソース で、AWS イベントまたは EventBridge パートナーイベント を選択します。
-
[イベントパターン] で、[イベントソース] に [AWS のサービス] を選択します。
-
イベントパターン の [AWS のサービス] で、[Health] を選択します。
-
[Event Type] (イベントタイプ) で、以下のいずれかのオプションを選択します。
-
[Specific Health Abuse Events] (特定の不正行為に関する Health イベント) – イベントタイプ名に
Abuse
という単語が含まれている AWS Health イベント用のルールを作成します。 -
[Specific Health events] (特定の Health イベント) – 特定の AWS のサービス (Amazon EC2 など) のイベント用のルールを作成します。
-
-
[Any service] (任意のサービス) または [Specific service(s)] (特定のサービス) を選択できます。特定のサービスを選択する場合は、以下のオプションの 1 つを選択します。
-
すべてのイベントタイプのカテゴリに適用されるルールを作成するには、[Any event type category] (任意のイベントタイプのカテゴリ) を選択します。
-
[Specific event type category(s)] (特定のイベントタイプのカテゴリ) を選択してから、[issue]、[accountNotification]、または [scheduledChange] などの値をリストから選択します。
ヒント
-
特定のサービスのすべての AWS Health イベントをモニタリングする場合は、[Any event type category] (任意のイベントタイプのカテゴリ) と [Any resource] (任意のリソース) を選択することをお勧めします。これにより、指定したサービスに対して、新しいイベントタイプのコードを含む、すべての AWS Health イベントがルールで確実にモニタリングされます。ルールの例については、すべての Amazon EC2 イベントを参照してください。
-
複数のサービスまたはイベントタイプのカテゴリをモニタリングするルールを作成できます。そのためには、ルールのイベントパターンを手動で更新する必要があります。詳細については、「複数のサービスおよびカテゴリに対するルールの作成」を参照してください。
-
-
特定のサービスおよびイベントタイプのカテゴリを選択した場合は、イベントタイプのコードに対して以下のいずれかのオプションを選択します。
-
すべてのイベントタイプのコードに適用されるルールを作成するには、[Any event type code] (任意のイベントタイプのコード) を選択します。
-
[Specific event type code(s)] (特定のイベントタイプのコード) を選択し、リストから 1 つ以上の値を選択します。これにより、特定のイベントタイプのコードにのみ適用されるルールが作成されます。例えば、
AWS_EC2_INSTANCE_STOP_SCHEDULED
とAWS_EC2_INSTANCE_RETIREMENT_SCHEDULED
を選択すると、これらのイベントがアカウントで発生した場合に、それらのイベントのみにルールが適用されます。
-
-
影響を受けるリソースに対して、以下のいずれかのオプションを選択します。
-
すべてのリソースに適用されるルールを作成するには、[Any resource] (任意のリソース) を選択します。
-
[Specific resource(s)] (特定のリソース) を選択し、1 つ以上のリソースの ID を入力します。例えば、
i-EXAMPLEa1b2c3de4
などの Amazon EC2 インスタンス ID を指定して、このリソースのみに影響を及ぼすイベントを監視できます。
-
-
ルールのセットアップを見直して、イベントモニタリング要件を満たしていることを確認します。
-
[Next] を選択します。
-
[Select target(s)] (ターゲットを選択) ページで、このルール用に作成したターゲットタイプを選択してから、そのタイプに必要な追加のオプションを設定します。例えば、イベントを Amazon SQS キューまたは Amazon SNS トピックに送信できます。
-
次へ をクリックします。
-
(オプション) [Configure tags] (タグの設定) ページで、いずれかのタグを追加し、[Next] (次へ) を選択します。
-
注:タグは現在、EventBridge の aws.health ソースから送信されません。
-
-
[Review and create] (確認および作成) ページで、ルールの設定を確認し、イベントモニタリング要件を満たしていることを確認してください。
-
ルールの作成を選択します。
例 : すべての Amazon EC2 イベントに対するルール
以下の例は、イベントタイプのカテゴリ、イベントコード、およびリソースなど、EventBridge がすべての Amazon EC2 イベントを管理するためのルールを作成します。
例 : 特定の Amazon EC2 イベントに対するルール
以下の例は、EventBridge が以下を監視するルールを作成します。
-
Amazon EC2 サービス
-
scheduledChange イベントタイプのカテゴリ
-
AWS_EC2_INSTANCE_TERMINATION_SCHEDULED
およびAWS_EC2_INSTANCE_RETIREMENT_SCHEDULED
のイベントタイプのコード -
i-EXAMPLEa1b2c3de4
という ID を持つインスタンス
複数のサービスおよびカテゴリに対するルールの作成
前の手順の例は、単一のサービスおよびイベントタイプのカテゴリに対してルールを作成する方法を示しています。複数のサービスやイベントタイプのカテゴリに対してルールを作成することもできます。つまり、モニタリングするサービスやカテゴリごとに個別のルールを作成する必要はありません。そのためには、イベントパターンを編集し、変更を手動で入力する必要があります。
次のオプションの 1 つを使用できます。
既存のルールにサービスとカテゴリを追加するには
-
EventBridge コンソールの [Rules] (ルール) ページでルール名を選択します。
-
右上隅の[編集] を選択します。
-
[Next] (次へ) を選択します。
-
[Event pattern] (イベントパターン) で [Edit pattern] (パターンを編集) をクリックしてから、変更内容をテキストフィールドに入力します。
-
[Review and update] (確認と更新) ページが表示されるまで [Next] (次へ) を選択します。
-
[Update rule] (ルールを更新) を選択して変更を保存します。
新しいルールにサービスとカテゴリを追加するには
-
「EventBridge ルールを設定して AWS Health のイベントに関する通知を送信する」の手順をステップ 9 まで実行します。
-
リストから単一のサービスまたはカテゴリを選択する代わりに、[Event pattern] (イベントパターン) で [Edit pattern] (パターンを編集) を選択します。
-
テキストフィールドに変更を入力します。独自のイベントパターンを作成するためのモデルとして、以下のサンプルパターンを参照してください。
-
イベントパターンを確認してから、「EventBridge ルールを設定して AWS Health のイベントに関する通知を送信する」の残りの手順を実行してルールを作成します。
APIまたは AWS Command Line Interface (AWS CLI) の使用
新規または既存のルールの場合、PutRule API オペレーションまたは aws events put-rule
コマンドを使用して、イベントパターンを更新します。AWS CLI コマンドの例については、AWS CLI コマンドリファレンスの put-rule を参照してください。
例: 複数のサービスとイベントタイプのカテゴリ
以下のイベントパターンは、Amazon EC2、Amazon EC2 Auto Scaling、および Amazon VPC の 3 つの issue
のサービスについて、accountNotification
、scheduledChange
、および AWS のイベントタイプカテゴリのイベントを監視するルールを作成します。
{ "detail": { "eventTypeCategory": [ "issue", "accountNotification", "scheduledChange" ], "service": [ "AUTOSCALING", "VPC", "EC2" ] }, "detail-type": [ "AWS Health Event" ], "source": [ "aws.health" ] }