Simple Log Service:Logtail 診断

コンソール診断

1. Simple Log Service コンソール にログインします。

2. プロジェクト セクションで、目的のプロジェクトをクリックします。

   

3. [ログストレージ] > [ログストア] タブで、ターゲットのログストアにカーソルを合わせて アイコンをクリックします。

   

4. 診断情報を表示します。

   重要

   詳細診断を使用するには、重要なログ収集が有効になっていることを確認してください。 詳細については、「重要なログ」をご参照ください。

   基本診断

   [ログ収集エラー] パネルには、ログストアのすべての Logtail 収集エラーが表示されます。 エラーコードをクリックすると、エラーの詳細が表示されます。 詳細については、「Simple Log Service におけるデータ収集の一般的なエラーの種類」をご参照ください。

   詳細診断

   [LoongCollector/Logtail 例外監視] ページで、アクティブな Logtail 数やすべてのエラーメッセージなどの情報を表示します。 詳細については、「データレポートの表示」および「Simple Log Service におけるデータ収集の一般的なエラーの種類」をご参照ください。

5. 問題を解決した後、残りのエラーを確認します。 履歴エラーは期限切れになるまで表示されます。 これらは無視して、以前のエラーを修正した後に新しいエラーのみを確認できます。 Logtail は 10 分ごとにエラーを報告します。

   説明

   解析エラーのために破棄された完全なログを表示するには、Logtail サーバーまたはコンテナにアクセスして、操作ログを確認します。 これらのログは次のパスに保存されます。

   • サーバー シナリオ：Logtail がインストールされているサーバー上の /usr/local/ilogtail/ilogtail.LOG ファイル内。

   • コンテナ シナリオ：Logtail がインストールされているコンテナ内の /usr/local/ilogtail/ilogtail.LOG ファイル内。

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 Please select language : 
                   1. Chinese. 
                   2. English. 
           Language :

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：マシン グループのハートビート ステータスは正常だが、ログ ファイルが収集されていない場合は、このオプションを選択します。

   マシン グループのハートビート ステータスの確認

   オプション 1 を選択すると、ツールは次のチェックを実行します。

   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. サーバーが Alibaba Cloud ECS インスタンスであり、現在のプロジェクトと同じアカウントに属しているかどうかを確認します。

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

      • それ以外の場合は、N と入力します。 ツールはローカルに設定されたユーザー識別子情報を出力します。 Alibaba Cloud アカウント ID が含まれていない場合は、「ユーザー識別子の再設定」をご参照ください。

        [Input]:  Is your server Alibaba Cloud ECS and belong 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 が、返されたメッセージの 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 がログを収集するときにエラーが発生するかどうかを確認する

   オプション 2 を選択すると、ツールは次のチェックを実行します。

   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 設定のログ ファイル パスが有効かどうかを確認します。

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

      設定が正しくない場合は、「変更する」を行い、約 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 ]
      ......
      ......

クイック チェック

収集の失敗は、多くの場合、ユーザー識別子が正しくないことが原因です。 Logtail クライアントで設定されている Alibaba Cloud アカウント ID とカスタム ユーザー識別子をすぐに確認して出力します。 これらが欠落している場合は、アラートは発生しません。 設定されている場合は、設定と一致していることを確認します。 それ以外の場合は、「マシン グループ」を参照して再設定します。

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

./checkingtool.sh --logFile [LogFileFullPath]

指定したログ ファイルがチェックに合格し、Logtail ランタイム環境が正常な場合は、Simple Log Service コンソールで関連パラメーターのエラー ログを表示します。 詳細については、「コンソール診断」をご参照ください。

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

Logtail 収集に関する一般的な問題

次の表に、一般的な Logtail 収集エラーの原因とその解決策を示します。