Amazon CloudWatch を使用して Amazon EC2 API リクエストをモニタリングする - Amazon Elastic Compute Cloud

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

Amazon CloudWatch を使用して Amazon EC2 API リクエストをモニタリングする

Amazon CloudWatch を使用して Amazon EC2 API リクエストをモニタリングすることで、raw データを収集し、読み取り可能なほぼリアルタイムのメトリクスに加工できます。これらのメトリクスは、Amazon EC2 API オペレーションの使用状況と結果を経時的に追跡する簡単な方法を提供します。この情報により、ウェブアプリケーションのパフォーマンスをより的確に把握し、さまざまな問題を特定して診断できます。また、特定のしきい値を監視するアラームを設定し、それらのしきい値に達したときに通知を送信したり、特定のアクションを実行したりすることもできます。

CloudWatch の詳細については、「Amazon CloudWatch ユーザーガイド」を参照してください。

重要

Amazon EC2 API メトリクスはオプトイン機能です。この機能へのアクセスをリクエストする必要があります。詳細については、「Amazon EC2 API メトリクスを有効にする」を参照してください。

Amazon EC2 API メトリクスを有効にする

のこの機能へのアクセスをリクエストするには、次の手順に従います AWS アカウント。

この機能へのアクセスをリクエストするには
  1. AWS サポート センターを開きます。

  2. [ケースを作成] を選択します。

  3. [Account and billing] (アカウントおよび請求) を選択します。

  4. サービスで、一般情報と開始方法を選択します。

  5. カテゴリ で、「Using AWS & Services」を選択します。

  6. [Next step: Additional information] (次のステップ:追加情報) を選択します。

  7. [Subject (件名)] に Request access to Amazon EC2 API metrics と入力します。

  8. [説明]Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html と入力します。アクセスが必要なリージョンも含めます。

  9. [次のステップ: 今すぐ解決またはお問い合わせ] を選択します。

  10. Contact us タブで、希望する問い合わせ言語と連絡方法を選択します。

  11. [送信] を選択します。

Amazon EC2 API のメトリクスとディメンション

メトリクス

Amazon EC2 API メトリクスは AWS/EC2/API名前空間に含まれています。次の表に、Amazon EC2 API リクエストで使用できるメトリクスを示します。

メトリクス 説明

ClientErrors

クライアントエラーによって失敗した API リクエストの数。

これらのエラーは通常、リクエストで正しくない、または無効なパラメータを指定する、またはアクションまたはリソースを使用するアクセス許可を持たないユーザーに代わってアクションまたはリソースを使用するなど、クライアントが行ったことが原因で発生します。

単位: 数

RequestLimitExceeded

アカウントで Amazon EC2 APIs で許可されている最大リクエストレートを超えた回数。

Amazon EC2 API リクエストは、サービスのパフォーマンスを維持するためにスロットリングされます。リクエストがスロットリングされている場合、 Client.RequestLimitExceeded エラーが発生します。

単位: 数

ServerErrors

内部サーバーエラーによって失敗した API リクエストの数。

これらのエラーは通常、 AWS サーバー側のエラー、例外、または障害によって発生します。

単位: 数

SuccessfulCalls

成功した API リクエストの数。

単位: 数

ディメンション

Amazon EC2 メトリクスデータは、すべての EC2 API アクションでフィルタリングできます。ディメンションの詳細については、Amazon CloudWatch の概念」を参照してください。

メトリクスデータ保持

Amazon EC2 API メトリクスは 1 分間隔で CloudWatch に送信されます。CloudWatch では、次のようにメトリクスデータを保持します。

  • 期間が 60 秒 (1 分) のデータポイントは、15 日間使用できます。

  • 期間が 300 秒 (5 分) のデータポイントは 63 日間使用できます。

  • 3600 秒 (1 時間) の期間を持つデータポイントは、455 日 (15 か月) 利用できます。

ユーザーに代わって行われたリクエストのモニタリング

AWS サービスにリンクされたロールによるリクエストなど、ユーザーに代わって のサービスによって行われた API リクエストは、API スロットリング制限にはカウントされず、アカウントの Amazon CloudWatch にメトリクスを送信しません。CloudWatch を使用してこれらのリクエストをモニタリングすることはできません。

サードパーティーサービスプロバイダーがユーザーに代わって行った API リクエストは、API スロットリング制限にカウントされ、アカウントの Amazon CloudWatch にメトリクスを送信します。これらのリクエストは CloudWatch を使用してモニタリングできます。

「請求」

