文档

安装Logtail(Linux系统)

更新时间:

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

使用限制

  • 支持如下版本的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

重要
  • 请根据适用场景,选择不同网络类型对应的安装命令进行安装,网络类型指日志服务从服务器采集日志数据的网络连接方式。更多信息,请参见选择网络

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

在线安装

网络类型

适用场景

阿里云内网

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

公网

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

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

全球加速

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

说明

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

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

  • 如果您无法确定ECS实例所在地域,可下载Logtail安装脚本,然后使用auto参数进行安装。

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

    1. 通过公网下载Logtail安装脚本到ECS实例的当前工作目录。此下载消耗公网流量,约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}

公网

  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

  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}-acceleration

ECS金融云

请根据Project所在的地域执行对应的安装命令。

Project所在的地域

安装命令

华东1 金融云

wget http://logtail-release-cn-hangzhou-finance-1.oss-cn-hzfinance-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hangzhou-finance

华东1 金融云(公网)

wget http://logtail-release-cn-hangzhou-finance-1.oss-cn-hzfinance.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hangzhou-finance-internet

华东2 金融云

wget http://logtail-release-cn-shanghai-finance-1.oss-cn-shanghai-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shanghai-finance-1

华东2 金融云(公网)

wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz chmod +x logtail.sh; ./logtail.sh install-local cn-shanghai-finance-1-internet

华北2 金融云(邀测)

wget http://logtail-release-cn-beijing-finance-1.oss-cn-beijing-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-beijing-finance-1

华北2 金融云(邀测)(公网)

wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz chmod +x logtail.sh; ./logtail.sh install-local cn-beijing-finance-1-internet

华南1 金融云

wget http://logtail-release-cn-shenzhen-finance-1.oss-cn-szfinance-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shenzhen-finance-1

华南1 金融云(公网)

wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz chmod +x logtail.sh; ./logtail.sh install-local cn-shenzhen-finance-1-internet

政务云

请根据Project所在的地域执行对应的安装命令。

Project所在的地域

安装命令

华北2 阿里政务云1

wget http://logtail-release-cn-north-2-gov-1.oss-cn-north-2-gov-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh; ./logtail.sh install cn-north-2-gov-1

离线安装

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

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

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

    1. 下载安装脚本

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
    2. 下载安装包

      • 安装包(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。升级只覆盖必要的文件,配置文件以及Checkpoint文件将会被保留,升级期间日志不会丢失。

在线升级Logtail

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

  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

  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 uninstall

后续步骤

日志服务Project与服务器同地域同账号

配置流程如下图:

image

完成Logtail安装后,您需创建机器组,并选择数据源配置Logtail采集日志。具体操作,请参见创建IP地址机器组创建用户自定义标识机器组采集文本日志

日志服务Project与服务器同地域不同账号

配置流程如下图:

image

完成Logtail安装后,您需配置用户标识,配置用户自定义标识,创建机器组,并选择数据源配置Logtail采集日志。具体操作,请参见配置用户标识创建用户自定义标识机器组采集文本日志通过Logtail跨阿里云账号采集日志

日志服务Project与服务器不同地域

配置流程如下图:

image

您需选择公网完成Logtail安装,并配置用户标识,创建机器组并选择数据源创建Logtail采集日志。具体操作,请参见配置用户标识创建IP地址机器组创建用户自定义标识机器组采集文本日志

重要

若下载Logtail时选择网络为阿里云内网(经典网络、VPC)时,可通过修改ilogtail_config.json文件中的网络参数进行跨地域采集。

常见问题

如何判断是否安装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

华东5

南京(本地地域)

cn-nanjing

华东6

福州(本地地域)

cn-fuzhou

华南1

深圳

cn-shenzhen

华南2

河源

cn-heyuan

华南3

广州

cn-guangzhou

华中1

武汉(本地地域)

cn-wuhan

西南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

沙特(利雅得)

利雅得

me-central-1

  • 本页导读 (1)
文档反馈