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

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

最終更新日:Aug 18, 2023

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はカスタム識別子を識別し、同じカスタム識別子を持つサーバーを同じマシングループに追加します。

手順

  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. Log Serviceコンソールにログインします。

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

  5. 左側のナビゲーションサイドバーで、[リソース] > [マシングループ] を選択します。

  6. マシングループの右側で、Machine groups > マシングループの作成を選択します。

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

    パラメーター

    説明

    名前

    マシングループの名前。

    重要

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

    識別子

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

    トピック

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

    カスタム識別子

    マシングループのカスタム識別子。 識別子は、ステップ2で指定した値と同じである必要があります。 詳細は、「2」をご参照ください。

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

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

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

      • マシングループのステータスセクションには、サーバーの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マシングループにハートビートがない場合の対処方法」をご参照ください。

        重要

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

      Machine Group Status

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

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

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

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

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

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

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