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

Simple Log Service:マシングループの管理

最終更新日:Mar 13, 2025

Simple Log Service では、複数のサーバーから 1 つのログストアにログを収集できます。サーバーは、1 つまたは複数のマシングループに所属できます。マシングループに Logtail 構成を適用すると、Simple Log Service は、マシングループ内のすべてのサーバーに Logtail 構成を配信して、サーバーからログを収集します。このトピックでは、Simple Log Service でマシングループを作成、表示、変更、および削除する方法について説明します。

マシングループの作成

前提条件

  • プロジェクトが作成されます。詳細については、「プロジェクトを作成する」をご参照ください。

  • サーバーに Logtail がインストールされていること。詳細については、「Linux サーバーに Logtail をインストールする」または「Windows サーバーに Logtail をインストールする」をご参照ください。Simple Log Service プロジェクトと同じリージョンにある Elastic Compute Service(ECS)インスタンスを使用している場合、Logtail 構成の作成時に Simple Log Service が Logtail を自動的にインストールできます。詳細については、「ECS インスタンスに Logtail をインストールする」をご参照ください。

  • サーバーが Simple Log Service プロジェクトとは異なる Alibaba Cloud アカウントに属している場合、またはサーバーがサードパーティのクラウド サービス プロバイダーまたはデータセンターからのものである場合は、サーバーに対してカスタム識別子が構成されていること。詳細については、「ユーザー識別子の構成」をご参照ください。

手順

説明

Simple Log Service では、IP アドレスまたは カスタム識別子を使用してマシングループを作成できます。IP アドレスベースのマシングループの作成は、カスタム識別子ベースの マシングループの作成に比べて簡単です。ただし、次の利点があるため、カスタム識別子を使用してマシングループを作成することをお勧めします。

  • マシングループのサーバーが仮想プライベートクラウド(VPC)などのカスタム ネットワーク環境にある場合、サーバーの IP アドレスが競合する可能性があります。この場合、Logtail はデータを収集できません。この問題を防ぐために、カスタム識別子を使用してマシングループを作成できます。

  • マシングループは、カスタム識別子を使用して柔軟にスケーリングできます。マシングループに追加する新しいサーバーに同じ カスタム識別子を構成すると、Simple Log Service はカスタム識別子を自動的に識別し、同じカスタム識別子を持つサーバーを マシングループに追加します。サーバーからログを収集する必要がなくなった場合は、サーバー上の カスタム識別子ファイルを削除できます。このようにして、Simple Log Service は、関連する マシングループからサーバーを自動的に削除します。

カスタム識別子ベースの マシングループを作成する

重要
  • マシングループには、Linux サーバーと Windows サーバーの両方を含めることはできません。Linux サーバーと Windows サーバーに同じ カスタム識別子を構成しないでください。

  • 1 つのサーバーに 1 つ以上の カスタム識別子を構成し、識別子を改行で区切ることができます。

  1. カスタム識別子を構成します。

    Linux
    1. Logtail がインストールされている Linux サーバーにログオンし、次のコマンドを実行して カスタム識別子を構成します。

      説明

      /etc/ilogtail/ ディレクトリが存在しない場合は、ディレクトリを作成します。

      echo "user-defined-1" > /etc/ilogtail/user_defined_id
    2. オプション。次のコマンドを実行して、カスタム識別子が構成されているかどうかを確認します。user-defined-1 が返された場合、カスタム識別子は構成されています。

      cat /etc/ilogtail/user_defined_id
    3. デフォルトでは、user_defined_id ファイルを作成、削除、または変更した後、新しい設定は 1 分以内に有効になります。新しい設定をすぐに有効にするには、次のコマンドを実行して Logtail を再起動します。

      /etc/init.d/ilogtaild stop
      /etc/init.d/ilogtaild start
    Windows
    1. Logtail がインストールされている Windows サーバーにログオンします。C:\LogtailData ディレクトリに user_defined_id という名前のファイルを作成し、user_defined_id ファイルに user-defined-1 と入力して、ファイルを保存します。

      説明

      C:\LogtailData ディレクトリが存在しない場合は、ディレクトリを作成します。

    2. デフォルトでは、user_defined_id ファイルを作成、削除、または変更した後、新しい設定は 1 分以内に有効になります。新しい設定をすぐに有効にするには、次の操作を実行して Logtail を再起動します。

      1. [スタート] > [コントロールパネル] > [管理ツール] > [サービス] を選択します。

      2. [サービス] ダイアログボックスで、管理するサービスを選択します。

      3. Logtail V0.x.x.x の場合は、LogtailWorker を選択します。

      4. Logtail V1.0.0.0 以降の場合は、LogtailDaemon を選択します。

      5. サービスを右クリックし、[再起動] を選択して設定を有効にします。

    コンテナー

    カスタム識別子ファイルは、Logtail コンテナーに保存されます。ファイルパスは、Logtail コンテナーの ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数で指定されます。docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID コマンドを実行して、ファイルパスを表示できます。

  2. Simple Log Service コンソール にログオンします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。

  3. 左側のナビゲーションウィンドウで、[リソース] > [マシングループ] を選択します。[マシングループ] リストで、机器组 > [マシングループの作成] を選択します。image

  4. [マシングループの作成] パネルで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。

    パラメーター

    説明

    名前

    マシングループの名前。名前は次の要件を満たしている必要があります。

    • 名前に使用できるのは、小文字、数字、ハイフン(-)、およびアンダースコア(_)のみです。

    • 名前は小文字または数字で開始および終了する必要があります。

    • 名前は 2 ~ 128 文字である必要があります。

    重要

    マシングループを作成した後、マシングループの名前を変更することはできません。ご注意ください。

    マシングループ識別子

    マシングループの識別子の種類。[カスタム識別子] を選択します。

    マシングループトピック

    オプション。マシングループのトピック。トピックは、異なるサーバーによって生成されたログを識別するために使用されます。詳細については、「ログトピック」をご参照ください。

    カスタム識別子

    カスタム識別子。構成済みの カスタム識別子を入力します。例:user-defined-1

