Supported systems 

Logtail supports the Linux x86-64 (64 bit) servers in the following releases: 

  • Aliyun Linux 
  • Ubuntu 
  • Debian 
  • CentOS 
  • OpenSUSE

Install Logtail 

Install Logtail in overwrite mode. If you have installed Logtail before, the installer uninstalls the Logtail and deletes the /usr/local/ilogtail directory  before installing Logtail.  By default, Logtail is started after the installation and at startup. 

Download the installer based on the network environment of your machine and the region of Log Service. Select different parameters for installation. 

Follow the steps in Installation method of this document to install Logtail.  If the installation fails, open a ticket.

Installation method 

To install Logtail, download and run the installation script. You must select the installation parameters based on the region and network type.

Installation parameters 
Note
To install Logtail in Docker or Kubernetes, the ${your_region_name} is the parameter in the following table.  Copy the corresponding installation statement directly. 

The installation parameters for different regions and network types are as follows (we recommend that you copy the corresponding installation statement directly). 

Region Classic network  VPC  Internet (self-built IDCs)
China North 2 (Beijing)   cn-beijing  cn-beijing_vpc  cn-beijing_internet 
China North 1 (Qingdao)  cn-qingdao  cn-qingdao_vpc  cn-qingdao_internet 
China East 1 (Hangzhou)  cn-hangzhou  cn-hangzhou_vpc  cn-hangzhou_internet 
China East 2 (Shanghai)  cn-shanghai  cn-shanghai_vpc  cn-shanghai_internet 
China South 1 (Shenzhen)  cn-shenzhen  cn-shenzhen_vpc  cn-shenzhen_internet 
China North 3 (Zhangjiakou)   cn-zhangjiakou  cn-zhangjiakou_vpc  cn-zhangjiakou_internet 
China North 5 (Huhehaote)  cn-huhehaote  cn-huhehaote  cn-huhehaote_internet
China (Chengdu)  None  cn-chengdu  cn-chengdu_internet 
Hong Kong (China)  cn-hongkong cn-hongkong_vpc  cn-hongkong_internet 
US West 1 (Silicon Valley)  us-west-1  us-west-1_vpc  us-west-1_internet 
US East 1 (Virginia)  None  us-east-1  us-east-1_internet 
Asia Pacific SE 1 (Singapore)  Ap-southeast-1  ap-southeast-1_vpc  ap-southeast-1_internet 
Asia Pacific SE 2 (Sydney)  ap-southeast-2  ap-southeast-2_vpc  ap-southeast-2_internet 
Asia Pacific SE 3 (Kuala Lumpur)  ap-southeast-3  ap-southeast-3 ap-southeast-3_internet 
Asia Pacific SE 5 (Jakarta)  None  ap-southeast-5  ap-southeast-5_internet 
Asia Pacific SOU 1 (Mumbai)   None  ap-south-1  ap-south-1_internet 
Asia Pacific NE 1 (Japan)  ap-northeast-1  ap-northeast-1_vpc  ap-northeast-1_internet 
EU Central 1 (Frankfurt)   eu-central-1  eu-central-1_vpc  eu-central-1_internet 
Middle East 1 (Dubai)  me-east-1  me-east-1_vpc  me-east-1_internet 
China East 1 (Hangzhou) (financial cloud)   None   cn-hangzhou-finance  None  
China East 2 (Shanghai) (financial cloud)  None   cn-shanghai-finance  None 
China South 1 (Shenzhen) (financial cloud)  None  cn-shenzhen-finance   None  

ECS instances of classic network 

