# 采集NGINX Ingress访问日志
CCE云原生日志采集插件支持收集NGINX Ingress控制器插件日志，可分析历史流量变化情况，得到业务流量特征，为业务决策提供数据支持。
#### 约束与限制
- 集群中需安装2.2.82及以上、2.6.32及以上、3.0.8及以上版本的[NGINX Ingress控制器](https://support.huaweicloud.com/usermanual-cce/cce_10_0034.html)插件。
- 集群中需安装1.6.0及以上版本的[云原生日志采集插件](https://support.huaweicloud.com/usermanual-cce/cce_10_0416.html)。
 
#### 费用说明
LTS创建日志组免费，并每月赠送每个账号一定量免费日志采集额度，超过免费额度部分将产生费用（[价格计算器](https://www.huaweicloud.com/pricing.html?tab=detail#/lts)）。
#### 步骤一：开启插件日志采集
集群中需要安装NGINX Ingress控制器插件，并在插件中开启"日志采集"功能。
![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/note_3.0-zh-cn.png)
开启日志采集后，日志中心默认采集标准输出的采集策略（default-stdout）将不再采集NGINX Ingress控制器插件的日志。
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 选择左侧导航栏的"插件中心"。
3. 找到**NGINX Ingress控制器** 插件并开启"日志采集"功能。
   - 已安装插件时：单击"管理"，找到已安装的插件实例，单击右侧"编辑"，在参数配置中找到"日志采集"并开启。 如果集群中安装了多个NGINX Ingress控制器，需修改每个插件实例的配置才可采集所有实例的日志。
     
   
   - 未安装插件时：单击"安装"，在参数配置中找到"日志采集"并开启。其余参数请根据需求选择，配置说明请参见[NGINX Ingress控制器](https://support.huaweicloud.com/usermanual-cce/cce_10_0034.html)。
   
   
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002038295885.png "点击放大")
   
 
#### 步骤二：在日志中心采集NGINX Ingress控制器插件日志
根据不同的场景，开通NGINX Ingress控制器插件日志采集的步骤如下：
- [集群未开通日志中心]
  如果集群未开通日志中心，您可以在开通日志中心时通过勾选"采集插件日志（NGINX Ingress控制器容器标准输出）"选项，直接创建NGINX Ingress插件的默认日志采集策略。
  1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
  
  2. 选择左侧导航栏的"日志中心"。
  
  3. 未进行授权的用户需要先授权，已授权的用户可忽略本步骤。 在弹出框中单击"确认授权"。
     图1添加授权   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002038186289.png "点击放大")
     
     
  
  4. 在页面中勾选需要采集的日志类型，单击"开启"，等待约30秒后，页面自动跳转。
     图2开启   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002051269276.png "点击放大")
     - 采集容器标准输出：您可按需开启，开启后将创建名为default-stdout的日志策略，并上报所有命名空间下的标准输出到云日志服务（LTS）。
     
     - 采集Kubernetes事件：您可按需开启，开启后将创建名为default-event的日志策略，并上报所有命名空间下的Kubernetes事件到云日志服务（LTS）。
     
     - 采集插件日志（NGINX Ingress控制器容器标准输出）：本示例中必选，需要安装NGINX Ingress控制器插件，并在插件中开启"日志采集"功能。 开启后，将创建名为default-nginx-ingress的日志策略，采集NGINX Ingress控制器插件标准输出，并上报到云日志服务（LTS）。
       
      
   
- [集群已开通日志中心]
  如果集群已开通日志中心，但未开通NGINX Ingress控制器插件日志采集，您可以手动创建一个日志采集策略。
  1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
  
  2. 选择左侧导航栏的"日志中心"。
  
  3. 右上角单击"日志采集策略"，将显示当前集群所有上报LTS的日志策略。
  
  4. 单击上方"创建日志采集策略"，勾选"采集插件日志（NGINX Ingress控制器容器标准输出）"，单击确定。
     图3创建日志策略   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002022975113.png "点击放大") 
  
  5. 系统将自动创建名为default-nginx-ingress的日志采集策略。创建完成后，您可前往"日志中心"页面，选择"插件日志"页签，即可查看该插件上报到云日志服务（LTS）的日志。
     图4查看日志   
     ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000001974892636.png "点击放大") 
   
