Simple Log Service:Logtail のセルフサービス診断ツール

使用上の注意

• このツールは Linux サーバーでのみ使用できます。

• ネットワーク接続を確認するために curl ツールを使用します。対象サーバーに curl ツールがインストールされていることを確認してください。

• Logtail は増分ログのみを収集します。適用された Logtail 構成がサーバーに配信された後、サーバー上のログファイルが更新されない場合、Logtail はそのファイルからログを収集しません。詳細については、「ログファイルの読み取り」をご参照ください。

• デフォルトでは、ファイルはコレクションに対して 1 つの Logtail 構成とのみ一致できます。ログを複数回収集する場合は、「ファイル内のログの複数のコピーを収集するにはどうすればよいですか？」をご参照ください。

診断手順

手順

1. Logtail がインストールされている Linux サーバーにログオンし、次のコマンドを実行して診断ツールをダウンロードします。

   wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/checkingtool.sh -O checkingtool.sh

2. 次のコマンドを実行して診断ツールを実行します。

   chmod 744 ./checkingtool.sh
   ./checkingtool.sh
   sh checkingtool.sh

3. 診断ツールを実行すると、次の情報が返されます。画面の指示に従って言語を選択します。

   [Info]:     Logtail checking tool version : 0.3.1
   [Input]:  Please choose language 请选择语言 : 
                   1. 中文. 
                   2. English. 
           語言 :

