AWSインテグレーション - API Gateway

MackerelはAWSインテグレーションにてAmazon API Gatewayのメトリック取得や監視に対応しています。AWSインテグレーションで連携を行なった場合、課金対象として1API = 1マイクロホストと換算します。

AWSインテグレーションの設定方法や対応AWSサービス一覧についてはこちらのページをご確認ください。
AWSインテグレーション

取得メトリック

AWSインテグレーションのAPI Gateway対応で取得できるメトリックは以下の通りです。メトリックの説明に関してはAWSのヘルプをご確認ください。

REST

最大で11個のメトリックが取得されます。

グラフ名 メトリック Mackerel上のメトリック名 単位 Statistics
Requests Count apigateway.requests.count integer Sum
Errors 4XXError
5XXError
apigateway.errors.4xx_error
apigateway.errors.5xx_error
integer Sum
Cache CacheHitCount
CacheMissCount
apigateway.cache.cache_hit_count
apigateway.cache.cache_miss_count
integer Sum
Latency Latency
IntegrationLatency
apigateway.latency.#.minimum
apigateway.latency.#.average
apigateway.latency.#.maximum
float Minimum
Average
Maximum
  • "Mackerel上のメトリック名"の#には、"Latency"、"IntegrationLatency"のいずれかが入ります。

WebSocket

最大で8個のメトリックが取得されます。

グラフ名 メトリック Mackerel上のメトリック名 単位 Statistics
WebSocket Connect ConnectCount apigateway.websocket_connect.count integer Sum
WebSocket Message MessageCount apigateway.websocket_message.count integer Sum
WebSocket Errors IntegrationError
ClientError
ExecutionError
apigateway.websocket_errors.integration
apigateway.websocket_errors.client
apigateway.websocket_errors.execution
integer Sum
WebSocket Latency IntegrationLatency apigateway.websocket_latency.minimum
apigateway.websocket_latency.average
apigateway.websocket_latency.maximum
float Minimum
Average
Maximum

HTTP

最大で10個のメトリックが取得されます。

グラフ名 メトリック Mackerel上のメトリック名 単位 Statistics
Requests Count apigateway.requests.count integer Sum
Data Processed DataProcessed apigateway.data_processed bytes Sum
Errors 4xx
5xx
apigateway.http_errors.4xx_error
apigateway.http_errors.5xx_error
integer Sum
Latency Latency
IntegrationLatency
apigateway.latency.#.minimum
apigateway.latency.#.average
apigateway.latency.#.maximum
float Minimum
Average
Maximum
  • "Mackerel上のメトリック名"の#には、"Latency"、"IntegrationLatency"のいずれかが入ります。

注意事項

REST APIでASCII以外の文字がAPI名に含まれる場合、ASCII以外の文字はCloudWatch上で"-"(ハイフン)に置換されます。
置換後のAPI名が一致するREST APIが他に存在する場合、取得するメトリックが混同されます。

これは、AWSの仕様です。