Log Serviceでは、カスタム識別子を使用してマシングループを定義できます。 このトピックでは、カスタム識別子ベースのマシングループを作成する方法について説明します。
前提条件
プロジェクトと Logstore が作成されていること。 詳細については、「プロジェクトの作成」および「Logstoreの作成」をご参照ください。
少なくとも1つのサーバーが利用可能です。
Logtailは各サーバーにインストールされます。
Elastic Compute Service (ECS) インスタンスを使用する場合は、ECSインスタンスがLog Serviceが有効化されているAlibaba Cloudアカウントに属し、Log Serviceリソースと同じリージョンにあることを確認してください。 詳細については、「ECSインスタンスへのLogtailのインストール」をご参照ください。
サーバーが別のAlibaba Cloudアカウントに属するECSインスタンス、サードパーティのクラウドサービスプロバイダーによって提供されるサーバー、または自己管理データセンターにデプロイされているサーバーの場合、ビジネス要件に基づいてネットワークを選択し、サーバーにLogtailをインストールする必要があります。 詳細については、「LinuxサーバーにLogtailをインストールする」および「WindowsサーバーにLogtailをインストールする」をご参照ください。
重要サーバーが別のAlibaba Cloudアカウントに属するECSインスタンス、サードパーティのクラウドサービスプロバイダーによって提供されるサーバー、または自己管理型データセンターにデプロイされているサーバーの場合、サーバーのユーザー識別子を設定する必要があります。 詳細については、「ユーザー識別子の設定」をご参照ください。
背景情報
カスタム識別子ベースのマシングループは、次のシナリオでメリットがあります。
サーバーが仮想プライベートクラウド (VPC) などの複数のカスタムネットワーク環境に存在する場合、一部のサーバーのIPアドレスが競合する可能性があります。 この場合、Log ServiceはLogtailを管理できません。 この問題を防ぐために、カスタム識別子ベースのマシングループを作成できます。
マシングループの自動スケーリングを実現する場合は、マシングループに追加する新しいサーバーに同じカスタム識別子を設定するだけで済みます。 Log Serviceはカスタム識別子を識別し、同じカスタム識別子を持つサーバーを同じマシングループに追加します。
手順
指定したディレクトリにuser_defined_idという名前のファイルを作成します。
Linuxサーバー: /etc/ilogtail/user_defined_idディレクトリにファイルを作成します。
Windowsサーバー: C:\LogtailData\user_defined_idディレクトリにファイルを作成します。
サーバーのカスタム識別子を設定します。
重要WindowsサーバーとLinuxサーバーを同じマシングループに追加することはできません。 LinuxサーバーとWindowsサーバーに同じカスタム識別子を構成しないでください。
1つのサーバーに1つ以上のカスタム識別子を設定し、改行でカスタム識別子を分けることができます。
Linuxサーバーで、/etc/ilogtail/ ディレクトリまたは /etc/ilogtail/user_defined_idファイルが存在しない場合は、ディレクトリとファイルを作成する必要があります。 Windowsサーバーで、C:\LogtailDataディレクトリまたはC:\LogtailData\user_defined_idファイルが存在しない場合は、ディレクトリとファイルも作成する必要があります。
Linux サーバー
/etc/ilogtail/user_defined_idファイルでカスタム識別子を設定します。 たとえば、カスタム識別子を
userdefined
として設定する場合は、次のコマンドを実行してファイルを編集します。 次に、ファイルにuserdefined
と入力し、ファイルを保存します。vim /etc/ilogtail/user_defined_id
Windows サーバー
C:\LogtailData\user_defined_idファイルでカスタム識別子を設定します。 たとえば、カスタム識別子を
userdefined_windows
として設定する場合は、C:\LogtailData\user_defined_idファイルにuserdefined_windows
と入力し、ファイルを保存します。
Log Serviceコンソールにログインします。
[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションサイドバーで、 を選択します。
マシングループの右側で、 を選択します。
[マシングループの作成] パネルでパラメーターを設定し、[OK] をクリックします。 次の表は、各パラメーターの説明です。
マシングループのステータスを表示します。
マシングループリストで、管理するマシングループをクリックします。
[マシングループの設定] ページで、同じカスタム識別子を持つサーバーと各サーバーのハートビートステータスを表示します。
マシングループのステータスセクションには、サーバーのIPアドレスが表示されます。
たとえば、カスタム識別子ベースのマシングループが作成され、カスタム識別子はuserdefinedで、マシングループのステータスセクションのIPアドレスは10.10.10.10、10.10.10.11、および10.10.10.12です。 これは、マシングループ内のサーバーに同じカスタム識別子を設定したことを示します。 マシングループに新しいサーバーを追加する場合、サーバーのIPアドレスが10.10.10.13の場合は、サーバーのユーザー定義としてカスタム識別子を設定します。 次に、マシングループのステータスセクションでサーバーのIPアドレスを表示できます。
サーバーのHeartbeat列の値がOKの場合、サーバーのLogtailはLog Serviceに接続されています。 値がFAILの場合、接続は失敗しました。 詳細については、「Logtailマシングループにハートビートがない場合の対処方法」をご参照ください。
重要マシングループの作成直後にマシングループのステータスを確認すると、接続が有効になっていないため、ハートビートが失敗する可能性があります。 この場合、[更新] をクリックします。
カスタム識別子を無効にする
Identifierパラメーターの値をIPアドレスに変更する場合は、user_defined_idファイルを削除する必要があります。 新しい設定は1分以内に有効になります。
Linuxの
rm -f /etc/ilogtail/user_defined_id
Windows
del C:\LogtailData\user_defined_id
有効期間
デフォルトでは、user_defined_idファイルを追加、削除、または変更した後、新しい設定は1分以内に有効になります。 新しい設定をすぐに有効にするには、次のコマンドを実行してLogtailを再起動します。
Linux
/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows
を選択します。
[サービス] ダイアログボックスで、管理するサービスを選択します。
Logtail V0.x.x.xの場合は、LogtailWorkerを選択します。
Logtail V1.0.0.0以降の場合は、LogtailDaemonを選択します。
サービスを右クリックし、[再起動] を選択して設定を有効にします。