产品动态
Nginx Ingress Controller Exporter 接入
操作场景
在使用 Nginx Ingress Controller 过程中需要对 Nginx Ingress Controller 运行状态进行监控，以便了解 Nginx Ingress Controller 服务是否运行正常，排查 Nginx Ingress Controller 故障等。腾讯云可观测平台 Prometheus 监控服务提供了开箱即用的 Nginx Ingress Controller Grafana 监控大盘，本文将为您介绍如何使用 Prometheus 监控 Nginx Ingress Controller。
接入方式
前提条件
在 Prometheus 实例对应地域及私有网络（VPC）下，创建腾讯云容器服务 Kubernetes 集群，并为集群创建 命名空间。
在容器集群中已成功部署自建的 Nginx Ingress。
在 Prometheus 监控服务控制台，选择对应的 Prometheus 实例，在数据采集 > 集成容器服务中找到对应容器集群完成关联集群操作。可参见指引 关联集群。
操作步骤
步骤1：确认 Nginx Ingress 暴露指标
1. 用户使用社区提供的 Helm repo 进行安装。需确认 values.yaml 中设置了开启指标的配置项 metrics，具体配置如下：
controller:metrics:port: 10254portName: metrics
2. 用户自行创建 Nginx Ingress 工作负载。
2.1 需在工作负载 ingress-nginx-controller 的端口设置 spec.template.spec.containers[0].ports 中增加以下配置项：
- containerPort: 10254name: metricsprotocol: TCP
配置完成后的效果如下图所示：
2.2 如果使用 v1.12.0及以上的 ingress-nginx-controller 镜像版本，还需在启动参数中增加开启指标的配置项，需在工作负载 ingress-nginx-controller 的参数设置 spec.template.spec.containers[0].args 中增加配置项
--enable-metrics=true，配置完成后的效果如下图所示：
2.3 重启工作负载 ingress-nginx-controller 以应用最新配置。
步骤2：添加采集任务
1. 登录 Prometheus 监控服务控制台，选择对应 Prometheus 实例进入管理页面。
2. 在数据采集 > 集成容器服务中选择已经关联的集群，通过数据采集配置 > 新建自定义监控来添加采集配置。
通过服务发现添加
PodMonitors 来定义 Prometheus 抓取任务，选择 yaml 编辑 > PodMonitors，填写 yaml 配置后单击确定即可，如下图所示：
YAML 配置示例如下：
apiVersion: monitoring.coreos.com/v1kind: PodMonitormetadata:name: ingress-nginx-monitor # 填写一个唯一名称namespace: prom-xxxxxxxx # 可填 prometheus 实例 ID 对应的 namespace，也可填写 ingress-nginx-controller 所在的 namespacespec:podMetricsEndpoints:- interval: 30sport: metrics # 填写步骤1 values.yaml 中 metrics 对应的 portNamepath: /metricshonorLabels: truerelabelings:- action: labeldropregex: endpointnamespaceSelector: # 选择要监控的 ingress-nginx-controller pod 所在的 namespacematchNames:- ingress-nginxselector: # 填写要监控 pod 的 Label 值，以定位目标 podmatchLabels:app.kubernetes.io/name: ingress-nginxapp.kubernetes.io/component: controller
通过控制台的页面编辑能力添加 Prometheus 原生采集配置，选择页面编辑，根据提示填充各配置项。配置完成后单击确定即可，具体示例如下：
监控类型选择 PodMonitors。
采集任务填写一个唯一名称。
命名空间选择 ingress-nginx-controller 所在的命名空间。
工作负载类型选择 ingress-nginx-controller 的负载类型。
工作负载选择 ingress-nginx-controller 的负载名称。
targetPort 填写步骤一中设置的端口号数字。
metricsPath 保持为 /metrics。
步骤3：验证
1. 在当前 Prometheus 实例，在数据采集 > 集成容器服务中选择对应集群，通过数据采集配置 > 自定义监控来查看采集配置。
2. 找到步骤二中添加的采集配置（二者选其一即可），查看指标采集速率是否大于0，Targets 是否与 ingress-nginx-controller pod 数量一致且均为 up 状态，如下图所示：
3. 单击采集配置对应的指标明细，可查看指标的采集详情，检查指标列表中包含以 nginx_ingress 为前缀的指标即可，如下图所示：
查看监控
前提条件
Prometheus 实例已绑定 Grafana 实例。
操作步骤
1. 登录 Prometheus 监控服务控制台，选择对应 Prometheus 实例进入管理页面。
2. 在数据采集 > 集成中心中找到并单击 Nginx Ingress Controller 监控，选择 Dashboard > Dashboard 操作 > Dashboard 安装/升级，单击安装/升级即可开启 Nginx Ingress Controller 监控大盘。
3. 在实例基本信息页面，找到绑定的 Grafana 地址，打开并登录，然后在 middleware 文件夹中找到 nginx-ingress 相关面板，即可观察上述 ingress-nginx-controller 的 dashboards，如下图所示：
NGINX Ingress controller：
Request Handling Performance：
文档反馈