Simple Log Service:Logtail 診断

コンソール診断

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

2. [プロジェクト] セクションで、管理するプロジェクトをクリックします。

   

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

   

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

   重要

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

   基本診断

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

   詳細診断

   [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 収集エラーの原因とその解決策を示します。