すべてのプロダクト
Search

このプロダクト

    :Linux サーバーに Logtail をインストールする

    ドキュメントセンター

    :Linux サーバーに Logtail をインストールする

    最終更新日:Feb 14, 2025

    Simple Log Service プロジェクトを使用してサーバーログを収集する場合、Logtail をインストールする必要があります。このトピックでは、Linux サーバーに Logtail をインストール、更新、およびアンインストールする方法について説明します。

    制限事項

    重要

    サーバーのスペックが低い場合、またはオペレーティングシステムのバージョンが古い場合、Logtail バージョン 2.0 をインストールするときに互換性の問題が発生する可能性があります。この場合、他のソフトウェアが期待どおりに動作しない可能性があります。 Logtail V1.8.7 をダウンロードし、./logtail.sh install ${region_id} -v 1.8.7 コマンドを実行して Logtail をインストールすることをお勧めします。

    • 次の x86-64 Linux オペレーティングシステムのいずれかを実行しているサーバーに Logtail をインストールできます。

      • Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3

      • Anolis OS 7 および Anolis OS 8

      • CentOS Linux 6、CentOS Linux 7、および CentOS Linux 8

      • Debian GNU/Linux 8、Debian GNU/Linux 9、Debian GNU/Linux 10、Debian GNU/Linux 11、および Debian GNU/Linux 12

      • Red Hat Enterprise Linux 6、Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、および Red Hat Enterprise Linux 9

      • openSUSE 15.1、openSUSE 15.2、および openSUSE 42.3

      • SUSE Linux Enterprise Server 11、SUSE Linux Enterprise Server 12、および SUSE Linux Enterprise Server 15

      • Ubuntu 14.04、Ubuntu 16.04、Ubuntu 18.04、Ubuntu 20.04、Ubuntu 22.04、および Ubuntu 24.04

      • GNU C Library バージョン 2.5 以降に基づく Linux オペレーティングシステム

        説明

        バージョン 2.0 以降の Logtail では、GNU C Library バージョン 2.6 以降が必要です。

      • SSE4.2 および AVX 命令セットをサポートする Linux オペレーティングシステム (バージョン 2.0 以降の Logtail)

    • 次の ARM64 Linux オペレーティングシステムのいずれかを実行しているサーバーに Logtail をインストールできます。

      • Alibaba Cloud Linux 3.2 for ARM

      • Anolis OS 8.2 for ARM 以降

      • CentOS Linux 8.4 for ARM

      • Debian 11.2 and Debian 12.2 for ARM

      • Ubuntu 20.04、Ubuntu 22.04、および Ubuntu 24.04 for ARM

      • ARMv8.2-A をサポートする Linux オペレーティングシステム (バージョン 2.0 以降の Logtail)

    Logtail をインストールする

    重要

    • オンラインで Logtail をインストールする

      ネットワークタイプ

      シナリオ

      Alibaba Cloud 内部ネットワーク

      使用される ECS インスタンスと Simple Log Service プロジェクトは同じリージョンにあります。

      インターネット

      • 使用される ECS インスタンスと Simple Log Service プロジェクトは異なるリージョンにあります。

      • 使用されるサーバーは、サードパーティのクラウド サービス プロバイダーまたはデータセンターにあります。

      転送アクセラレーション

      使用されるサーバーは、中国国外のサードパーティ クラウド サービス プロバイダーまたは中国国外のデータセンターにあります。インターネット経由のデータ転送は、ネットワーク遅延の増加と接続の不安定化を引き起こす可能性があります。この場合、転送アクセラレーション機能を使用してログを転送することをお勧めします。

      説明

      Logtail をオンラインでインストールすると、サーバーのオペレーティングシステムに基づいて Logtail が自動的にインストールされます。ネットワークタイプを選択する必要はありません。

      Alibaba Cloud 内部ネットワーク (クラシックネットワークまたは VPC)

      • ECS インスタンスが存在するリージョンは識別されません。

        インターネット経由で Logtail インストールスクリプトをダウンロードし、auto パラメーターを構成して Logtail をインストールします。インストールコマンドで auto パラメーターを構成すると、Logtail インストールスクリプトは ECS インスタンスのメタデータを取得して使用し、ECS インスタンスのリージョンを自動的に識別します。 ECS インスタンスのメタデータの詳細については、「ECS インスタンスメタデータの概要」をご参照ください。

        1. インターネット経由で Logtail インストールスクリプトを ECS インスタンスの作業ディレクトリにダウンロードします。ダウンロード操作では、約 10 KB のインターネットトラフィックが消費されます。

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

        2. auto パラメーターを構成して Logtail をインストールします。特定のリージョンの Logtail インストールパッケージは、Alibaba Cloud 内部ネットワーク経由で自動的にダウンロードされます。ダウンロード操作では、インターネットトラフィックは消費されません。

          ./logtail.sh install auto

      • ECS インスタンスが存在するリージョンは識別されます。

        ECS インスタンスが存在するリージョンの ${region_id} パラメーターの値を取得します。${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

        重要

        各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

        wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}

        Alibaba Cloud 内部ネットワーク経由で Logtail インストールスクリプトをダウンロードし、Logtail をインストールします。ダウンロード操作では、インターネットトラフィックは消費されません。

      インターネット

      Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

      重要

      各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

      wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet

      転送アクセラレーション

      Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

      重要 
      wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration

    • オフラインで Logtail をインストールする

      1. インターネットにアクセスできるサーバーで、インストールスクリプトとインストールパッケージをダウンロードします。

        重要

        各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

        1. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行してインストールスクリプトをダウンロードします。

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

        2. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行してインストールパッケージをダウンロードします。

          • インストールパッケージ (x86-64)

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

          • インストールパッケージ (ARM)

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

      2. インストールスクリプトとインストールパッケージを、Logtail をインストールするサーバーにコピーします。

      3. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

        重要

        各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

        • インターネット

          chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet

        • 内部ネットワーク

          chmod +x logtail.sh; ./logtail.sh install-local ${region_id}

        • 転送アクセラレーション

          転送アクセラレーションを使用して Logtail をインストールした後、転送アクセラレーション機能を有効にする必要があります。詳細については、「プロジェクトの転送アクセラレーション機能を有効にする」をご参照ください。

          chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

    Logtail を起動および停止する

    • Logtail を起動するには、次のコマンドを実行します。

      sudo /etc/init.d/ilogtaild start

    • Logtail を停止するには、次のコマンドを実行します。

      sudo /etc/init.d/ilogtaild stop

    Logtail のステータスとバージョンを表示する

    • Logtail のステータスを表示する

      Logtail のステータスを表示するには、次のコマンドを実行します。

      sudo /etc/init.d/ilogtaild status

      次の情報が返された場合、Logtail はインストールされています。

      ilogtail is running

      Logtail が「実行中」状態ではない場合は、Logtail をアンインストールしてから再インストールしてください。

    • Logtail のバージョンを表示する

      Logtail のインストールディレクトリに移動し、/usr/local/ilogtail/app_info.json ファイルを開きます。 logtail_version フィールドの値が Logtail のバージョンです。 Logtail のバージョンを表示するには、次のコマンドを実行します。

      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 コマンドを実行して Logtail を更新すると、上書きインストールが実行されます。システムは現在のバージョンの Logtail をアンインストールし、/usr/local/ilogtail などの関連ディレクトリを削除してから、新しいバージョンの Logtail をインストールします。インストールが成功すると、Logtail は自動的に実行され、スタートアッププログラムとして追加されます。

    • Logtail は更新中は一時的に停止されます。ログデータは失われません。 Logtail が更新された後、構成ファイルとチェックポイントファイルのみが保持されます。他のファイルは上書きされます。

    • Logtail バージョン 1.x からバージョン 2.x にアップグレードする場合は、コレクション構成でコンテナ検出機能が無効になっていることを確認してください。つまり、コンソールの収集構成ページには container に関連する用語が表示されてはならず、EnableContainerDiscovery パラメーターと docker_file パラメーターの両方が false に設定されていることを確認する必要があります。 これを行わないと、収集に失敗する可能性があります。

    • オンラインで Logtail を更新する

      Logtail インストールスクリプト logtail.sh を使用して Logtail を更新できます。インストールスクリプトは、インストールされている Logtail の構成に基づいて更新方法を自動的に選択します。

      1. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行して Logtail を更新します。

        重要

        各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

        wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh
