# 配置容器服务日志采集路径 AOM支持容器服务日志采集，并展现在AOM界面中，以供您检索。使用该功能前首先要配置日志采集路径，配置方法详见如下操作。 #### 注意事项 - ICAgent只采集\*.log、\*.trace和\*.out类型的文本日志文件。 #### 配置步骤 **在CCE中添加日志策略** 1. 在CCE中创建工作负载时，添加容器后，展开"容器日志"页签。 2. 单击"添加日志策略"，设置自定义日志参数，配置日志策略，以nginx为例，不同工作负载根据实际情况配置。 图1添加日志策略 ![](https://support.huaweicloud.com/usermanual-aom/zh-cn_image_0263893519.png "点击放大") 3. 存储类型有"主机路径"和"容器路径"两种类型可供选择： - 主机路径：可将主机上的路径挂载到指定的容器路径。日志策略配置参数如下： 表1添加日志策略-主机路径 | 参数 | 参数说明 | |:---|:---| | 存储类型 | 设置为"主机路径"。将主机上的路径挂载到指定的容器路径。 | | **添加容器挂载** || | \*主机路径 | 容器内日志文件所在路径挂载到主机上的位置，如：/var/paas/sys/log/nginx | | 挂载路径 | 输入数据逻辑卷挂载到容器上的路径，如：/tmp 须知： - 请不要挂载在系统目录下，如"**/** "、"**/var/run"**等，会导致容器异常。建议挂载在空目录下，若目录不为空，请确保目录下无影响容器启动的文件，否则文件会被替换，导致容器启动异常，工作负载创建失败。 - 挂载高危目录的情况下 ，建议使用低权限账号启动，否则可能会造成宿主机高危文件被破坏。 - AOM只采集最近修改过的前20个日志文件，且默认采集两级子目录。 - AOM只采集挂载路径下的".log"、".trace"、".out"文本日志文件。 | | 主机扩展路径 | 会在原先的"卷目录/子目录"中增加一个三级目录。使用户更方便获取单个Pod输出的文件。 - None：不配置拓展路径。 - PodUID：Pod的ID。 - PodName：Pod的名称。 - PodUID/ContainerName：Pod的ID/容器名称。 - PodName/ContainerName：Pod名称/容器名称。 | | 采集路径 | 设置采集路径可以更精确的指定采集内容，当前支持以下设置方式： - 不设置则默认采集当前路径下.log .trace .out文件。 - 设置\*\*表示递归采集5层目录下的.log .trace .out文件。 - 设置\*表示模糊匹配。 例子： 采集路径为/tmp/\*\*/test\*.log 表示采集/tmp目录及其1-5层子目录下的全部以test开头的.log文件。 注意： 使用采集路径功能请确认您的采集器ICAgent版本为5.12.22或以上版本。 | | 日志转储 | 此处日志转储是指日志的本地绕接。 - 设置：AOM每分钟扫描一次日志文件，当某个日志文件超过50MB时，会立即对其转储（转储时会在该日志文件所在的目录下生成一个新的zip文件。对于一个日志文件，AOM只保留最近生成的20个zip文件，当zip文件超过20个时，时间较早的zip文件会被删除），转储完成后AOM会将该日志文件清空。 - 不设置：若您在下拉列表框中选择"不设置"，则AOM不会对日志文件进行转储。 说明： - AOM的日志绕接能力是使用copytruncate方式实现的，如果选择了设置，请务必保证您写日志文件的方式是append（追加模式），否则可能出现文件空洞问题。 - 当前主流的日志组件例如Log4j、Logback等均已经具备日志文件的绕接能力，如果您的日志文件已经实现了绕接能力，则无需设置。否则可能出现冲突。 - 建议您的业务自己实现绕接，可以更灵活的控制绕接文件的大小和个数。 | - 容器路径：日志仅输出到容器路径，无需挂载主机路径。日志策略配置参数如下： ![](https://support.huaweicloud.com/usermanual-aom/public_sys-resources/note_3.0-zh-cn.png) 此功能需要采集器ICAgent版本升级到5.10.79或以上版本。 表2添加日志策略-容器路径 | 参数 | 参数说明 | |:---|:---| | 存储类型 | 设置为"容器路径"。 日志仅输出到容器路径，无需挂载主机路径。此功能需要采集器ICAgent版本升级到5.10.79或以上版本。 | | **添加容器挂载** || | 挂载路径 | 输入数据逻辑卷挂载到容器上的路径，如：/tmp 须知： - 请不要挂载在系统目录下，如"**/** "、"**/var/run"**等，会导致容器异常。建议挂载在空目录下，若目录不为空，请确保目录下无影响容器启动的文件，否则文件会被替换，导致容器启动异常，工作负载创建失败。 - 挂载高危目录的情况下 ，建议使用低权限账号启动，否则可能会造成宿主机高危文件被破坏。 - AOM只采集最近修改过的前20个日志文件，且默认采集两级子目录。 - AOM只采集挂载路径下的".log"、".trace"、".out"文本日志文件。 | | 采集路径 | 设置采集路径可以更精确的指定采集内容，当前支持以下设置方式： - 不设置则默认采集当前路径下.log .trace .out文件。 - 设置\*\*表示递归采集5层目录下的.log .trace .out文件。 - 设置\*表示模糊匹配。 例子： 采集路径为/tmp/\*\*/test\*.log 表示采集/tmp目录及其1-5层子目录下的全部以test开头的.log文件。 注意： 使用采集路径功能请确认您的采集器ICAgent版本为5.12.22或以上版本。 | | 日志转储 | 此处日志转储是指日志的本地绕接。 - 设置：AOM每分钟扫描一次日志文件，当某个日志文件超过50MB时，会立即对其转储（转储时会在该日志文件所在的目录下生成一个新的zip文件。对于一个日志文件，AOM只保留最近生成的20个zip文件，当zip文件超过20个时，时间较早的zip文件会被删除），转储完成后AOM会将该日志文件清空。 - 不设置：若您在下拉列表框中选择"不设置"，则AOM不会对日志文件进行转储。 说明： - AOM的日志绕接能力是使用copytruncate方式实现的，如果选择了设置，请务必保证您写日志文件的方式是append（追加模式），否则可能出现文件空洞问题。 - 当前主流的日志组件例如Log4j、Logback等均已经具备日志文件的绕接能力，如果您的日志文件已经实现了绕接能力，则无需设置。否则可能出现冲突。 - 建议您的业务自己实现绕接，可以更灵活的控制绕接文件的大小和个数。 | **[在ServiceStage中添加日志策略](https://support.huaweicloud.com/usermanual-servicestage/servicestage_03_0058.html)** **在CCI中添加日志策略** 1. 在[创建负载](https://support.huaweicloud.com/usermanual-cci/cci_01_0011.html)时，选择镜像后，单击"高级设置"，展开"日志采集"页签。 2. 添加日志策略。 单击"添加日志存储"，参考[表3]进行配置。 图2在CCI中添加日志策略 ![](https://support.huaweicloud.com/usermanual-aom/zh-cn_image_0263893545.png "点击放大") 表3参数说明 | 参数 | 参数说明 | |:---|:---| | 容器内日志路径 | 日志存储挂载到容器内的挂载路径，需要保证服务的日志输出路径与该路径一致，这样日志才能写入到日志存储卷中。 须知： - 日志存储卷挂载后，会覆盖掉日志路径下已有的内容。请保证日志路径为一个独立的路径，否则原来的内容不可见。 - AOM只采集最近修改过的前20个日志文件，且不采集子目录。 - AOM只采集日志路径下的".log"、".trace"、".out"文本日志文件。 | | 日志存储空间 | 日志的存储空间大小。 AOM对日志卷中的日志按50MB进行防爆处理，AOM只保留最近生成的20个zip文件，当zip文件超过20个时，时间较早的zip文件会被删除。 | #### 查看容器服务日志 日志采集路径配置成功后，若已配置的路径下存在日志文件，则ICAgent会从已配置的路径中采集日志文件，采集大概需要1分钟，请您耐心等待。待采集完成后，您可执行如下操作： - **查看容器服务日志文件** 在左侧导航栏中选择"日志 \> 日志文件"，在"组件"页签的下拉列表框中选择对应的集群和命名空间，左边的列表展示了在已选命名空间下该集群的组件，单击某个组件，即可查看其日志文件，如下图所示。详细操作请参见[查看日志文件](https://support.huaweicloud.com/usermanual-aom/aom_02_0010.html)。 图3查看容器服务日志文件 ![](https://support.huaweicloud.com/usermanual-aom/zh-cn_image_0269618511.png "点击放大") - **查看容器服务日志** **并进行分析** 在左侧导航栏中选择"日志 \> 日志搜索"，在"组件"页签中选择对应的集群与命名空间，选择某个组件及已配的文件名称，查看采集到的日志并进行分析。详细操作请参见[搜索日志](https://support.huaweicloud.com/usermanual-aom/aom_02_0009.html)。 图4查看容器服务日志并进行分析 ![](https://support.huaweicloud.com/usermanual-aom/zh-cn_image_0269622697.png "点击放大")