配置容器服務日志采集路徑
更新時間 2024-01-09 14:59:41
最近更新時間: 2024-01-09 14:59:41
分享文章
本節主要介紹配置容器服務日志采集路徑
AOM支持容器服務日志采集，并展現在AOM界面中，以供您檢索。使用該功能前首先要配置日志采集路徑，配置方法詳見如下操作。
注意事項
- ICAgent只采集*.log、 .trace和 .out類型的文本日志文件。
- AOM默認會采集容器標準輸出日志，您不用做任何配置。
配置步驟
在CCE中添加日志策略
步驟 1 在CCE中創建工作負載時，添加容器后，展開“容器日志”頁簽。
步驟 2 單擊“添加日志策略”，設置自定義日志參數，配置日志策略，以nginx為例，不同工作負載根據實際情況配置。
步驟 3 存儲類型有“主機路徑”和“容器路徑”兩種類型可供選擇：
主機路徑：可將主機上的路徑掛載到指定的容器路徑。日志策略配置參數如下：
添加日志策略-主機路徑
| 參數 | 說明 |
|---|---|
| 存儲類型 | 設置為“主機路徑”。將主機上的路徑掛載到指定的容器路徑 |
| 添加容器掛載 | |
| 主機路徑 | 容器內日志文件所在路徑掛載到主機上的位置，如： /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等均已經具備日志文件的繞接能力，如果您的日志文件已經實現了繞接能力，則無需設置。否則可能出現沖突。 – 建議您的業務自己實現繞接，可以更靈活的控制繞接文件的大小和個數。 |
日志僅輸出到容器路徑，無需掛載主機路徑。日志策略配置參數如下：
說明
此功能需要采集器ICAgent版本升級到5.10.79或以上版本。
添加日志策略-容器路徑
| 參數 | 說明 |
|---|---|
| 存儲類型 | 設置為“容器路徑”。 日志僅輸出到容器路徑，無需掛載主機路徑。此功能需要采集器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等均已經具備日志文件的繞接能力，如果您的日志文件已經實現了繞接能力，則無需設置。否則可能出現沖突。 – 建議您的業務自己實現繞接，可以更靈活的控制繞接文件的大小和個數。 |
查看容器服務日志
日志采集路徑配置成功后，若已配置的路徑下存在日志文件，則ICAgent會從已配置的路徑中采集日志文件，采集大概需要1分鐘，請您耐心等待。待采集完成后，您可執行如下操作：
- 查看容器服務日志文件：
在左側導航欄中選擇“日志 > 日志文件”，在“組件”頁簽的下拉列表框中選擇對應的集群和命名空間，左邊的列表展示了在已選命名空間下該集群的組件，單擊某個組件，即可查看其日志文件。
- 查看容器服務日志并進行分析
在左側導航欄中選擇“日志 > 日志搜索”，在“組件”頁簽中選擇對應的集群與命名空間，選擇某個組件及已配的文件名稱，查看采集到的日志并進行分析。