IP アドレスベースの マシングループを作成する

  1. サーバーの IP アドレスを取得します。

    Logtail がインストールされているサーバーで app_info.json ファイルを開き、ip フィールドの値を表示します。

    • 次の表に、app_info.json ファイルへのパスを示します。

      オペレーティング システム

      Logtail

      app_info.json ファイルへのパス

      Linux

      64 ビット Linux 用 Logtail

      /usr/local/ilogtail/app_info.json

      64 ビット Windows

      64 ビット Windows 用 Logtail

      C:\Program Files\Alibaba\Logtail\app_info.json

      32 ビット Windows 用 Logtail

      C:\Program Files (x86)\Alibaba\Logtail\app_info.json

      32 ビット Windows

      32 ビット Windows 用 Logtail

      C:\Program Files\Alibaba\Logtail\app_info.json

    • app_info.json ファイルの ip フィールドには、Logtail によって自動的に取得されたサーバーの IP アドレスが記録されます。IP地址

  2. Simple Log Service コンソール にログオンします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。

  3. 左側のナビゲーションウィンドウで、[リソース] > [マシングループ] を選択します。[マシングループ] リストで、机器组 > [マシングループの作成] を選択します。image

  4. [マシングループの作成] パネルで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。

    パラメーター

    説明

    名前

    マシングループの名前。名前は次の要件を満たしている必要があります。

    • 名前に使用できるのは、小文字、数字、ハイフン(-)、およびアンダースコア(_)のみです。

    • 名前は小文字または数字で開始および終了する必要があります。

    • 名前は 2 ~ 128 文字である必要があります。

    重要

    マシングループを作成した後、マシングループの名前を変更することはできません。ご注意ください。

    マシングループ識別子

    マシングループの識別子の種類。[IP アドレス] を選択します。

    マシングループトピック

    オプション。マシングループのトピック。トピックは、異なるサーバーによって生成されたログを識別するために使用されます。詳細については、「ログトピック」をご参照ください。

    IP アドレス

    IP アドレス。Logtail によって自動的に取得された IP アドレスを入力します。

    重要
    • 複数のサーバーをマシングループに追加する場合は、サーバーの IP アドレスを手動で入力し、IP アドレスを改行で区切ることをお勧めします。

    • マシングループには、Linux サーバーと Windows サーバーの両方を含めることはできません。Linux サーバーと Windows サーバーの IP アドレスを同じ マシングループに追加しないでください。

表示マシングループの構成を表示する

[マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページで、[マシングループ情報][マシングループステータス]、および [構成の管理] セクションのマシングループ関連の設定を表示できます。

  • サーバーの [ハートビート] 列の値が [OK] の場合、サーバー上の LogtailSimple Log Service に接続されています。

  • サーバーの [ハートビート] 列の値が [FAIL] の場合、マシングループの構成が有効になっていないためにエラーが発生している可能性があります。マシングループの作成には約 2 分かかります。2 分後も [ハートビート] 列の値が [FAIL] の場合は、他の構成の問題が原因でエラーが発生している可能性があります。エラーのトラブルシューティングを行うには、「ホスト環境で Logtail マシングループに関連するエラーをトラブルシューティングするにはどうすればよいですか。」をご参照ください。

image

マシングループ情報を変更する

  1. [マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページの右上隅にある [変更] をクリックします。

  2. Simple Log Service の [マシングループ情報] セクションで、次のパラメーターを変更できます。

    • マシングループ識別子

    • マシングループトピック

    • カスタム識別子または IP アドレス

    image

  3. マシングループ情報を変更した後、[保存] をクリックします。

特定のマシングループに Logtail 構成を適用する

  1. [マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページの右上隅にある [変更] をクリックします。

  2. [構成の管理] セクションで、Logtail 構成を選択し、> アイコンをクリックして、Logtail 構成を [すべての Logtail 構成] セクションから [適用済みの Logtail 構成] セクションに移動します。

    重要
    • マシングループに Logtail 構成を追加すると、Logtail 構成は、マシングループ内の各サーバーにインストールされている Logtail に配信されます。

    • マシングループから Logtail 構成を削除すると、Logtail 構成は、マシングループ内の各サーバーにインストールされている Logtail から削除されます。

    image

  3. マシングループを変更した後、[保存] をクリックします。

マシングループを削除する

  1. [マシングループ] リストで、管理するマシングループを見つけ、机器组管理图标 > [削除] を選択します。

  2. 表示されるダイアログボックスで、マシングループの名前を入力し、[削除の確認] をクリックします。

参照