Nginx Exporter 接入

Nginx 通过 stub_status 页面暴露了部分监控指标。Nginx Prometheus Exporter 会采集单个 Nginx 实例指标，并将其转化为 Prometheus 可用的监控数据， 最终通过 HTTP 协议暴露给 Prometheus 服务进行采集。我们可以通过 Exporter 上报重点关注的监控指标，用于异常报警和大盘展示。

操作步骤

使用 Docker 容器运行 Exporter

方式1：使用 nginx-prometheus-exporter 通过 Docker 容器快速部署 Exporter。执行 Docker 命令如下：

$ docker run -p 9113:9113 nginx/nginx-prometheus-exporter:0.8.0 -nginx.scrape-uri http://<nginx>:8080/stub_status

方式2：使用 nginx-prometheus-exporter 镜像将服务部署在腾讯云 容器服务 TKE 中，通过托管 Prometheus 的监控自发现 CRD PodMonitor 或者 ServiceMonitor 来采集监控数据。

使用二进制程序运行 Exporter

下载安装

1. 根据实际运行环境在社区中下载相应的 Nginx Prometheus Exporter 。
2. 安装 Nginx Prometheus Exporter。

开启 NGINX stub_status 功能

1. 开源 Nginx 提供一个简单页面用于展示状态数据，该页面由 tub_status 模块提供。执行以下命令检查 Nginx 是否已经开启了该模块：
   

   nginx -V 2>&1 | grep -o with-http_stub_status_module
   

   • 如果在终端中输出 with-http_stub_status_module ，则说明 Nginx 已启用 tub_status 模块。
   • 如果未输出任何结果，则可以使用 --with-http_stub_status_module 参数从源码重新配置编译一个 Nginx。示例如下：
     

     ./configure \
     … \
     --with-http_stub_status_module
     make
     sudo make install
     

2. 确认 stub_status 模块启用之后，修改 Nginx 的配置文件指定 status 页面的 URL。示例如下：
   

   server { location /nginx_status { stub_status access_log off allow 127.0.0.1
           deny all
       }
   }
   

3. 检查并重新加载 nginx 的配置使其生效。
   

   nginx -t
   nginx -s reload
   

4. 完成上述步之后，可以通过配置的 URL 查看 Nginx 的指标：
   

   Active connections: 45
   server accepts handled requests
   1056958 1156958 4491319
   Reading: 0 Writing: 25 Waiting : 7
   

运行 NGINX Prometheus Exporter

执行以下命令启动 NGINX Prometheus Exporter：

$ nginx-prometheus-exporter -nginx.scrape-uri http://<nginx>:8080/nginx_status

上报指标

• nginxexporter_build_info -- exporter 编译信息。
• 所有的 stub_status 指标。
• nginx_up -- 展示上次抓取的状态：1表示抓取成功， 0表示抓取失败。

配置 Prometheus 的抓取 Job

1. Nginx Prometheus Exporter 正常运行后，执行以下命令，将 Job 添加到 Prometheus 的抓取任务中。
   

   ... - job_name: 'nginx_exporter' static_configs: - targets: ['your_exporter:port']                    
   

2. 通常情况下 ，Exporter 和 Nginx 并非共同运行，所以数据上报的 instance 并不能真实描述是哪个实例，为了方便数据的检索和观察，我们可以修改 instance 标签，使用真实的 IP 进行替换以便更加直观。示例如下：
   

   ... - job_name: 'nginx_exporter' static_configs: - targets: ['your_exporter:port'] relabel_configs: - source_labels: [__address__] regex: '.*' target_label: instance replacement: '10.0.0.1:80'
   

启用数据库监控大盘

Prometheus 监控服务在 Grafana 中提供预先配置的 Nginx Exporter Dashboard，您可以根据以下操作步骤查看 Nginx 监控数据。

1. 登录 Prometheus 监控服务控制台。
2. 单击对应实例 ID 右侧的，即可查看数据。
   

在使用数据库 Redis 过程中需要对 Redis 运行状态进行监控，以便了解 Redis 服务是否运行正常，排查 Redis 故障等。Prometheus 监控服务提供基于 Exporter 的方式来监控 Redis 运行状态，并提供了开箱即用的 Grafana 监控大盘。本文为您介绍如何使用 Prometheus 监控 Redis。

说明：

为了方便安装管理 Exporter，推荐使用腾讯云 容器服务 进行统一管理。

前提条件

操作步骤

Exporter 部署

使用 Secret 管理 Redis 密码

1. 在左侧菜单中选择工作负载 > Deployment，进入 Deployment 页面。
2. 在页面右上角单击 YAML 创建资源，创建 YAML 配置，配置说明如下：
   使用 Kubernetes 的 Secret 来管理密码并对密码进行加密处理，在启动 Redis Exporter 的时候直接使用 Secret Key，需要调整对应的 password，YAML 配置示例如下：

   apiVersion: v1
   kind: Secret
   metadata:
    name: redis-secret-test
    namespace: redis-test
   type: Opaque
   stringData:
    password: you-guess  

