すべてのプロダクト
Search

このプロダクト

    Simple Log Service:LoongCollector のインストール

    ドキュメントセンター

    Simple Log Service:LoongCollector のインストール

    最終更新日:Jun 22, 2026

    LoongCollector は、Simple Log Service (SLS) のログ収集エージェントです。Linux サーバーからログを収集するには、まず LoongCollector をインストールする必要があります。

    制限事項

    サポート対象の Linux オペレーティングシステム

    • 次の 64 ビット (x86-64) Linux オペレーティングシステムをサポートしています：

      • Alibaba Cloud Linux 2 および 3

      • Anolis OS 7 および 8

      • CentOS 6、7、および 8

      • Debian 8、9、10、11、および 12

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

      • openSUSE 15.1、15.2、および 42.3

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

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

      • glibc 2.6 以降に基づくその他の Linux オペレーティングシステム

      • CPU は SSE4.2 および AVX 命令セットをサポートする必要があります。

    • 次の 64 ビット ARM Linux オペレーティングシステムをサポートしています：

      • Alibaba Cloud Linux 3.2 for ARM

      • Anolis OS 8.2 for ARM 以降

      • CentOS 8.4 for ARM

      • Debian 11.2 および 12.2 (ARM 版)

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

      • CPU アーキテクチャは ARMv8.2-A 以降である必要があります。

    前提条件

    アクセス許可

    ルートアカウントで Alibaba Cloud コンソールにログインすると、デフォルトで必要なアクセス許可が付与されています。

    RAM ユーザーの場合は、ルートアカウント所有者に次のシステムポリシーを依頼して、Simple Log Service (SLS)、Elastic Compute Service (ECS)、および Operation Orchestration Service (OOS) リソースを管理するために必要なアクセス許可を取得してください。

    • AliyunLogFullAccess： SLS を管理するための完全なアクセス許可を付与します。

    • AliyunOOSFullAccess： OOS を管理するための完全なアクセス許可を付与します。OOS を使用した LoongCollector の自動インストールに必要です。

    • AliyunECSFullAccess： ECS を管理するための完全なアクセス許可を付与します。Cloud Assistant を使用した LoongCollector の一括インストールに必要です。

    デフォルトのシステムポリシーが要件を満たさない場合は、カスタムポリシーを作成して、きめ細かなアクセス制御を行うことができます。詳細については、次の例をご参照ください。

    Resource フィールドの ${projectName} をプロジェクト名に置き換えてください。
    {
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeTagKeys",
        "ecs:DescribeTags",
        "ecs:DescribeInstances",
        "ecs:DescribeInvocationResults",
        "ecs:RunCommand",
        "ecs:DescribeInvocations",
        "ecs:InvokeCommand"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "oos:ListTemplates",
        "oos:StartExecution",
        "oos:ListExecutions",
        "oos:GetExecutionTemplate",
        "oos:ListExecutionLogs",
        "oos:ListTaskExecutions"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListProject",
        "log:GetAcceleration",
        "log:ListDomains",
        "log:GetLogging",
        "log:ListTagResources"
      ],
      "Resource": [
        "acs:log:*:*:project/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:GetProject"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListLogStores",
        "log:GetLogStore",
        "log:GetLogStoreHistogram",
        "log:GetIndex",
        "log:CreateIndex",
        "log:UpdateIndex",
        "log:ListShards",
        "log:GetCursorOrData",
        "log:ListSavedSearch",
        "log:GetLogStoreLogs",
        "log:ListDashboard",
        "log:GetLogStoreContextLogs"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:*"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/logtailconfig/*",
        "acs:log:*:*:project/${projectName}/machinegroup/*"
      ]
    }
  ]
}

    プロジェクトの作成

    使用可能なプロジェクトがない場合は、次の手順に従って基本的なプロジェクトを作成します。作成設定の詳細については、「プロジェクトの管理」をご参照ください。

    SLS コンソールにログオンし、プロジェクトの作成 をクリックします。 以下のパラメーターを設定し、その他の設定はデフォルト値のままにします:

    • [リージョン]： ログのソースに基づいて Alibaba Cloud リージョンを選択します。この設定は、プロジェクト作成後に変更できません。

    • [プロジェクト名]： プロジェクトの名前を入力します。名前は、選択した Alibaba Cloud リージョン内で一意である必要があり、作成後に変更できません。

    Logstore の作成

    使用可能な Logstore がない場合は、基本的な Logstore を作成します。設定の詳細については、「Logstore の管理」をご参照ください。

    1. SLS コンソールにログオンします。プロジェクトリストで、目的のプロジェクトをクリックします。

    2. ログ管理 セクションで、Logstores タブに移動し、[+] アイコンをクリックします。

    3. Logstore 名 を入力し、その他のパラメーターはデフォルト値のままにします。

    サーバーのネットワーク要件

    1. LoongCollector をインストールするサーバーは、データをアップロードするためにポート 80 (HTTP) および 443 (HTTPS) でのアウトバウンドトラフィックを許可する必要があります。

    2. サーバーは SLS エンドポイントに接続できる必要があります。接続を確認するには、次の手順に従います。

      1. SLS コンソールにログオンします。プロジェクトリストで、目的のプロジェクトをクリックします。

      2. プロジェクト名の横にあるimageアイコンをクリックして、プロジェクトの概要 ページに移動します。

      3. エンドポイント セクションで、プロジェクトのエンドポイント情報を確認します。その後、次のコマンドの変数を置き換えて実行します。

        curl https://${project_name}.${endpoint}

      4. {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} のようなレスポンスは、ネットワーク接続が正常であることを示します。それ以外の場合は、ファイアウォール、DNS 設定、およびセキュリティグループ設定を確認してください。

        このエラーは、リクエスト URL に必要なパラメータが不足しているために発生する想定内のエラーです。このテストではネットワーク接続のみを検証するため、完全なリクエスト URL は使用しません。

    インストール方法の選択

    インストール方法

    シナリオ

    同一アカウント・同一リージョン

    サーバーが、プロジェクトと同じアカウントおよびリージョンにある ECS インスタンスの場合。

    同一アカウント・別リージョン

    サーバーが、プロジェクトと同じアカウントにあるが、異なるリージョンにある ECS インスタンスの場合。

    別アカウント・同一リージョン

    サーバーが、プロジェクトと同じリージョンにあるが、異なるアカウントの ECS インスタンスの場合。

    他のクラウドプラットフォームまたはオンプレミスサーバー

    • サーバーが Alibaba Cloud ECS インスタンス以外 (オンプレミスサーバーや他社クラウドプロバイダーのサーバーなど) の場合。

    • サーバーが Alibaba Cloud ECS インスタンスであっても、インスタンスとプロジェクトが異なる Alibaba Cloud アカウントに属し、かつ異なるリージョンにある場合。この場合、ECS インスタンスはオンプレミスサーバーとして扱われます。

    同一アカウント・同一リージョン

    ECS インスタンスとプロジェクトが同じアカウントおよびリージョンにある場合は、ワンクリックインストールを使用できます。Simple Log Service (SLS) は Operation Orchestration Service (OOS) を使用してインストールを自動化するため、インスタンスに手動でログインする必要はありません。

    ワンクリックインストール機能は、SLS のデータ収集テンプレートに統合されています。SLS は、単一行、複数行、正規表現ベースなど、さまざまなテキストログテンプレートを提供しています。これらのテンプレートは処理プラグインのみが異なります。テンプレート内で処理プラグインを追加または削除できます。収集するログの特性に基づいてテンプレートを選択するか、任意のテキストログテンプレートを選択してからログの特性に基づいて処理プラグインを設定してください。

    手順

    1. SLSコンソールにログインします。プロジェクトリストで、目的のプロジェクトをクリックします。

    2. 左側のナビゲーションペインで、imageログ管理 > Logstores を選択します。 目的の Logstore 名の横にある image アイコンをクリックします。

    3. データのインポート の横にある image アイコンをクリックし、ポップアップダイアログボックスで「単一行 - テキストログ」インポートテンプレートを選択して、今すぐ統合 をクリックします。

    4. サーバグループの作成 をクリックします。プロジェクトと 同じリージョン にある 1 つ以上の ECS インスタンスを選択し、次に マシングループとしてインストールおよび作成する をクリックします。

    5. インストールが完了するのを待ち、名前を入力して、OK をクリックします。インストールが失敗した場合は、インストールタスクを再作成する をクリックして ECS インスタンスを再選択します。選択した ECS インスタンスがプロジェクトと同じリージョンにあることを確認してください。

    6. 次へ をクリックします。 ハートビートステータスが FAIL の場合は、自動再試行 をクリックし、ステータスが OK に変わるまで約 2 分待ちます。

    7. ワンクリックインストールが完了しました。[次へ] をクリックして、収集設定を作成します。

    同一アカウント・別リージョン

    サーバーが Alibaba Cloud ECS インスタンスで、インスタンスとプロジェクトが同じ Alibaba Cloud アカウントに属し、異なるリージョンにある場合は、インストールパッケージを手動でダウンロードし、インストールコマンドでインターネット経由のデータ転送または転送アクセラレーションを使用する必要があります。

    手順

    1. インストールパッケージをダウンロードします。サーバーでダウンロードコマンドを実行します。サンプルコードでは、${region_id}をcn-hangzhouに置き換えることができます。ダウンロードを高速化するには、${region_id}を、ECS インスタンスが存在するリージョンのリージョン IDに置き換えます。

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

    2. 送信方法を選択し、インストールコマンドを実行します。${region_id}を、プロジェクトが存在するリージョンのリージョン IDに置き換えます。

      • インターネット：この方法は、リージョン間のデプロイや他のクラウドプラットフォームまたはオンプレミスサーバーからのデータ収集など、ほとんどのシナリオに適しています。ただし、帯域幅の制限や不安定性の影響を受ける可能性があります。

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

      • 転送アクセラレーション：この方法は、中国本土のリージョンから中国本土以外のリージョンへのデータ転送など、リージョン間のデータ転送に使用されます。Content Delivery Network (CDN) を使用してデータ転送を高速化し、パフォーマンスを向上させることで、インターネット経由の高レイテンシーや不安定性を回避します。ただし、この方法ではデータ転送料金が発生します。

        インストールコマンドを実行する前に、プロジェクトのリージョン間転送アクセラレーション機能を有効にする必要があります。
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. 起動ステータスを確認します。loongcollector is running が返された場合、エージェントは起動しています。

      sudo /etc/init.d/loongcollectord status

    4. マシングループを設定します。SLS はマシングループを使用してカスタム識別子を検出し、ホスト上の LoongCollector とのハートビート接続を確立します。

      1. サーバー上で、カスタム識別子ファイルに user-defined-test-1 などのカスタム文字列を書き込みます。この文字列は後のステップで使用されます。

        # カスタム文字列を指定されたファイルに書き込みます。ディレクトリが存在しない場合は、手動で作成してください。ファイルパスと名前はSLSによって固定されており、変更できません。
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. SLSコンソールにログインします。プロジェクトリストで、目的のプロジェクトをクリックします。

      3. 左側のナビゲーションペインで、imageリソース > マシングループ を選択します。

      4. マシングループ の横にある image アイコンをクリックし、次に マシングループの作成 をクリックします。

      5. 以下のパラメーターを設定し、OK をクリックします。

        • マシングループ名：マシングループの名前を入力します。プロジェクト内で一意である必要があり、3～128 文字で、英小文字または数字で開始・終了し、英小文字、数字、ハイフン (-)、アンダースコア (_) のみを含める必要があります。

        • 識別子：：ユーザー定義 ID を選択します。

        • カスタム識別子: サーバー上のカスタム識別子ファイルにあるカスタム文字列と一致する識別子を入力します。例: user-defined-test-1。

    5. マシングループの作成後、マシングループリストで対象のマシングループをクリックし、ハートビート ステータスを確認します。ステータスが FAIL の場合は、約 2 分待ってから手動で更新してください。ステータスが OK であれば、マシングループは正常に作成されています。

    6. インストール完了後、収集設定を作成してログを収集してください。

    別アカウント・同一リージョン

    サーバーが Alibaba Cloud ECS インスタンスで、インスタンスとプロジェクトが同じリージョンにあるが、異なる Alibaba Cloud アカウントに属している場合は、インストールパッケージを手動でダウンロードする必要があります。インストールコマンドで内部ネットワーク転送方法を使用し、ユーザーID を設定する必要があります。

    手順

    1. インストールパッケージをダウンロードし、サーバーでダウンロードコマンドを実行します。サンプルコードでは、${region_id} を cn-hangzhou に置き換えることができます。ダウンロードを高速化するには、「リージョン ID」を参照し、${region_id} を ECS インスタンスのリージョンに置き換えます。

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

    2. インストールコマンドを実行します。${region_id} をプロジェクトの リージョン ID に置き換えます。

      接続タイムアウトが発生した場合、間違った ${region_id} を使用した可能性があります。内部ネットワークは、異なるリージョン間で接続を確立できません。リージョン ID を修正し、インストールコマンドを再度実行してください。
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}

    3. コマンドを実行して、起動ステータスを確認します。「loongcollector is running」と返された場合、起動は成功です。

      sudo /etc/init.d/loongcollectord status

    4. ユーザーID を設定します。ユーザーID ファイルには、プロジェクトを所有する Alibaba Cloud ルートアカウントの ID を記述します。この ID は、アカウントがこのサーバーからログにアクセスして収集する権限を持っていることを検証するために使用されます。

      ユーザーID の設定が必要なのは、別のアカウント配下の ECS インスタンス、自己管理サーバー、または他のクラウドプロバイダーのサーバーからログを収集する場合のみです。複数のアカウントが同じサーバーからログを収集する場合は、そのサーバーに複数のユーザーID ファイルを作成できます。

      1. SLSコンソールにログインします。右上隅のプロフィール画像にポインターを合わせます。表示されるタブで、アカウント ID を確認してコピーします。必ずルートアカウントの ID をコピーしてください。

      2. LoongCollector がインストールされているサーバーで、ユーザーID ファイルを作成します。ファイル名としてルートアカウント ID を使用します。

        touch /etc/ilogtail/users/{Alibaba Cloud アカウント ID} # /etc/ilogtail/users ディレクトリが存在しない場合は、手動で作成してください。ユーザーIDファイルにはファイル名のみが必要で、ファイル拡張子は不要です。

    5. マシングループを設定します。SLS はマシングループを使用してカスタム識別子を検出し、ホスト上の LoongCollector とのハートビート接続を確立します。

      1. サーバー上で、カスタム識別子ファイルにカスタム文字列 user-defined-test-1 を書き込みます。この文字列は後の手順で使用します。

        # カスタム文字列を指定されたファイルに書き込みます。ディレクトリが存在しない場合は、手動で作成してください。
