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 の収集エラーの表示：ハートビートのステータスが正常であるにもかかわらずログが収集されない場合は、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 アドレスベースのマシングループとカスタム識別子ベースのマシングループの 2 種類のマシングループを提供します。詳細については、「マシングループ」をご参照ください。

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

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

   • カスタム ID ベースのマシングループ：[マシングループステータス] リストで、前のステップで取得した 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. ilogtail_config.json ファイルを開き、設定パラメーターが正しいかを確認します。

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

      • ilogtail_config.json ファイルの起動パラメーターが以下の説明と一致する場合、それらは正しいです。

      • 起動パラメーターが正しくない場合は、以下の表に基づいて ilogtail_config.json ファイルを修正し、Logtail を再起動します。詳細については、「Logtail の再起動」をご参照ください。

        プロジェクトのリージョンに関する情報については、「サポートされているリージョン」をご参照ください。

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

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

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

2. http://<project-name>.<endpoint>。

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

     

   • <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

   システム時刻が実際の時刻と大幅にずれている場合は、次のいずれかのアクションを実行します。

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

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

Windows

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

2. デスクトップ右下のタスクバーで時刻を確認します。

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

   • システム時刻を変更できない場合は、Logtail の起動パラメーターを変更します。ilogtail_config.json ファイルに `"enable_log_time_auto_adjust": true` 設定を追加します。修正後、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 ファイルが存在するか、またはファイル内にユーザー定義の識別子が設定されているかを確認する必要があります。

  説明

  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 を再起動する必要があります。