Simple Log Service：Logtail機器組問題排查思路（主機情境）

機器組安裝樣本

• 機器組配置：ECS和Log ServiceProject同帳號同地區。

• 通過Logtail跨地區採集日誌：ECS和Log ServiceProject同帳號不同地區。

• 通過Logtail跨阿里雲帳號採集日誌：其他雲或、自建伺服器、Project和ECS伺服器屬於不同帳號。

排查預覽

1. 步驟一：檢查Logtail是否正常運行：檢查Logtail在伺服器是否正常運行。

2. 步驟二：確認機器組中的IP地址是否為Logtail擷取的IP地址：確認機器組中的IP地址是否和Logtail的app_info.json檔案中的IP地址一致，不一致會導致心跳失敗。

3. 步驟三：檢查Logtail啟動參數是否正確：檢查ilogtail_config.json檔案中配置的Project地區是否正確。

4. 步驟四：檢查網路是否通暢：檢查伺服器與Project之間網路是否通暢。

5. 步驟五：檢查Logtail所在伺服器的系統時間是否正確：如果系統時間明顯快於或慢於當前真即時間，需要修改。

6. 步驟六：檢查是否存在使用者標識：如果Project和ECS伺服器屬於不同帳號，其他雲或者自建伺服器，必須檢查使用者標識。

7. 步驟七：檢查是否已配置自訂標識：如果是使用者自訂標識機器組，檢查是否已配置自訂標識。

步驟一：檢查Logtail是否正常運行

1. 擷取app_info.json檔案中的ip欄位值。

   該檔案在不同系統下的預設路徑說明如下表所示：

   作業系統	Logtail	app_info.json檔案路徑
   Linux	Logtail（64位程式）	/usr/local/ilogtail/app_info.json
   Windows（64位作業系統）	Logtail （64位程式）	C:\Program Files\Alibaba\Logtail\app_info.json
   	Logtail（32位程式）	C:\Program Files (x86)\Alibaba\Logtail\app_info.json
   Windows （32位作業系統）	Logtail（32位程式）	C:\Program Files\Alibaba\Logtail\app_info.json

   Logtail將擷取的IP地址記錄在app_info.json檔案的ip欄位中。

   {
     "UUID" : "",
     "hostname" : "iZ8vbdlzf******azuhZ",
     "instance_id" : "E9633380-***********-00163E1AA597_172.16.2.200_166****11",
     "ip" : "172.**.**.200",
     "logtail_version" : "1.3.1",
     "os" : "Linux; 4.19.91-26.1.al7.x86_64; #1 SMP Tue Jul 26 17:52:28 CST 2022; x86_64",
     "update_time" : "2022-12-27 05:38:33"
   }

2. 確認機器組中使用的是Logtail擷取的IP地址。

   Simple Log Service機器組包括IP地址機器組和使用者自訂標識機器組。更多資訊，請參見什麼是機器組。

   • IP地址機器組：請查看IP地址是否包含上一步擷取的IP地址。

     當IP地址文字框內填寫了目標Logtail的其它IP地址（例如公網地址）時，請修改為Logtail擷取的IP地址，然後觀察機器心跳是否正常。如果正常，則可以結束本次排查。

   • 使用者自訂標識機器組：請查看機器組狀態是否包含上一步擷取的IP地址。如果心跳顯示OK，則可以結束本次排查流程。

ilogtail_config.json檔案記錄了Logtail的相關啟動參數。

1. 登入Logtail所在的機器。

2. 尋找ilogtail_config.json檔案。

   該檔案在不同系統下的預設路徑說明如下表所示：

   作業系統	Logtail	ilogtail_config.json檔案路徑
   Linux	Logtail（64位程式）	/usr/local/ilogtail/ilogtail_config.json
   Windows（64位作業系統）	Logtail（64位程式）	\ilogtail_config.json
   	Logtail（32位程式）	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json
   Windows （32位作業系統）	Logtail（32位程式）	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

   1. 開啟ilogtail_config.json檔案，確認設定檔參數是否正確。

      {
        "config_server_address" : "http://logtail.<config_region>.log.aliyuncs.com",
        "data_server_list" :
        [
          {
            "cluster" : "<project地區>",
            "endpoint" : "<endpoint>"
          }
        ],
        ...
      }

      • 如果ilogtail_config.json檔案中的啟動參數符合下述表格中的說明，則表示Logtail啟動參數正確。

      • 如果Logtail啟動參數錯誤，請根據下述表格修改ilogtail_config.json檔案，然後重啟Logtail。具體操作，請參見附錄：重啟Logtail。

        地區具體Project地區資訊請參見開服地區。

        情境	網路類型	<config_region>	<endpoint>
        伺服器為ECS，且與Project屬於同一地區	阿里雲內網	<project地區>-intranet	<project地區>-intranet.log.aliyuncs.com
        其它情況	公網	<project地區>	<project地區>.log.aliyuncs.com
        	傳輸加速		log-global.aliyuncs.com

