についてAWSのリージョンAWS Health の公開イベントについてAWS Health の CloudWatch Events ルールの作成AWS Health 受信AWS HealthイベントとAWS Chatbot Amazon EC2 インスタンスのアクションを自動化

MonitoringAWS HealthAmazon CloudWatch Events

Amazon CloudWatch Events を使用すると、AWS Healthイベント. 次に、作成したルールで指定した値とイベントが一致すると、CloudWatch Events で 1 つ以上のターゲットアクションが呼び出されます。イベントのタイプに応じて、通知の送信、イベント情報の取得、是正措置の実施、またはその他の対策を行うことができます。たとえば、AWS Healthを使用して電子メール通知を受信します。AWSリソースをAWSAmazon Elastic Compute Cloud (Amazon EC2) インスタンスなど、更新が予定されているアカウント。

Notes

このトピックでは、CloudWatch イベントコンソールを使用してルールを作成します。Amazon EventBridge コンソールを使用してルールを作成することもできます。詳細については、「」を参照してください。のルールの作成AWSのサービスのAmazon EventBridge ユーザーガイド。
どちらのサービスでも、AWS Healthは、ベストエフォートベースでイベントを発行します。イベントが CloudWatch イベントまたは EventBridge に配信されるとは限りません。
CloudWatch イベントルールを作成して、アカウントの通知のみを受信できます。他のアカウントの組織イベントをAWS Organizations。詳細については、「組織ビューでのアカウント全体の AWS Health イベントの集計」を参照してください。

CloudWatch Events をAWS Healthワークフロー:

AWS Lambda 関数
Amazon Kinesis Data Streams
Amazon Simple Queue Service (Amazon SQS) キュー
組み込みターゲット (CloudWatch アラームアクション)
Amazon Simple Notification Service (Amazon SNS) のトピック

たとえば、Lambda 関数を使用して、AWS Healthイベントが発生した場合。または、Lambda イベントと CloudWatch イベントを使用して、AWS Healthイベントが発生した場合。

AWS Health イベントに作成できる自動アラートおよびカスタムアラートのサンプルについては、GitHub の AWS Health Tools を参照してください。

トピック

についてAWSのリージョンAWS Health
の公開イベントについてAWS Health
の CloudWatch Events ルールの作成AWS Health
受信AWS HealthイベントとAWS Chatbot
Amazon EC2 インスタンスのアクションを自動化

についてAWSのリージョンAWS Health

受信するリージョンごとに CloudWatch Events ルールを作成する必要があります。AWS Healthイベント. ルールを作成しないと、イベントは受信されません。たとえば、米国西部 (オレゴン) リージョンからイベントを受信するには、このリージョンのルールを作成する必要があります。

ある程度AWS Healthイベントはリージョン固有ではなく、代わりにグローバルです。AWS Identity and Access Management(IAM) である。グローバルイベントを受信するには、米国東部 (バージニア北部) リージョンのルールを作成する必要があります。

グローバルイベントを AWS GovCloud (US) でルールを作成するには、AWSGovCloud (米国西部) リージョン。

の公開イベントについてAWS Health

のみAWS Health固有のイベントです。AWSアカウントは CloudWatch イベントに配信されます。たとえば、Amazon EC2 インスタンスへの必要な更新や、アカウントやリソースに影響する可能性のあるスケジュールされた変更イベントなどのイベントを含めることができます。

現時点では、CloudWatch Events を使用してパブリックのイベントService Health Dashboard。Service Health Dashboard のイベントは、リージョンでのサービスの可用性に関する公開情報を提供します。これらのイベントはAWSアカウントに配信されるため、CloudWatch Events には配信されません。

代わりに、AWS HealthコンソールとDescribeEventDetailsオペレーション. どちらのオプションを使用してイベントに関する情報を返し、そのイベントが Service Health Dashboard の公開イベントか、アカウントに影響するアカウント固有のイベントかを特定できます。

次のオプションを使用して、イベントがパブリックかアカウント固有かを識別できます。

左AWS Personal Health Dashboard] で、影響を受けるリソース[] タブの []イベントログページで. リソースがあるイベントは、アカウントに固有です。リソースのないイベントはパブリックであり、アカウント固有のものではありません。詳細については、「AWS Personal Health Dashboard の開始方法」を参照してください。
AWS Health API を使用して、eventScopeCode パラメータを返します。イベントには PUBLIC、ACCOUNT_SPECIFIC、または NONE の値を指定できます。詳細については、「」を参照してください。DescribeEventDetailsオペレーションをAWS HealthAPI リファレンス。

