Amazon API Gateway
開発者ガイド

Amazon API Gateway のディメンションおよびメトリクス

API Gateway が Amazon CloudWatch に送信するメトリクスおよびディメンションは次のとおりです。詳細については、「Amazon CloudWatch を使用した API 実行のモニタリング」を参照してください。

API Gateway メトリクス

Amazon API Gateway は、CloudWatch にメトリクスデータを毎分送信します。

AWS/ApiGateway 名前空間には、以下のメトリクスが含まれます。

メトリクス 説明

4XXError

指定された期間に取得されたクライアント側エラーの数。

Sum 統計は、このメトリクス、つまり、指定された期間内の 4XXError エラーの合計数を表します。Average 統計は、4XXError のエラー率、つまり、4XXError エラーの合計数をその期間のリクエストの合計数で割ったものです。分母は Count メトリクス (下記) に対応します。

Unit: Count

5XXError

指定された期間に取得されたサーバー側エラーの数。

Sum 統計は、このメトリクス、つまり、指定された期間内の 5XXError エラーの合計数を表します。Average 統計は、5XXError のエラー率、つまり、5XXError エラーの合計数をその期間のリクエストの合計数で割ったものです。分母は Count メトリクス (下記) に対応します。

Unit: Count

CacheHitCount

指定された期間内に API キャッシュから配信されたリクエストの数。

Sum 統計は、このメトリクス、つまり、指定された期間内のキャッシュヒットの合計数を表します。Average 統計は、キャッシュヒット率、つまり、キャッシュヒットの合計数をその期間のリクエストの合計数で割ったものです。分母は Count メトリクス (下記) に対応します。

Unit: Count

CacheMissCount

API キャッシュが有効になっている特定の期間における、バックエンドから提供されたリクエストの数。

Sum 統計は、このメトリクス、つまり、指定された期間内のキャッシュミスの合計数を表します。Average 統計は、キャッシュミス率、つまり、キャッシュミスの合計数をその期間のリクエストの合計数で割ったものです。分母は Count メトリクス (下記) に対応します。

Unit: Count

Count

指定された期間内の API リクエストの合計数。

SampleCount 統計は、このメトリクスを表します。

Unit: Count

IntegrationLatency

API Gateway がバックエンドにリクエストを中継してから、バックエンドからレスポンスを受け取るまでの時間。

Unit: Millisecond

Latency

API Gateway がクライアントからリクエストを受け取ってから、クライアントにレスポンスを返すまでの時間。レイテンシーには、統合のレイテンシーおよびその他の API Gateway オーバーヘッドが含まれます。

Unit: Millisecond

メトリクスのディメンション

API Gateway のメトリクスをフィルタ処理するには、以下の表のディメンションを使用できます。

ディメンション 説明

ApiName

指定した API 名を使用して、REST API の API Gateway メトリクスをフィルタ処理します。

ApiName, Method, Resource, Stage

指定した API 名、ステージ、リソース、メソッドを使用して、API メソッドの API Gateway メトリクスをフィルタ処理します。

API Gateway は、明示的に詳細な CloudWatch メトリクスを有効にしていない場合、そのようなメトリクスを送信しません。この操作は、[Settings (設定)] タブで、[Enable CloudWatch Metrics (CloudWatch メトリクスの有効化)] を選択することにより、コンソールで行うことができます。あるいは、update-stage AWS CLI コマンドを呼び出して metricsEnabled プロパティを true に更新することもできます。

これらのメトリクスを有効にすることで、アカウントに追加料金が発生します。料金の詳細については、「Amazon CloudWatch 料金表」を参照してください。

ApiName, Stage

指定した API 名とステージを使用して、API ステージリソースの API Gateway メトリクスをフィルタ処理します。