CloudWatch メトリクスを使用した WebSocket API 実行のモニタリング - Amazon API Gateway

CloudWatch メトリクスを使用した WebSocket API 実行のモニタリング

Amazon CloudWatch メトリクスを使用して WebSocket API を監視できます。この設定は、REST API に使用される設定と似ています。詳細については、「Amazon CloudWatch メトリクスを使用した REST API 実行のモニタリング」を参照してください。

WebSocket API では、次のメトリクスがサポートされています。

Metric 説明
ConnectCount $connect ルート統合に送信されるメッセージの数。
MessageCount クライアントとの間で送受信される、WebSocket API に送信されるメッセージの数。
IntegrationError 統合から 4XX/5XX レスポンスを返すリクエストの数。
ClientError 統合が呼び出される前に API Gateway によって返された 4XX レスポンスを持つリクエストの数。
ExecutionError 統合を呼び出す際に発生したエラー。
IntegrationLatency API Gateway による統合へのリクエストの送信から、API Gateway による統合からのレスポンスの受信までの時間の差。コールバックと Mock 統合では除外されます。

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

ディメンション 説明
ApiId 指定された API ID で、API に対する API Gateway メトリクスがフィルタリングされます。
ApiId、ステージ 指定された API ID とステージ ID で、API ステージに対する API Gateway メトリクスがフィルタリングされます。
ApiId、ステージ、ルート

指定された API ID、ステージ ID、ルート ID で、API メソッドに対する API Gateway メトリクスがフィルタリングされます。

API Gateway は、明示的に詳細な CloudWatch メトリクスを有効にしていない場合、そのようなメトリクスを送信しません。そのためには、API Gateway V2 REST API の UpdateStage アクションを呼び出して、metricsEnabled プロパティを true に更新します。このようなメトリクスを有効にすることで、アカウントに追加料金が発生します。料金の詳細については、「Amazon CloudWatch の料金」を参照してください。