部署 Redis Exporter

在 Deployment 管理页面，单击新建，选择对应的命名空间来进行部署服务。可以通过控制台的方式创建，如下以 YAML 的方式部署 Exporter，YAML 配置示例如下：

说明：

更多 Exporter 详细参数介绍请参见 redis_exporter。

apiVersion: apps/v1
kind: Deployment
metadata:
 labels:
 k8s-app: redis-exporter name: redis-exporter namespace: redis-test
spec:
 replicas: 1
 selector:
 matchLabels:
 k8s-app: redis-exporter template:
 metadata:
 labels:
 k8s-app: redis-exporter spec:
 containers:
 - env:
 - name: REDIS_ADDR
 value: ip:port - name: REDIS_PASSWORD
 valueFrom:
 secretKeyRef:
 name: redis-secret-test
 key: password
 image: ccr.ccs.tencentyun.com/rig-agent/redis-exporter:v1.32.0
 imagePullPolicy: IfNotPresent
 name: redis-exporter
 ports:
 - containerPort: 9121
 name: metric-port securityContext:
 privileged: false
 terminationMessagePath: /dev/termination-log
 terminationMessagePolicy: File
 dnsPolicy: ClusterFirst
 imagePullSecrets:
 - name: qcloudregistrykey
 restartPolicy: Always
 schedulerName: default-scheduler
 securityContext: {}
 terminationGracePeriodSeconds: 30

验证

1. 在 Deployment 页面单击上述步骤创建的 Deployment，进入 Deployment 管理页面。
2. 单击日志页签，可以查看到 Exporter 成功启动并暴露对应的访问地址，如下图所示：
   
3. 单击 Pod 管理页签，进入 Pod 页面。
4. 在右侧的操作项下单击远程登录登录 Pod，在命令行窗口中执行以下 curl 命令对应 Exporter 暴露的地址，可以正常得到对应的 Redis 指标。如发现未能得到对应的数据，请检查一下 REDIS_ADDR 和 REDIS_PASSWORD 是否正确。示例如下：
   

   curl localhost:9121/metrics

   命令执行结果如下图所示：
   

添加采取任务

1. 登录 Prometheus 监控服务控制台，选择对应 Prometheus 实例进入管理页面。
2. 通过集成容器服务列表单击集群 ID 进入到容器服务集成管理页面。
3. 通过服务发现添加 Pod Monitor 来定义 Prometheus 抓取任务，YAML 配置示例如下：

apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
 name: redis-exporter namespace: cm-prometheus spec:
 podMetricsEndpoints:
 - interval: 30s
 port: metric-port path: /metrics relabelings:
 - action: replace
 sourceLabels:
 - instance
 regex: (.*)
 targetLabel: instance
 replacement: 'crs-xxxxxx' - action: replace
 sourceLabels:
 - instance
 regex: (.*)
 targetLabel: ip
 replacement: '1.x.x.x' namespaceSelector: matchNames:
 - redis-test
 selector: matchLabels:
 k8s-app: redis-exporter

说明：

由于 Exporter 和 Redis 部署在不同的服务器上，因此建议通过 Prometheus Relabel 机制将 Redis 实例的信息放到监控指标中，以方便定位问题。

查看监控

1. 登录 Prometheus 监控服务控制台，选择对应 Prometheus 实例进入管理页面。
2. 单击集成中心，进入集成中心页面。找到 Redis 监控，安装对应的 Grafana Dashboard 即可开启 Redis 监控大盘，查看实例相关的监控数据，如下图所示：
   

告警以及接入

MySQL Exporter 是社区专门为采集 MySQL/MariaDB 数据库监控指标而设计开发，通过 Exporter 上报核心的数据库指标，用于异常报警和监控大盘展示，云监控 Prometheus 提供了与 MySQL Exporter 集成及开箱即用的 Grafana 监控大盘。

目前，Exporter 支持高于5.6版本的 MySQL 和高于10.1版本的 MariaDB。在 MySQL/MariaDB 低于5.6版本时，部分监控指标可能无法被采集。

说明：

为了方便安装管理 Exporter，推荐使用腾讯云 容器服务 来统一管理。

前提条件

操作步骤

数据库授权

因为 MySQL Exporter 是通过查询数据库中状态数据来对其进行监控，所以需要为对应的数据库实例进行授权。帐号和密码需根据实际情况而定，授权步骤如下：

