本文介绍如何在Linux服务器上安装、升级及卸载Logtail等操作。
前提条件
- 已拥有一台及以上的服务器。
- 已根据服务器类型和所在地域,确定采集日志时所需的网络类型。更多信息,请参见选择网络。
支持的系统
- 支持如下版本的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 0.0版本(Logtail 0.16.x)。当您需要安装、升级Logtail 1.0版本时,需要在安装命令中添加版本号,例如
sudo ./logtail.sh upgrade -v v1
、./logtail.sh install cn-hangzhou -v v1
。 - Logtail采用覆盖安装模式,如果您已安装过Logtail,那么重新安装Logtail时会先执行卸载、删除/usr/local/ilogtail目录操作。安装后默认启动Logtail并注册开机启动。
- 安装Logtail后,如果ECS的网络由经典网络切换至VPC,则需要更新logtail配置。更多信息,请参见ECS经典网络切换为VPC后,如何更新Logtail配置。
- 日志服务无法获取非本账号下ECS、自建IDC或其他云厂商服务器的属主信息,因此在这些服务器上安装Logtail后,您必须手动配置用户标识。具体操作,请参见配置用户标识。
安装方式
请根据您的网络类型选择对应的安装命令。
执行安装命令之前,您需要根据Project所在地域替换安装命令中的${your_region_name}参数,各地域对应的${your_region_name}参数如下所示。
地域 | ${your_region_name} |
---|---|
华东1(杭州) | cn-hangzhou |
华东2(上海) | cn-shanghai |
华北1(青岛) | cn-qingdao |
华北2(北京) | cn-beijing |
华北3(张家口) | cn-zhangjiakou |
华北5(呼和浩特) | cn-huhehaote |
华北6(乌兰察布) | cn-wulanchabu |
华南1(深圳) | cn-shenzhen |
华南2(河源) | cn-heyuan |
华南3(广州) | cn-guangzhou |
西南1(成都) | cn-chengdu |
中国(香港) | cn-hongkong |
俄罗斯(莫斯科) | rus-west-1 |
美国(硅谷) | 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 |
华北2(北京-金融云) | cn-beijing-finance-1 |
阿里云内网(经典网络、VPC)
- 如果您无法确定ECS所在地域,可使用Logtail安装脚本中的auto参数进行安装。 在安装命令中指定auto参数后,Logtail安装脚本会通过ECS获取您的实例元数据,自动确定ECS所在地域,实例元数据介绍请参见 ECS实例元数据概述。
- 通过公网下载Logtail安装脚本。
此下载消耗公网流量,约10 KB。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh
- 使用auto参数安装logtail。
此步骤自动下载对应地域的安装程序,不消耗公网流量。
./logtail.sh install auto
- 通过公网下载Logtail安装脚本。
- 如果您已确定ECS所在地域,请根据地域选择安装命令。 通过内网下载Logtail安装脚本,手动安装Logtail,不消耗公网流量。
- 根据日志服务Project所在地域,获取对应的${your_region_name}。
各个地域对应的${your_region_name}请参见Logtail安装参数,例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。
- 替换${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}
您也可以根据日志服务Project所在的地域执行对应的命令进行安装。Project所在地域 安装命令 华东1(杭州) wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hangzhou
华东2(上海) wget http://logtail-release-cn-shanghai.oss-cn-shanghai-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shanghai
华北1(青岛) wget http://logtail-release-cn-qingdao.oss-cn-qingdao-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-qingdao
华北2(北京) wget http://logtail-release-cn-beijing.oss-cn-beijing-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-beijing
华北3(张家口) wget http://logtail-release-cn-zhangjiakou.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-zhangjiakou
华北5(呼和浩特) wget http://logtail-release-cn-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-huhehaote
华北6(乌兰察布) wget http://logtail-release-cn-wulanchabu.oss-cn-wulanchabu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-wulanchabu
华南1(深圳) wget http://logtail-release-cn-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-shenzhen
华南2(河源) wget http://logtail-release-cn-heyuan.oss-cn-heyuan-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-heyuan
华南3(广州) wget http://logtail-release-cn-guangzhou.oss-cn-guangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-guangzhou
西南1(成都) wget http://logtail-release-cn-chengdu.oss-cn-chengdu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-chengdu
中国(香港) wget http://logtail-release-cn-hongkong.oss-cn-hongkong-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install cn-hongkong
美国(硅谷) wget http://logtail-release-us-west-1.oss-us-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install us-west-1
美国(弗吉尼亚) wget http://logtail-release-us-east-1.oss-us-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install us-east-1
新加坡 wget http://logtail-release-ap-southeast-1.oss-ap-southeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-1
澳大利亚(悉尼) wget http://logtail-release-ap-southeast-2.oss-ap-southeast-2-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-2
马来西亚(吉隆坡) wget http://logtail-release-ap-southeast-3.oss-ap-southeast-3-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-3
印度尼西亚(雅加达) wget http://logtail-release-ap-southeast-5.oss-ap-southeast-5-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-5
菲律宾(马尼拉) wget http://logtail-release-ap-southeast-6.oss-ap-southeast-6-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-6
泰国(曼谷) wget http://logtail-release-ap-southeast-7.oss-ap-southeast-7-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-southeast-7
日本(东京) wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-northeast-1
韩国(首尔) wget http://logtail-release-ap-northeast-2.oss-ap-northeast-2-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-northeast-2
印度(孟买) wget http://logtail-release-ap-south-1.oss-ap-south-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ap-south-1
德国(法兰克福) wget http://logtail-release-eu-central-1.oss-eu-central-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install eu-central-1
阿联酋(迪拜) wget http://logtail-release-me-east-1.oss-me-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install me-east-1
英国(伦敦) wget http://logtail-release-eu-west-1.oss-eu-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install eu-west-1
俄罗斯(莫斯科) wget http://logtail-release-rus-west-1.oss-rus-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install rus-west-1
- 根据日志服务Project所在地域,获取对应的${your_region_name}。
公网
- 根据日志服务Project所在地域,获取对应的
${your_region_name}
。各个地域对应的${your_region_name}请参见Logtail安装参数,例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。
- 替换${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
您也可以根据日志服务Project所在地域直接执行对应的命令进行安装。
Project所在的地域 | 安装命令 |
---|---|
华东1(杭州) |
|
华东2(上海) |
|
华北1(青岛) |
|
华北2(北京) |
|
华北3(张家口) |
|
华北5(呼和浩特) |
|
华北6(乌兰察布) |
|
华南1(深圳) |
|
华南2(河源) |
|
华南3(广州) |
|
西南1(成都) |
|
中国(香港) |
|
美国(硅谷) |
|
美国(弗吉尼亚) |
|
新加坡 |
|
澳大利亚(悉尼) |
|
马来西亚(吉隆坡) |
|
印度尼西亚(雅加达) |
|
菲律宾(马尼拉) |
|
泰国(曼谷) |
|
日本(东京) |
|
韩国(首尔) |
|
德国(法兰克福) |
|
阿联酋(迪拜) |
|
印度(孟买) |
|
英国(伦敦) |
|
俄罗斯(莫斯科) |
|
全球加速
- 根据日志服务Project所在地域选择安装参数。各个地域对应的${your_region_name}请参见Logtail安装参数。例如华东 1(杭州)对应的${your_region_name}为cn-hangzhou。
- 替换${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
您也可以根据日志服务Project所在地域执行对应的命令进行安装。
Project所在的地域 | 安装命令 |
---|---|
华北2(北京) |
|
华北1(青岛) |
|
华东1(杭州) |
|
华东2(上海) |
|
华南1(深圳) |
|
华南2(河源) |
|
华南3(广州) |
|
华北3(张家口) |
|
华北5(呼和浩特) |
|
华北6(乌兰察布) |
|
西南1(成都) |
|
中国(香港) |
|
美国(硅谷) |
|
美国(弗吉尼亚) |
|
新加坡 |
|
澳大利亚(悉尼) |
|
马来西亚(吉隆坡) |
|
印度尼西亚(雅加达) |
|
菲律宾(马尼拉) |
|
泰国(曼谷) |
|
日本(东京) |
|
韩国(首尔) |
|
德国(法兰克福) |
|
阿联酋(迪拜) |
|
印度(孟买) |
|
英国(伦敦) |
|
俄罗斯(莫斯科) |
|
离线安装
- 登录能通过公网访问的服务器。
- 替换${your_region_name}后,执行下载命令,下载安装脚本和安装包。
各个地域对应的${your_region_name}请参见Logtail安装参数。例如华东 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
- 下载安装脚本
- 将安装脚本和安装包拷贝至待安装Logtail的目标服务器上。
- 替换${your_region_name}后,在目标服务器上执行安装命令。各个地域对应的${your_region_name}请参见Logtail安装参数。例如:
- 华东 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,可在下载最新版本的安装包后,执行
chmod +x logtail.sh; ./logtail.sh upgrade-local
命令。查看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安装脚本(logtail.sh)升级Logtail,Logtail安装脚本会根据已经安装的Logtail配置信息自动选择合适的方式进行升级。
说明 升级过程中会短暂停止Logtail。升级只覆盖必要的文件,配置文件以及Checkpoint文件将会被保留,升级期间日志不会丢失。
- 执行以下命令升级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
- 确认升级结果。显示类似信息表示升级成功。
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
- 登录能通过公网访问的服务器。
- 替换${your_region_name}后,执行下载命令,下载安装脚本和安装包。
各个地域公网对应的${your_region_name}请参见Logtail安装参数。例如华东 1(杭州)公网对应的${your_region_name}为cn-hangzhou-internet。
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
- 将安装脚本和安装包拷贝至待升级Logtail的目标服务器上。
- 在目标服务器上执行升级命令。
chmod +x logtail.sh; ./logtail.sh upgrade-local
手动启动和停止Logtail
- 启动 执行如下命令。
sudo /etc/init.d/ilogtaild start
- 停止 执行如下命令
sudo /etc/init.d/ilogtaild stop
卸载Logtail
执行以下命令卸载Logtail。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh;./logtail.sh uninstall