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

Simple Log Service:マシングループ

最終更新日:May 04, 2025

マシングループとは、サーバーの仮想コレクションです。Simple Log Service は、Logtail を使用してこれらのサーバーのログを管理および収集します。マシングループを使用すると、多数のサーバーからのログをログストアに収集できます。

前提条件

マシングループの概要

Simple Log Service プロジェクトでは、1 つの Logtail 構成を複数のマシングループに適用したり、1 つのグループを複数の Logtail 構成にバインドしたりできます。複数のサーバーからデータを収集するには、デプロイリージョンまたはカテゴリに基づいてサーバーをマシングループに分類し、指定されたグループに Logtail 構成を適用します。Simple Log Service は、グループ内のすべてのサーバーに構成を配信して、サーバーからデータを収集します。

マシングループを作成する

ステップ 1: ユーザー識別子を構成する (オプション)

次のいずれかの条件が満たされる場合、サーバーでユーザー識別子を構成します。Elastic Compute Service (ECS) インスタンスと Simple Log Service が同じ Alibaba Cloud アカウントに属している場合は、この手順をスキップしてください。

  • サーバーが ECS インスタンスではない。

  • サーバーは ECS インスタンスであるが、ECS インスタンスと Simple Log Service は異なる Alibaba Cloud アカウントに属している。

説明

ユーザー識別子を使用すると、サーバーに Alibaba Cloud アカウントからアクセスできるようになり、Simple Log Service プロジェクトで Logtail を使用してサーバーからログを収集できるようになります。

  1. Alibaba Cloud アカウントを使用して、Simple Log Service コンソール にログインします。右上隅にあるプロファイル画像にカーソルを合わせ、表示されるタブから [アカウント ID] を表示してコピーします。RAM ユーザーを使用してログインする場合は、[メインアカウント] をコピーします。image

  2. データを収集するサーバーにログインします。次に、次のいずれかの方法を使用してユーザー識別子を構成し、Alibaba Cloud アカウント ID ファイルを構成します。

    Linux

    • /etc/ilogtail/users ディレクトリに Alibaba Cloud アカウント ID ファイルを作成します。

      touch /etc/ilogtail/users/{Alibaba Cloud アカウント ID}
      重要
      • /etc/ilogtail/users ディレクトリが存在しない場合は、作成します。

      • ユーザー識別子を構成または削除した後、変更は 1 分以内に有効になります。

    • 異なる Alibaba Cloud アカウントに属する複数の Simple Log Service プロジェクトを使用して同じサーバーからログを収集するには、サーバー上に Alibaba Cloud アカウントの ID を名前とする複数のファイルを作成します。次に例を示します。

      touch /etc/ilogtail/users/{Alibaba Cloud アカウント ID 1}
      touch /etc/ilogtail/users/{Alibaba Cloud アカウント ID 2}

    Windows

    • C:\LogtailData\users ディレクトリに Alibaba Cloud アカウント ID ファイルを作成します。

      • Windows PowerShell を使用します。

        ni C:\LogtailData\users\{Alibaba Cloud アカウント ID}
      • コマンドプロンプトで次のコマンドを実行して、ファイルを作成します。

        type nul > C:\LogtailData\users\{Alibaba Cloud アカウント ID}
    • 異なる Alibaba Cloud アカウントに属する複数の Simple Log Service プロジェクトを使用して同じサーバーからログを収集するには、サーバー上に Alibaba Cloud アカウントの ID を名前とする複数のファイルを作成します。

    コンテナ環境

    Logtail が Alibaba Cloud Kubernetes クラスターにデプロイされており、Logtail-ds のバージョンが 1.7.3 以降である場合は、Container Service for Kubernetes コンソール でカスタム識別子を設定できます。[コンポーネント] ページで、[logtail-ds] コンポーネントを変更し、[LogtailDSExternalUserDefinelDs] パラメーターを設定します。詳細については、「コンポーネントの管理」をご参照ください。

    説明
    • ユーザー識別子を設定するには、ファイルの拡張子ではなく、ファイル名のみを構成します。

    • サーバーには複数のユーザー識別子を設定できますが、Logtail コンテナには 1 つだけ設定できます。

    • ユーザー識別子が不要になった場合は、サーバーから Alibaba Cloud アカウント ID ファイルを削除します。

