全部产品
Search
文档中心

日志服务:安装Logtail(Linux系统)

更新时间:Jan 16, 2024

本文介绍如何在Linux服务器上安装、升级及卸载Logtail等操作。

前提条件

支持安装Logtail的Linux系统如下:

  • 支持如下版本的Linux x86-64(64位)服务器。

    • Alibaba Cloud Linux 2

    • RedHat Enterprise 6、7、8

    • CentOS Linux 6、7、8

    • Debian GNU/Linux 8、9、10、11

    • Ubuntu 14.04、16.04、18.04、20.04

    • SUSE Linux Enterprise Server 11、12、15

    • OpenSUSE 15.1、15.2、42.3

    • 其他基于glibc 2.5及以上版本的Linux操作系统

  • 支持如下版本的Linux ARM(64位)服务器。

    • Alibaba Cloud Linux 3.2 ARM版

    • Anolis OS 8.2 ARM版及以上版本

    • CentOS 8.4 ARM版

    • Ubuntu 20.04 ARM版

    • Debian 11.2 ARM版

安装Logtail

在线安装

请根据实际情况选择网络类型对应的安装命令进行安装。

重要

网络类型指日志服务从服务器采集日志数据的网络连接方式。

网络类型

适用场景

阿里云内网

云服务器ECS和日志服务Project属于同一地域。

公网

  • 云服务器ECS和日志服务Project属于不同地域。

  • 服务器为其他云厂商服务器或自建IDC。

全球加速

服务器分布在海外各地的自建机房或者来自海外云厂商,使用公网传输数据可能会出现网络延迟高、传输不稳定等问题,推荐选择全球加速传输数据。

更多信息,请参见选择网络

说明

在线安装时,将根据服务器系统自动匹配安装对应的Logtail,无需进行手动选择。

阿里云内网(经典网络、VPC)

  • 如果您无法确定ECS所在地域,可使用Logtail安装脚本中的auto参数进行安装。

    在安装命令中指定auto参数后,Logtail安装脚本会通过ECS获取您的实例元数据,自动确定ECS所在地域,实例元数据介绍请参见 ECS实例元数据概述

    1. 通过公网下载Logtail安装脚本。

      此下载消耗公网流量,约10 KB。

      wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh
    2. 使用auto参数安装logtail。

      此步骤自动下载对应地域的安装程序,不消耗公网流量。

      ./logtail.sh install auto
  • 如果您已确定ECS所在地域,请根据地域选择安装命令。

    通过内网下载Logtail安装脚本,手动安装Logtail,不消耗公网流量。

    1. 根据日志服务Project所在地域,获取对应的${your_region_name}

      各个地域对应的${your_region_name}请参见附录:地域与安装参数对照表,例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。

    2. 替换${your_region_name}后,执行安装命令。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}
说明

安装Logtail后,如果ECS的网络由经典网络切换至VPC,则需要更新Logtail配置。更多信息,请参见ECS经典网络切换为VPC后,如何更新机器组配置?

公网

  1. 根据日志服务Project所在地域,获取对应的${your_region_name}

    各个地域对应的${your_region_name}请参见附录:地域与安装参数对照表,例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。

  2. 替换${your_region_name}后,执行安装命令。

    wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-internet

全球加速

  1. 根据日志服务Project所在地域,获取对应的${your_region_name}

    各个地域对应的${your_region_name}请参见附录:地域与安装参数对照表。例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。

  1. 替换${your_region_name}后,执行安装命令。

    wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-acceleration

离线安装

  1. 登录能通过公网访问的服务器。

  2. 替换${your_region_name}后,执行下载命令,下载安装脚本和安装包。

    各个地域对应的${your_region_name}请参见附录:地域与安装参数对照表。例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。

    • 下载安装脚本

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
    • 下载安装包(x86-64)

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
    • 下载安装包(ARM)

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz
  3. 将安装脚本和安装包拷贝至待安装Logtail的目标服务器上。

  4. 替换${your_region_name}后,在目标服务器上执行安装命令。

    各个地域对应的${your_region_name}请参见附录:地域与安装参数对照表。例如:

    • 华东 1(杭州)内网对应的${your_region_name}cn-hangzhou-internet

    • 华东 1(杭州)公网对应的${your_region_name}cn-hangzhou

    • 华东 1(杭州)全球加速对应的${your_region_name}cn-hangzhou-acceleration

    chmod +x logtail.sh; ./logtail.sh install-local ${your_region_name}

查看Logtail状态及版本

Logtail安装完成后,您可以查看Logtail状态及版本。

查看Logtail状态

您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。

  • 命令

    sudo /etc/init.d/ilogtaild status 
  • 返回结果

    如果系统返回如下信息,表示已安装Logtail。

    ilogtail is running

    如果Logtail状态显示未运行,请卸载后重新安装。

查看Logtail版本

