All Products
Search

This Product

    Simple Log Service:Upgrade Logtail to LoongCollector

    Document Center

    Simple Log Service:Upgrade Logtail to LoongCollector

    Last Updated:Dec 11, 2025

    This topic describes how to upgrade Logtail to LoongCollector and how to roll back LoongCollector to Logtail.

    Introduction to upgrading Logtail to LoongCollector

    LoongCollector is a comprehensive upgrade for log collection scenarios, with significant optimizations in features, performance, and stability. The iLogtail architecture has been refactored. The core C++ engine now uses a pipeline design. This design makes the input, processing, and output modules pluggable and supports flexible combinations. Each collection task has an independent configuration that precisely defines the entire process of data collection, processing, and transmission. For more information, see Leap in Log Collection Efficiency: A Comprehensive Upgrade from iLogtail to LoongCollector.

    Server scenarios

    Upgrade from Logtail to LoongCollector

    To upgrade Logtail to LoongCollector, find the appropriate command for your server in the table below and run it.

    Operating system

    CPU architecture

    Download method

    Installation method

    Linux

    ARM

    The server has an Internet connection and can download directly.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    Select the installation command based on your network connection.

    # Install from the Internet
chmod +x loongcollector.sh; ./loongcollector.sh upgrade

    x86-64

    ARM

    The server is offline. First, download the installation script and package on a server that can access the Internet.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

    Copy the installation script and package to the server where you want to install LoongCollector. Then, select the installation command based on your network connection.

    # Install from the Internet
chmod +x loongcollector.sh; ./loongcollector.sh upgrade-local

    x86-64

    The server is offline. First, download the installation script and package on a server that can access the Internet.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    If the following information is displayed, the upgrade is successful.

    Try to stop ilogtail ...
kill process Name: ilogtail pid: 878
kill process Name: ilogtail pid: 879
stop successfully
Stop ilogtail successfully.
Upgrading loongcollector files ...
Upgrade loongcollector files successfully.
Starting loongcollector ...
loongcollector is running
Upgrade loongcollector successfully.

    Roll back from LoongCollector to Logtail

    To roll LoongCollector back to Logtail, find the appropriate command for your server in the table below and run it.

    Note

    You must download the logtail.sh script again. Do not use the old logtail.sh script.

    CPU architecture

    Download method

    Execution command

    ARM and x86-64

    The server has an Internet connection:

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 

    After the download is complete, run the upgrade command.

    chmod +x logtail.sh; sudo ./logtail.sh upgrade;

    To specify a version, run the following command.

    # For example, to specify version 1.8.7, replace the version number as needed.
chmod +x logtail.sh; sudo ./logtail.sh upgrade -v -v 1.8.7;

    ARM

    The server is offline. First, download the installation script and package on a server that can access the Internet:

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz;

    Copy the installation script and package to the server where you want to upgrade Logtail. Then, run the following upgrade command.

    chmod +x logtail.sh; ./logtail.sh upgrade-local;

    x86-64

    The server is offline. First, download the installation script and package on a server that can access the Internet:

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz;