すべてのプロダクト
Search

このプロダクト

    Simple Log Service:データコレクターのインストール

    ドキュメントセンター

    Simple Log Service:データコレクターのインストール

    最終更新日:Jan 23, 2026

    LoongCollector は、Simple Log Service が提供するデータコレクターです。Linux サーバーからログを収集するには、まずサーバーに LoongCollector クライアントをインストールする必要があります。ご利用のサーバーと Simple Log Service プロジェクトの関係に基づいて、インストール方法を選択してください。

    制限事項

    サポートされる Linux オペレーティングシステム

    • 次の Linux x86-64 (64 ビット) サーバーバージョンがサポートされています：

      • Alibaba Cloud Linux 2 および 3

      • Anolis OS 7 および 8

      • CentOS Linux 6、7、および 8

      • Debian GNU/Linux 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 命令セットをサポートする必要があります。

    • 次の Linux ARM (64 ビット) サーバーバージョンがサポートされています：

      • Alibaba Cloud Linux 3.2 ARM

      • Anolis OS 8.2 ARM 以降

      • CentOS 8.4 ARM

      • Debian 11.2 および 12.2 ARM

      • Ubuntu 20.04、22.04、および 24.04 ARM

      • 最小要件の CPU アーキテクチャは ARMv8.2-A です。

    前提条件

    権限

    Alibaba Cloud アカウントでログインすると、デフォルトですべての操作権限が付与されており、必要な操作を実行できます。

    Resource Access Management (RAM) ユーザーとしてログインする場合は、Alibaba Cloud アカウントのオーナーに次のシステムポリシーをリクエストして、Simple Log Service、Elastic Compute Service (ECS)、および Operation Orchestration Service (OOS) のリソースを管理する権限を取得してください。

    • AliyunLogFullAccess：Simple Log Service を管理する権限を付与します。

    • AliyunOOSFullAccess：OOS を管理する権限を付与します。これにより、OOS のオーケストレーション機能を使用して LoongCollector を自動的にインストールできます。

    • AliyunECSFullAccess：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 コンソールにログインし、プロジェクトの作成 をクリックして、次の基本設定を行います。その他の設定はデフォルトのままにします。

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

    • プロジェクト名：プロジェクトの名前を設定します。名前は Alibaba Cloud リージョン内でグローバルに一意である必要があり、プロジェクト作成後に変更できません。

    Logstore の作成

    Logstore がない場合は、次の手順に従って基本的な Logstore を作成します。Logstore の作成方法の詳細については、「Logstore の管理」をご参照ください。

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

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

      image

    3. Logstore 名 を入力し、他の設定はデフォルトのままにします。

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

    1. LoongCollector をインストールするマシンでは、ポート 80 (HTTP) とポート 443 (HTTPS) のアウトバウンドアクセスを有効にする必要があります。これにより、LoongCollector がデータをアップロードできるようになります。

    2. LoongCollector をインストールするマシンは、次のエンドポイントに接続できる必要があります：

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

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

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

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

      4. {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} のような応答が返された場合、ネットワーク接続は正常です。そうでない場合は、宛先アドレスがブロックされていないか確認し、DNS 設定やセキュリティグループルールなど、他のネットワークチェックを実行してください。

        アクセス URL に必須パラメーターが欠落しているため、エラーが返されます。このテストはネットワーク接続のみを検証し、完全な URL を使用しないため、ネットワークが正常な場合はエラーメッセージが表示されます。

    インストール方法の選択

    インストール方法

    シナリオ

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

    この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じ Alibaba Cloud アカウントに属し、同じリージョンにある場合にのみ適用されます。

    同一アカウント、異なるリージョン

    この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じ Alibaba Cloud アカウントに属しているが、異なるリージョンにある場合に適用されます。

    異なるアカウント、同一リージョン

    この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトが同じリージョンにあるが、異なる Alibaba Cloud アカウントに属している場合に適用されます。

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

    • この方法は、サーバーが Alibaba Cloud ECS インスタンスではない場合、たとえばオンプレミスサーバーや他のクラウドプロバイダーのサーバーである場合に適用されます。

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

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

    この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、ECS インスタンスとプロジェクトの両方が同じ Alibaba Cloud アカウントに属し、同じリージョンにある場合にのみ適用されます。Simple Log Service は、ECS インスタンスに LoongCollector をワンクリックでインストールする方法を提供します。この方法は OOS のオーケストレーション機能を使用するため、ECS インスタンスにログインして手動でインストールを実行する必要はありません。

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

    操作手順は次のとおりです：

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

    2. imageログ管理 をクリックします。Logstores リストで、対象の Logstore の前にある image アイコンをクリックして Logstore を展開します。

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

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

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

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

    7. これでワンクリックインストールは完了です。[次へ] をクリックして、収集設定に進みます。

    同一アカウント、異なるリージョン

    この方法は、サーバーが Alibaba Cloud ECS インスタンスであり、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

      • 転送アクセラレーション：この方法は、中国本土から中国以外のリージョンへのデータ転送など、リージョン間のデータ転送に使用されます。CDN を使用してパフォーマンスを高速化し、パブリックネットワークでの高遅延や不安定性を回避します。ただし、トラフィックに対して課金されます。

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

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

      sudo /etc/init.d/loongcollectord status

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

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

        # 指定されたファイルにカスタム文字列を書き込みます。フォルダが存在しない場合は、手動で作成してください。ファイルパスと名前は 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 を選択します。

        • [カスタム ID]：設定したカスタム ID を入力します。これはサーバー上のカスタム ID ファイル内のカスタム文字列と同じでなければなりません。この例では user-defined-test-1 です。

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

    6. インストール完了後、ログを収集するためには収集設定も行う必要があります。

    異なるアカウント、同一リージョン

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

    操作手順は次のとおりです：

    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 に置き換えます。

      接続タイムアウトが発生した場合、${region_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. Simple Log Service コンソールにログインし、右上隅のプロフィール画像にマウスを合わせ、表示されるタブからアカウント ID を表示してコピーします。必ず Alibaba Cloud アカウントの ID をコピーしてください。

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

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

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

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

        # 指定されたファイルにカスタム文字列を書き込みます。フォルダが存在しない場合は、手動で作成してください。ファイルパスと名前は 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 を選択します。

        • [カスタム ID]：設定したカスタム ID を入力します。これはサーバー上のカスタム ID ファイル内のカスタム文字列と同じでなければなりません。この例では user-defined-test-1 です。

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

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

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

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

    説明

    サーバーの制限事項については、「サポートされる Linux オペレーティングシステム」をご参照ください。

    操作手順は次のとおりです：

    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

      • 転送アクセラレーション：この方法は、中国本土から中国以外のリージョンへのデータ転送など、リージョン間のデータ転送に使用されます。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. Simple Log Service コンソールにログインし、右上隅のプロフィール画像にマウスを合わせ、表示されるタブからアカウント ID を表示してコピーします。必ず Alibaba Cloud アカウントの ID をコピーしてください。

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

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

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

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

        # 指定されたファイルにカスタム文字列を書き込みます。フォルダが存在しない場合は、手動で作成してください。ファイルパスと名前は 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 を選択します。

        • [カスタム ID]：設定したカスタム ID を入力します。これはサーバー上のカスタム ID ファイル内のカスタム文字列と同じでなければなりません。この例では user-defined-test-1 です。

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

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

    LoongCollector のバッチインストール

    • ECS インスタンスとプロジェクトが同じアカウントとリージョンに属するシナリオでは、自動インストール中に複数の ECS インスタンスを選択できます。

    • その他のシナリオでは、クラウドアシスタントを使用して一時的なタスクを実行します。これにより、ECS インスタンス上で LoongCollector のインストールコマンドをバッチで実行できます。

      インストールシナリオに基づいて、ダウンロードおよびインストールコマンドを選択します。クラウドアシスタントの使用方法の詳細については、「コマンドの作成と実行」をご参照ください。

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

    重要

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

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

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

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

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

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

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

    説明

    logtail.sh スクリプトを再度ダウンロードする必要があります。古い logtail.sh スクリプトは使用しないでください。

    1. サーバーでダウンロードコマンドを実行して、インストールパッケージを取得します。サンプルコードでは、${region_id} を cn-hangzhou に置き換えることができます。ダウンロードを高速化するには、${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 に置き換えることができます。実行を高速化するには、${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;

    よくある質問

    サーバーが外部ネットワークに接続できない場合、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. チェックコマンドを実行します。loongcollector is running が返された場合、起動は成功です。

      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 インスタンスとプロジェクトが同じアカウントとリージョンに属する場合にのみサポートされます。この条件が満たされない場合は、別のインストール方法を選択してください。条件が満たされている場合は、前提条件セクションの権限とネットワーク要件が満たされているか確認してください。

    「ハートビートなし」または「ハートビート FAIL」のステータスを解決するにはどうすればよいですか？

    ハートビートステータスが FAIL の場合、最初のハートビート接続に時間がかかることが原因である可能性があります。約 2 分待ってからハートビートステータスを更新してください。ステータスが依然として FAIL の場合は、次のチェックを実行してください：

    • サーバーと Simple Log Service プロジェクトの関係を確認します。関係が異なれば、インストール手順も異なります。

      • 誤った手順を選択したことが判明した場合は、サーバーで chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; コマンドを実行して LoongCollector をアンインストールします。その後、正しい手順を選択して実行してください。

    • 手順は正しいがハートビートステータスが FAIL の場合は、LoongCollector がインストールされているサーバーの /usr/local/ilogtail/ilogtail_config.json ファイル内の region 情報が Simple Log Service プロジェクトのリージョン ID と一致するか確認してください。

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

        この方法は上書きインストールを実行し、元の設定が失われます。すでに収集設定があるサーバーでは注意して使用してください。

      • 情報が一致するか、再インストール後もハートビートステータスが FAIL の場合は、次のチェックを続けてください。

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

      • ユーザー ID の値は Alibaba Cloud アカウントの ID でなければなりません。そうでない場合は修正してください。

      • この Alibaba Cloud アカウント ID は、ECS サーバーが属するアカウントの ID ではなく、Simple Log Service プロジェクトが属するアカウントの ID である必要があります。

    • Simple Log Service コンソールのマシングループで設定されたカスタム ID の内容が、サーバー上のカスタム ID ファイルの内容と一致しているか確認してください。一致していない場合は、どちらかを修正して一致させてください。

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

    関連資料

    リージョン

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

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

    3. 基本情報で、現在のプロジェクトのリージョン名を確認できます。リージョン名に対応するリージョン ID については、以下の表をご参照ください。

      リージョンは、Alibaba Cloud サービスリソースが配置されている物理データセンターの地理的な場所を表します。リージョン ID は、Alibaba Cloud サービスリージョンの一意の識別子です。

    リージョンとリージョン 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

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

    エンドポイントは Simple Log Service のアクセスドメイン名です。これはプロジェクトとそのログデータにアクセスするために使用される URL であり、プロジェクトが所在するリージョンに関連しています。Simple Log Service は、プライベートエンドポイント、パブリックエンドポイント、およびアクセラレーションエンドポイントを提供します。エンドポイントは次のように表示できます：

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

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

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

    ネットワークタイプ

    適用可能なドメイン名

    説明

    シナリオ

    Alibaba Cloud プライベートネットワーク

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

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

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

    説明

    ECS インスタンスと同じリージョンに Simple Log Service プロジェクトを作成します。これにより、パブリック帯域幅を消費することなく、Alibaba Cloud プライベートネットワーク経由で ECS インスタンスからログを収集できます。

    パブリックネットワーク

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

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

    次の 2 つの場合に、パブリックネットワーク経由でデータを転送することを選択できます：

    • ECS インスタンスと Simple Log Service プロジェクトが異なるリージョンにある。

    • サーバーが他のクラウドプロバイダーまたはオンプレミスのデータセンターのものである。

    転送アクセラレーション

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

    この方法は、Alibaba Cloud CDN の POP (Points of Presence) を使用してログ収集を高速化します。パブリックネットワーク収集と比較して、ネットワーク遅延と安定性において大きな利点があります。ただし、トラフィックに対して課金されます。

    ビジネスサーバーと Simple Log Service プロジェクトが異なるリージョンにある場合、たとえば一方が中国本土に、もう一方が中国以外にある場合、パブリックネットワークを使用すると高いネットワーク遅延や不安定な転送が発生する可能性があります。この場合、転送アクセラレーションを使用することを選択できます。詳細については、「転送アクセラレーション」をご参照ください。