3.5. ガバナンスメトリクス
ポリシーフレームワークは、ポリシーの配布とステータスを示すメトリクスを公開します。ハブクラスターで policy_governance_info メトリックを使用してトレンドを表示し、ポリシーの失敗を分析します。メトリックの概要は、次のトピックを参照してください。
3.5.1. メトリック: policy_governance_info リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform モニタリングコンポーネントは policy_governance_info メトリックを収集します。可観測性を有効にすると、コンポーネントはいくつかの集約データを収集します。
注記: 可観測性を有効にする場合は、Grafana Explore ページからメトリクスのクエリーを入力します。ポリシーの作成時に、root ポリシーを作成します。フレームワークは、ルートポリシー、Placement リソース、および PlacementBindings リソースを監視して、propagated ポリシーを作成する場所の情報を取得し、ポリシーをマネージドクラスターに配布します。
ルートポリシーと伝播されたポリシーの両方について、ポリシーが準拠している場合はメトリクス 0 が記録され、準拠していない場合はメトリクス 1 が記録され、不明または保留中の状態の場合はメトリクス -1 が記録されます。
policy_governance_info メトリックは、以下のラベルを使用します。
-
type: ラベルの値はrootまたはpropagatedを使用できます。 -
policy: 関連付けられたルートポリシーの名前。 -
policy_namespace: ルートポリシーが定義されているハブクラスター上の namespace。 -
cluster_namespace: ポリシーの分散先のクラスターの namespace。
これらのラベルと値は、クラスターで発生している、追跡が困難なイベントを表示できるクエリーを有効にします。
注記: メトリクスが必要なく、パフォーマンスやセキュリティーに懸念がある場合は、メトリクスの収集を無効にできます。プロパゲーターデプロイメントで DISABLE_REPORT_METRICS 環境変数を true に設定します。policy_governance_info メトリックを、可観測性の許可リストにカスタムメトリックとして追加することもできます。詳細は、カスタムメトリクスの追加 を参照してください。
3.5.2. メトリクス: cluster_policy_governance_info リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform のモニタリングコンポーネントは、cluster_policy_governance_info メトリクスを収集します。可観測性を有効にすると、コンポーネントがこのデータを収集します。
注記: 可観測性を有効にする場合は、Grafana Explore ページからメトリクスのクエリーを入力します。
マネージドクラスターポリシーの場合、ポリシーに準拠している場合は 0、準拠していない場合は 1、不明または保留中の状態の場合は -1 というメトリクスが記録されます。
cluster_policy_governance_info メトリクスは次のラベルを使用します。
-
kind: ポリシーの種類。 -
policy: ポリシーの名前。 -
policy_namespace: ポリシーが定義されているマネージドクラスター上の namespace。 -
severity: ポリシーで指定された重大度。
これらのラベルと値を使用すると、追跡が困難な可能性のあるクラスター内の変更に対して、詳細なクエリーを実行できます。
注記: cluster_policy_governance_info メトリクスを、可観測性の allowlist にカスタムメトリクスとして追加することもできます。詳細は、カスタムメトリクスの追加 を参照してください。
3.5.3. メトリック: config_policies_evaluation_duration_seconds リンクのコピーリンクがクリップボードにコピーされました!
config_policies_evaluation_duration_seconds ヒストグラムは、クラスターで評価する準備ができているすべての設定ポリシーを処理するのにかかる秒数を追跡します。次のメトリックを使用して、ヒストグラムをクエリーします。
-
config_policies_evaluation_duration_seconds_bucket: バケットは累積的であり、可能なエントリー (1、3、9、10.5、15、30、60、90、120、180、300、450、600、およびそれ以上) で秒を表します。 -
config_policies_evaluation_duration_seconds_count: すべてのイベントの数。 -
config_policies_evaluation_duration_seconds_sum: すべての値の合計。
config_policies_evaluation_duration_seconds メトリックを使用して、頻繁に評価する必要がないリソース集約型ポリシーの ConfigurationPolicy evaluationInterval 設定を変更する必要があるかどうかを判断します。また、Kubernetes API サーバーでのリソース使用率が高くなる代わりに、同時実行数を増やすこともできます。詳細は、同時実行の設定 セクションを参照してください。
設定ポリシーの評価に使用された時間に関する情報を取得するには、次の式のような Prometheus クエリーを実行します。
rate(config_policies_evaluation_duration_seconds_sum[10m])/rate (config_policies_evaluation_duration_seconds_count[10m]
open-cluster-management-agent-addon namespace のマネージドクラスターで実行している config-policy-controller Pod がメトリックを計算します。デフォルトでは、config-policy-controller はメトリックを observability に送信しません。