4. 次に、確認手順を選択するように求められます。

   [Input]:  please choose which type you want to check : 
                   1. MachineGroup heartbeat fail. 
                   2. MachineGroup heartbeat is ok, but log files have not been collected. 
           Type :

   • 1: マシングループを検査するには、このオプションを選択します。

   • 2: Logtail 構成を確認するには、このオプションを選択します。

   マシングループの確認

   Logtail のセルフサービス診断ツールは、次の確認を実行します。

   1. 基本情報を確認します。

      • Logtail のインストール

      • Logtail の実行ステータス

      • Secure Sockets Layer (SSL) ステータス

      • Simple Log Service へのネットワーク接続

      [Info]:     Check Logtail install files
      [Info]:     Install file: ilogtail_config.json exists.                          [ OK ]
      [Info]:     Install file: /etc/init.d/ilogtaild exists.                         [ OK ]
      [Info]:     Install file: ilogtail exists.                                      [ OK ]
      [Info]:     Bin file: /usr/local/ilogtail/ilogtail_2.0.8 exists.                [ OK ]
      [Info]:     Logtail version : 2.0.8                                             [ OK ]
      
      [Info]:     Check Logtail running status
      [Info]:     Logtail is runnings.                                                [ OK ]
      [Info]:     Check network status
      [Info]:     Logtail is using ip: 172.31.0.246
      [Info]:     Logtail is using UUID: D1BA8F5A-FA52-11EF-8935-00163E4C****
      [Info]:     Check SSL status
      Redirecting to /bin/systemctl status iptables.service
      Unit iptables.service could not be found.
      [Info]:     SSL status OK.                                                      [ OK ]
      [Info]:     Check logtail config server
      [Info]:     config server address: http://logtail.cn-hangzhou-intranet.log.aliyuncs.com
      [Info]:     Logtail config server HTTP OK                                       [ OK ]
      [Info]:     Logtail config server HTTPS OK                                      [ OK ]

   2. サーバーが Elastic Compute Service (ECS) インスタンスであり、現在のプロジェクトと同じアカウントに属しているかどうかを確認します。

      • はいの場合は、y と入力して次の手順に進みます。

      • いいえの場合は、N と入力します。診断ツールは、サーバーで構成されているユーザー識別子を返します。Alibaba Cloud アカウント ID が含まれていない場合は、ユーザー識別子を再構成します。

        [Input]:  Is your server Alibaba Cloud ECS belongs to the same account of the current SLS Project ? (y/N)n
        [Info]:     Check aliyun user id(s)
        [Info]:     aliyun user id : 198********815 .                                 [ OK ]
        
        [Input]:  Is your project owner account ID among the above IDs ? (y/N)n
        [Error]:    please configure user IDs (account IDs), this doc will help
                    [ https://www.alibabacloud.com/help/doc-detail/49007.htm ]          [ Error ]

   3. プロジェクトのリージョンが、Logtail のインストール中に選択したリージョンと一致するかどうかを確認します。

      • はいの場合は、y と入力して次の手順に進みます。

      • いいえの場合は、N と入力します。診断ツールは、Logtail を再インストールするか、プロジェクトを再作成して、プロジェクトのリージョンが Logtail のインストール中に選択したリージョンと一致するように求めます。詳細については、「Linux サーバーに Logtail をインストールする」をご参照ください。

        [Input]:  please make sure your project is in this region : { cn-hangzhou } (y/N) :n
        [Error]:    please reinstall your Logtail or recreate your project to
                    make sure your project is located in the same region with your Logt [ Error ]

   4. マシングループの IP アドレスまたはカスタム ID が、返されたメッセージに表示されているものと一致するかどうかを確認します。

      • はいの場合は、y と入力します。診断ツールはレポートを生成します。問題が解決しない場合は、出力レポートをコピーしてチケットを送信します。

      • いいえの場合は、N と入力します。診断ツールは、マシングループの IP アドレスまたはカスタム ID を修正するように求めます。詳細については、「マシングループ情報の変更」をご参照ください。

        [Input]:  please make sure your machine group's ip is same with : { 172.31.0.246 } or your machine group's userdefined-id is in : { user-defined-linux-1 } (y/N) :n
        [Error]:    please correct your machine group's ip or userdefined-id,
                    save the configuration, wait 1 minute and check again               [ Error ]

   Logtail 構成の確認

   Logtail のセルフサービス診断ツールは、次の確認を実行します。

   1. マシングループのハートビートステータスが正常であり、マシングループの IP アドレスが返されたメッセージに表示されている IP アドレスと一致することを確認します。

      • はいの場合は、y と入力して次の手順に進みます。

      • いいえの場合は、N と入力します。診断ツールは、マシングループの確認に戻るように求めます。

        [Input]:  please make sure your machine's heartbeat is ok and machine group's ip is same with : { 172.31.0.246 } (y/N) :n
        [Error]:    please rerun the script and choose type 1 to check machine group's  [ Error ]

   2. Logtail 構成がマシングループに適用されていることを確認します。

      • はいの場合は、y と入力して次の手順に進みます。確認方法の詳細については、「マシングループ構成の表示」をご参照ください。

      • いいえの場合は、N と入力します。診断ツールは、Logtail 構成を指定のマシングループに適用するように求めます。

        [Input]:  please make sure you have applied collection config to the machine group (y/N) :n
        [Error]:    please apply collection config to the machine group                 [ Error ]

   3. Logtail 構成のログファイルパスが有効かどうかを確認します。

      確認する際は、確認するログファイルのフルパスを入力します。一致するファイルがない場合は、指定したパスがファイルと一致するかどうかを確認します。

      構成が無効な場合は、Logtail 構成を変更し、約 1 分待ってからこのスクリプトを再実行して再度確認します。

      [Input]:  please input your log file's full path (eg. /var/log/nginx/access.log) : /var/log/nginx/access.log
      [Info]:     Check specific log file
      [Info]:     Check if specific log file [ /var/log/nginx/access.log ] is included by user log config.
      [Info]:     Specific log file exists.                                           [ OK ]
      [Error]:    No match config for your log file.                                  [ Error ]
      [Suggestion]:  Please check collection config is created in SLS Project/Logstore and make sure you have applied config to your machine group

   4. 問題が解決しない場合は、診断レポートをコピーしてチケットを送信します。

      [Input]:  please make sure all the check items above have passed. If the problem persists, please copy all the outputs and submit a ticket in the ticket system. : (y/N)y
      [Info]:     Check system support
      [Info]:     Check system support OK.                                            [ OK ]
      
      [Info]:     Check Logtail install files
      [Info]:     Install file: ilogtail_config.json exists.                          [ OK ]
      [Info]:     Install file: /etc/init.d/ilogtaild exists.                         [ OK ]
      [Info]:     Install file: ilogtail exists.                                      [ OK ]
      [Info]:     Bin file: /usr/local/ilogtail/ilogtail_2.0.8 exists.                [ OK ]
      [Info]:     Logtail version : 2.0.8                                             [ OK ]
      ......
      ......

クイックチェックの実行

クイックチェック中に、診断ツールはサーバーで構成されているユーザー識別子 (Alibaba Cloud アカウント ID) とマシングループのカスタム ID を返します。どちらかが欠落していても、アラートはトリガーされません。設定が構成されている場合は、ユーザー識別子またはカスタム ID が返されたメッセージと一致することを確認してください。異なる場合は、ユーザー識別子を再構成し、カスタム ID を使用してマシングループを作成します。

次のコマンドを実行してクイックチェックを実行します。

./checkingtool.sh --logFile [LogFileFullPath]

指定したログファイルがチェックに合格し、Logtail ランタイム環境が正常な場合は、Simple Log Service コンソールで関連パラメーターのエラーログを表示することをお勧めします。詳細については、「Logtail 収集エラーを表示するにはどうすればよいですか？」をご参照ください。

診断ツールの共通パラメーター

Logtail 収集例外の一般的な問題

セルフサービス診断ツールを使用して、ログ収集のエラーを特定し、解決します。次の表は、Logtail 収集エラーの一般的な原因とその解決策の概要を示しています。