メトリック配信機能は、Managed Service for Prometheus インスタンスにメトリックをストリーミングします。有効にすると、これらのメトリックを使用してカスタムダッシュボードを作成し、重大な変更をモニターし、潜在的な問題を特定して解決できます。この Topic では、Cloud-native API Gateway のメトリック配信を有効にする方法について説明します。
準備
ゲートウェイインスタンスを作成済みであること。
メトリック配信の有効化
Cloud-native API Gateway は無料ですが、Managed Service for Prometheus は使用量に基づいて課金されます。詳細については、「課金の概要」をご参照ください。
API Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、 をクリックします。上部のナビゲーションバーで、リージョンを選択します。
[インスタンス] ページで、対象インスタンスの ID/名前をクリックします。左側のナビゲーションウィンドウで、[パラメーター] をクリックします。
[可観測性パラメーター] セクションで、[メトリクス配信設定]
の横にある アイコンをクリックします。[メトリクス配信設定] パネルで、[メトリクス配信] をオンにします。[利用規約] と [料金詳細] を確認した後、[OK] をクリックします。
リソースの作成が完了するまで待ちます。配信が正常に有効化されると、コンソールでメトリック配信用の Cloud Monitor Prometheus インスタンス ID を表示でき、インスタンス ID をクリックして対応する Cloud Monitor Prometheus インスタンスの詳細ページに移動できます。
メトリックの説明
現在サポートされているメトリック項目とその意味は次のとおりです。ビジネス要件に応じて、これらのメトリックに基づいて Grafana ダッシュボードを作成できます。
メトリック名 | 説明 | 粒度 |
envoy_http_downstream_cx_active | ゲートウェイとクライアント間の接続数 | インスタンスレベル |
envoy_http_downstream_cx_rx_bytes_total | ゲートウェイ受信トラフィック | インスタンスレベル |
envoy_http_downstream_cx_tx_bytes_total | ゲートウェイ送信トラフィック | インスタンスレベル |
envoy_http_downstream_rq | ゲートウェイのリクエスト数関連 | インスタンスレベル |
envoy_http_downstream_rq_time_bucket | ゲートウェイの RT 関連 | インスタンスレベル |
envoy_http_downstream_rq_time_count | ゲートウェイの RT 関連 | インスタンスレベル |
envoy_http_downstream_rq_time_sum | ゲートウェイの RT 関連 | インスタンスレベル |
envoy_http_downstream_rq_total | ゲートウェイのリクエスト数関連 | インスタンスレベル |
envoy_listener_downstream_cx_destroy | ダウンストリーム接続数関連 | インスタンスレベル |
envoy_listener_downstream_cx_total | ダウンストリーム接続数関連 | インスタンスレベル |
envoy_listener_ssl_connection_error | SSL ハンドシェイク関連 | インスタンスレベル |
envoy_listener_ssl_handshake | SSL ハンドシェイク関連 | インスタンスレベル |
envoy_listener_ssl_session_reused | SSL ハンドシェイク関連 | インスタンスレベル |
envoy_cluster_membership_healthy | バックエンドサービスの正常なノード数 | サービスレベル |
envoy_cluster_upstream_cx_active | アクティブな接続数メトリックの構築 | サービスレベル |
envoy_cluster_upstream_cx_destroy | 破棄された接続数メトリックの構築 | サービスレベル |
envoy_cluster_upstream_cx_total | 新規接続数メトリックの構築 | サービスレベル |
envoy_cluster_upstream_rq | バックエンドサービスのリクエスト数 | サービスレベル |
envoy_cluster_upstream_rq_time_bucket | バックエンドサービスの P パーセンタイル RT の構築 | サービスレベル |
envoy_cluster_upstream_rq_time_count | バックエンドサービスの平均 RT の構築 | サービスレベル |
envoy_cluster_upstream_rq_time_sum | バックエンドサービスの平均 RT の構築 | サービスレベル |
envoy_cluster_upstream_rq_timeout | バックエンドサービスのタイムアウトリクエスト数 | サービスレベル |
envoy_cluster_upstream_rq_total | バックエンドサービスの総リクエスト数 | サービスレベル |
envoy_vhost_route_upstream_rq | ルートのリクエスト数 | ルートレベル |
envoy_vhost_route_upstream_rq_timeout | ルートのタイムアウトリクエスト数 | ルートレベル |
envoy_vhost_route_upstream_rq_time_bucket | ルートの RT 関連 | ルートレベル |
envoy_vhost_route_upstream_rq_time_count | ルートの RT 関連 | ルートレベル |
envoy_vhost_route_upstream_rq_time_sum | ルートの RT 関連 | ルートレベル |