Logtail会将版本信息记录在/usr/local/ilogtail/app_info.json文件中的logtail_version字段。

  • 命令

    cat /usr/local/ilogtail/app_info.json
  • 返回结果

    {
       "UUID" : "0DF18E97-0F2D-486F-B77F-*********",
       "hostname" : "david*******",
       "instance_id" : "F4FAFADA-F1D7-11E7-846C-00163E30349E_*********_1515129548",
       "ip" : "**********",
       "logtail_version" : "0.16.30",
       "os" : "Linux; 2.6.32-220.23.2.ali1113.el5.x86_64; #1 SMP Thu Jul 4 20:09:15 CST 2013; x86_64",
       "update_time" : "2020-01-05 13:19:08"
    }

升级Logtail

重要

升级Logtail时,请使用upgrade命令。如果使用install命令,则会进行覆盖安装,会卸载、删除/usr/local/ilogtail等目录,清空原有配置。安装后默认启动Logtail并注册开机启动。

在线升级Logtail

您可以通过Logtail安装脚本(logtail.sh)升级Logtail,Logtail安装脚本会根据已经安装的Logtail配置信息自动选择合适的方式进行升级。

说明

升级过程中会短暂停止Logtail。升级只覆盖必要的文件,配置文件以及Checkpoint文件将会被保留,升级期间日志不会丢失。

  1. 执行以下命令升级Logtail。

    wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh
    sudo ./logtail.sh upgrade
  2. 确认升级结果。

    显示类似信息表示升级成功。

    Stop logtail successfully.
    ilogtail is running
    Upgrade logtail success
    {
       "UUID" : "***",
       "hostname" : "***",
       "instance_id" : "***",
       "ip" : "***",
       "logtail_version" : "0.16.30",
       "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
       "update_time" : "2020-08-29 15:01:36"
    }

离线升级Logtail

  1. 登录能通过公网访问的服务器。

  2. 替换${your_region_name}后,执行下载命令。

    各个地域公网对应的${your_region_name}请参见附录:地域与安装参数对照表。例如华东 1(杭州)公网对应的${your_region_name}为cn-hangzhou-internet。

    1. 执行命令,下载安装脚本。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
    2. 执行命令,下载安装包。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
  3. 将安装脚本和安装包拷贝至待升级Logtail的目标服务器上。

  4. 在目标服务器上执行升级命令。

    chmod +x logtail.sh; ./logtail.sh upgrade-local

手动启动和停止Logtail

  • 执行如下命令启动Logtail。

    sudo /etc/init.d/ilogtaild start
  • 执行如下命令停止Logtail。

    sudo /etc/init.d/ilogtaild stop

卸载Logtail

  1. 根据日志服务Project所在地域,获取对应的${your_region_name}

    各个地域对应的请参见附录:地域与安装参数对照表。例如华东 1(杭州)对应的${your_region_name}cn-hangzhou

  1. 替换${your_region_name}后,执行卸载命令。

    wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh;./logtail.sh uninstall

后续步骤

Logtail安装完成后,您可根据实际应用场景,进行后续操作。

常见问题

如何判断是否安装Logtail成功?

您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。具体操作,请参见查看Logtail状态

安装Logtail后,配置采集任务心跳失败如何解决?

完成Logtail采集配置后,若出现心跳失败的情况,可执行如下命令查看Logtail版本,并进行升级重试。

cat /usr/local/ilogtail/app_info.json

安装Logtail后,采集数据发送失败错误码及处理方法有哪些?

Logtail将采集到的日志聚合并发送到日志服务。如果数据发送失败,Logtail自动根据错误信息决定重试或放弃发送,具体信息,请参见发送日志

附录:地域与安装参数对照表

各地域对应的${your_region_name}参数如下所示。

地域

城市

Region ID

华北1

青岛

cn-qingdao

华北2

北京

cn-beijing

华北3

张家口

cn-zhangjiakou

华北5

呼和浩特

cn-huhehaote

华北6

乌兰察布

cn-wulanchabu

华东1

杭州

cn-hangzhou

华东2

上海

cn-shanghai

华南1

深圳

cn-shenzhen

华南2

河源

cn-heyuan

华南3

广州

cn-guangzhou

西南1

成都

cn-chengdu

中国香港

香港

cn-hongkong

亚太东南1

新加坡

ap-southeast-1

亚太东南2

悉尼

ap-southeast-2

亚太东南3

吉隆坡

ap-southeast-3

亚太东南5

雅加达

ap-southeast-5

亚太东南6

马尼拉

ap-southeast-6

亚太东南7

曼谷

ap-southeast-7

亚太南部1

孟买

ap-south-1

亚太东北1

东京

ap-northeast-1

亚太东北2

首尔

ap-northeast-2

美国西部1

硅谷

us-west-1

美国东部1

弗吉尼亚

us-east-1

欧洲中部1

法兰克福

eu-central-1

欧洲西部1

伦敦

eu-west-1

中东东部1

迪拜

me-east-1