1. 登录 云数据库 MySQL 控制台。
2. 在实例列表页面单击需要授权的数据库名称，进入数据库详情页。
3. 选择数据库管理 > 帐号管理，进入帐号管理页面，根据业务实际需要创建监控建立的账号。
4. 单击帐号右侧操作项下的修改权限，修改对应权限。示例如下图所示：
   您可以通过执行以下命令进行授权：

   CREATE USER 'exporter'@'ip' IDENTIFIED BY 'XXXXXXXX' WITH MAX_USER_CONNECTIONS 3;
   GRANT PROCESS, REPLICATION CLIENT, SELECT ON *.* TO 'exporter'@'ip';

   说明：

   建议为该用户设置最大连接数限制，以避免因监控数据抓取对数据库带来影响。但并非所有的数据库版本中都可以生效，例如 MariaDB 10.1 版本不支持最大连接数设置，则无法生效。详情请参见 MariaDB 说明。

Exporter 部署

使用 Secret 管理 MySQL 连接串

1. 在左侧菜单中选择工作负载 > Deployment，进入 Deployment 页面。
2. 在页面右上角单击 YAML 创建资源，创建 YAML 配置，配置说明如下：
   使用 Kubernetes 的 Secret 来管理连接串，并对连接串进行加密处理，在启动 MySQL Exporter 的时候直接使用 Secret Key，需要调整对应的连接串，YAML 配置示例如下：

apiVersion: v1
kind: Secret
metadata:
 name: mysql-secret-test
 namespace: mysql-demo
type: Opaque
stringData:
 datasource: "user:password@tcp(ip:port)/"  

部署 MySQL Exporter

在 Deployment 管理页面，选择对应的命名空间来进行部署服务，可以通过控制台的方式创建。如下以 YAML 的方式部署 Exporter， 配置示例如下：

apiVersion: apps/v1
kind: Deployment
metadata:
 labels:
 k8s-app: mysql-exporter name: mysql-exporter namespace: mysql-demo
spec:
 replicas: 1
 selector:
 matchLabels:
 k8s-app: mysql-exporter template:
 metadata:
 labels:
 k8s-app: mysql-exporter spec:
 containers:
 - env:
 - name: DATA_SOURCE_NAME
 valueFrom:
 secretKeyRef:
 name: mysql-secret-test
 key: datasource
 image: ccr.ccs.tencentyun.com/rig-agent/mysqld-exporter:v0.12.1
 imagePullPolicy: IfNotPresent
 name: mysql-exporter
 ports:
 - containerPort: 9104
 name: metric-port 
 terminationMessagePath: /dev/termination-log
 terminationMessagePolicy: File
 dnsPolicy: ClusterFirst
 imagePullSecrets:
 - name: qcloudregistrykey
 restartPolicy: Always
 schedulerName: default-scheduler
 securityContext: {}
 terminationGracePeriodSeconds: 30

验证

1. 在 Deployment 页面单击上述步骤创建的 Deployment，进入 Deployment 管理页面。
2. 单击日志页签，可以查看到 Exporter 成功启动并暴露对应的访问地址，如下图所示：
   
3. 单击 Pod 管理页签进入 Pod 页面。
4. 在右侧的操作项下单击远程登录登录 Pod，在命令行窗口中执行以下 curl 命令对应 Exporter 暴露的地址，可以正常得到对应的 MySQL 指标。如发现未能得到对应的数据，请检查连接串是否正确，具体如下：

curl localhost:9104/metrics

执行结果如下图所示：

添加采取任务

1. 登录 云监控 Prometheus 控制台，选择对应 Prometheus 实例进入管理页面。
2. 通过集成容器服务列表单击集群 ID 进入到容器服务集成管理页面。
3. 通过服务发现添加 Pod Monitor 来定义 Prometheus 抓取任务，YAML 配置示例如下：

apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
 name: mysql-exporter namespace: cm-prometheus spec:
 podMetricsEndpoints:
 - interval: 30s
 port: metric-port path: /metrics relabelings:
 - action: replace
 sourceLabels: 
 - instance
 regex: (.*)
 targetLabel: instance
 replacement: 'crs-xxxxxx' - action: replace
 sourceLabels: 
 - instance
 regex: (.*)
 targetLabel: ip
 replacement: '1.x.x.x' namespaceSelector: matchNames:
 - mysql-demo
 selector: matchLabels:
 k8s-app: mysql-exporter

查看监控

1. 登录 云监控 Prometheus 控制台，选择对应 Prometheus 实例进入管理页面。
2. 单击集成中心，进入集成中心页面。找到 MySQL 监控，安装对应的 Grafana Dashboard 即可开启 MySQL 监控大盘，查看实例相关的监控数据，如下图所示：
   

告警以及接入

腾讯云 Prometheus 托管服务内置了部分 MySQL 数据库的报警策略模板，可根据业务实际的情况调整对应的阈值来添加告警策略。详情请参见 新建告警策略。

MySQL Exporter 采集参数说明

MySQL Exporter 使用各种 Collector 来控制采集数据的启停，具体参数如下：

全局配置参数

heartbeat 心跳检测

如果开启 collect.heartbeat， mysqld_exporter 会通过心跳检测机制抓取复制延迟数据。