機器組安裝示例

• 機器組配置：ECS和日志服務Project同賬號同地域。

• 通過Logtail跨地域采集日志：ECS和日志服務Project同賬號不同地域。

• 通過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地址。

   日志服務機器組包括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版本）。