第2章 可観測性メトリクスの設定
Connectivity Link によって提供されるダッシュボードとアラートのサンプルは、Connectivity Link および Gateway API コンポーネントによりエクスポートされたメトリクスを使用して、アプリケーション、API、ゲートウェイの詳細情報を提供します。必須ではありませんが、これらのメトリクスを設定し、そのダッシュボードとアラートを OpenShift クラスターでセットアップすることをお勧めします。
Connectivity Link 機能を観測するためのダッシュボードとアラートは、OpenShift のユーザーモニタリングスタックから使用できる低レベルの CPU メトリクスとネットワークメトリクス、および Gateway API と Connectivity Link リソースのリソース状態メトリクスを使用します。
このセクションでは、モニタリングおよびメトリクスストレージの設定方法に関する OpenShift ドキュメントへのリンクと、関連するメトリクスを収集するようにリソースを設定する方法を説明します。
これらの手順は、Connectivity Link を使用する OpenShift クラスターごとに実行する必要があります。
前提条件
- OpenShift に Connectivity Link をインストールする の説明に従って Connectivity Link をインストールした。
- OpenShift モニタリングドキュメント の説明に従ってユーザー定義プロジェクトのモニタリングを設定した。
手順
OpenShift でユーザープロジェクトのモニタリングが有効になっている場合は、Gateway および Connectivity Link コンポーネントからメトリクスを収集できます。OpenShift で追加のメトリクスを収集するには、以下のようにカスタムリソース設定を使用して
kube-state-metricsインスタンスをインストールします。kubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/v1.0.1/config/observability/openshift/kube-state-metrics.yaml kubectl apply -k https://github.com/Kuadrant/gateway-api-state-metrics/config/kuadrant?ref=0.6.0一部のサンプルダッシュボードは、リクエストパス別にデータを集計します。OpenShift Service Mesh メトリクスにはデフォルトでリクエストパスのラベルが含まれていませんが、以下を実行してラベルを有効にできます。
kubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/v1.0.1/config/observability/openshift/telemetry.yaml注記これにより、複数の時系列が生成される高カーディナリティーのラベルとなり、パフォーマンスとリソース使用量に影響を及ぼす可能性があります。詳細は、カーディナリティーに関する Reliable Insights のブログ投稿 を参照してください。
次のように、さまざまな Connectivity Link Operator からメトリクス収集を設定できます。
kubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/v1.0.1/config/observability/prometheus/monitors/operators.yaml注記関連するすべてのメトリクスが収集されるように、追加の設定を適用する必要があります。ただし、この設定は後でゲートウェイをどのようにデプロイするかにより異なります。必要な手順の詳細は、Connectivity Link を使用したゲートウェイポリシーの設定およびデプロイ を参照してください。
関連情報
- OpenShift Service Mesh でメトリクスを有効にする方法の詳細は、OpenShift Service Mesh メトリクスのドキュメント を参照してください。
- Connectivity Link コンポーネントメトリクスの詳細は、Kuadrant メトリクスのドキュメント を参照してください。