1.3.3. カスタムメトリクスの追加

metrics_list.yaml ファイルにメトリクスを追加して、マネージドクラスターから収集されるようにします。

カスタムメトリクスを追加するには、以下の手順を実行します。

  1. クラスターにログインします。

  2. mco observability が有効化されていることを確認します。status.conditions.message の メッセージが Observability components are deployed and running となっていることを確認します。以下のコマンドを実行します。 

    oc get mco observability -o yaml

  3. 以下の内容で、observability-metrics-custom-allowlist.yaml という名前のファイルを作成します。metrics_list.yaml パラメーターにカスタムメトリクスの記録ルールと名前を追加します。たとえば、マネージドクラスターから node_memory_MemTotal_bytes および apiserver_request_duration_seconds:histogram_quantile_90 を収集します。ConfigMap の YAML は、以下の内容のようになります。 

    kind: ConfigMap
apiVersion: v1
metadata:
  name: observability-metrics-custom-allowlist
data:
  metrics_list.yaml: |
    names:
      - node_memory_MemTotal_bytes
    rules:
    - record: apiserver_request_duration_seconds:histogram_quantile_90
      expr: histogram_quantile(0.90,sum(rate(apiserver_request_duration_seconds_bucket{job=\"apiserver\",
        verb!=\"WATCH\"}[5m])) by (verb,le))
    • names セクションで、マネージドクラスターから収集されるカスタムメトリクスの名前を追加します。
    • rules セクションで、expr および record パラメーターペアに値を 1 つだけ入力し、クエリー式を定義します。メトリクスは、マネージドクラスターの record パラメーターで定義される名前で収集されます。クエリー式の実行後の結果が、メトリクスの値として返されます。
    • names と rules セクションはオプションです。セクションのいずれかまたは両方を使用できます。

  4. 以下のコマンドを実行して、open-cluster-management-observability namespace に observability-metrics-custom-allowlist ConfigMap を作成します。 

    oc apply -n open-cluster-management-observability -f observability-metrics-custom-allowlist.yaml
  5. Grafana ダッシュボードでメトリクスを表示して、カスタムメトリクスがマネージドクラスターから収集されていることを確認します。ハブクラスターから、Grafana ダッシュボード のリンクを選択します。
  6. Grafana 検索バーから、表示するメトリクスを入力します。カスタムメトリクスからデータを収集します。
  7. 更新したメトリクスを Grafana ダッシュボードで使用する場合は、「Grafana ダッシュボードの設計」を参照してダッシュボードを更新します。