#### 步骤三：查看NGINX Ingress控制器插件日志
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 在左侧导航栏中选择"日志中心"。
3. 选择"插件日志"页签，选中插件为"NGINX Ingress控制器"。关于该页面的操作详情，请参见[LTS用户指南](https://support.huaweicloud.com/usermanual-lts/lts_07_0076.html)。
   图5查看NGINX Ingress控制器插件日志   
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002036105353.png "点击放大")
   
   
4. 如果集群中同时安装多套NGINX Ingress控制器，且多个控制器均开启了日志采集，此处的日志将显示所有控制器的日志，您可以在筛选栏中通过appName进行筛选。
   其中appName的取值如下：
   - NGINX Ingress控制器名称为nginx，appName为**cceaddon-nginx-ingress-controller**。
   
   - NGINX Ingress控制器名称为其他自定义名称，如{className}，则appName为**cceaddon-nginx-ingress-*{className}*-controller**。
    
   筛选cceaddon-nginx-ingress-controller的日志示例如下，关于其中日志格式的说明请参见[Log format](https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/log-format/)：
   ```
   appName : cceaddon-nginx-ingress-controller
   ```
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002038193073.png "点击放大")
   
   
 
#### 步骤四：查看NGINX Ingress仪表盘
CCE支持采集NGINX Ingress日志，并借助LTS日志服务进行多维度分析，并为NGINX日志配置结构化和仪表盘，满足不同场景的监控需求。详情请参见[NGINX仪表盘模板](https://support.huaweicloud.com/usermanual-lts/lts_07_0018.html)。
查看NGINX Ingress仪表盘的步骤如下：
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，单击集群名称进入集群。
2. 在左侧导航栏中选择"日志中心"。
3. 选择"插件日志"页签，选中"仪表盘"页面，您可以选择不同的仪表盘模板。
4. 如果集群中同时安装多套NGINX Ingress控制器，且多个控制器均开启了日志采集，此处的日志将显示所有控制器的日志，您可以在筛选栏中通过appName进行筛选。
   其中appName的取值如下：
   - NGINX Ingress控制器名称为nginx，appName为**cceaddon-nginx-ingress-controller**。
   
   - NGINX Ingress控制器名称为其他自定义名称，如{className}，则appName为**cceaddon-nginx-ingress-*{className}*-controller**。
    
   ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002038365565.png "点击放大")
   
   
支持**监控中心** 、**访问中心** 和**秒级监控**仪表盘，不同仪表盘的说明如下：
- [监控中心]
  监控中心主要展示NGINX Ingress的基本信息，支持不同时间维度（相对时间、整点时间、自定义时间段）的呈现，包括以下参数报表：
  - 访问数据：访问量PV、访问量UV、请求成功率、平均延迟、4XX请求数、404请求数、429请求数、5XX请求数、504请求数、状态码分布、流量、访问失败率和延迟。
  
  - TOP统计：包括Host请求TOP、Host延迟TOP、Host失败率TOP、URL请求TOP、URL延迟TOP、URL失败率TOP、后端请求TOP、后端延迟TOP和后端失败率TOP。
  
  
  ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002038566229.png "点击放大")
  
- [访问中心]
  访问中心主要提供细致的访问请求统计信息，支持不同时间维度（相对时间、整点时间、自定义时间段）的呈现，包括以下参数报表：
  - 数据对比：PV对比昨日、PV对比上周、UV对比昨日、UV对比上周、今日PV/UV、7日PV/UV。
  
  - 数据分布：访问量PV分布（中国）、访问量PV分布（世界）、访问量UV分布（中国）、访问量UV分布（世界）、平均时延分布（中国）、平均时延分布（世界）、设备占比（终端）、设备占比（系统）。
  
  - TOP统计：区域访问TOP10（省份）、区域访问TOP10（城市）、Host访问TOP10、UserAgent访问TOP10、TOP URL、TOP 访问IP。
  
  
  ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002039140473.png "点击放大")
  
- [秒级监控]
  CCE提供NGINX Ingress秒级监控能力，收集和分析关键性能指标，可实时洞察NGINX Ingress网络流量和应用性能，包括QPS、成功率、延迟、流量、状态码、后端响应码等图表。
  ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000002003141302.png "点击放大")
  
#### 相关文档
#### 日志格式说明
关于NGINX Ingress控制器日志格式的说明，请参见[Log format](https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/log-format/)。
#### 更多日志管理功能
NGINX Ingress控制器日志采集后会接入LTS，您可以在LTS控制台使用更多日志功能，如日志分析、日志告警等，详情请参考[LTS帮助中心](https://support.huaweicloud.com/lts/index.html)。