文档中心

容器服务

请输入

网络

自定义 Nginx Ingress Controller 观测最佳实践

ingress 作为集群中接入层的资源对象，其稳定性与业务质量息息相关。本文为您介绍集群中自定义 Nginx Ingress Controller 的监控最佳实践。

背景信息

容器服务支持在集群中同时部署多套独立的 Nginx Ingress Controller 服务，各服务之间互不影响，包括：

系统默认 ingress-nginx：在集群组件中心中，使用 ingress-nginx 组件部署，并按照系统提示安装。详情请参见 ingress-nginx 组件。

自定义 ingress-nginx：在容器服务应用中心中，使用模板部署自定义的 ingress-nginx 应用。详情请参见部署多套 Nginx Ingress Controller。

日志采集

默认情况下，自定义 Nginx Ingress Controller 的日志没有进行采集和持久化存储，需要您进行配置开启，实现自定义 Nginx Ingress Controller 日志持久化采集、存储以及查询。

前提条件

已开通火山引擎日志服务。

已在日志服务中创建日志项目和日志主题。详细操作，请参见日志项目和日志主题。

已在集群中部署自定义 Nginx Ingress Controller，详情请参见部署多套 Nginx Ingress Controller。

配置日志采集

登录容器服务控制台。

单击左侧导航栏中的集群。

在集群列表页面，单击目标集群。

在集群管理页面的左侧导航栏中，单击日志中心。

选择日志采集规则页签，单击新建采集规则，配置自定义 Nginx Ingress Controller 的日志采集。

配置日志的存储位置，包括 IAM 项目、日志项目和日志主题。完成后，单击下一步，采集规则。

配置日志采集规则。

配置项	说明
规则名称	配置采集规则的名称。在同一个集群下，名称必须唯一。
采集类型	配置日志采集类型，本例中选择 K8s 容器标准输出。
采集信息	配置日志采集信息，本例中选择标准输出-stdout 和标准错误-stderr。
K8s 采集规则	勾选启用，并基于命名空间、工作负载名称等参数指定需要进行日志采集的容器。 Namespace：配置自定义 ingress-nginx 所在的命名空间。工作负载类型：勾选启用，并选择无状态负载。工作负载名称：配置自定义 ingress-nginx 的工作负载名称。

其他配置，保持缺省即可。完成后，单击下一步：检查索引配置。

说明

更多容器日志采集规则的配置方式和参数解释，请参见采集容器标准输出。

配置日志检查索引。本例中保持缺省。

单击提交，完成配置。

查看日志

在集群管理页面的左侧导航栏中，单击日志中心。

选择容器日志页签，并选择正确的项目、日志项目和日志主题，即可查看自定义 Nginx Ingress Controller 的日志。

监控和告警

您可以在集群中开启云原生观测功能，实现对自定义 Nginx Ingress Controller 的监控和告警。

前提条件

已开通托管 Prometheus。

已创建托管 Prometheus 工作区，详情请参见创建工作区。

已在集群中部署自定义 Nginx Ingress Controller，详情请参见部署多套 Nginx Ingress Controller。

配置指标采集

在集群中开启云原生观测，详情请参见开启云原生观测。

开启 Ingress 服务观测，详情请参见 Ingress 服务观测。

（可选）配置服务发现。

说明

当您的自定义 Nginx Ingress Controller 部署在 kube-system 命名空间时，无需配置服务发现，即可查看实例的指标和大盘。

当您的自定义 Nginx Ingress Controller 部署在其他命名空间时，需要配置服务发现，才能查看实例的指标和大盘。

在集群管理页面的左侧导航栏中，单击服务与路由 > 服务，在命名空间下拉菜单中选择目标命名空间。

在服务列表中，选择名称为 *-ingress-nginx-controller-metrics的服务。其中 *代表您自定义的名称。例如：本例中的服务名称为nginx-ingress-nginx-controller-metrics。

在操作栏中，选择 ... > 更新，为服务配置如下 Annotation，实现服务发现。

prometheus.io/scrape: "true" # 配置为 true 表示开启采集
prometheus.io/port: "10254" # 配置为采集指标暴露的端口号
prometheus.io/path: "/metrics" # 填写指标暴露的 URI 路径，一般是 /metrics