すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Sep 18, 2024

このトピックでは、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をオンラインでインストール

ネットワークタイプ

シナリオ

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 755 logtail.sh
    2. autoパラメーターを使用してLogtailをインストールします。

      特定のリージョンのLogtailインストールパッケージが自動的にダウンロードされます。 ダウンロード操作では、インターネットトラフィックは消費されません。

      ./logtail.sh install auto
  • ECSインスタンスが存在するリージョンを特定できる場合は、インストールコマンドでリージョンを指定できます。

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

    1. Simple Log Serviceプロジェクトが存在するリージョンの ${your_region_name} 変数の値を取得します。

      各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhouです。

    2. インストールコマンドの ${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}

インターネット

  1. Simple Log Serviceプロジェクトが存在するリージョンの ${your_region_name} 変数の値を取得します。

    各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhouです。

  2. インストールコマンドの ${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

転送アクセラレーション

  1. Simple Log Serviceプロジェクトが存在するリージョンの ${your_region_name} 変数の値を取得します。

    各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhouです。

  2. インストールコマンドの ${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をオフラインでインストールする

  1. インターネット経由でアクセスできるサーバーにログオンします。

  2. ダウンロードコマンドの ${your_region_name} 変数をプロジェクトが存在するリージョンの値に置き換え、ダウンロードコマンドを実行してインストールスクリプトとインストールパッケージをダウンロードします。

    各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhouです。

    1. インストールスクリプトをダウンロードします。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
    2. インストールパッケージのダウンロード

      • インストールパッケージ (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
  3. インストールスクリプトとインストールパッケージを、Logtailをインストールするサーバーにコピーします。

  4. インストールコマンドの ${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の設定に基づいて更新方法を自動的に選択します。

  1. 次のコマンドを実行して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
  2. 更新結果を確認します。

    次の例のような情報が返された場合、更新は成功します。

    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をオフラインで更新

  1. インターネット経由でアクセスできるサーバーにログオンします。

  2. ダウンロードコマンドの ${your_region_name} 変数を、プロジェクトが存在するリージョンの値に置き換えてから、ダウンロードコマンドを実行します。

    インターネット経由でリソースにアクセスできる各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、インターネット経由でリソースにアクセスできる中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhou-Internetです。

    1. 次のコマンドを実行して、インストールスクリプトをダウンロードします。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
    2. 次のコマンドを実行して、インストールパッケージをダウンロードします。

      wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
  3. インストールスクリプトとインストールパッケージを、Logtailを更新するサーバーにコピーします。

  4. 次のコマンドを実行して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のアンインストール

  1. Simple Log Serviceプロジェクトが存在するリージョンの ${your_region_name} 変数の値を取得します。

    各リージョンの ${your_region_name} 変数の値の詳細については、「付録: Logtailインストールのリージョン名」をご参照ください。 たとえば、中国 (杭州) リージョンの ${your_region_name} 変数の値はcn-Hangzhouです。

  2. ${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プロジェクトとサーバーは同じアカウントに属し、同じリージョンにあります

次の図に、設定プロセスを示します。

image

Logtailのインストール後、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「IPアドレスベースのマシングループの作成」、「カスタム識別子ベースのマシングループの作成」、および「サーバーからのテキストログの収集」をご参照ください。

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

次の図に、設定プロセスを示します。

image

Logtailのインストール後、ユーザー識別子を設定し、カスタム識別子を設定し、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「ユーザー識別子の設定」、「カスタム識別子ベースのマシングループの作成」、「サーバーからのテキストログの収集」、および「Logtailを使用してAlibaba Cloudアカウント全体のログを収集する」をご参照ください。

Simple Log Serviceプロジェクトとサーバーが異なるリージョンに存在する

次の図に、設定プロセスを示します。

image

インターネットタイプ用に作成されたインストールコマンドを使用して、Logtailをインストールする必要があります。 Logtailをインストールした後、ユーザー識別子を設定し、マシングループを作成し、Logtailを設定するデータソースを指定する必要があります。 次に、Logtailを使用してログを収集できます。 詳細については、「ユーザー識別子の設定」、「IPアドレスベースのマシングループの作成」、「カスタム識別子ベースのマシングループの作成」、および「サーバーからのテキストログの収集」をご参照ください。

LogtailをクラシックネットワークまたはVPC経由でダウンロードする場合、/usr/local/ilogtail/ilogtail_config.jsonファイルのネットワークパラメーターを変更して、Logtailを設定し、リージョン間でログを収集できます。

  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

よくある質問

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