Simple Log Service：運行情況診斷與監控

前提條件

• 已使用Log Service採集器採集日誌。具體操作，請參見持續採集主機文本日誌。

• 開通目標Project的重要日誌

  本文僅介紹開通操作步驟，詳細瞭解服務日誌請參見開通服務日誌。

  1. 登入Log Service控制台，在Project列表中單擊目標Project。在目標Project詳情頁的服務日誌頁簽中，單擊開通服務日誌。

  2. 在開通服務日誌面板中，選擇重要日誌和任務作業記錄，單擊確定。

     • 該操作會在目標地區自動建立名稱為log-service-{使用者ID}-{region}的Project。

     • 重要日誌和任務作業記錄接入、儲存與查詢分析免費。當您進行資料加工、資料投遞等操作時，隨用隨付。

運行問題診斷

運行診斷套件括進階版診斷和基礎版診斷：

• 進階版診斷（推薦）：提供異常診斷儀錶盤，清晰展示採集器相關的異常資訊，並且支援更長時間的異常資訊查詢。

• 基礎版診斷：提供最近1小時內的採集異常資訊。

適用情境

• 採集器狀態異常：心跳失敗、進程未運行或SSL認證異常。

• 日誌採集異常：日誌未採集、延遲過高或解析失敗（如正則匹配錯誤）。

• 配置錯誤：檔案路徑不正確、機器組IP不匹配、跨帳號許可權問題。

• 效能瓶頸：採集速率接近或超過預設限制（如20 MB/s），導致日誌丟棄。

• 容器日誌採集問題：Pod頻繁重啟、日誌輪轉過快導致採集不全。

• 外掛程式與自訂採集問題：自訂外掛程式（如Grok解析）或HTTP資料來源採集失敗。

• 資料可靠性問題：日誌丟失（如LoongCollector未運行或輪轉速度過快）。

• 採集配置參數需修改：多行處理條件等日誌解析參數無法在採集配置列表頁直接編輯，需進入該採集配置的修改流程，在解析日誌步驟中調整後儲存。

• 單個配置採集多個路徑：單個採集配置只支援一組日誌路徑與檔案名稱匹配規則，不支援在同一配置中填寫多個不同路徑；如需採集多個路徑，需為每個路徑分別建立採集配置，並將這些配置應用到同一機器組。

• 通過 API 或 Terraform 建立採集配置時請求體校正失敗：調用建立介面返回請求體參數校正錯誤（如 PostBodyInvalid）時，需檢查 inputDetail 中各欄位是否齊全且類型正確，其中 localStorage 須為布爾類型（true 或 false）。

• 與其他日誌採集軟體共存：伺服器上同時部署 LoongCollector 與其他採集軟體（如 Filebeat）時，出現連接埠佔用、進程衝突或資料重複採集的排查。

• 無法確認日誌的採集方式：同一 LogStore 中的日誌來源不明，需要區分是由 LoongCollector/Logtail 採集寫入，還是由應用通過 SDK 直寫；可通過檢查伺服器上是否存在對應的採集配置，以及應用代碼中是否有 SDK 寫入邏輯來判斷。

• 目標資料類型不在採集範圍內：需要確認待採集對象（如應用效能指標、.NET 應用指標）是否屬於 LoongCollector 支援的採集類型，避免因採集對象不受支援而誤判為採集失敗。

• 容器標準輸入/標準輸出日誌未採集：ACK 叢集中容器標準輸入、標準輸出日誌採集不生效的排查。

• 通過 SDK 直寫時記憶體積壓或寫入被限流：應用使用 Java SDK/Producer 直寫日誌時出現記憶體持續增長、資料積壓或寫入被限流，需要結合 LogStore 寫入配額與應用側日誌產生速率排查。

操作步驟如下：

1. 登入Log Service控制台。在Project列表中，單擊目標Project。

2. 單擊日誌儲存，在日誌庫中，將滑鼠懸浮在目標LogStore上，然後單擊目標LogStore右側的表徵圖。

3. 按需要單擊進階版診斷或基礎版診斷查看診斷資訊。

4. 查看診斷資訊。

   基礎版診斷

   日誌採集錯誤面板中將展示該LogStore所對應的所有LoongCollector採集錯誤清單。您可以單擊目標錯誤碼，查看錯誤詳情。更多資訊，請參見Log Service採集資料常見的錯誤類型。

   進階版診斷

   在LoongCollector/Logtail異常監控頁面，查看活躍用戶端數、全量錯誤資訊等資訊。採集異常監控儀錶盤的更多資訊，請參見查看資料報表。錯誤碼的更多資訊，請參見Log Service採集資料常見的錯誤類型。

5. 處理問題完畢後，查看是否仍有報錯。歷史報錯在到期前仍顯示，請忽略這部分報錯，僅確認在問題處理完畢的時間點之後是否有新的錯誤。其中LoongCollector上報錯誤資訊的時間間隔為10分鐘。

   如果您需要查看解析失敗而被丟棄的完整日誌，可查看LoongCollector作業記錄。路徑為：

   主機情境：在伺服器的/usr/local/ilogtail/loongcollector.LOG檔案中。

   容器情境：在容器的/usr/local/ilogtail/loongcollector.LOG檔案中。

健全狀態監控

Log Service提供了內建的警示策略協助即時監控採集器，若有以下監控需求時可進行內建警示策略的配置：

• 採集器心跳異常監控

  通過查詢 internal-diagnostic_log 中 __topic__:logtail_status 日誌，統計LoongCollector心跳正常機器數，並配置警示規則（如心跳數低於預期值時觸發警示），用於排查宕機或網路異常的機器 。

• 採集器採集異常警示

  執行 __topic__: logtail_alarm 查詢語句，分析15分鐘內各類異常（如檔案不可讀、許可權不足、解析失敗）的發生次數，及時發現並修複配置問題，避免日誌丟失 。

• 效能瓶頸預警

  利用Logtail異常監控儀錶盤（展示活躍LoongCollector數、重啟列表、全量錯誤資訊等），監控Logtail運行狀態及資源使用（如CPU、記憶體），識別效能瓶頸或異常重啟 。

• 中心化日誌採集監控

  通過LoongCollector檔案採集監控儀錶盤（展示採集檔案數、平均延遲、解析失敗率等），統一管理多帳號或多地區情境下的日誌採集狀態，確保採集連續性 。

操作步驟如下：

1. 配置行動策略：用於在監控警示狀態發生變化時，定義如何發送通知。

   1. 登入Log Service控制台。

   2. 在Project列表中，找到開啟重要日誌功能時選擇的Project，單擊Project名稱。

   3. 在左側導覽列中，單擊警示，在警示中心頁面，選擇通知策略 > 行動策略頁簽。

   4. 在行動策略列表中，找到目標行動策略sls.app.logtail.builtin，單擊操作列的修改。

   5. 在編輯行動策略對話方塊中，根據業務需求，選擇渠道並參考通知渠道說明進行配置，然後單擊確認。

2. 建立警示規則：用於設定監控規則，當LoongCollector健全狀態觸發閾值時進行警示。

   1. 在警示中心頁面，單擊警示規則，單擊新建告警右側的。

   2. 單擊從模板建立，在從模板建立面板中，單擊全部模板下的Logtail錯誤監控，在右側面板中選擇目標卡片後單擊。

   3. 在新建告警面板中查看配置，內建警示監控規則已預設參數，請直接單擊確定。關於配置參數的說明，請參見建立警示監控規則。