阿里云日志服务SLSLogtail机器组问题排查思路（主机场景）-云淘科技

本文主要介绍如何系统排查主机场景下的机器组无心跳问题。

步骤一：检查Logtail是否正常运行

步骤二：确认机器组中的IP地址是否为Logtail获取的IP地址

Logtail获取服务器IP地址的方式如下：

• 如果您没有设置主机名绑定，则Logtail会获取服务器中第一块网卡的IP地址。

• 如果您在/etc/hosts文件中设置了主机名绑定，则Logtail会获取绑定的主机名对应的IP地址。

您可以根据下述步骤完成排查。

1. 打开app_info.json文件。

   Logtail将获取的IP地址记录在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

2. 获取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"
   }

3. 确认机器组中使用的是Logtail获取的IP地址。

   日志服务机器组包括IP地址机器组和用户自定义标识机器组。更多信息，请参见机器组简介。

   • 如果是IP地址机器组，请查看IP地址文本框内的IP地址。具体操作，请参见查看机器组状态。

     当IP地址文本框内填写了目标Logtail的其它IP地址（例如公网地址）时，请修改为Logtail获取的IP地址，然后观察机器心跳是否正常。如果正常，则可以结束本次排查。

   • 如果是用户自定义标识机器组，请使用Logtail获取的IP地址搜索目标机器组的状态信息。具体操作，请参见查看机器组状态。如果搜索成功，则可以结束本次排查流程。

步骤三：检查Logtail启动参数是否正确

ilogtail_config.json文件记录了Logtail的相关启动参数。

1. 登录Logtail所在的机器。

2. 查找ilogtail_config.json文件。

   先执行如下命令确认环境变量中是否指定了该文件的存储路径。

   echo $ALIYUN_LOGTAIL_CONFIG

   • 如果返回结果非空，则返回的环境变量值为ilogtail_config.json文件的存储路径，一般为/etc/ilogtail/conf//ilogtail_config.json。

   • 如果返回结果为空，则说明未使用环境变量指定ilogtail_config.json文件的存储路径。您可以通过如下默认路径查找。

     操作系统	Logtail	ilogtail_config.json文件路径
     Linux	Logtail（64位程序）	/usr/local/ilogtail/ilogtail_config.json
     Windows（64位操作系统）	Logtail（64位程序）	C:\Program Files\Alibaba\Logtail\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

3. 打开ilogtail_config.json文件，确认配置文件参数是否正确。

   {
     "config_server_address" : "http://logtail..log.aliyuncs.com",
     "data_server_list" :
     [
       {
         "cluster" : "",
         "endpoint" : ""
       }
     ],
     ...
   }

   • 如果ilogtail_config.json文件中的启动参数符合下述表格中的说明，则表示Logtail启动参数正确。

   • 如果Logtail启动参数错误，请根据下述表格修改ilogtail_config.json文件，然后重启Logtail。具体操作，请参见附录：重启Logtail。

     场景	网络类型
     服务器为ECS，且与Project属于同一地域	阿里云内网	-intranet	-intranet.log.aliyuncs.com
     其它情况	公网		.log.aliyuncs.com
     	全球加速		log-global.aliyuncs.com

步骤四：检查网络是否通畅

使用Logtail上传数据成功，至少需要保证Logtail所在服务器能够连通下列地址。

重要

如果使用内网，需要在地址中添加-intranet。

1. ilogtail_config.json文件中config_server_address字段指定的地址及其HTTPS版本。

2. http://.。其中为ilogtail_config.json文件中data_server_list.endpoint字段指定的地址。

3. http://ali--sls-admin.。其中为ilogtail_config.json文件中data_server_list.endpoint字段指定的地址。

具体的网络检查及解决方法如下：

步骤五：检查Logtail所在服务器的系统时间是否正确

步骤六：检查是否已配置用户标识

如果您的服务器是与日志服务属于不同账号的ECS、其他云厂商的服务器和自建IDC时，您要通过Logtail采集该服务器日志，需在服务器上安装Logtail后，手动配置日志服务所在阿里云账号ID为用户标识，表示该账号有权限通过Logtail采集该服务器日志。更多信息，请参见配置用户标识。

重要

必须是阿里云账号ID（主账号ID）。如何获取，请参见获取日志服务所在的阿里云账号ID。

您可以通过环境变量ALIYUN_LOGTAIL_USER_ID或指定目录下的用户标识文件判断是否已配置用户标识。如果已通过环境变量设置用户标识，则以环境变量配置方式为准。因此，您需要先执行如下命令，确认是否已通过环境变量指定用户标识。

echo $ALIYUN_LOGTAIL_USER_ID

• 如果返回结果中包含当前Project所属阿里云账号ID，则说明已正确配置用户标识。

• 如果返回结果非空但未包含当前Project所属阿里云账号ID，则需修改该环境变量的值为Project所属的阿里云账号ID或在现有值后面增加Project所属的阿里云账号ID，以半角逗号（,）分隔。

• 如果返回结果为空，则您需要查看指定路径中是否已有用户标识文件。

  说明

  用户标识文件路径如下：

  • Linux系统：/etc/ilogtail/users/

  • Windows系统：C:\LogtailData\users\

  • 如果指定路径下无用户标识文件或用户标识文件配置错误，请按照如下方法解决。

    • Linux系统：执行cd /etc/ilogtail/users/ && touch 命令，创建用户标识文件。其中为Project所属的阿里云账号ID。

    • Windows系统：进入C:\LogtailData\users\目录，创建一个名为的空文件。其中为Project所属的阿里云账号ID。

  • 如果指定路径下存在以当前Project所属的阿里云账号ID命名的文件，则说明用户标识配置正确。

重要

完成上述修改后，必须重启Logtail。具体操作，请参见附录：重启Logtail。

步骤七：如果是用户自定义标识机器组，检查是否已配置自定义标识

您可以通过环境变量ALIYUN_LOGTAIL_USER_DEFINED_ID或指定目录下的user_defined_id文件判断是否已在服务器上配置用户自定义标识。如果已通过环境变量设置用户自定义标识，则以环境变量配置为准。因此，您需要先执行如下命令，确认是否已通过环境变量指定用户自定义标识。

echo $ALIYUN_LOGTAIL_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文件已包含您在机器组中设置的用户自定义标识，则说明用户自定义标识配置正确。

重要

完成上述修改后，必须重启Logtail。具体操作，请参见附录：重启Logtail方法。

后续步骤

经过上述排查后，仍未解决问题，请提工单。

附录：重启Logtail

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家

阿里云企业补贴进行中： 马上申请

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心。

购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