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

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

最終更新日:Aug 21, 2024

Simple Log Serviceでは、カスタム識別子を使用してマシングループを定義できます。 このトピックでは、カスタム識別子ベースのマシングループを作成する方法について説明します。

前提条件

背景情報

カスタム識別子ベースのマシングループは、次のシナリオでメリットがあります。

  • サーバーが仮想プライベートクラウド (VPC) などの複数のカスタムネットワーク環境に存在する場合、一部のサーバーのIPアドレスが競合する可能性があります。 この場合、Simple Log ServiceはLogtailを管理できません。 この問題を防ぐために、カスタム識別子ベースのマシングループを作成できます。

  • 複数のサーバーに同じカスタム識別子を設定することで、マシングループを柔軟にスケーリングできます。 マシングループに追加する新しいサーバーに同じカスタム識別子を設定した場合、Simple Log Serviceはカスタム識別子を識別し、同じカスタム識別子を持つサーバーをマシングループに追加します。

手順

  1. という名前のファイルを作成します。user_defined_id特定のディレクトリに

    • Linuxサーバー: /etc/ilogtail/user_defined_idディレクトリにファイルを作成します。

    • Windowsサーバー: C:\LogtailData\user_defined_idディレクトリにファイルを作成します。

  2. サーバーのカスタム識別子を設定します。

    重要
    • 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と入力し、ファイルを保存します。

  3. にログインします。Simple Log Serviceコンソール.

  4. [プロジェクト] セクションで、管理するプロジェクトをクリックします。

    image

  5. 左側のナビゲーションウィンドウで、リソース > マシングループ.

  6. の右側にマシングループ、選択机器组 > マシングループの作成.

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

    パラメーター

    説明

    名前

    マシングループの名前。

    重要

    マシングループの作成後、マシングループの名前を変更することはできません。 作業は慎重に行ってください。

    マシングループ識別子

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

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

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

    カスタム識別子

    マシングループのカスタム識別子。 ステップ2で設定したカスタム識別子を指定します。

  8. マシングループのステータスを表示します。

    1. マシングループリストで、管理するマシングループをクリックします。

    2. On theマシングループの設定ページで、同じカスタム識別子を持つサーバーと各サーバーのハートビートステータスを表示します。

      • マシングループのステータスセクションには、同じカスタム識別子を持つサーバーのIPアドレスが表示されます。

        たとえば、カスタム識別子ベースのマシングループが作成され、カスタム識別子はuserdefinedで、マシングループのステータスセクションのIPアドレスは10.10.10.10、10.10.10.11、および10.10.10.12です。 これは、マシングループ内のサーバーに同じカスタム識別子を設定したことを示します。 マシングループに別のサーバーを追加する場合、サーバーのIPアドレスが10.10.10.13の場合は、サーバーのカスタム識別子をuserdefinedとして設定します。 次に、マシングループのステータスセクションでサーバーのIPアドレスを表示できます。

      • サーバーのHeartbeat列の値がOKの場合、サーバーのLogtailはSimple Log Serviceに接続されています。 値がFAILの場合、接続は失敗しました。 詳細については、「」をご参照ください。Logtailマシングループにハートビートがない場合はどうすればよいですか?

        重要

        マシングループの作成直後にマシングループのステータスを確認すると、接続が有効になっていないため、ハートビートが失敗する可能性があります。 この場合、[更新] をクリックします。

      机器组状态

カスタム識別子を無効にする

マシングループ識別子パラメータの値を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

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

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

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

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

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