LinuxサーバーにLogtailをインストール、更新、およびアンインストールする方法 - Simple Log Service

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
- Red Hat Enterprise Linux 6、Red Hat Enterprise Linux 7、およびRed Hat Enterprise Linux 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
- Ubuntu 14.04、Ubuntu 16.04、Ubuntu 18.04、Ubuntu 20.04、Ubuntu 22.04、Ubuntu 24.04
- SUSE Linux Enterprise Server 11、SUSE Linux Enterprise Server 12、およびSUSE Linux Enterprise Server 15
- openSUSEリープ15.1、openSUSEリープ15.2、openSUSEリープ42.3
- GNU Cライブラリのバージョン2.5以降に基づくLinuxオペレーティングシステム
  説明
  バージョン2.0以降のLogtailの場合、GNU Cライブラリバージョン2.6以降が必要です。
- SSE4.2およびAVX命令セット (バージョン2.0以降のLogtail) をサポートするLinuxオペレーティングシステム
次のARM64 Linuxオペレーティングシステムのいずれかを実行するサーバーにLogtailをインストールできます。
- Alibaba Cloud Linux 3.2 for ARM
- ARMまたはそれ以降のAnolis OS 8.2
- ARM用CentOS Linux 8.4
- Ubuntu 20.04とARM用のUbuntu 24.04
- ARM用Debian GNU/Linux 11.2
- ARMv8.2-AをサポートするLinuxオペレーティングシステム (バージョン2.0以降のLogtail)

Logtailのインストール

重要

インストールコマンドは、Logtailをインストールするサーバーのネットワークタイプによって異なります。ネットワークタイプは、Simple Log Serviceプロジェクトがサーバーからログを収集するために使用するネットワーク接続モードを指します。ネットワークタイプの詳細については、「ネットワークタイプの選択」をご参照ください。
クラシックネットワークにあるElastic Compute Service (ECS) インスタンスにLogtailをインストールし、ネットワークタイプをクラシックネットワークからVirtual Private Cloud (VPC) に変更する場合、Logtail設定を更新する必要があります。詳細については、「」をご参照ください。ECSインスタンスのネットワークタイプをクラシックネットワークからVPCに切り替えた後、Logtail設定を更新するにはどうすればよいですか。

Logtailをオンラインでインストール

ネットワークタイプ	シナリオ
Alibaba Cloud内部ネットワーク	使用されているECSインスタンスとSimple Log Serviceプロジェクトは同じリージョンにあります。
インターネット	使用されているECSインスタンスとSimple Log Serviceプロジェクトは異なるリージョンにあります。使用されるサーバーは、サードパーティのクラウドサービスプロバイダーまたはデータセンターにあります。
転送アクセラレーション	使用されるサーバーは、中国以外のサードパーティのクラウドサービスプロバイダーまたは中国以外のデータセンターにあります。インターネットを介したデータ転送は、高いネットワーク待ち時間と不安定な接続を引き起こす可能性があります。この場合、転送アクセラレーション機能を使用してログを転送することを推奨します。

説明

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

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

ECSインスタンスが存在するリージョンが特定されていません。
インターネット経由でLogtailインストールスクリプトをダウンロードし、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. 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

転送アクセラレーション

重要

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}
```
  - 転送アクセラレーション
```
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のバージョンを表示する

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

cat /usr/local/ilogtail/app_info.json

Output

{
   "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をオンラインで更新する
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のアンインストール

重要

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とOperation Orchestration Service (OOS) を使用して、Simple Log Serviceプロジェクトと同じリージョンにあるECSインスタンスにLogtailを自動的にインストールすることを推奨します。詳細については、「ECSインスタンスへのLogtailのインストール」をご参照ください。
自動インストールが要件を満たしていない場合は、このトピックに基づいて手動でLogtailをインストールできます。
Simple Log Serviceプロジェクトとサーバーは同じアカウントに属していますが、異なるリージョンにあります。
次の図に、設定プロセスを示します。
Logtailはインターネット経由でインストールする必要があります。次に、Simple Log Serviceプロジェクトでマシングループを作成し、ログを収集するようにLogtailを設定する必要があります。詳細については、「マシングループの作成」および「サーバーからのテキストログの収集」をご参照ください。
LogtailをクラシックネットワークまたはVPC経由でインストールする場合、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アカウント全体のログを収集する」をご参照ください。

よくある質問

Logtailがインストールされているかどうかを確認する方法?
Logtailのステータスを表示して、Logtailがサーバーにインストールされているかどうかを確認できます。詳細については、「Logtailのステータスの表示」をご参照ください。
Logtailがインストールされた後、Logtail構成用に作成されたマシングループのハートビートステータスはFAILです。どうすればよいですか。
Logtail設定の作成後にハートビートステータスがFAILの場合、次のコマンドを実行してLogtailのバージョンを表示できます。次に、Logtailを更新して、ハートビートステータスが正常になるかどうかを確認します。
```
cat /usr/local/ilogtail/app_info.json
```
Logtailのインストール後、Logtailはログの収集を開始します。ただし、ログの収集に失敗したことを示すステータスコードが返されます。どうすればよいですか。
Logtailは収集したログを集約し、集約したログをSimple Log Serviceに送信します。ログがSimple Log Serviceに送信されない場合、Logtailはエラーメッセージに基づいてログを再送信するか、ログの送信を停止するかを決定します。詳細については、「ログの送信」をご参照ください。

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

制限事項

Logtailのインストール

Logtailをオンラインでインストール

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

インターネット

転送アクセラレーション

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

Logtailの起動と停止

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

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

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

Logtail に更新

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

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

Logtailのアンインストール

シナリオ

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

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

Simple Log Serviceプロジェクトとサーバーは異なるアカウントに属しています

よくある質問