Simple Log Service:ホスト環境で Logtail マシングループに関連するエラーをトラブルシューティングするにはどうすればよいですか?

マシングループインストールの例

• Elastic Compute Service (ECS) インスタンスと Simple Log Service プロジェクトが同じ Alibaba Cloud アカウントに属し、同じリージョンにある場合は、「Logtail をインストールしてマシングループを作成する」の手順に従ってマシングループを作成します。

• ECS インスタンスと Simple Log Service プロジェクトが異なる Alibaba Cloud アカウントに属している場合、ECS インスタンスと Simple Log Service プロジェクトが同じ Alibaba Cloud アカウントに属しているが異なるリージョンにある場合、および他のクラウドと自己管理サーバーを含むシナリオでは、「マシングループを作成する」の手順に従ってマシングループを作成します。

トラブルシューティングプレビュー

1. 手順 1：Logtail が想定どおりに実行されているかどうかを確認する: サーバー上で Logtail が想定どおりに実行されているかどうかを確認します。

2. 手順 2：マシングループで指定されている IP アドレスが、Logtail によって取得された IP アドレスと同じであるかどうかを確認する: マシングループで指定されている IP アドレスが、Logtail の app_info.json ファイルの IP アドレスと同じであるかどうかを確認します。IP アドレスが異なる場合、ハートビートエラーが発生します。

3. 手順 3：Logtail 起動パラメータが有効かどうかを確認する: ilogtail_config.json ファイルで指定されているリージョンがサポートされているかどうかを確認します。

4. 手順 4：ネットワーク接続が利用可能かどうかを確認する: サーバーがプロジェクトのアドレスに接続できるかどうかを確認します。

5. 手順 5：Logtail がインストールされているサーバーのシステム時刻が正しいかどうかを確認する: システム時刻が現地時刻よりも前または後の場合、システム時刻を変更する必要があります。

6. 手順 6：クロスアカウントシナリオでユーザー識別子が構成されているかどうかを確認する: サーバーが ECS インスタンスでない場合、または ECS インスタンスと Simple Log Service プロジェクトが異なる Alibaba Cloud アカウントに属している場合は、ユーザー識別子が正しく構成されているかどうかを確認する必要があります。

7. 手順 7：カスタム識別子ベースのマシングループを使用している場合、カスタム識別子が構成されているかどうかを確認する: カスタム識別子ベースのマシングループを使用している場合は、カスタム識別子が構成されているかどうかを確認します。

8. 手順 8：Logtail を再起動する: 前述の操作を実行した後、Logtail を再起動する必要があります。

次の手順

ハートビートステータスが OK に変更された後もログが収集されない場合は、Logtail エラーに基づいて問題をトラブルシューティングします。詳細については、「Logtail 収集エラーを表示するにはどうすればよいですか?」をご参照ください。

手順 1：Logtail が想定どおりに実行されているかどうかを確認する

1. app_info.json ファイルの ip フィールドの値を取得します。

   次の表は、異なるオペレーティングシステムにおける app_info.json ファイルへのデフォルトパスを示しています。

   オペレーティングシステム	Logtail	app_info.json ファイルへのパス
   Linux	64 ビット Linux 用 Logtail	/usr/local/ilogtail/app_info.json
   64 ビット Windows	64 ビット Windows 用 Logtail	C:\Program Files\Alibaba\Logtail\app_info.json
   	32 ビット Windows 用 Logtail	C:\Program Files (x86)\Alibaba\Logtail\app_info.json
   32 ビット Windows	32 ビット Windows 用 Logtail	C:\Program Files\Alibaba\Logtail\app_info.json

   ip フィールドの値は、Logtail によって取得された IP アドレスを指定します。

   {
     "UUID" : "",
     "hostname" : "iZ8vbdlzf******azuhZ",
     "instance_id" : "E9633380-***********-00163E1AA597_172.16.2.200_166****11",
     "ip" : "172.**.**.200",
     "logtail_version" : "1.3.1",
     "os" : "Linux; 4.19.91-26.1.al7.x86_64; #1 SMP Tue Jul 26 17:52:28 CST 2022; x86_64",
     "update_time" : "2022-12-27 05:38:33"
   }

