すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Mar 27, 2026

    LoongCollector は、Simple Log Service (SLS) が提供するデータコレクターです。Linux サーバーからログを収集するには、まずそのサーバーに LoongCollector クライアントをインストールする必要があります。使用するインストール方法は、サーバーと SLS プロジェクトの関係によって異なります。

    制限事項

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

    • 以下の x86-64 Linux オペレーティングシステムをサポートしています：

      • Alibaba Cloud Linux 2、3

      • Anolis OS 7、8

      • CentOS Linux 6、7、8

      • Debian GNU/Linux 8、9、10、11、12

      • RedHat Enterprise 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 Linux 8.4 for ARM

      • Debian GNU/Linux 11.2 および 12.2 for ARM

      • Ubuntu 20.04、22.04、24.04 for ARM

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

    前提条件

    権限要件

    Alibaba Cloud アカウント (root ユーザー) でログインした場合、デフォルトで必要なすべての権限が付与されています。

    RAM ユーザーとしてログインした場合は、Simple Log Service、ECS、CloudOps Orchestration Service (OOS) のリソースを管理するための権限を、Alibaba Cloud アカウント所有者に依頼して以下のシステムポリシーを割り当ててください。

    • AliyunLogFullAccess：Simple Log Service を完全に管理するための権限を付与します。

    • AliyunOOSFullAccess：CloudOps Orchestration Service (OOS) を完全に管理するための権限を付与します。これにより、OOS を使用して LoongCollector のインストールを自動化できます。

    • AliyunECSFullAccess：ECS を完全に管理するための権限を付与します。これにより、クラウドアシスタントコマンドを実行して、複数の ECS インスタンスに 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/*"
      ]
    }
  ]
}

    プロジェクトの作成

    既存のプロジェクトがない場合は、以下の手順に従って基本的なプロジェクトを作成してください。すべての構成オプションの詳細については、「プロジェクトの管理」をご参照ください。

    「Simple Log Service コンソール」にログインし、プロジェクトの作成 をクリックします。以下の基本パラメーターを設定し、その他の設定はデフォルト値のままにしてください：

    • リージョン：ログの発生元となるリージョンを選択します。この設定はプロジェクト作成後に変更できません。

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

    Logstore の作成

    既存の Logstore がない場合は、以下の手順に従って基本的な Logstore を作成してください。すべての構成オプションの詳細については、「Logstore の管理」をご参照ください。

    1. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から対象のプロジェクトをクリックします。

    2. 「ログ管理 ＞ Logstores」タブで、[＋] アイコンをクリックします。

      image

    3. Logstore 名 を入力し、その他の設定はデフォルト値のままにしてください。

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

    1. LoongCollector をインストールするサーバーは、ポート 80（HTTP）およびポート 443（HTTPS）でのアウトバウンドトラフィックを許可する必要があります。LoongCollector はこれらのポートを使用してデータをアップロードします。

    2. サーバーは、必要なサービスエンドポイントに接続できる必要があります。接続性を確認するには、以下の手順を実行してください：

      1. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から対象のプロジェクトをクリックします。

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

      3. 「エンドポイント」セクションでプロジェクトのエンドポイントを確認し、以下のコマンド内のプレースホルダーを置き換えて実行します。

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

      4. 応答が {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} のような形式の場合、接続は成功しています。接続に失敗した場合は、DNS 設定やセキュリティグループルールなどのネットワーク設定を確認し、エンドポイントへのアクセスが可能であることを確認してください。

        このエラー応答は、テスト用 URL が不完全であるため予期されるものです。リクエスト自体は無効ですが、ネットワーク接続性は確認できます。

    適切なインストール方法の選択

    インストール方法

    ユースケース

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

    ECS インスタンスとプロジェクトが同一の Alibaba Cloud アカウントに属し、かつ同一のリージョンにある場合に適用されます。

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

    ECS インスタンスとプロジェクトが同一の Alibaba Cloud アカウントに属するものの、異なるリージョンにある場合に適用されます。

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

    ECS インスタンスとプロジェクトが同一のリージョンにありながらも、異なる Alibaba Cloud アカウントに属する場合に適用されます。

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

    • ECS インスタンスではないサーバー（例：オンプレミスサーバー、他社クラウドのサーバー）に適用されます。

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

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

    サーバーが ECS インスタンスであり、かつその ECS インスタンスとプロジェクトが同一の Alibaba Cloud アカウントに属し、同一のリージョンにある場合、ワンクリックで LoongCollector をインストールできます。Simple Log Service（SLS）は、OOS（Operation Orchestration Service）のオーケストレーション機能を活用してインストールを自動化し、ECS インスタンスにログインして手動でコマンドを実行する必要をなくします。

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

    操作手順

    1. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から対象のプロジェクトをクリックします。

    2. imageログ管理 をクリックします。「Logstores」一覧から対象の Logstore を見つけ、その横にある image アイコンをクリックします。

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

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

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

    6. 次へ をクリックします。「自動再試行」のステータスが FAIL の場合、「自動リトライ」をクリックし、約 2 分待ってステータスが OK に変わることを確認してください。

    7. ワンクリックインストールはこれで完了です。「次へ」をクリックして、収集設定 に進んでください。

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

    サーバーが ECS インスタンスであり、かつその ECS インスタンスとプロジェクトが同一の Alibaba Cloud アカウントに属するものの、異なるリージョンにある場合、インストールパッケージを手動でダウンロードし、インターネットまたは転送アクセラレーションのいずれかの方法でデータを送信する必要があります。

    操作手順

    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」という応答が出れば、LoongCollector の起動に成功しています。

      sudo /etc/init.d/loongcollectord status

    4. マシングループを構成します。Simple Log Service では、マシングループを使用して、カスタム識別子を用いてサーバーを検出し、各サーバー上の LoongCollector エージェントとのハートビート接続を確立します。

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

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

      2. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から送信先プロジェクトをクリックします。

      3. 左側のナビゲーションウィンドウで、imageリソース をクリックし、「マシングループ」をクリックします。

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

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

        • マシングループ名：マシングループの名前を入力します。この名前はプロジェクト内で一意である必要があり、3～128 文字の長さで、小文字または数字で始まり・終わる必要があります。また、小文字、数字、ハイフン（-）、アンダースコア（_）のみを使用できます。

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

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

    5. マシングループが作成されたら、一覧から該当のマシングループを見つけ、「ハートビート ステータスを確認します。ステータスが FAIL の場合は、約 2 分待ってページを更新してください。OK ステータスは、接続が成功したことを示します。

    6. インストール後は、ログの収集を開始するために、収集設定 も作成する必要があります。

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

    サーバーが ECS インスタンスであり、かつその ECS インスタンスとプロジェクトが同一のリージョンにあるものの、異なる Alibaba Cloud アカウントに属する場合、インストールパッケージを手動でダウンロードし、内部ネットワークを用いてデータを送信し、ユーザー ID を構成する必要があります。

    操作手順

    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に置き換えてください。

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

    3. エージェントのステータスを確認します。以下のコマンドを実行します。「loongcollector is running」という応答が出れば、LoongCollector の起動に成功しています。

      sudo /etc/init.d/loongcollectord status

    4. ユーザー ID を構成します。ユーザー ID ファイルには、プロジェクトを所有する Alibaba Cloud アカウントのルートアカウント ID が含まれています。この ID により、プロジェクトがこのサーバーからログを収集・アクセスすることを許可します。

      ユーザー ID の構成は、ご自身のアカウントに属さない ECS インスタンス、オンプレミスサーバー、または他社クラウドのサーバーからログを収集する場合にのみ必要です。同じサーバーから複数のアカウントがログを収集する必要がある場合は、そのサーバーに複数のユーザー ID ファイルを作成できます。

      1. 「Simple Log Service コンソール」にログインします。右上隅のプロフィール画像にカーソルを合わせて、ルートアカウント ID を表示・コピーします。

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

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

    5. マシングループを構成します。Simple Log Service では、マシングループを使用して、カスタム識別子を用いてサーバーを検出し、各サーバー上の LoongCollector エージェントとのハートビート接続を確立します。

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

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

      2. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から送信先プロジェクトをクリックします。

      3. 左側のナビゲーションウィンドウで、imageリソース をクリックし、次に マシングループ をクリックします。

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

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

        • マシングループ名：マシングループの名前を入力します。この名前はプロジェクト内で一意である必要があり、3～128 文字の長さで、小文字または数字で始まり・終わる必要があります。また、小文字、数字、ハイフン（-）、アンダースコア（_）のみを使用できます。

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

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

    6. マシングループを作成した後、リストでそれを検索し、そのハートビート ステータスを確認します。ステータスが FAIL の場合、約 2 分待ってページをリフレッシュします。OK ステータスは、接続が成功したことを示します。

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

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

    この方法は、オンプレミスサーバーまたは他社クラウドのサーバーに適用されます。サーバーが ECS インスタンスであっても、それがプロジェクトとは異なる Alibaba Cloud アカウントに属し、かつ異なるリージョンにある場合、オンプレミスサーバーとして扱う必要があります。このようなシナリオでは、インストールパッケージを手動でダウンロードし、インターネットまたは転送アクセラレーションのいずれかの方法を用いてデータを送信し、ユーザー ID を構成する必要があります。

    説明

    サーバー要件については、「サポート対象の Linux オペレーティングシステムのバージョン」をご参照ください。

    操作手順

    1. インストールパッケージをダウンロードします。サーバー上でダウンロードコマンドを実行します。サンプルコードでは、${region_id} を cn-hangzhou に置き換えられます。ダウンロード速度を向上させるには、「リージョン ID」を参照し、${region_id} をサーバーに近いリージョンの 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」という応答が出れば、LoongCollector の起動に成功しています。

      sudo /etc/init.d/loongcollectord status

    4. ユーザー ID を構成します。ユーザー ID ファイルには、プロジェクトを所有する Alibaba Cloud アカウントのルートアカウント ID が含まれています。この ID により、プロジェクトがこのサーバーからログを収集・アクセスすることを許可します。

      ユーザー ID の構成は、ご自身のアカウントに属さない ECS インスタンス、オンプレミスサーバー、または他社クラウドのサーバーからログを収集する場合にのみ必要です。同じサーバーから複数のアカウントがログを収集する必要がある場合は、そのサーバーに複数のユーザー ID ファイルを作成できます。

      1. 「Simple Log Service コンソール」にログインします。右上隅のプロフィール画像にカーソルを合わせて、ルートアカウント ID を表示・コピーします。

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

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

    5. マシングループを構成します。Simple Log Service では、マシングループを使用して、カスタム識別子を用いてサーバーを検出し、各サーバー上の LoongCollector エージェントとのハートビート接続を確立します。

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

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

      2. 「Simple Log Service コンソール」にログインします。プロジェクト一覧から送信先プロジェクトをクリックします。

      3. 左側のナビゲーションウィンドウで、imageリソース をクリックし、次に マシングループ をクリックします。

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

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

        • マシングループ名：マシングループの名前を入力します。この名前はプロジェクト内で一意である必要があり、3～128 文字の長さで、小文字または数字で始まり・終わる必要があります。また、小文字、数字、ハイフン（-）、アンダースコア（_）のみを使用できます。

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

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

    6. マシングループが作成されたら、一覧から該当のマシングループを見つけ、「ハートビート ステータスを確認します。ステータスが FAIL の場合は、約 2 分待ってページを更新してください。OK ステータスは、接続が成功したことを示します。

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

    LoongCollector の一括インストール

    • 同一アカウント・同一リージョンのシナリオでは、自動インストール機能により、複数の ECS インスタンスを一度に選択できます。

    • その他のすべてのシナリオでは、ECS クラウドアシスタント を使用して、ECS インスタンス上で LoongCollector の一括インストールコマンドを実行できます。

      ダウンロードおよびインストールコマンドについては、本トピックで説明するインストールシナリオを参照してください。ECS クラウドアシスタントの使用方法については、「コマンドの作成と実行」をご参照ください。

    バージョンのアップグレードおよびロールバック

    重要

    LoongCollector のアップグレード中は、サービスが一時停止し、アップグレード完了後に自動的に再起動します。アップグレードプロセスでは、必要なプログラムファイルのみが上書きされます。構成ファイルおよびチェックポイントファイルは保持されるため、ログデータの損失は発生しません。

    LoongCollector へのアップグレード

    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. アップグレードコマンドを実行します。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 インスタンスが配置されているリージョンの ID に置き換えてください。

      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 インスタンスが配置されているリージョンの ID に置き換えてください。

      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;

    よくある質問

    オフラインインストール

    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. 以下のコマンドを実行してステータスを確認します。「loongcollector is running」という応答が出れば、LoongCollector の起動に成功しています。

      sudo /etc/init.d/loongcollectord status

    4. サーバーがインターネットに接続できないため、プロキシの構成も必要です。

    オフラインアップグレード

    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 のスペックアップを行うサーバーにコピーし、次のコマンドを実行します：

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

    ワンクリックインストールの失敗

    ワンクリックインストールは、ECS インスタンスとプロジェクトが同一の Alibaba Cloud アカウントおよび同一のリージョンにあることが必須です。それ以外の場合は、別のインストール方法を選択してください。この要件を満たしているにもかかわらず失敗する場合は、「前提条件」セクションで説明されている権限およびネットワーク要件を満たしているか確認してください。

    「ハートビートなし」または「ハートビート FAIL」の問題の解決

    ハートビートステータスが FAIL の場合、初期ハートビートの確立には時間がかかることがあります。約 2 分待ってからハートビートステータスを更新してください。それでもステータスが FAIL の場合は、以下の点を確認してください：

    • サーバーと SLS プロジェクトの関係を確認します。異なる関係では、異なるインストール手順が必要です。

      • 誤った手順を使用した場合は、chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; コマンドを実行して LoongCollector をアンインストールし、正しい手順を選択して再インストールしてください。

    • 正しい手順に従ったにもかかわらずハートビートステータスが依然として FAIL の場合は、サーバー上の region 値が /usr/local/ilogtail/ilogtail_config.json ファイルに正しく設定されているか確認してください。この値は、SLS プロジェクトのリージョン IDと一致している必要があります。

      • 一致していない場合は、正しいリージョン ID を指定してインストールコマンドを再実行してください。これにより、ファイルの内容が更新されます。

        この方法では上書きインストールが実行され、元の構成が消去されます。既に収集設定が構成済みのサーバーでは、この方法を注意して使用してください。

      • 情報が一致している、または再インストール後もハートビートステータスが FAIL の場合は、次のステップに進んでください。

    • 手順でユーザー ID ファイルの構成が必要な場合（クロスアカウントシナリオ）、以下の点を確認してください：

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

      • これは、ECS インスタンスの所有者ではなく、SLS プロジェクトの所有者の Alibaba Cloud アカウント ID である必要があります。

    • SLS コンソールのマシングループのカスタム識別子が、サーバー上のカスタム識別子ファイルの値と一致しているか確認してください。一致していない場合は、どちらか一方の値を修正して一致させてください。

    • ハートビートステータスが依然として FAIL の場合は、「前提条件」セクションで説明されているネットワーク要件を満たしているか確認してください。

    参考文献

    リージョン

    1. 「Simple Log Service コンソール」にログインし、プロジェクト一覧から対象のプロジェクトをクリックします。

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

    3. 基本情報セクションで、現在のプロジェクトのリージョン名を確認できます。以下の表は、各リージョン名と対応するリージョン ID を示しています。

      リージョンとは、クラウドサービスリソースが配置される物理データセンターの地理的位置を表します。リージョン ID は、クラウドサービスのリージョンを一意に識別する識別子です。

    リージョン名とリージョン ID の対応表

    リージョン名

    リージョン ID

    中国 (青島)

    cn-qingdao

    中国 (北京)

    cn-beijing

    中国 (張家口)

    cn-zhangjiakou

    中国 (フフホト)

    cn-huhehaote

    中国 (ウランチャブ)

    cn-wulanchabu

    中国 (杭州)

    cn-hangzhou

    中国 (上海)

    cn-shanghai

    中国（南京 - ローカルリージョン - 廃止中）

    cn-nanjing

    中国 (福州 - ローカルリージョン - 廃止予定)

    cn-fuzhou

    中国 (深セン)

    cn-shenzhen

    中国 (河源)

    cn-heyuan

    中国 (広州)

    cn-guangzhou

    フィリピン (マニラ)

    ap-southeast-6

    韓国 (ソウル)

    ap-northeast-2

    マレーシア (クアラルンプール)

    ap-southeast-3

    日本 (東京)

    ap-northeast-1

    タイ (バンコク)

    ap-southeast-7

    中国 (成都)

    cn-chengdu

    シンガポール

    ap-southeast-1

    インドネシア (ジャカルタ)

    ap-southeast-5

    中国 (香港)

    cn-hongkong

    ドイツ (フランクフルト)

    eu-central-1

    米国 (バージニア)

    us-east-1

    米国 (シリコンバレー)

    us-west-1

    イギリス (ロンドン)

    eu-west-1

    UAE (ドバイ)

    me-east-1

    サウジアラビア (リヤド - パートナー運営)

    me-central-1

    エンドポイント

    エンドポイントとは、Simple Log Service（SLS）のサービスアクセスポイントです。プロジェクトおよびそのログデータにアクセスするための URL であり、プロジェクトが配置されているリージョンによって決定されます。Simple Log Service では、非公開エンドポイント、パブリックエンドポイント、アクセラレーションエンドポイントの 3 種類を提供しています。エンドポイントを確認するには、以下の手順を実行してください：

    1. 「Simple Log Service コンソール」にログインし、プロジェクト一覧から対象のプロジェクトをクリックします。

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

    3. 「エンドポイント」セクションで、現在のプロジェクトのエンドポイント情報を確認できます。異なるネットワーク伝送方法では、異なるエンドポイントが使用されます。適切なネットワーク伝送方法を選択することで、より高速かつ安定したデータ転送を実現できます。

    ネットワークタイプ

    エンドポイントタイプ

    説明

    シナリオ

    Alibaba Cloud 内部ネットワーク

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

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

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

    説明

    SLS プロジェクトは、ECS インスタンスと同じリージョンに作成することを推奨します。これにより、インターネット帯域幅を消費せずに、Alibaba Cloud 内部ネットワーク経由で ECS インスタンスからのログ収集が可能になります。

    インターネット

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

    インターネット経由でログデータを送信する場合、ネットワーク帯域幅に制限があり、ジッター、ネットワーク遅延、パケット損失などの要因の影響を受けます。

    以下のシナリオでインターネット経由でのデータ送信が可能です：

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

    • サーバーが他社クラウドのもの、またはオンプレミス IDC のものである場合。

    転送アクセラレーション

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

    この方法では、Alibaba Cloud CDN のエッジノードを活用してログ収集を高速化します。インターネット経由のログ収集と比較して、ネットワーク遅延を低減し、安定性を向上させますが、追加のトラフィック料金が発生します。

    中国本土とその他のリージョン間でデータを送信する場合、インターネット経由ではネットワーク遅延が高くなり、不安定になることがあります。このような場合は、転送アクセラレーションを使用できます。詳細については、「転送アクセラレーション」をご参照ください。