また、を使用することもできますAWS HealthService Health Dashboard 通知ツールで、公開イベントの通知を受けます。詳細については、「」を参照してください。aws-ヘルスツールGitHub ウェブサイトで。

の CloudWatch Events ルールの作成AWS Health

CloudWatch Events ルールを作成して、AWS Healthアカウントでイベントを発行します。AWS Health のイベントルールを作成する前に、以下のことを行う必要があります。

CloudWatch Events のイベント、ルール、およびターゲットをよく理解しておく。詳細については、「」を参照してください。Amazon CloudWatch Events とはのAmazon CloudWatch Events ユーザーガイドおよび新しい CloudWatch イベント — 変更を追跡して対応するAWSリソース。
イベントのルールで使用するターゲットを作成する。

の CloudWatch Events ルールを作成するにはAWS Health

CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。
AWS リージョンを変更するには、ページの右上隅にあるリージョンセレクターを使用します。AWS Health イベントを追跡するリージョンを選択します。
ナビゲーションペインの [] で、イベント] で、ルール。
[Create rule] を選択し、次に [Event Source] の下の [Service Name] で [Health] を選択します。
を使用する場合イベントタイプ[] で、次のいずれかのオプションを選択します。
- 選択すべてのイベントすべてのに適用するルールを作成するにはAWSのサービス。このルールはAWS Health。このオプションを選択すると、イベントタイプのカテゴリやイベントタイプのコードを指定することはできません。
- 選択特定のHealth スイベント,特定のサービス[] を選択し、リストからサービス名を選択します。この例では、EC2に設定して、CloudWatch イベントが Amazon EC2 イベントのみをモニタリングするようにします。
特定のサービスを選択した場合は、次のいずれかのオプションを選択します。
- 選択任意のイベント・タイプ・カテゴリすべてのイベントタイプのカテゴリに適用されるルールを作成します。
- 選択特定のイベント・タイプ・カテゴリリストから値を選択します。これにより、1 つのイベントタイプカテゴリにのみ適用されるルールが作成されます (scheduledChange。
ヒント
- すべてを監視するにはAWS Healthイベントを特定のサービスに対して設定するには、[] を選択することをお勧めします。任意のイベント・タイプ・カテゴリおよび任意のリソース。これにより、ルールがすべてのAWS Healthイベント (新しいイベントタイプコードを含む)。ルールの例については、すべての Amazon EC2 イベント。
- 複数のサービスまたはイベントタイプカテゴリを監視するルールを作成できます。そのためには、ルールのイベントパターンを手動で更新する必要があります。詳細については、「複数のサービスおよびカテゴリに対するルールの作成」を参照してください。
特定のサービスおよびイベントタイプカテゴリを選択した場合は、イベントタイプコードに次のいずれかのオプションを選択します。
- 選択任意のイベント・タイプ・コードすべてのイベントタイプのコードに適用されるルールを作成します。
- 選択特定のイベント・タイプ・コードリストから 1 つまたは複数の値を選択します。これにより、特定のイベントタイプコードにのみ適用されるルールが作成されます。たとえば、[] を選択した場合AWS_EC2_INSTANCE_STOP_SCHEDULEDおよびAWS_EC2_INSTANCE_RETIREMENT_SCHEDULEDに設定されている場合、ルールはアカウント内で発生したイベントにのみ適用されます。
影響を受けるリソースに対して、次のいずれかのオプションを選択します。
- 選択任意のリソースすべてのリソースに適用されるルールを作成するには。
- 選択特定のリソース1 つ以上のリソースの ID を入力します。たとえば、Amazon EC2 インスタンス ID (i-EXAMPLEa1b2c3de4を使用して、このリソースにのみ影響するイベントを監視します。
ルール設定を確認して、イベントモニタリング要件を満たします。
[Targets] エリアで、[Add target*] を選択します。
左ターゲットのタイプの選択リストで、このルールを使用するために準備したターゲットのタイプを選択してから、そのタイプに必要な追加オプションを設定します。
[設定の詳細] を選択します。
リポジトリの []ルールの詳細の設定ページで、ルールの名前と説明を入力し、[] を選択します。州/地域ルールを作成してすぐに有効にするには] ボックスをオンにします。
[Create rule] を選択します。

例 : すべての Amazon EC2 イベントのルール

次の例では、CloudWatch Events がイベントタイプカテゴリ、イベントコード、リソースなど、すべての Amazon EC2 イベントを監視するようにルールを作成します。

すべての Amazon EC2 イベントだけの CloudWatch Events ルールを作成する方法について説明します。

例 : 特定の Amazon EC2 イベントに関するルール

次の例では、CloudWatch イベントが以下を監視するようにルールを作成します。

Amazon EC2 サービス
-scheduledChangeイベントタイプカテゴリ
イベントタイプコードAWS_EC2_INSTANCE_TERMINATION_SCHEDULEDおよびAWS_EC2_INSTANCE_RETIREMENT_SCHEDULED
インスタンスがi-EXAMPLEa1b2c3de4ID

特定の Amazon EC2 イベントだけの CloudWatch Events ルールを作成する方法について説明します。

複数のサービスおよびカテゴリに対するルールの作成

前の手順の例で、1 つのサービスとイベントタイプカテゴリに対してルールを作成する方法を示します。また、複数のサービスおよびイベントタイプカテゴリに対してルールを作成することもできます。つまり、監視するサービスおよびカテゴリごとに個別のルールを作成する必要はありません。これを行うには、イベントパターンを編集し、変更を手動で入力する必要があります。

以下のいずれかのオプションを使用できます。

既存のルールにサービスとカテゴリを追加するには

CloudWatch イベントコンソールで、ルールページで、ルール名を選択します。
右上隅の [] を選択します。アクション[] を選択して [] を選択します。編集。
を使用する場合イベントパターンテキストフィールドに変更内容を入力します。
選択詳細の構成[] を選択して [] を選択します。ルールの更新[] をクリックして変更を保存します。

新しいルールのサービスとカテゴリを追加するには

の手順に従います。の CloudWatch Events ルールの作成AWS Health～ステップ 6。
リストから単一のサービスまたはカテゴリを選択する代わりに、イベントパターンのプレビュー] で、編集。
テキストフィールドに変更を入力し、[] を選択します。保存。以下を参照してくださいパターンの例。
イベントパターンを確認し、」の CloudWatch Events ルールの作成AWS Healthルールを作成するには、[] を選択します。

