6.3. Prometheus のクエリーログファイルの有効化

前提条件

• openshift-monitoring プロジェクトで Prometheus のクエリーログファイル機能を有効にしている場合:

  • cluster-admin クラスターロールを持つユーザーとしてクラスターにアクセスできる。
  • cluster-monitoring-config ConfigMap オブジェクトを作成している。

• openshift-user-workload-monitoring プロジェクトで Prometheus のクエリーログファイル機能を有効にしている場合:

  • cluster-admin クラスターロールを持つユーザーとして、または openshift-user-workload-monitoring プロジェクトの user-workload-monitoring-config-edit ロールを持つユーザーとして、クラスターにアクセスできる。
  • クラスター管理者は、ユーザー定義プロジェクトのモニタリングを有効にしている。
• OpenShift CLI (oc) がインストールされている。

手順

• openshift-monitoring プロジェクトで Prometheus のクエリーログファイルを設定するには、以下を実行します。

  1. openshift-monitoring プロジェクトで cluster-monitoring-config ConfigMap オブジェクトを編集します。

     $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

  2. data/config.yamlの下のprometheusK8sのqueryLogFile: <path> を追加します:

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: cluster-monitoring-config
       namespace: openshift-monitoring
     data:
       config.yaml: |
         prometheusK8s:
           queryLogFile: <path> 1

     1

     クエリーがログに記録されるファイルへのフルパス。

  3. 変更を適用するためにファイルを保存します。新しい設定の影響を受ける Pod は自動的に再デプロイされます。

  4. コンポーネントの Pod が実行中であることを確認します。次のコマンドの例は、openshift-monitoringプロジェクトの Pod のステータスを一覧表示します。

     $ oc -n openshift-monitoring get pods

  5. クエリーログを読みます。

     $ oc -n openshift-monitoring exec prometheus-k8s-0 -- cat <path>

     重要

     ログに記録されたクエリー情報を確認した後、config map の設定を元に戻します。

• openshift-user-workload-monitoringプロジェクトで Prometheus のクエリーログファイルを設定するには、以下を実行します。

  1. openshift-user-workload-monitoring プロジェクトで user-workload-monitoring-config ConfigMap オブジェクトを編集します。

     $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

  2. data/config.yaml の下の prometheus の queryLogFile: <path> を追加します:

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: user-workload-monitoring-config
       namespace: openshift-user-workload-monitoring
     data:
       config.yaml: |
         prometheus:
           queryLogFile: <path> 1

     1

     クエリーがログに記録されるファイルへのフルパス。

  3. 変更を適用するためにファイルを保存します。新しい設定の影響を受ける Pod は自動的に再デプロイされます。

  4. コンポーネントの Pod が実行中であることを確認します。以下の例は、openshift-user-workload-monitoring プロジェクトの Pod のステータスを一覧表示します。

     $ oc -n openshift-user-workload-monitoring get pods

  5. クエリーログを読みます。

     $ oc -n openshift-user-workload-monitoring exec prometheus-user-workload-0 -- cat <path>

     重要

     ログに記録されたクエリー情報を確認した後、config map の設定を元に戻します。