ステップ 2: マシングループを作成する

説明

Simple Log Service プロジェクトでは、カスタム識別子 (推奨) または IP アドレスを使用してマシングループを作成できます。IP アドレスを使用してグループを作成する方が簡単ですが、カスタム識別子には次の利点があります。

  • VPC などのカスタムネットワークで発生する可能性のある IP アドレスの競合を防ぎ、Logtail 収集が失敗しないようにします。

  • エラスティックスケーリングをサポートします。同じ識別子を持つ新しいサーバーは、マシングループに自動的に追加されます。サーバーからのログ収集を停止するには、カスタム識別子ファイルを削除します。グループから自動的に削除されます。

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

通常、システムには複数のモジュールがあり、サーバーを追加することで各モジュールを拡張できます。ログを効率的に収集して整理するには、モジュールごとにマシングループを作成します。モジュール内のすべてのサーバーが同じユーザー識別子を共有して、正しいマシングループに属していることを確認します。

たとえば、Web サイトには、HTTP リクエスト、キャッシュ、ロジック処理、ストレージのモジュールがあり、識別子は http_modulecache_modulelogic_modulestore_module などです。

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

  • 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-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 コンテナの ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数で構成されます。docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID コマンドを実行して表示します。

  2. Simple Log Service コンソール にログインします。[プロジェクト] セクションで、ターゲットプロジェクトをクリックします。左側のナビゲーションウィンドウで、[リソース] > [マシングループ] を選択します。[マシングループ] ページで、机器组 アイコンをクリックし、[マシングループの作成] を選択します。image

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

    パラメーター

    説明

    名前

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

    • 小文字、数字、ハイフン (-)、アンダースコア (_) のみを含む。

    • 小文字または数字で開始および終了する。

    • 長さが 2 ~ 128 文字である。

    重要

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

    マシングループ識別子

    [カスタム識別子] を選択します。

    マシングループトピック (オプション)

    マシングループの トピック。異なるサーバーで生成されたログデータを区別するために使用されます。

    カスタム識別子

    ステップ 1 で構成したカスタム識別子を入力します (例: user-defined-1)。

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

  1. Simple Log Service コンソール にログインします。[プロジェクト] セクションで、ターゲットプロジェクトをクリックします。

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

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

    パラメーター

    説明

    名前

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

    • 名前には、小文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができます。

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

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

    重要

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

    識別子

    [IP アドレス] を選択します。

    トピック

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

    IP アドレス

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

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

    • app_info.json ファイルのパスは次のとおりです。

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

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

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

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

[マシングループ] リストで、1 つをクリックして [マシングループ構成] ページに移動します。ここでは、[マシングループ情報][マシングループステータス]、および構成管理を表示できます。

  • [ハートビート] ステータスが [OK] の場合、サーバー上の Logtail インスタンスは Simple Log Service プロジェクトに接続されています。

  • [ハートビート] ステータスが [FAIL] の場合、構成が有効にならない可能性があります。約 2 分待ちます。ステータスがまだ [FAIL] の場合は、他の構成の問題が存在する可能性があります。詳細については、「ホスト環境の Logtail マシングループに関連するエラーのトラブルシューティング方法」をご参照ください。

image

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

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

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

    重要

    マシングループに Logtail 構成を追加すると、グループ内の各サーバーの Logtail に構成が適用されます。構成を削除すると、グループ内の各サーバーの Logtail から構成が削除されます。

    image

  3. [保存] をクリックします。

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

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

  2. 次の情報を変更します。

    • マシングループ識別子: マシングループタイプ。[IP アドレス] または [カスタム識別子] を指定できます。

    • [マシン グループ] トピック: 詳細については、「ログ トピック」をご参照ください。

    • カスタム識別子 または IP アドレス: マシングループにマシンを追加または削除できます。各マシンは改行で区切ります。マシングループ識別子で選択したタイプとの整合性を確保します。

      重要

      新しく追加されたマシンには、Logtail がインストールされている必要があります。インストールされていない場合、マシングループに追加しても Logtail は自動的にインストールされず、ハートビートエラーが発生する可能性があります。

    image

  3. [保存] をクリックします。

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

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

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

参照