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>

     重要

     在检查了记录的查询信息后，恢复配置映射的设置。

• 要在 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>

     重要

     在检查了记录的查询信息后，恢复配置映射的设置。