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 つ以上の カスタム識別子を構成し、識別子を改行で区切ることができます。
カスタム識別子を構成します。
Linux
Logtail がインストールされている Linux サーバーにログオンし、次のコマンドを実行して カスタム識別子を構成します。
説明/etc/ilogtail/ディレクトリが存在しない場合は、ディレクトリを作成します。echo "user-defined-1" > /etc/ilogtail/user_defined_idオプション。次のコマンドを実行して、カスタム識別子が構成されているかどうかを確認します。
user-defined-1が返された場合、カスタム識別子は構成されています。cat /etc/ilogtail/user_defined_idデフォルトでは、
user_defined_idファイルを作成、削除、または変更した後、新しい設定は 1 分以内に有効になります。新しい設定をすぐに有効にするには、次のコマンドを実行して Logtail を再起動します。/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows
Logtail がインストールされている Windows サーバーにログオンします。
C:\LogtailDataディレクトリにuser_defined_idという名前のファイルを作成し、user_defined_id ファイルにuser-defined-1と入力して、ファイルを保存します。説明C:\LogtailDataディレクトリが存在しない場合は、ディレクトリを作成します。デフォルトでは、user_defined_id ファイルを作成、削除、または変更した後、新しい設定は 1 分以内に有効になります。新しい設定をすぐに有効にするには、次の操作を実行して Logtail を再起動します。
を選択します。
[サービス] ダイアログボックスで、管理するサービスを選択します。
Logtail V0.x.x.x の場合は、LogtailWorker を選択します。
Logtail V1.0.0.0 以降の場合は、LogtailDaemon を選択します。
サービスを右クリックし、[再起動] を選択して設定を有効にします。
コンテナー
カスタム識別子ファイルは、Logtail コンテナーに保存されます。ファイルパスは、Logtail コンテナーの
ALIYUN_LOGTAIL_USER_DEFINED_ID環境変数で指定されます。docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_IDコマンドを実行して、ファイルパスを表示できます。Simple Log Service コンソール にログオンします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションウィンドウで、 を選択します。[マシングループ] リストで、
> [マシングループの作成] を選択します。
[マシングループの作成] パネルで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。
パラメーター
説明
名前
マシングループの名前。名前は次の要件を満たしている必要があります。
名前に使用できるのは、小文字、数字、ハイフン（-）、およびアンダースコア（_）のみです。
名前は小文字または数字で開始および終了する必要があります。
名前は 2 ～ 128 文字である必要があります。
重要マシングループを作成した後、マシングループの名前を変更することはできません。ご注意ください。
マシングループ識別子
マシングループの識別子の種類。[カスタム識別子] を選択します。
マシングループトピック
オプション。マシングループのトピック。トピックは、異なるサーバーによって生成されたログを識別するために使用されます。詳細については、「ログトピック」をご参照ください。
カスタム識別子
カスタム識別子。構成済みの カスタム識別子を入力します。例：
user-defined-1。
IP アドレスベースの マシングループを作成する
サーバーの IP アドレスを取得します。
Logtail がインストールされているサーバーで
app_info.jsonファイルを開き、ipフィールドの値を表示します。次の表に、
app_info.jsonファイルへのパスを示します。オペレーティング システム
Logtail
app_info.json ファイルへのパス
Linux
64 ビット Linux 用 Logtail
/usr/local/ilogtail/app_info.json64 ビット Windows
64 ビット Windows 用 Logtail
C:\Program Files\Alibaba\Logtail\app_info.json32 ビット Windows 用 Logtail
C:\Program Files (x86)\Alibaba\Logtail\app_info.json32 ビット Windows
32 ビット Windows 用 Logtail
C:\Program Files\Alibaba\Logtail\app_info.jsonapp_info.jsonファイルのipフィールドには、Logtail によって自動的に取得されたサーバーの IP アドレスが記録されます。
Simple Log Service コンソール にログオンします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションウィンドウで、 を選択します。[マシングループ] リストで、
> [マシングループの作成] を選択します。[マシングループの作成] パネルで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。
パラメーター
説明
名前
マシングループの名前。名前は次の要件を満たしている必要があります。
名前に使用できるのは、小文字、数字、ハイフン（-）、およびアンダースコア（_）のみです。
名前は小文字または数字で開始および終了する必要があります。
名前は 2 ～ 128 文字である必要があります。
重要マシングループを作成した後、マシングループの名前を変更することはできません。ご注意ください。
マシングループ識別子
マシングループの識別子の種類。[IP アドレス] を選択します。
マシングループトピック
オプション。マシングループのトピック。トピックは、異なるサーバーによって生成されたログを識別するために使用されます。詳細については、「ログトピック」をご参照ください。
IP アドレス
IP アドレス。Logtail によって自動的に取得された IP アドレスを入力します。
重要複数のサーバーをマシングループに追加する場合は、サーバーの IP アドレスを手動で入力し、IP アドレスを改行で区切ることをお勧めします。
マシングループには、Linux サーバーと Windows サーバーの両方を含めることはできません。Linux サーバーと Windows サーバーの IP アドレスを同じ マシングループに追加しないでください。
表示マシングループの構成を表示する
[マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページで、[マシングループ情報]、[マシングループステータス]、および [構成の管理] セクションのマシングループ関連の設定を表示できます。
サーバーの [ハートビート] 列の値が [OK] の場合、サーバー上の Logtail は Simple Log Service に接続されています。
サーバーの [ハートビート] 列の値が [FAIL] の場合、マシングループの構成が有効になっていないためにエラーが発生している可能性があります。マシングループの作成には約 2 分かかります。2 分後も [ハートビート] 列の値が [FAIL] の場合は、他の構成の問題が原因でエラーが発生している可能性があります。エラーのトラブルシューティングを行うには、「ホスト環境で Logtail マシングループに関連するエラーをトラブルシューティングするにはどうすればよいですか。」をご参照ください。
マシングループ情報を変更する
[マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページの右上隅にある [変更] をクリックします。
Simple Log Service の [マシングループ情報] セクションで、次のパラメーターを変更できます。
マシングループ識別子
マシングループトピック
カスタム識別子または IP アドレス
マシングループ情報を変更した後、[保存] をクリックします。
特定のマシングループに Logtail 構成を適用する
[マシングループ] リストで、管理するマシングループをクリックします。[マシングループの構成] ページの右上隅にある [変更] をクリックします。
[構成の管理] セクションで、Logtail 構成を選択し、
>アイコンをクリックして、Logtail 構成を [すべての Logtail 構成] セクションから [適用済みの Logtail 構成] セクションに移動します。重要マシングループに Logtail 構成を追加すると、Logtail 構成は、マシングループ内の各サーバーにインストールされている Logtail に配信されます。
マシングループから Logtail 構成を削除すると、Logtail 構成は、マシングループ内の各サーバーにインストールされている Logtail から削除されます。
マシングループを変更した後、[保存] をクリックします。
マシングループを削除する
[マシングループ] リストで、管理するマシングループを見つけ、
> [削除] を選択します。表示されるダイアログボックスで、マシングループの名前を入力し、[削除の確認] をクリックします。
参照
Simple Log Service で Logtail 構成を作成できます。詳細については、「サーバーからテキストログを収集する」をご参照ください。
マシングループを管理できます。マシングループの管理のために呼び出すことができる API 操作を以下に示します。