sudo ./logtail.sh upgrade

      2. 更新結果を確認します。

        次のサンプル結果は、アップグレードが成功したことを示しています。

        stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

    • オフラインで Logtail を更新する

      1. インターネットにアクセスできるサーバーでインストールスクリプトとインストールパッケージをダウンロードします。

        重要

        各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

        1. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行してインストールスクリプトをダウンロードします。

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

        2. Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行してインストールパッケージをダウンロードします。

          • インストールパッケージ (x86-64)

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

          • インストールパッケージ (ARM)

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

      2. インストールスクリプトとインストールパッケージを Logtail をインストールするサーバーにコピーします。

      3. Logtail を更新するには、次のコマンドを実行します。

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

    Logtail をアンインストールする

    重要

    各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。

    Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、次のコマンドを実行して Logtail をアンインストールします。

    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

    シナリオ

    • Simple Log Service プロジェクトとサーバーが同じアカウントに属し、同じリージョンに存在する

      Simple Log Service プロジェクトと同じリージョンにある ECS インスタンスに Logtail を自動的にインストールするには、Simple Log Service を Operation Orchestration Service (OOS) と併用することをお勧めします。詳細については、「ECS インスタンスに Logtail をインストールする」をご参照ください。

      自動インストールが要件を満たしていない場合は、このトピックに基づいて Logtail を手動でインストールできます。

    • Simple Log Service プロジェクトとサーバーが同じアカウントに属しているが、異なるリージョンに存在する

      次の図は、構成プロセスを示しています。

      インターネット経由で Logtail をインストールする必要があります。次に、Simple Log Service プロジェクトでマシングループを作成し、ログを収集するように Logtail を構成する必要があります。詳細については、「マシングループを作成する」および「サーバーからテキストログを収集する」をご参照ください。

      クラシックネットワークまたは VPC 経由で Logtail をインストールする場合は、ilogtail_config.json ファイルのネットワークパラメーターを変更して、リージョンをまたいでログを収集するように Logtail を構成できます。詳細については、「Alibaba Cloud 内部ネットワーク (クラシックネットワークまたは VPC)」をご参照ください。

      1. /usr/local/ilogtail/ilogtail_config.json ファイルのネットワークパラメーターを変更します。

        たとえば、プロジェクトが中国 (成都) リージョンにあり、ECS インスタンスが中国 (杭州) リージョンにあるとします。次のコードに基づいてパラメーターを変更します。

        {
  "config_server_address" : "http://logtail.cn-chengdu.log.aliyuncs.com",
  "data_server_list" :
  [
    {
      "cluster" : "cn-chengdu",
      "endpoint" : "cn-chengdu.log.aliyuncs.com"
    }
  ],
  ...
}

      2. 構成ファイルを変更した後、Logtail を再起動する必要があります。

        sudo /etc/init.d/ilogtaild restart

    • Simple Log Service プロジェクトとサーバーが異なるアカウントに属する

      このシナリオでは、Logtail をインストールするサーバーは、Simple Log Service プロジェクトのアカウントとは異なる Alibaba Cloud アカウントに属しているか、データセンターまたはサードパーティのクラウド環境に存在します。次の図は、構成プロセスを示しています。

      インターネット経由で Logtail をインストールする必要があります。次に、アカウント A の ID を使用してユーザー識別子を構成し、カスタムユーザー識別子を構成する必要があります。詳細については、「ユーザー識別子を構成する」をご参照ください。次に、アカウント A の Simple Log Service プロジェクトでカスタム識別子ベースのマシングループを作成し、ログを収集するように Logtail を構成する必要があります。詳細については、「マシングループを管理する」、「サーバーからテキストログを収集する」、および「Logtail を使用して Alibaba Cloud アカウント間でログを収集する」をご参照ください。

    FAQ

    1. Logtail がインストールされているかどうかを確認するにはどうすればよいですか。

      Logtail のステータスを表示して、サーバーに Logtail がインストールされているかどうかを確認できます。詳細については、「Logtail のステータスを表示する」をご参照ください。

    2. Logtail をインストールした後、Logtail 構成用に作成したマシングループのハートビートステータスが FAIL になります。どうすればよいですか。

      Logtail 構成を作成した後にハートビートステータスが FAIL の場合は、次のコマンドを実行して Logtail のバージョンを表示できます。次に、Logtail を更新して、ハートビートステータスが正常になるかどうかを確認します。

      cat /usr/local/ilogtail/app_info.json

    3. Logtail をインストールした後、Logtail はログの収集を開始します。ただし、ログの収集に失敗したことを示す状態コードが返されます。どうすればよいですか。

      Logtail は収集されたログを集約し、集約されたログを Simple Log Service に送信します。ログが Simple Log Service に送信できない場合、Logtail はエラーメッセージに基づいて、ログを再送信するか、ログの送信を停止するかを決定します。詳細については、「ログを送信する」をご参照ください。