標準の CloudWatch 料金と料金が適用されます。Amazon EC2 API メトリクスの使用には追加料金はかかりません。詳細については、「Amazon CloudWatch 料金表」をご覧ください。

Amazon CloudWatch との連携

CloudWatch メトリクスの表示

Amazon EC2 API メトリクスを表示するには、次の手順に従います。

前提条件

アカウントの Amazon EC2 API メトリクスへのアクセスを有効にする必要があります。詳細については、「Amazon EC2 API メトリクスを有効にする」を参照してください。

コンソールを使用して Amazon EC2 API メトリクスを表示するには
  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで、メトリクスすべてのメトリクスを選択します。

  3. 参照タブのメトリクスで、メトリクスを表示するリージョンを選択します。

  4. EC2 のメトリクスの名前空間を選択してください。

  5. メトリクスを表示するには、インスタンスごとのメトリクスなどのメトリクスディメンションを選択します。

    注記

    メトリクスは、2 週間の非アクティブ状態が続くと非表示になります。過去 2 週間に新しいデータポイントを受信しなかった場合、コンソールに表示されなくなり、コンソールの検索ボックスにメトリクス名またはディメンション名を入力すると表示されず、list-metrics AWS CLI コマンドによって返されません。これらのメトリクスを取得するには、get-metric-data コマンドまたは get-metric-statistics コマンドを使用します。

コマンドラインを使用して Amazon EC2 API メトリクスを表示するには

以下のいずれかのコマンドを使用します。

  • list-metrics (AWS CLI)

    aws cloudwatch list-metrics --namespace "AWS/EC2/API"
  • Get-CWMetricList (AWS Tools for Windows PowerShell)

    Get-CWMetricList -Namespace "AWS/EC2/API"

CloudWatch アラームの作成

アラームの状態が変わったら、Amazon SNS メッセージを送信する Amazon CloudWatch のアラームを作成することができます。1 つのアラームで、指定した期間中、1 つのメトリクスを監視します。SNS トピックに通知を送信します。この通知は、複数の期間にわたる特定のしきい値に対するメトリクスの値に基づきます。

例えば、サーバー側のエラーが原因で失敗した DescribeInstances API リクエストの数をモニタリングするアラームを作成できます。次のアラームは、DescribeInstances API リクエストの失敗の数が 5 分間にサーバー側のエラーのしきい値である 10 に達すると、E メール通知を送信します。

前提条件

アカウントの Amazon EC2 API メトリクスへのアクセスを有効にする必要があります。詳細については、「Amazon EC2 API メトリクスを有効にする」を参照してください。

Amazon EC2 DescribeInstances API リクエストサーバーエラーのアラームを作成するには
  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで、[アラーム]、[すべてのアラーム] の順に選択します。

  3. [アラームの作成] を選択します。

  4. Select メトリクスを選択し、 で以下を指定します。

    1. EC2/API を選択します。

    2. アクションごとのメトリクスを選択します。

    3. ServerErrors メトリクス名と同じ行にある DescribeInstances の横にあるチェックボックスをオンにします。

    4. [メトリクスの選択] を選択します。

  5. [Specify metric and conditions (メトリクスと条件の指定)] ページに、選択したメトリクスと統計のグラフや他の情報が表示されます。

    1. メトリクスで、以下を指定します。

      1. [統計] で、[合計] を選択します。

      2. 期間 で、5 分が選択されていることを確認します。

    2. [Conditions (条件)] で、次のように指定します。

      1. [Threshold type (しきい値タイプ)] で [静的] を選択します。

      2. ServerErrors が のときはいつでもGreater/Equal >= を選択します。

      3. than... には10 と入力します。

    3. [Next (次へ)] を選択します。

  6. [Configure actions] (アクションの設定) ページが表示されます。

    1. 通知 で、以下を指定します。

      1. Alam 状態トリガーで、In alarm を選択します。

      2. 「SNS トピックの選択」で、「既存の SNS トピックの選択」または「新しいトピックの作成」を選択し、通知の必須フィールドに入力します。

      3. [Next (次へ)] を選択します。

  7. 名前と説明の追加ページが表示されます。

    1. アラーム名に、アラームの名前を入力します。名前には ASCII 文字のみを使用します。

    2. アラームの説明には、アラームのオプションの説明を入力します。

    3. [Next (次へ)] を選択します。

  8. プレビューと作成ページが表示されます。情報が正しいことを確認し、アラームの作成を選択します。

詳細については、『Amazon CloudWatch ユーザーガイド』の「Amazon CloudWatch アラームの使用」を参照してください。