API を使用するAWS Command Line Interface(AWS CLI)

新規または既存のルールの場合は、PutRuleAPI オペレーションまたはaws events put-ruleコマンドを使用してイベントパターンを更新します。例AWS CLIコマンドの詳細については、put-ruleのAWS CLIコマンドリファレンス。

例: 複数のサービスとイベントタイプのカテゴリ

次のイベントパターンは、issue,accountNotification, およびscheduledChangeイベントタイプのカテゴリと 3 つのAWSのサービス。


{
  "detail": {
    "eventTypeCategory": [
      "issue",
      "accountNotification",
      "scheduledChange"
    ],
    "service": [
      "AUTOSCALING",
      "VPC",
      "EC2"
    ]
  },
  "detail-type": [
    "AWS Health Event"
  ],
  "source": [
    "aws.health"
  ]
}

受信AWS HealthイベントとAWS Chatbot

あなたは受け取ることができますAWS Healthイベントを Slack や Amazon Chime などのチャットクライアントに直接送信できます。このイベントを使用して、最近のAWS影響する可能性のあるサービスの問題AWSアプリケーションとインフラストラクチャ。その後、[]AWS Personal Health Dashboard更新プログラムの詳細については、「」を参照してください。たとえば、AWS_EC2_INSTANCE_STOP_SCHEDULEDイベントタイプAWSアカウントの場合、AWS Healthイベントは Slack チャンネルに直接表示されます。

Prerequisites

開始するには、以下のものが必要です。

で設定されたチャットクライアントAWS Chatbot。Amazon Chime スラックを設定できます。詳細については、「」を参照してください。の開始方法AWS ChatbotのAWS Chatbot管理者ガイド。
作成して購読した Amazon SNS トピック。SNS トピックがすでにある場合は既存の SNS トピックを使用できます。詳細については、「」を参照してください。Amazon SNS の開始方法のAmazon Simple Notification Service デベロッパーガイド。