# ファイルパスと名前はSLSによって固定されており、変更できません。
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. SLSコンソールにログインします。プロジェクトリストで、対象のプロジェクトをクリックします。

      3. image リソース をクリックし、次に マシングループ をクリックします。

      4. マシングループ リストの右側にある image アイコンをクリックし、次に マシングループの作成 をクリックします。または、右上隅にある四角が 4 つのアイコンをクリックし、ドロップダウンメニューから [マシン グループの作成] を選択することもできます。

      5. 以下の設定を行い、OK をクリックします。

        • マシングループ名：マシングループの名前を入力します。プロジェクト内で一意である必要があり、3～128 文字で、英小文字または数字で開始・終了し、英小文字、数字、ハイフン (-)、アンダースコア (_) のみを含める必要があります。

        • 識別子： を ユーザー定義 ID に設定します。

        • カスタム識別子：設定したカスタム識別子を入力します。この識別子は、サーバー上のカスタム識別子ファイル内のカスタム文字列と同じである必要があります。この例では、識別子は user-defined-test-1 です。

    6. マシングループが作成されたら、リストで対象のマシングループをクリックします。マシングループのステータスセクションで、ハートビート ステータスを確認します。ステータスが FAIL の場合は、約 2 分待ってからページを更新します。ハートビートステータスが OK の場合、マシングループは正常に作成されています。

    7. インストール完了後、ログを収集するために収集設定を作成する必要があります。

    他のクラウドまたはオンプレミスサーバー

    サーバーが別のクラウドプラットフォームでホストされている場合、またはオンプレミスサーバーの場合は、インストールパッケージを手動でダウンロードする必要があります。インストールコマンドでインターネットまたは転送アクセラレーションを使用し、ユーザーID を設定する必要があります。Alibaba Cloud ECS インスタンスも、インスタンスとプロジェクトが異なる Alibaba Cloud アカウントに属し、かつ異なるリージョンにある場合は、オンプレミスサーバーとして扱われます。

    説明

    サーバーの使用制限については、「サポートされている Linux ディストリビューション」をご参照ください。

    手順

    1. インストールパッケージをダウンロードするには、サーバーでダウンロードコマンドを実行します。 サンプルコードでは、${region_id} を cn-hangzhou に置き換えることができます。 パッケージのダウンロードを高速化するには、リージョン ID を参照し、${region_id} をお使いの ECS インスタンスのリージョン ID に置き換えます。

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

    2. 転送方法を選択し、インストールコマンドを実行します。${region_id} を、プロジェクトが配置されているリージョンのリージョン ID に置き換えます。

      • インターネット：この方法は、リージョン間転送や他のクラウドまたはオンプレミスのサーバーなど、ほとんどのシナリオに対応しています。ただし、帯域幅の制限や不安定性の影響を受ける可能性があります。

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

      • 転送アクセラレーション：中国本土から海外リージョンへの転送など、リージョン間転送に使用します。CDN アクセラレーションを使用してパフォーマンスを向上させ、インターネットの高レイテンシーや不安定性を回避します。この方法では追加料金が発生します。

        インストールコマンドを実行する前に、プロジェクトのリージョン間ログ転送アクセラレーション機能を有効にしてください。
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. 起動ステータスを確認します。コマンドを実行します。loongcollector is running が返された場合、起動は成功です。

      sudo /etc/init.d/loongcollectord status

    4. ユーザーID を設定します。ユーザーID ファイルには、プロジェクトを所有する Alibaba Cloud ルートアカウントの ID を記述します。この ID は、アカウントがこのサーバーからログにアクセスして収集する権限を持っていることを検証するために使用されます。

      ユーザーID の設定は、自分のアカウント配下にない ECS インスタンス、オンプレミスサーバー、または他のクラウドプロバイダーのサーバーからログを収集する場合にのみ行ってください。複数のアカウントが同じサーバーからログを収集する場合は、そのサーバーに複数のユーザーID ファイルを作成できます。

      1. SLSコンソールにログインします。右上隅のユーザーアバターにポインターを合わせます。表示されるタブで、アカウント ID を確認してコピーします。必ずルートアカウントの ID をコピーしてください。

      2. LoongCollector がインストールされているサーバーで、ユーザーID ファイルを作成します。ファイル名としてルートアカウント ID を使用します。

        touch /etc/ilogtail/users/{Alibaba Cloud アカウント ID} # /etc/ilogtail/users ディレクトリが存在しない場合は、手動で作成してください。ユーザーIDファイルにはファイル名のみが必要で、ファイル拡張子は不要です。

    5. マシングループを設定します。SLS はマシングループを使用してカスタム識別子を検出し、ホスト上の LoongCollector とのハートビート接続を確立します。

      1. サーバーで、カスタム文字列 user-defined-test-1 をカスタム識別子ファイルに書き込みます。この文字列は後のステップで使用されます。

        # カスタム文字列を指定されたファイルに書き込みます。ディレクトリが存在しない場合は、手動で作成してください。ファイルパスと名前はSLSによって固定されており、変更できません。
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. SLSコンソールにログインします。プロジェクトリストで、対象のプロジェクトをクリックします。

      3. image リソース をクリックし、次に マシングループ をクリックします。

      4. マシングループ の右にある image をクリックし、次に マシングループの作成 をクリックします。

      5. 以下の設定を構成し、OK をクリックします。

        • マシングループ名：マシングループの名前を入力します。プロジェクト内で一意である必要があり、3～128 文字で、英小文字または数字で開始・終了し、英小文字、数字、ハイフン (-)、アンダースコア (_) のみを含める必要があります。

        • [識別子：] ユーザー定義 ID を選択します。

        • カスタム識別子：設定したカスタム識別子を入力します。サーバー上のカスタム識別子ファイル内のカスタム文字列と一致させる必要があります。この例では、値は user-defined-test-1 です。

    6. マシン グループが作成されたら、マシン グループ リストでそのグループをクリックします。マシン グループ ステータス パネルで、ハートビート ステータスを確認します。ステータスが FAIL の場合は、約 2 分待ってからページを更新します。ステータスが OK であれば、作成が成功したことを意味します。

    7. インストール後、収集設定を作成してログを収集します。

    LoongCollectorの一括インストール

    • 自動インストール機能では、インスタンスとプロジェクトが同じアカウントおよびリージョンにある場合に、複数の ECS インスタンスを選択できます。

    • その他のシナリオでは、ECS Cloud Assistant を使用してコマンドを一時タスクとして実行します。これにより、ECS インスタンスで LoongCollector インストールコマンドを一括実行できます。

      ダウンロードおよびインストールコマンドについては、前述のインストールシナリオをご参照ください。ECS Cloud Assistant の使用方法については、「コマンドの作成と実行」をご参照ください。

    アップグレードとロールバック

    重要

    LoongCollector はアップグレード中に実行を停止し、アップグレードが完了すると自動的に起動します。アップグレードでは必要なファイルのみが上書きされます。設定ファイルとチェックポイントファイルは保持され、アップグレード中にログが失われることはありません。

    LoongCollectorのアップグレードまたはLogtailからLoongCollectorへのアップグレード

    1. サーバーでダウンロードコマンドを実行して、最新のインストールパッケージを取得します。サンプルコードでは、${region_id} を cn-hangzhou などのリージョン ID に置き換えます。パッケージのダウンロードを高速化するには、「リージョン」を参照し、${region_id} をお使いの ECS インスタンスが配置されているリージョンに置き換えます。

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

    2. アップグレードコマンドを実行します。アップグレードするには、upgrade コマンドを使用します。install コマンドを使用すると、上書きインストールが実行され、元の設定が失われます。

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

    3. 次の情報が表示された場合、アップグレードは成功です。

      Upgrade loongcollector files successfully.