Data is written to Log Service by means of the Alibaba Cloud intranet without consuming Internet bandwidth,  which is applicable to Alibaba Cloud Elastic Compute Service (ECS) instances.

  • Note: By default, newly created ECS instances in new regions (such as overseas regions) are of Virtual Private Cloud (VPC). See ECS instances of VPC in this document.
  • China North  2 (Beijing)
    wget http://logtail-release-bj.oss-cn-beijing-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-beijing 
  • China North  1 (Qingdao)
    wget http://logtail-release-qd.oss-cn-qingdao-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-qingdao
  • China East 1 (Hangzhou)
    wget http://logtail-release.oss-cn-hangzhou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou
  • China East 2 (Shanghai)
    wget http://logtail-release-sh.oss-cn-shanghai-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai 
  • China South  1 (Shenzhen) 
    wget http://logtail-release-sz.oss-cn-shenzhen-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen
  • China North 3  (Zhangjianchou)
    wget http://logtail-release-zjk.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-zhangjiakou
  • China North 5 (Huhehaote)
    wget http://logtail-release-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-huhehaote 
  • Hong Kong (China) 
    wget http://logtail-release-hk.oss-cn-hongkong-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hongkong 
  • US West 1  (Silicon Valley)
    wget http://logtail-release-us-west-1.oss-us-west-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-west-1 
  • Asia Pacific SE 1  (Singapore)
    wget http://logtail-release-ap-southeast-1.oss-ap-southeast-1-internal.aliyuncs.com/linux64/logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-1
  • Asia Pacific SE 2  (Sydney)
    wget http://logtail-release-ap-southeast-2.oss-ap-southeast-2-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-2
  • Asia Pacific SE 3  (Kuala Lumpur) 
    wget http://logtail-release-ap-southeast-3.oss-ap-southeast-3-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-3
  • Asia Pacific NE 1  (Japan)
    wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-northeast-1
  • EU Central 1  (Frankfurt) 
    wget http://logtail-release-eu-central-1.oss-eu-central-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install eu-central-1
  • Middle East 1  (Dubai) 
    wget http://logtail-release-me-east-1.oss-me-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install me-east-1 

ECS instances of VPC 

Data is written to Log Service by means of Alibaba Cloud VPC,  which is applicable to Alibaba Cloud ECS instances of VPC.

  • China North  2 (Beijing) 
    wget http://logtail-release-bj.vpc100-oss-cn-beijing.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-beijing_vpc 
  • China North 1 (Qingdao) 
    wget http://logtail-release-qd.vpc100-oss-cn-qingdao.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-qingdao_vpc 
  • China East 1 (Hangzhou) 
    wget http://logtail-release.vpc100-oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou_vpc 
  • China East 2 (Shanghai)
    wget http://logtail-release-sh.vpc100-oss-cn-shanghai.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai_vpc
  • China South 1 (Shenzhen) 
    wget http://logtail-release-sz.vpc100-oss-cn-shenzhen.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen_vpc 
  • China North 3 (Zhangjianchou)
    wget http://logtail-release-zjk.oss-cn-zhangjiakou-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-zhangjiakou_vpc
  • China North 5 (Huhehaote)
    wget http://logtail-release-huhehaote.oss-cn-huhehaote-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-huhehaote
  • China (Chengdu) 
    wget http://logtail-release-cn-chengdu.oss-cn-chengdu-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-chengdu
  • Hong Kong (China)
    wget http://logtail-release-hk.vpc100-oss-cn-hongkong.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hongkong_vpc 
  • US West 1 (Silicon Valley) 
    wget http://logtail-release-us-west-1.vpc100-oss-us-west-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-west-1_vpc 
  • US East 1  (Virginia) 
    wget http://logtail-release-us-east-1.vpc100-oss-us-east-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-east-1 
  • Asia Pacific SE 1 (Singapore) 
    wget http://logtail-release-ap-southeast-1.vpc100-oss-ap-southeast-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-1_vpc 
  • Asia Pacific SE 2 (Sydney) 
    wget http://logtail-release-ap-southeast-2.oss-ap-southeast-2-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-2_vpc 
  • Asia Pacific SE 3 (Kuala Lumpur) 
    wget http://logtail-release-ap-southeast-3.oss-ap-southeast-3-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-3
  • Asia Pacific SE 5  (Jakarta)
    wget http://logtail-release-ap-southeast-5.oss-ap-southeast-5-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-5 
  • Asia Pacific NE 1  (Japan) 
    wget http://logtail-release-ap-northeast-1.oss-ap-northeast-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-northeast-1_vpc 
  • EU Central 1 (Frankfurt) 
    wget http://logtail-release-eu-central-1.oss-eu-central-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install eu-central-1_vpc 
  • Middle East 1 (Dubai) 
    wget http://logtail-release-me-east-1.oss-me-east-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install me-east-1_vpc 
  • Asia Pacific SOU 1  (Mumbai) 
    wget http://logtail-release-ap-south-1.oss-ap-south-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-south-1 

