安装Logtail(Linux系统)

更新时间: 2023-09-14 14:12:23

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

前提条件

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

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

    • Aliyun 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 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

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。

    • 下载安装脚本

      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。

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

    • 华东 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}参数如下所示。

地域

${your_region_name}

华北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-chengdu

中国(香港)

cn-hongkong

美国(硅谷)

us-west-1

美国(弗吉尼亚)

us-east-1

新加坡

ap-southeast-1

澳大利亚(悉尼)

ap-southeast-2

马来西亚(吉隆坡)

ap-southeast-3

印度尼西亚(雅加达)

ap-southeast-5

菲律宾(马尼拉)

ap-southeast-6

泰国(曼谷)

ap-southeast-7

印度(孟买)

ap-south-1

日本(东京)

ap-northeast-1

韩国(首尔)

ap-northeast-2

德国(法兰克福)

eu-central-1

阿联酋(迪拜)

me-east-1

英国(伦敦)

eu-west-1

阿里云首页 日志服务 相关技术圈