2. マシングループで指定されている IP アドレスが、Logtail によって取得された IP アドレスと同じであるかどうかを確認します。

   Simple Log Service マシングループは、IP アドレスベースのマシングループとカスタム識別子ベースのマシングループに分類されます。詳細については、「マシングループ」をご参照ください。

   • IP アドレスベースのマシングループ: 前の手順 で取得した IP アドレスが、[IP アドレス] フィールドの値に含まれているかどうかを確認します。

     [IP アドレス] フィールドの値がパブリック IP アドレスなど Logtail の別の IP アドレスである場合は、値を Logtail によって取得された IP アドレスに変更します。前の手順 で取得した IP アドレスが正しくない場合は、working_ip を変更 して Logtail を再起動します。次に、マシングループのハートビートが検出できるかどうかを確認します。ハートビートが検出できる場合は、トラブルシューティングを停止できます。

   • カスタム識別子ベースのマシングループ: 前の手順 で取得した IP アドレスが [マシングループステータス] セクションに含まれているかどうかを確認します。[ハートビート] ステータスが [OK] の場合は、トラブルシューティングを停止できます。

ilogtail_config.json ファイルには、Logtail の起動パラメータが記録されています。

1. Logtail がインストールされているサーバーにログオンします。

2. ilogtail_config.json ファイルを見つけます。

   次の表は、異なるオペレーティングシステムにおける ilogtail_config.json ファイルへのデフォルトパスを示しています。

   オペレーティングシステム	Logtail	ilogtail_config.json ファイルへのパス
   Linux	64 ビット Linux 用 Logtail	/usr/local/ilogtail/ilogtail_config.json
   64 ビット Windows	64 ビット Windows 用 Logtail	\ilogtail_config.json
   	32 ビット Windows 用 Logtail	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json
   32 ビット Windows	32 ビット Windows 用 Logtail	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

   1. ilogtail_config.json ファイルを開き、構成ファイルのパラメータが有効かどうかを確認します。

      {
        "config_server_address" : "http://logtail.<config_region>.log.aliyuncs.com",
        "data_server_list" :
        [
          {
            "cluster" : "<プロジェクトが属するリージョン>",
            "endpoint" : "<endpoint>"
          }
        ],
        ...
      }

      • ilogtail_config.json ファイルの起動パラメータの構成が次の表の説明に準拠している場合、Logtail の起動パラメータは有効です。

      • Logtail の起動パラメータが無効な場合は、次の表の説明に基づいて ilogtail_config.json ファイルを変更し、Logtail を再起動します。詳細については、「Logtail を再起動する」をご参照ください。

        サポートされているリージョンの詳細については、「サポートされているリージョン」をご参照ください。

        シナリオ	ネットワークタイプ	<config_region>	<endpoint>
        サーバーは、プロジェクトと同じリージョンにある ECS インスタンスです。	Alibaba Cloud 内部ネットワーク	<プロジェクトが属するリージョン>-intranet	<プロジェクトが属するリージョン>-intranet.log.aliyuncs.com
        その他のシナリオ	インターネット	<プロジェクトが属するリージョン>	<プロジェクトが属するリージョン>.log.aliyuncs.com
        	転送アクセラレーション		log-global.aliyuncs.com

Logtail がインストールされているサーバーが次のアドレスに接続できる場合にのみ、Logtail は Simple Log Service にデータをアップロードできます。

1. ilogtail_config.json ファイルの config_server_address フィールドで指定されているアドレス。フィールド値で指定された HTTPS バージョンのみがサポートされています。

2. http://<プロジェクト名>.<endpoint> 形式のアドレス。

   • 図の手順に従って、プロジェクトの名前とリージョンを表示できます。

     

   • <endpoint> は、ilogtail_config.json ファイルの data_server_list.endpoint フィールドで指定されるアドレスです。

3. http://ali-<プロジェクトが属するリージョン>-sls-admin.<エンドポイント> 形式のアドレス。<エンドポイント> は、ilogtail_config.json ファイルの data_server_list.endpoint フィールドで指定されるアドレスです。