Internet (self-built IDCs or other cloud hosts)

Data is written to Log Service by means of Internet, which occupies Internet bandwidth  and is applicable to non-Alibaba Cloud virtual machines or other IDCs.
Note
Log Service cannot obtain the owner information of non-Alibaba Cloud machines. Therefore, you must manually configure the user identification after installing Logtail. For more information, see Configure a user identity for non-Alibaba Cloud ECS instances.  Collect logs from non-Alibaba Cloud ECS instances or ECS instances not in your accountOtherwise,  Logtail has abnormal heartbeat and cannot collect logs.
  • China North  2 (Beijing)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-beijing_internet 
  • China North  1 (Qingdao)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-qingdao_internet
  • China East  1 (Hangzhou)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou_internet 
  • China East  2 (Shanghai)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai_internet
  • China South 1 (Shenzhen)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen_internet 
  • China North 3 (Zhangjianchou)
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-zhangjiakou_internet 
  • China North 5  (Huhehaote) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-huhehaote_internet 
  • China  (Chengdu) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-chengdu_internet 
  • Hong Kong (China)
    wget http://logtail-release-hk.oss-cn-hongkong.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hongkong_internet 
  • US West 1 (Silicon Valley) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-west-1_internet 
  • US East 1 (Virginia) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install us-east-1_internet 
  • Asia Pacific SE 1 (Singapore) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-1_internet 
  • Asia Pacific SE 2 (Sydney) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-2_internet
  • Asia Pacific SE 3 (Kuala Lumpur) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-3_internet 
  • Asia Pacific SE 5 (Jakarta) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-southeast-5_internet 
  • Asia Pacific NE 1 (Japan) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-northeast-1_internet 
  • EU Central 1   (Frankfurt) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install eu-central-1_internet 
  • Middle East 1  (Dubai) 
    wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install me-east-1_internet 
  • Asia Pacific SOU 1 (Mumbai) 
    wget http://logtail-release-ap-south-1.oss-ap-south-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install ap-south-1_internet 

ECS instances of financial cloud

  • China East 1 (Hangzhou) 
    wget http://logtail-release-hz-finance.oss-cn-hzjbp-a-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-hangzhou-finance 
  • China East  2 (Shanghai)
    wget http://logtail-release-sh-finance.oss-cn-shanghai-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shanghai-finance
  • China South 1 (Shenzhen) 
    wget http://logtail-release-sz-finance.oss-cn-shenzhen-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh install cn-shenzhen-finance

View Logtail version

Logtail records its version information in the logtail_version field of the / /usr/local/ilogtail/app_info.json file. For example:
$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.0",
   "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" : "2018-01-05 13:19:08"
}

Update Logtail

The procedure of updating Logtail is the same as that of installing Logtail. When you update the Logtail, the Logtail is automatically uninstalled first and then the latest version of Logtail is installed.

Manually start and stop Logtail

  • Start Logtail
    Run the following command as an administrator: 
    /etc/init.d/ilogtaild start.
  • Stop Logtail
    Run the following command as an administrator:
    /etc/init.d/ilogtaild stop.

Uninstall Logtail

Download the installer logtail.sh. For more information, see Install Logtail  in this document.   Run the following command as an administrator in shell mode: 

wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; sh logtail.sh uninstall