マシングループとは、サーバーの仮想コレクションです。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 を使用してサーバーからログを収集できるようになります。
Alibaba Cloud アカウントを使用して、Simple Log Service コンソール にログインします。右上隅にあるプロファイル画像にカーソルを合わせ、表示されるタブから [アカウント ID] を表示してコピーします。RAM ユーザーを使用してログインする場合は、[メインアカウント] をコピーします。
データを収集するサーバーにログインします。次に、次のいずれかの方法を使用してユーザー識別子を構成し、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_module
、cache_module
、logic_module
、store_module
などです。
Linux サーバーと Windows サーバーを同じマシングループに含めることはできません。Linux サーバーと Windows サーバーの両方で同じカスタム識別子を使用しないでください。
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-1
をファイルに書き込みます。ファイルを保存します。説明C:\LogtailData
ディレクトリが存在しない場合は作成します。デフォルトでは、
user_defined_id
ファイルへの変更は、作成、削除、または変更後 1 分以内に有効になります。変更をすぐに適用するには、次の手順で Logtail を再起動します。を選択します。
[サービス] ダイアログボックスで、対応するサービスを選択します。
Logtail V0.x.x.x の場合は、LogtailWorker を選択します。
Logtail V1.0.0.0 以降の場合は、LogtailDaemon を選択します。
[再起動] を右クリックして、構成を適用します。
コンテナ
カスタム識別子は、Logtail コンテナの
ALIYUN_LOGTAIL_USER_DEFINED_ID
環境変数で構成されます。docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID
コマンドを実行して表示します。Simple Log Service コンソール にログインします。[プロジェクト] セクションで、ターゲットプロジェクトをクリックします。左側のナビゲーションウィンドウで、 を選択します。[マシングループ] ページで、
アイコンをクリックし、[マシングループの作成] を選択します。
[マシングループの作成] パネルで、次のパラメーターを構成し、[OK] をクリックします。
パラメーター
説明
名前
マシングループの名前。名前は次の要件を満たしている必要があります。
小文字、数字、ハイフン (-)、アンダースコア (_) のみを含む。
小文字または数字で開始および終了する。
長さが 2 ~ 128 文字である。
重要マシングループを作成した後、その名前を変更することはできません。注意して進めてください。
マシングループ識別子
[カスタム識別子] を選択します。
マシングループトピック (オプション)
マシングループの トピック。異なるサーバーで生成されたログデータを区別するために使用されます。
カスタム識別子
ステップ 1 で構成したカスタム識別子を入力します (例:
user-defined-1
)。
IP アドレスベースのマシングループを作成する
Simple Log Service コンソール にログインします。[プロジェクト] セクションで、ターゲットプロジェクトをクリックします。
左側のナビゲーションウィンドウで、
を選択します。[マシングループ] ページで、[マシングループ] > を選択します。[マシングループの作成] パネルで、次のパラメーターを構成し、[OK] をクリックします。
パラメーター
説明
名前
マシングループ の名前。名前は次の要件を満たしている必要があります。
名前には、小文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができます。
名前は、小文字または数字で開始および終了する必要があります。
名前は、2 ~ 128 文字の長さである必要があります。
重要マシングループを作成した後、マシングループの名前を変更することはできません。注意して進めてください。
識別子
[IP アドレス] を選択します。
トピック
(オプション) マシングループの トピック。トピックは、異なるサーバーで生成されたログデータを区別するために使用されます。詳細については、「ログトピック」をご参照ください。
IP アドレス
Logtail によって自動的に取得される IP アドレスを入力します。
Logtail がインストールされているサーバーで、
app_info.json
ファイルを開き、ip
フィールドの値を表示します。app_info.json
ファイルのパスは次のとおりです。Logtail によって自動的に取得される IP アドレスは、次の図に示すように、
app_info.json
ファイルのip
フィールドに記録されます。
重要マシングループに複数のサーバーを追加する場合は、サーバーの IP アドレスを手動で入力し、改行で区切ります。
1 つのマシングループに Linux サーバーと Windows サーバーの両方を含めることはできません。Windows サーバーと Linux サーバーの IP アドレスを同じ マシングループ に追加しないでください。
マシングループ構成を表示する
[マシングループ] リストで、1 つをクリックして [マシングループ構成] ページに移動します。ここでは、[マシングループ情報]、[マシングループステータス]、および構成管理を表示できます。
[ハートビート] ステータスが [OK] の場合、サーバー上の Logtail インスタンスは Simple Log Service プロジェクトに接続されています。
[ハートビート] ステータスが [FAIL] の場合、構成が有効にならない可能性があります。約 2 分待ちます。ステータスがまだ [FAIL] の場合は、他の構成の問題が存在する可能性があります。詳細については、「ホスト環境の Logtail マシングループに関連するエラーのトラブルシューティング方法」をご参照ください。
マシングループに Logtail 構成を適用する
[マシングループ] リストで、1 つをクリックして [マシングループ構成] ページに移動します。次に、ページの右上隅にある [変更] をクリックします。
[構成の管理] セクションで、左側から Logtail 構成を選択し、
>
アイコンをクリックして、構成を右側の [適用済み Logtail 構成] セクションに移動します。重要マシングループに Logtail 構成を追加すると、グループ内の各サーバーの Logtail に構成が適用されます。構成を削除すると、グループ内の各サーバーの Logtail から構成が削除されます。
[保存] をクリックします。
マシングループ情報を変更する
[マシングループ] リストで、1 つをクリックして [マシングループ構成] ページに移動します。次に、ページの右上隅にある [変更] をクリックします。
次の情報を変更します。
マシングループ識別子: マシングループタイプ。[IP アドレス] または [カスタム識別子] を指定できます。
[マシン グループ] トピック: 詳細については、「ログ トピック」をご参照ください。
カスタム識別子 または IP アドレス: マシングループにマシンを追加または削除できます。各マシンは改行で区切ります。マシングループ識別子で選択したタイプとの整合性を確保します。
重要新しく追加されたマシンには、Logtail がインストールされている必要があります。インストールされていない場合、マシングループに追加しても Logtail は自動的にインストールされず、ハートビートエラーが発生する可能性があります。
[保存] をクリックします。
マシングループを削除する
[マシングループ] リストで、削除するマシングループを選択し、
を選択します。表示されるダイアログボックスで、マシングループの名前を入力し、[削除の確認] をクリックします。
参照
詳細については、「Logtail を手動でインストールしてサーバーからテキストログを収集する」をご参照ください。
マシングループを管理するには、次の API を使用できます。