ネットワーク接続が利用可能かどうかを確認するには、次の操作を実行します。

Linux

1. Logtail がインストールされているサーバーにログオンします。

2. date コマンドを実行して、システム時刻を表示します。

   Wed Dec 28 06:59:26 UTC 2022

   システム時刻がローカル時刻よりも前または後の場合は、次の操作を実行します。

   • システム時刻をローカル時刻に変更します。

   • システム時刻を変更できない場合は、ilogtail_config.json ファイルに "enable_log_time_auto_adjust": true を追加します。ファイルを修正した後、Logtail を再起動します。詳細については、「Logtail を再起動する」をご参照ください。 ilogtail_config.json ファイルのパスについては、「手順 3: Logtail 起動パラメーターが有効かどうかを確認する」をご参照ください。

Windows

1. Logtail がインストールされているサーバーにログオンします。

2. デスクトップの右下隅にあるタスクバーで時間情報を確認します。

   • システム時間をローカル時間に変更します。

   • システム時間を変更できない場合は、ilogtail_config.json ファイルに "enable_log_time_auto_adjust": true を追加します。ファイルを修正した後、Logtail を再起動します。詳細については、「Logtail を再起動する」をご参照ください。 ilogtail_config.json ファイルへのパスの詳細については、「手順 3：Logtail 起動パラメーターが有効かどうかを確認する」をご参照ください。

ステップ 6：クロスアカウントシナリオでユーザー識別子が構成されているかどうかを確認する

指定されたディレクトリにあるユーザー識別子ファイルを使用して、ユーザー識別子が構成されているかどうかを確認します。出力が空の場合は、指定されたディレクトリにユーザー識別子ファイルが存在するかどうかを確認する必要があります。ユーザー識別子は、アカウントにこのサーバーにアクセスする権限があることを確認します。

• 指定されたディレクトリにユーザー識別子ファイルが存在しない場合、またはユーザー識別子ファイルが無効な場合は、次の操作を実行して問題を修正します。

  • Linux：cd /etc/ilogtail/users/ && touch <uid> コマンドを実行して、ユーザー識別子ファイルを作成します。<uid> は、プロジェクトが属する Alibaba Cloud アカウントの ID を指定します。

  • Windows：C:\LogtailData\users\ ディレクトリに移動し、<uid> という名前の空のファイルを作成します。<uid> は、プロジェクトが属する Alibaba Cloud アカウントの ID を指定します。

• 指定されたディレクトリに、プロジェクトが属する Alibaba Cloud アカウントの ID に基づいて名前が付けられたファイルが含まれている場合、ユーザー識別子は構成済みで有効です。

ステップ 7：カスタム識別子ベースのマシングループを使用している場合、カスタム識別子が構成されているかどうかを確認する

カスタム識別子ベースのマシングループを使用している場合は、指定されたディレクトリにある user_defined_id ファイルを使用して、サーバーにカスタム識別子が構成されているかどうかを確認します。

• 出力が空の場合は、user_defined_id ファイルが存在するかどうか、またはファイルにカスタム識別子が構成されているかどうかを確認する必要があります。

  説明

  user_defined_id ファイルへのパスは、オペレーティングシステムによって異なります。

  • Linux： /etc/ilogtail/user_defined_id

  • Windows： C:\LogtailData\user_defined_id

  • user_defined_id ファイルが存在しない場合は、user_defined_id という名前のファイルを作成し、マシングループのカスタム識別子をファイルに追加します。詳細については、「サーバーのカスタム識別子を構成する」をご参照ください。

  • user_defined_id ファイルにカスタム識別子が存在しない場合、またはカスタム識別子が無効な場合は、ファイルに 1 行追加し、マシングループのカスタム識別子を入力します。詳細については、「サーバーのカスタム識別子を構成する」をご参照ください。

  • user_defined_id ファイルにマシングループ用に構成したカスタム識別子が含まれている場合、カスタム識別子は構成済みで有効です。

手順 8：Logtail を再起動する

上記の手順を実行した後、Logtail を再起動する必要があります。