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の仕様です。