受信するにはAWS HealthイベントとAWS Chatbot

「の CloudWatch Events ルールの作成AWS Health」の手順に従います。
1. でターゲットを選択するとステップ 11で、SNS トピックを選択します。この同じ SNS トピックをAWS Chatbotconsole.
2. ルールを作成するには、残りの手順を完了します。
AWS Chatbot コンソールに移動します。
Slack チャンネル名など、チャットクライアントを選択し、編集。
左通知-オプションセクションに追加します。トピックで、指定した SNS トピックと同じ SNS トピックを選択します。
[Save] を選択します。

メトリックAWS Healthがルールに一致するイベントを CloudWatch イベントに送信する場合、AWS Healthイベントは、チャットクライアントに表示されます。
イベント名を選択すると、AWS Personal Health Dashboard。

例 :AWS HealthSlack に送信されたイベント

以下に、2 つの例を示します。AWS HealthSlack チャネルに表示される米国東部 (バージニア北部) リージョンの Amazon EC2 および Amazon Simple Storage Service (Amazon S3) のイベントです。

2 つのスクリーンショットAWS Healthイベントは Slack チャンネルに表示されます。

Amazon EC2 インスタンスのアクションを自動化

Amazon EC2 インスタンスのスケジュールされたイベントに応答するアクションを自動化できます。メトリックAWS HealthはイベントをAWSアカウントを使用すると、CloudWatch イベントルールがAWS Systems Manager自動化ドキュメント。ユーザーに代わってアクションを自動化します。

たとえば、Amazon Elastic Block Store（Amazon EBS）でバックアップされた EC2 インスタンスに対して Amazon EC2 インスタンスのリタイアイベントがスケジュールされている場合、AWS Healthは、AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULEDイベントタイプをAWS Personal Health Dashboard。ルールでこのイベントタイプが検出されると、インスタンスの停止と開始を自動化できます。こうすれば、これらのアクションを手動で実行する必要はありません。

Notes

この手順では、CloudWatch イベントコンソールを使用してルールを作成します。EventBridge コンソールを使用してルールを作成することもできます。詳細については、「」を参照してください。のルールの作成AWSのサービスのAmazon EventBridge ユーザーガイド。
Amazon EC2 インスタンスのアクションを自動化するには、Systems Manager によって管理されている必要があります。

詳細については、「」を参照してください。EventBridge による Amazon EC2 の自動化のLinux インスタンス用 Amazon EC2 ユーザーガイド。

Prerequisites

作成する必要があります。AWS Identity and Access Management(IAM) ポリシーを作成し、IAM ロールを作成し、信頼ポリシーを更新してからルールを作成してください。

ロールにカスタマー管理ポリシーを作成するには、次の手順に従います。このポリシーは、ユーザーに代わってアクションを実行するロールアクセス権限を付与します。この手順では、IAM コンソールの JSON ポリシーエディタを使用します。

IAM ポリシーを作成するには

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。
ナビゲーションペインで、[ポリシー] を選択します。
[ポリシーの作成] を選択します。
[JSON] タブを選択します。

次の JSON をコピーし、エディタでデフォルトの JSON を置き換えます。

左Resourceパラメータには、Amazon リソースネーム (ARN) にAWSアカウント ID。

ロール名を置き換えるか、デフォルトを使用することもできます。この例ではを使用しますAutomationCWRole。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:DescribeInstanceStatus"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "ssm:*"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": "arn:aws:iam::123456789012:role/AutomationCWRole"
    }
  ]
}

[Next: (次へ:)] を選択しますタグ
(オプション) タグをキーと値のペアとして使用して、メタデータをポリシーに追加できます。
[Next: (次へ:)] を選択します確認.
リポジトリの []ポリシーの確認ページで、名前など自動化CWRoleポリシーと説明(オプション)。
[] を確認します。概要ページをクリックして、ポリシーで許可されているアクセス許可を表示し、ポリシーの作成。

このポリシーは、ロールが実行できるアクションを定義します。詳細については、「」を参照してください。IAM ポリシーの作成（コンソール）のIAM ユーザーガイド。

ポリシーを作成したら、IAM ロールを作成してから、そのロールにポリシーをアタッチする必要があります。

