Simple Log Service:Logtail マシングループの問題のトラブルシューティング

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

トラブルシューティングのチェックリスト

1. ステップ 1：Logtail が実行中であることを確認する：サーバーで Logtail プロセスがアクティブかを確認します。

2. ステップ 2：マシングループの IP アドレスが Logtail の取得する IP アドレスと一致することを確認する：マシングループと Logtail の app_info.json ファイルの IP アドレスが一致しない場合、ハートビート障害の原因となることがあります。

3. 手順 3: Logtail の起動パラメーターが正しいかどうかを確認する：ilogtail_config.json ファイルで設定されているプロジェクトリージョンが正しいかどうかを確認します。

4. ステップ 4：ネットワーク接続の確認：サーバーがプロジェクトのエンドポイントに接続できることを確認します。

5. ステップ 5：Logtail サーバーのシステム時刻の確認：システム時刻が実際の時刻と大幅に異なる場合は、修正します。

6. ステップ 6：クロスアカウント収集のためのユーザー識別子の確認：このステップは、サーバーが ECS インスタンスではない場合、またはインスタンスとプロジェクトが異なる Alibaba Cloud アカウントに属する場合に必要です。

7. ステップ 7：カスタム識別子ベースのマシングループのカスタム識別子の確認：カスタム識別子ベースのマシングループを使用する場合は、サーバーにカスタム識別子が設定されていることを確認します。

8. ステップ 8：Logtail の再起動：変更を加えた後、Logtail を再起動して変更を適用します。

次のステップ

Logtail の収集エラーの表示：ハートビートのステータスが OK であるにもかかわらずログが収集されない場合は、Logtail のエラーメッセージを確認して、トラブルシューティングを続行します。

ステップ 1：Logtail のステータスの確認

1. app_info.json ファイルから ip フィールドの値を取得してください。

   以下の表に、さまざまなオペレーティングシステムでのこのファイルのデフォルトパスを示します。

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

   Logtail は、収集した IP アドレスを app_info.json ファイルの 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. マシングループが、Logtail が取得した IP アドレスを使用していることを確認します。

   Simple Log Service が提供するマシン グループには、IP アドレスベースのマシン グループとカスタム ID ベースのマシン グループの 2 種類があります。 詳細については、「マシン グループ」をご参照ください。

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

     IP アドレスが含まれていない場合、まず、サーバーの正しい IP アドレスを確認します。[IP アドレス] リストのアドレスが正しくない場合は、マシングループ設定で更新します。前の手順で Logtail によって取得された IP アドレスが間違っている場合は、「Logtail の起動パラメーターを設定する」で説明されているように working_ip パラメーターを変更し、Logtail を再起動します。修正後、マシンのハートビートを監視します。ステータスが正常になった場合、問題は解決です。

   • カスタム識別子ベースのマシングループ：[マシングループステータス] リストで、前の手順で取得した IP アドレスを確認します。[ハートビート] のステータスが [OK] であれば、問題は解決です。

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

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

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

   以下の表に、さまざまなオペレーティングシステムでのこのファイルのデフォルトパスを示します。

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

   1. Open the ilogtail_config.json file and check if the configuration parameters are correct.

      {
        "config_server_address" : "http://logtail.<config_region>.log.aliyuncs.com",
        "data_server_list" :
        [
          {
            "cluster" : "<project_region>",
            "endpoint" : "<endpoint>"
          }
        ],
        ...
      }

      • If the startup parameters in the ilogtail_config.json file match the following descriptions, they are correct.

      • If the startup parameters are incorrect, modify the ilogtail_config.json file based on the following table and then restart Logtail. For more information, see Restart Logtail.

        For information about project regions, see Supported regions.

        Scenario	Network type	<config_region>	<endpoint>
        The server is an ECS instance, and it is in the same region as the project.	Alibaba Cloud internal network	<project_region>-intranet	<project_region>-intranet.log.aliyuncs.com
        Other scenarios	Internet	<project_region>	<project_region>.log.aliyuncs.com
        	transfer acceleration		log-global.aliyuncs.com

データのアップロードを成功させるには、Logtail サーバーが以下のアドレスに接続できる必要があります。

1. ilogtail_config.json ファイルの config_server_address フィールドで指定されたアドレスと、その HTTPS バージョン。

2. http://<プロジェクト名>.<エンドポイント>。

   • プロジェクト名とリージョンは、以下の図に示すように確認できます。

     

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

3. http://ali-<project-region>-sls-admin.<endpoint> であり、<endpoint> は 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 を再起動します。 詳細については、「Logtail を再起動する」をご参照ください。 ilogtail_config.json ファイルのパスについては、「手順 3: Logtail の起動パラメーターが正しいかどうかを確認する」をご参照ください。

Windows

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

2. デスクトップの右下にあるタスクバーの時刻を確認してください。

   • システム時刻を正しい時刻に調整します。

   • システム時刻を変更できない場合は、Logtail の起動パラメーターを変更します。"enable_log_time_auto_adjust": true 設定を ilogtail_config.json ファイルに追加してください。変更後、Logtail を再起動してください。詳細については、「Logtail の再起動」をご参照ください。ilogtail_config.json ファイルのパスについては、「ステップ 3：起動パラメーターの確認」をご参照ください。

ステップ 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 ファイルの有無、およびそのファイルにユーザー定義 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 ファイルに、マシングループに設定したカスタム識別子がすでに含まれている場合、設定は正しいです。

ステップ 8：Logtail の再起動

これらの変更が完了したら、Logtail を再起動してください。

よくある質問