このトピックでは、LinuxサーバーにLogtailをインストール、更新、およびアンインストールする方法について説明します。
制限事項
サーバーの仕様が低い場合、またはオペレーティングシステムが以前のバージョンを実行している場合、Logtail V2.0をインストールすると互換性の問題が発生する可能性があります。 この場合、他のソフトウェアは期待どおりに実行できません。 Logtailをダウンロードすることを推奨しますV1.8.7を実行し、. /logtail.sh install ${your_region_name} -v 1.8.7
コマンドを実行してLogtailをインストールします。
次のx86-64 Linuxオペレーティングシステムのいずれかを実行するサーバーにLogtailをインストールできます。
Alibaba Cloud Linux 2
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
Ubuntu 14.04、Ubuntu 16.04、Ubuntu 18.04、およびUbuntu 20.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オペレーティングシステム
SSE4.2命令セット (V2.0以降のLogtail) をサポートするLinuxオペレーティングシステム
次のARM64 Linuxオペレーティングシステムのいずれかを実行するサーバーにLogtailをインストールできます。
Alibaba Cloud Linux 3.2 for ARM
ARMまたはそれ以降のAnolis OS 8.2
ARM用CentOS Linux 8.4
ARM用Ubuntu 20.04
ARM用Debian GNU/Linux 11.2
ARMv8.2-AをサポートするLinuxオペレーティングシステム (V2.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プロジェクトは同じリージョンにあります。 |
インターネット |
|
転送アクセラレーション | 使用されるサーバーは、中国以外のサードパーティのクラウドサービスプロバイダーまたは中国以外のデータセンターにあります。 インターネットを介したデータ転送は、高いネットワーク待ち時間と不安定な接続を引き起こす可能性があります。 この場合、転送アクセラレーション機能を使用してログを転送することを推奨します。 |
Logtailをオンラインでインストールすると、サーバーのオペレーティングシステムに基づいてLogtailが自動的にインストールされます。 ネットワークタイプを選択する必要はありません。
Alibaba Cloud内部ネットワーク (クラシックネットワークまたはVPC)
ECSインスタンスが存在するリージョンを特定できない場合は、Logtailインストールスクリプトをダウンロードし、autoパラメーターを使用してLogtailをインストールできます。
インストールコマンドでautoパラメーターを設定すると、Logtailインストールスクリプトは自動的にECSインスタンスのメタデータを取得して使用し、ECSインスタンスのリージョンを識別します。 ECSインスタンスのメタデータの詳細については、「ECSインスタンスメタデータの概要」をご参照ください。
Logtailインストールスクリプトをインターネット経由でECSインスタンスの作業ディレクトリにダウンロードします。 ダウンロード操作は約10 KBのインターネットトラフィックを消費します。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh
autoパラメーターを使用してLogtailをインストールします。
特定のリージョンのLogtailインストールパッケージが自動的にダウンロードされます。 ダウンロード操作では、インターネットトラフィックは消費されません。
./logtail.sh install auto
ECSインスタンスが存在するリージョンを特定できる場合は、インストールコマンドでリージョンを指定できます。
内部ネットワーク経由でLogtailインストールスクリプトをダウンロードし、Logtailをインストールします。 ダウンロード操作では、インターネットトラフィックは消費されません。
Simple Log Serviceプロジェクトが存在するリージョンの
${your_region_name}
変数の値を取得します。各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの${your_region_name}
変数の値はcn-Hangzhou
です。インストールコマンドの
${your_region_name}
変数を、プロジェクトが存在するリージョンの値に置き換えてから、インストールコマンドを実行します。wget http://logtail-release-${your_region_name}.oss-${your_region_name}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}
インターネット
Simple Log Serviceプロジェクトが存在するリージョンの
${your_region_name}
変数の値を取得します。各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの${your_region_name}
変数の値はcn-Hangzhou
です。インストールコマンドの
${your_region_name}
変数を、プロジェクトが存在するリージョンの値に置き換えてから、インストールコマンドを実行します。wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-internet
転送アクセラレーション
Simple Log Serviceプロジェクトが存在するリージョンの
${your_region_name}
変数の値を取得します。各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの${your_region_name}
変数の値はcn-Hangzhou
です。インストールコマンドの
${your_region_name}
変数を、プロジェクトが存在するリージョンの値に置き換えてから、インストールコマンドを実行します。wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}-acceleration
Logtailをオフラインでインストールする
インターネット経由でアクセスできるサーバーにログオンします。
ダウンロードコマンドの
${your_region_name}
変数をプロジェクトが存在するリージョンの値に置き換え、ダウンロードコマンドを実行してインストールスクリプトとインストールパッケージをダウンロードします。各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの${your_region_name}
変数の値はcn-Hangzhouです。インストールスクリプトをダウンロードします。
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
インストールパッケージのダウンロード
インストールパッケージ (x86-64)
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
インストールパッケージ (ARM)
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz
インストールスクリプトとインストールパッケージを、Logtailをインストールするサーバーにコピーします。
インストールコマンドの
${your_region_name}
変数をプロジェクトが存在するリージョンの値に置き換え、Logtailをインストールするサーバーでインストールコマンドを実行します。各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 例:インターネット経由でリソースにアクセスできる中国 (杭州) リージョンの
${your_region_name}
変数の値は、cn-Hangzhou-Internet
です。内部ネットワーク経由でリソースにアクセスできる中国 (杭州) リージョンの
${your_region_name}
変数の値はcn-Hangzhou
です。transfer accelerationを使用してリソースにアクセスできる中国 (杭州) リージョンの
${your_region_name}
変数の値は、cn-Hangzhou-acceleration
です。
chmod +x logtail.sh; ./logtail.sh install-local ${your_region_name}
Logtailのステータスとバージョンを表示する
サーバーにLogtailがインストールされたら、Logtailのステータスとバージョンを表示できます。
Logtailのステータスを表示する
Logtailのステータスを表示して、Logtailがサーバーにインストールされているかどうかを確認します。
コマンド
sudo /etc/init.d/ilogtaild status
Output
次の情報が返されると、Logtailがインストールされます。
ilogtail is running
Logtailが [実行中] 状態でない場合は、LogtailをアンインストールしてからLogtailを再インストールします。
Logtailのバージョンを表示
/usr/local/ilogtail/app_info.json
ファイルを開きます。 logtail_version
フィールドの値は、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の設定に基づいて更新方法を自動的に選択します。
次のコマンドを実行してLogtailを更新します。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh sudo ./logtail.sh upgrade
更新結果を確認します。
次の例のような情報が返された場合、更新は成功します。
Stop logtail successfully. ilogtail is running Upgrade logtail success { "UUID" : "***", "hostname" : "***", "instance_id" : "***", "ip" : "***", "logtail_version" : "0.16.30", "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64", "update_time" : "2020-08-29 15:01:36" }
Logtailをオフラインで更新
インターネット経由でアクセスできるサーバーにログオンします。
ダウンロードコマンドの
${your_region_name}
変数を、プロジェクトが存在するリージョンの値に置き換えてから、ダウンロードコマンドを実行します。インターネット経由でリソースにアクセスできる各リージョンの
${your_region_name}
変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、インターネット経由でリソースにアクセスできる中国 (杭州) リージョンの${your_region_name}
変数の値はcn-Hangzhou-Internet
です。次のコマンドを実行して、インストールスクリプトをダウンロードします。
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
次のコマンドを実行して、インストールパッケージをダウンロードします。
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
インストールスクリプトとインストールパッケージを、Logtailを更新するサーバーにコピーします。
次のコマンドを実行してLogtailを更新します。
chmod +x logtail.sh; ./logtail.sh upgrade-local
Logtailの起動と停止
次のコマンドを実行してLogtailを起動します。
sudo /etc/init.d/ilogtaild start
次のコマンドを実行してLogtailを停止します。
sudo /etc/init.d/ilogtaild stop
Logtailのアンインストール
Simple Log Serviceプロジェクトが存在するリージョンの
${your_region_name}
変数の値を取得します。各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの
${your_region_name}
変数の値はcn-Hangzhou
です。${your_region_name}
変数の値を置き換え、次のコマンドを実行してLogtailをアンインストールします。wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh;./logtail.sh uninstall
次のステップ
Simple Log Serviceプロジェクトとサーバーは同じアカウントに属し、同じリージョンにあります
次の図に、設定プロセスを示します。
Logtailのインストール後、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「IPアドレスベースのマシングループの作成」、「カスタム識別子ベースのマシングループの作成」、および「サーバーからのテキストログの収集」をご参照ください。
Simple Log Serviceプロジェクトとサーバーは異なるアカウントに属し、同じリージョンに存在します。
次の図に、設定プロセスを示します。
Logtailのインストール後、ユーザー識別子を設定し、カスタム識別子を設定し、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「ユーザー識別子の設定」、「カスタム識別子ベースのマシングループの作成」、「サーバーからのテキストログの収集」、および「Logtailを使用してAlibaba Cloudアカウント全体のログを収集する」をご参照ください。
Simple Log Serviceプロジェクトとサーバーが異なるリージョンに存在する
次の図に、設定プロセスを示します。
インターネットタイプ用に作成されたインストールコマンドを使用して、Logtailをインストールする必要があります。 Logtailをインストールした後、ユーザー識別子を設定し、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「ユーザー識別子の設定」、「IPアドレスベースのマシングループの作成」、「カスタム識別子ベースのマシングループの作成」、および「サーバーからのテキストログの収集」をご参照ください。
LogtailをクラシックネットワークまたはVPC経由でダウンロードする場合、/usr/local/ilogtail/ilogtail_config.jsonファイルのネットワークパラメーターを変更して、Logtailを設定し、リージョン間でログを収集できます。
/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" } ], ... }
次のコマンドを実行して、Logtailを再起動します。
sudo /etc/init.d/ilogtaild restart
よくある質問
Logtailがインストールされているかどうかを確認する方法?
Logtailのステータスを表示して、Logtailがサーバーにインストールされているかどうかを確認できます。 詳細については、「Logtailのステータスの表示」をご参照ください。
Logtailのインストール後、Logtail設定用に作成されたマシングループのハートビートステータスはFAILです。 どうすればよいですか。
Logtail設定の作成後にハートビートステータスがFAILの場合、次のコマンドを実行してLogtailのバージョンを表示できます。 次に、Logtailを更新して、ハートビートステータスが正常になるかどうかを確認します。
sudo /etc/init.d/ilogtaild restart
Logtailのインストール後、Logtailはログの収集を開始します。 ただし、ログの収集に失敗したことを示すステータスコードが返されます。 どうすればよいですか。
Logtailは収集したログを集約し、集約したログをSimple Log Serviceに送信します。 ログがSimple Log Serviceに送信されない場合、Logtailはエラーメッセージに基づいてログを再送信するか、ログの送信を停止するかを決定します。 詳細については、「ログの送信」をご参照ください。
付録: Logtailインストールのリージョン名
次の表に、各リージョンの ${your_region_name}
変数の値を示します。
リージョン | 市 | リージョン ID |
中国 (青島) | 青島 | cn-qingdao |
中国 (北京) | 北京 | cn-beijing |
中国 (張家口) | 張家口 | cn-zhangjiakou |
中国 (フフホト) | フフホト | cn-huhehaote |
中国 (ウランチャブ) | ウランチャブ | cn-wulanchabu |
中国 (杭州) | 杭州 | cn-hangzhou |
中国 (上海) | 上海 | cn-shanghai |
中国 (深セン) | 深セン | cn-shenzhen |
中国 (河源) | 河源 | cn-heyuan |
中国 (広州) | 広州 | cn-guangzhou |
中国 (成都) | 成都 | cn-chengdu |
中国 (香港) | 中国香港 | cn-hongkong |
シンガポール | シンガポール | ap-southeast-1 |
マレーシア (クアラルンプール) | マレーシア (クアラルンプール) | ap-southeast-3 |
インドネシア (ジャカルタ) | ジャカルタ | ap-southeast-5 |
フィリピン (マニラ) | マニラ | ap-southeast-6 |
タイ (バンコク) | バンコク | ap-southeast-7 |
日本 (東京) | 日本 (東京) | ap-northeast-1 |
韓国 (ソウル) | ソウル | ap-northeast-2 |
米国 (シリコンバレー) | シリコンバレー | us-west-1 |
米国 (バージニア) | バージニア | us-east-1 |
ドイツ (フランクフルト) | フランクフルト | eu-central-1 |
イギリス (ロンドン) | ロンドン | eu-west-1 |
UAE (ドバイ) | ドバイ | me-east-1 |