使用Logtail上傳資料成功，至少需要保證Logtail所在伺服器能夠連通下列地址。

1. ilogtail_config.json檔案中的config_server_address欄位指定的地址及其HTTPS版本。

2. http://<project名>.<endpoint>。

   • Project的名稱和地區，可以通過如下方式查看。

     

   • <endpoint>為ilogtail_config.json檔案中data_server_list.endpoint欄位指定的地址。

3. http://ali-<project地區>-sls-admin.<endpoint>。其中<endpoint>為ilogtail_config.json檔案中data_server_list.endpoint欄位指定的地址。

具體的網路檢查及解決方案如下：

Linux系統

1. 登入Logtail所在的機器。

2. 執行date命令查看系統時間。

   Wed Dec 28 06:59:26 UTC 2022

   如果系統時間明顯快於或慢於當前真即時間，請嘗試如下修改。

   • 調整系統時間至真即時間。

   • 如果不能修改系統時間，請修改Logtail啟動參數，即在ilogtail_config.json檔案中增加配置項"enable_log_time_auto_adjust": true。修改後，需要重啟Logtail。具體操作，請參見附錄：重啟Logtail。ilogtail_config.json檔案路徑說明請參見步驟三：檢查Logtail啟動參數是否正確。

Windows系統

1. 登入Logtail所在的機器。

2. 查看案頭右下角工作列中時間資訊。

   • 調整系統時間至真即時間。

   • 如果不能修改系統時間，請修改Logtail啟動參數，即在ilogtail_config.json檔案中增加配置項"enable_log_time_auto_adjust": true。修改後，需要重啟Logtail。具體操作，請參見附錄：重啟Logtail。ilogtail_config.json檔案路徑說明，請參見步驟三：檢查Logtail啟動參數是否正確。

步驟六：檢查是否存在使用者標識

您可以通過指定目錄下的使用者標識檔案判斷是否存在使用者標識。如果返回結果為空白，則您需要查看指定路徑中是否已有使用者標識檔案。

• 如果指定路徑下無使用者標識檔案或使用者標識檔案配置錯誤，請按照如下方法解決。

  • Linux系統：執行cd /etc/ilogtail/users/ && touch <uid>命令，建立使用者標識檔案。其中<uid>為Project所屬的阿里雲帳號ID。

  • Windows系統：進入C:\LogtailData\users\目錄，建立一個名為<uid>的空檔案。其中<uid>為Project所屬的阿里雲帳號ID。

• 如果指定路徑下存在以當前Project所屬的阿里雲帳號ID命名的檔案，則說明使用者標識配置正確。

步驟七：如果是使用者自訂標識機器組，檢查是否已配置自訂標識

您可以通過指定目錄下的user_defined_id檔案判斷是否已在伺服器上配置使用者自訂標識。

• 如果返回結果為空白，您需要查看是否存在user_defined_id檔案或該檔案中是否已配置使用者自訂標識。

  說明

  user_defined_id檔案路徑如下：

  • Linux系統：/etc/ilogtail/user_defined_id

  • Windows系統：C:\LogtailData\user_defined_id

  • 如果user_defined_id檔案不存在，則新增一個user_defined_id的檔案，然後在檔案中輸入機器組的使用者自訂標識。具體操作，請參見配置使用者自訂標識。

  • 如果user_defined_id檔案中無使用者自訂標識或自訂標識配置錯誤，則在檔案中新增一行，然後輸入機器組的使用者自訂標識。具體操作，請參見配置使用者自訂標識。

  • 如果user_defined_id檔案已包含您在機器組中設定的使用者自訂標識，則說明使用者自訂標識配置正確。

Windows系統

1. 登入Logtail所在的機器。

2. 開啟運行視窗，輸入services.msc。

3. 重啟LogtailDaemon服務（Logtail 1.0.0.0及以上版本）或LogtailWorker服務（Logtail 0.x.x.x版本）。