edit-icon download-icon

Install Agent

Last Updated: Jun 01, 2018

ARMS uses the Log Service agent to collect ECS logs. This topic explains how to install the Logtail agent on an ECS instance.

Install Logtail

  1. In the left-side navigation pane of the ARMS console, choose Custom Datasource Management > [ECS Log].

  2. On the instance list page, click Install Agent for the target ECS instance.

  3. Download the installer according to the network environment of the machine and the region of Log Service. Select parameters accordingly for installation.

    Install the agent

NOTE: The agent is installed in overwrite mode. If you have installed Logtail before, the installer uninstalls and deletes the /usr/local/ilogtail directory before re-installing Logtail. Logtail is launched by default after installation.

ECS classic network

Data is written to Log Service through the Alibaba Cloud intranet without consuming public bandwidth. It is applicable to Alibaba Cloud ECS.

  • China North 2 (Beijing)

    1. wget http://logtail-release-bj.oss-cn-beijing-internal.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_beijing
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China North 1 (Qingdao)

    1. wget http://logtail-release-qd.oss-cn-qingdao-internal.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_qingdao
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 1 (Hangzhou)

    1. wget http://logtail-release.oss-cn-hangzhou-internal.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_hangzhou
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 2 (Shanghai)

    1. wget http://logtail-release-sh.oss-cn-shanghai-internal.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shanghai
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China South 1 (Shenzhen)

    1. wget http://logtail-release-sz.oss-cn-shenzhen-internal.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shenzhen
    4. sudo touch /etc/ilogtail/users/1098370038733503

ECS VPC

Data is written to Log Service through Alibaba Cloud VPC. It is applicable to Alibaba Cloud ECS VPC.

  • China North 2 (Beijing)

    1. wget http://logtail-release-bj.vpc100-oss-cn-beijing.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_beijing_vpc
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 1 (Hangzhou)

    1. wget http://logtail-release.vpc100-oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_hangzhou_vpc
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 2 (Shanghai)

    1. wget http://logtail-release-sh.vpc100-oss-cn-shanghai.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shanghai_vpc
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China South 1 (Shenzhen)

    1. wget http://logtail-release-sz.vpc100-oss-cn-shenzhen.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shenzhen_vpc
    4. sudo touch /etc/ilogtail/users/1098370038733503

Internet (Self-built IDC or other cloud hosts)

Data is written to Log Service through the Internet, which consumes public bandwidth. It is applicable to non-Alibaba Cloud virtual machines or other IDCs.

Because Log Service cannot obtain the owner information of non-Alibaba Cloud machines, you must manually configure a user ID after installing Logtail. Otherwise, Logtail will have abnormal heartbeats and fail to collect logs.

  • China North 2 (Beijing)

    1. wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_beijing_internet
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China North 1 (Qingdao)

    1. wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_qingdao_internet
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 1 (Hangzhou)

    1. wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_hangzhou_internet
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China East 2 (Shanghai)

    1. wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shanghai_internet
    4. sudo touch /etc/ilogtail/users/1098370038733503
  • China South 1 (Shenzhen)

    1. wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh
    2. chmod 755 logtail.sh
    3. sudo sh logtail.sh install cn_shenzhen_internet
    4. sudo touch /etc/ilogtail/users/1098370038733503

Verify Logtail

  1. In the left-side navigation pane of the ARMS console, choose Custom Datasource Management > [ECS Log].

  2. On the instance list page, click Check Agent for the target ECS instance. Wait a moment until the agent status changes to Installed, which indicates the Agent is working.

Uninstall Logtail

Follow the instructions of Install Logtail section to download the logtail.sh installer, and run the following command as the administrator in shell mode:

  1. sudo sh logtail.sh uninstall
  2. sudo rm -rf /etc/ilogtail/users/1098370038733503
Thank you! We've received your feedback.