向けのロールを作成するにはAWSのサービス

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。
ナビゲーションペインで [Roles] を選択し、続いて [Create role] を選択します。
[Select type of trusted entity (信頼されたエンティティのタイプの選択)] で、[AWS のサービス] を選択します。
選択EC2このロールを引き受けることを許可するサービスの
[Next: (次へ:)] を選択します アクセス許可.
作成したポリシー名を入力します（自動化CWRoleポリシーポリシーの横にあるチェックボックスをオンにします。
[Next: (次へ:)] を選択しますタグ
(オプション) タグをキーと値のペアとして使用して、ロールにメタデータを追加できます。
[Next: (次へ:)] を選択します確認.
を使用する場合ロール名[] で、AutomationCWRole。この名前は、前に作成した IAM ポリシーの ARN に表示される名前と同じである必要があります。
（オプション）ロールの説明ロールの説明を入力します。
ロール情報を確認し、[Create role (ロールの作成)] を選択します。

詳細については、「」を参照してください。向けのロールの作成AWSのサービスのIAM ユーザーガイド。

作成したロールの信頼ポリシーを更新するには、次の手順を実行します。CloudWatch イベントコンソールでこのロールを選択できるようにするには、この手順を完了する必要があります。

ロールの信頼ポリシーを更新するには

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。
ナビゲーションペインで [Roles (ロール) ] を選択します。
ロールのリストでAWSアカウントで、作成したロールの名前 (AutomationCWRole。
[Trust relationships] タブを選択し、続いて [Edit trust relationship] を選択します。

を使用する場合ポリシードキュメントをクリックし、次の JSON をコピーして、デフォルトのポリシーを置き換えます。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "ssm.amazonaws.com",
                    "events.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

[Update Trust Policy] を選択します。

詳細については、「」を参照してください。ロールの信頼ポリシーの変更 (コンソール)のIAM ユーザーガイド。

CloudWatch Events のルールの作成

以下の手順に従って、リタイアが予定されている EC2 インスタンスの停止と起動を自動化できるように、CloudWatch Events コンソールでルールを作成します。

Systems Manager の自動アクションの CloudWatch イベントのルールを作成するには

CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。
ナビゲーションペインの [] で、イベント] で、ルール。
[Create rule] を選択し、次に [Event Source] の下の [Service Name] で [Health] を選択します。
を使用する場合イベントタイプ] で、特定のHealth スイベント。
選択特定のサービス[] を選択して、[EC2。
選択特定のイベント・タイプ・カテゴリ[] を選択して、[scheduledChange。
選択特定のイベント・タイプ・コードをクリックし、イベントタイプのコードを選択します。たとえば、Amazon EC2 EBS-backed インスタンスの場合は、AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULED。Amazon EC2 instance store-Backed インスタンスの場合は、AWS_EC2_INSTANCE_RETIREMENT_SCHEDULED。

選択任意のリソース。

あなたのイベントパターンのプレビュー次の例のようになります。


{
  "source": [
    "aws.health"
  ],
  "detail-type": [
    "AWS Health Event"
  ],
  "detail": {
    "service": [
      "EC2"
    ],
    "eventTypeCategory": [
      "scheduledChange"
    ],
    "eventTypeCode": [
      "AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULED"
    ]
  }
}

Systems Manager オートメーションドキュメントターゲットを追加します。[]ターゲット] で、ターゲットの追加*[] を選択して [] を選択します。SSM オートメーション。
を使用する場合ドキュメント*] で、AWS-RestartEC2Instance。
を展開します。オートメーションパラメーターの設定[] を選択して、[インプットトランスフォーマー。
向けの入力パスフィールドに [] と入力します。{"Instances":"$.resources"}。
2 番目のフィールドに [] と入力します。{"InstanceId": <Instances>}。
選択既存のロールを使用する[] を選択し、作成した IAM ロールを選択します。AutomationCWRole。

ターゲットは、次の例のようになります。

注記

必要な EC2 および Systems Manager アクセス許可と信頼関係を持つ既存の IAM ロールがない場合、ロールはリストに表示されません。詳細については、「Prerequisites」を参照してください。
[設定の詳細] を選択します。
ルールの名前と説明を入力します。保持する州/地域オプションが選択されました。
[Create rule] を選択します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

組織ビュー (CLI)

のモニタリングAWS Health