Starting loongcollector ...
Upgrade loongcollector successfully.

    LoongCollectorからLogtailへのロールバック

    説明

    logtail.sh スクリプトを再度ダウンロードしてください。以前のバージョンのスクリプトは使用しないでください。

    1. サーバーでダウンロードコマンドを実行して、インストールパッケージを取得します。コード例では、${region_id} を cn-hangzhou などのリージョン ID に置き換えます。パッケージのダウンロードを高速化するには、「リージョン」を参照し、${region_id} をお使いの ECS インスタンスが存在するリージョンに置き換えます。

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

    2. ロールバックコマンドを実行します。1.8.7 などのバージョンを指定するには、コメント行を参考に、必要に応じてバージョン番号を置き換えてください。

      chmod +x logtail.sh; sudo ./logtail.sh upgrade;
# chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

    特定バージョンのインストール

    特定のバージョンをインストールするには、-v パラメーターを使用します。次のコマンドを参照し、必要に応じてバージョン番号を置き換えてください。

    • LoongCollector

      chmod +x loongcollector.sh; sudo ./loongcollector.sh install ${region_id} -v 3.2.6;

    • Logtail

      chmod +x logtail.sh; sudo ./logtail.sh install ${region_id} -v 1.8.7;

    LoongCollectorのアンインストール

    1. サンプルコードで、${region_id} を cn-hangzhou などのリージョン ID に置き換えます。 実行を高速化するには、リージョンを参照し、${region_id} をお使いの ECS インスタンスが配置されているリージョンに置き換えます。

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

    2. アンインストールコマンドを実行します。

      chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

    よくある質問

    インターネット接続のないサーバーへの LoongCollector のインストール

    1. LoongCollector をインストールするサーバーで、uname -m を実行してシステムアーキテクチャを確認します。 次に、インターネットにアクセスできるサーバーで、対応するダウンロードコマンドを実行します。 ${region_id} をプロジェクトの リージョン ID に置き換えます。

      • ARM アーキテクチャ：

        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;

      • x86-64 アーキテクチャ：

        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;

    2. ダウンロードしたインストールスクリプトとパッケージを LoongCollector をインストールするサーバーにコピーします。次に、${region_id} をプロジェクトの リージョン ID に置き換えて、次のコマンドを実行します。

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

    3. status コマンドを実行します。出力が loongcollector is running であれば、LoongCollector は正常に起動しています。

      sudo /etc/init.d/loongcollectord status

    4. サーバーはインターネットにアクセスできないため、プロキシを設定して接続を確立する必要もあります。

    インターネット接続のないサーバーでの LoongCollector のアップグレード

    1. LoongCollector をアップグレードするサーバーで、uname -m を実行してシステムアーキテクチャを確認します。次に、インターネットにアクセスできるサーバーで、対応するコマンドを実行します。${region_id} を、お使いのプロジェクトの リージョン に置き換えます。

      • ARM アーキテクチャ：

        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;

      • x86-64 アーキテクチャ：

        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;

    2. インストールスクリプトとパッケージをサーバーにコピーし、LoongCollector をアップグレードします。次に、次のコマンドを実行します。

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

    ワンクリックインストールが失敗する場合

    自動インストールは、ECS インスタンスとプロジェクトが同じアカウントおよびリージョンにある場合にのみサポートされます。これに該当しない場合は、別のインストール方法を使用してください。セットアップがこの要件を満たしている場合は、アクセス権限とネットワーク要件を満たしているかどうかを確認してください。詳細については、「前提条件」をご参照ください。

    ハートビートの欠落または失敗への対処

    ハートビートステータスが失敗の場合、初期接続に時間がかかっている可能性があります。約 2 分待ってから、ステータスを更新してください。それでもステータスが失敗の場合は、次の手順に従ってトラブルシューティングを行ってください。

    • サーバーと SLS プロジェクトの関係を確認します。インストール手順は、この関係によって異なります。

      • 誤った手順を実行した場合は、サーバーで chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; コマンドを実行してアンインストールします。その後、正しい手順でインストールを繰り返します。

    • 正しい手順を使用してもハートビートステータスが依然として FAIL の場合は、LoongCollector がインストールされているサーバーを確認し、/usr/local/ilogtail/ilogtail_config.json ファイル内の region がお使いの SLS プロジェクトの リージョン ID と一致することを確認してください。

      • 一致しない場合は、インストールコマンドの ${region_id} を正しいリージョン ID に置き換えて、コマンドを再度実行してください。LoongCollector がファイルを更新します。

        この操作により、既存のインストールが上書きされ、元の設定が削除されます。すでにデータ収集用に設定されているサーバーでは、この方法を慎重に使用してください。

      • 情報が正しい場合、または再インストール後もハートビートステータスが失敗のままの場合は、次の手順に進んでください。

    • 手順が、ユーザー ID ファイルを必要とするクロスアカウントシナリオの場合は、次の点を確認してください。

      • ユーザー ID は、ルートアカウントの ID である必要があります。そうでない場合は、変更してください。

      • ルートアカウント ID は、ECS サーバーを所有するアカウントのものではなく、SLS プロジェクトを所有するアカウントのものである必要があります。

    • SLS コンソールでマシングループに設定されているカスタム識別子を確認してください。サーバー上のカスタム識別子ファイルの内容と一致していることを確認してください。一致しない場合は、コンソールの設定またはファイルのいずれかを変更して、同一にしてください。

    • それでもハートビートステータスが失敗の場合は、ネットワーク要件を満たしているかどうかを確認してください。詳細については、「前提条件」をご参照ください。

    関連ドキュメント

    リージョン

    1. SLS コンソールにログインします。プロジェクトの一覧で、対象のプロジェクトをクリックします。

    2. プロジェクト名の右側にある image アイコンをクリックして、プロジェクト概要ページに移動します。

    3. [Basic Information] セクションで、現在のプロジェクトのリージョン名を確認します。対応するリージョン ID については、次の表をご参照ください。

      リージョンは、クラウドリソースの物理データセンターの地理的な場所を表します。リージョン ID は、クラウドサービスのリージョンを一意に識別する ID です。

    リージョンとリージョン ID のマッピング表

    リージョン名

    リージョン ID

    China (Qingdao)

    cn-qingdao

    China (Beijing)

    cn-beijing

    China (Zhangjiakou)

    cn-zhangjiakou

    China (Hohhot)

    cn-huhehaote

    China (Ulanqab)

    cn-wulanchabu

    China (Hangzhou)

    cn-hangzhou

    China (Shanghai)

    cn-shanghai

    China (Nanjing) - ローカルリージョン - 提供終了

    cn-nanjing

    China (Fuzhou) - ローカルリージョン - 提供終了

    cn-fuzhou

    China (Shenzhen)

    cn-shenzhen

    China (Heyuan)

    cn-heyuan

    China (Guangzhou)

    cn-guangzhou

    Philippines (Manila)

    ap-southeast-6

    South Korea (Seoul)

    ap-northeast-2

    Malaysia (Kuala Lumpur)

    ap-southeast-3

    Japan (Tokyo)

    ap-northeast-1

    Thailand (Bangkok)

    ap-southeast-7

    China (Chengdu)

    cn-chengdu

    Singapore

    ap-southeast-1

    Indonesia (Jakarta)

    ap-southeast-5

    China (Hong Kong)

    cn-hongkong

    Germany (Frankfurt)

    eu-central-1

    US (Virginia)

    us-east-1

    US (Silicon Valley)

    us-west-1

    UK (London)

    eu-west-1

    UAE (Dubai)

    me-east-1

    Saudi Arabia (Riyadh)

    me-central-1

    LoongCollector のネットワーク転送タイプ

    エンドポイントは、SLS のアクセス用ドメイン名です。プロジェクトとそのログデータにアクセスするために使用する URL です。エンドポイントは、プロジェクトが存在するリージョンに固有です。SLS では、プライベートエンドポイント、パブリックエンドポイント、および転送アクセラレーションエンドポイントが提供されています。エンドポイントは、次の手順で確認できます。

    1. SLS コンソールにログインします。プロジェクトの一覧で、対象のプロジェクトをクリックします。

    2. プロジェクト名の右側にある image アイコンをクリックして、プロジェクト概要ページに移動します。

    3. [Access Endpoints] セクションで、現在のプロジェクトのエンドポイント情報を確認します。ネットワーク転送方法ごとに、対応するエンドポイントが異なります。適切なネットワーク転送方法を選択すると、ログデータをより高速かつ安定して転送できます。

    ネットワークタイプ

    対応するエンドポイントタイプ

    説明

    シナリオ

    Alibaba Cloud 内部ネットワーク

    プライベートエンドポイント

    Alibaba Cloud 内部ネットワークは、ギガビットの共有ネットワークです。内部ネットワーク経由でログデータを転送すると、パブリックインターネット経由よりも高速かつ安定します。内部ネットワークには、VPC とクラシックネットワークが含まれます。

    ECS インスタンスと SLS プロジェクトが同一リージョンにある場合、またはオンプレミスサーバーを内部ネットワークに接続している場合。

    説明

    ECS インスタンスと同一リージョンに SLS プロジェクトを作成してください。これにより、パブリック帯域幅を消費せずに、Alibaba Cloud 内部ネットワーク経由で ECS インスタンスからログを収集できます。

    パブリックインターネット

    パブリックエンドポイント

    パブリックインターネット経由でログデータを転送する場合、データ収集の速度と安定性は、帯域幅制限、ネットワークジッター、遅延、パケット損失の影響を受ける可能性があります。

    次の 2 つの場合は、パブリックインターネット経由でデータを転送します。

    • ECS インスタンスと SLS プロジェクトが異なるリージョンにある場合。

    • サーバーが他のクラウドプロバイダーでホストされている場合、またはオンプレミスデータセンターにある場合。

    転送アクセラレーション

    転送アクセラレーションエンドポイント

    Alibaba Cloud CDN のエッジノードを使用してログ収集を高速化すると、パブリックインターネット経由の収集と比べて、ネットワーク遅延と安定性の面で大きなメリットがあります。ただし、このトラフィックには追加料金が発生します。

    アプリケーションサーバーと SLS プロジェクトがそれぞれ中国リージョンと海外リージョンにある場合、パブリックインターネット経由のデータ転送では高い遅延や不安定さが発生する可能性があります。この場合は、転送アクセラレーションを使用してください。詳細については、「転送アクセラレーション」をご参照ください。