Simple Log Service:Logtailの自動診断ツールを使用するにはどうすればよいですか?

診断プロセス

診断ツールをダウンロードして実行する

1. Linuxサーバーにログオンします。

2. 診断ツールのスクリプトをダウンロードします。

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

3. カールツールをインストールします。

   Logtailの自動診断ツールは、curlツールを使用してネットワーク接続を確認します。 curlツールがLinuxサーバーにインストールされていることを確認します。

4. 診断ツールを実行します。

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

   次の例のような情報が返されます。

   [Info]:     Logtail checking tool version : 0.3.0
   [Input]:  please choose which item you want to check :
                1. MachineGroup heartbeat fail.
                2. MachineGroup heartbeat is ok, but log files have not been collected.
   Item :

5. プロンプトに従って1または2を入力します。 スクリプトが実行され、選択したオプションに基づいてチェックが実行されます。

   • 1: システムは、マシングループのハートビートステータスをチェックします。 マシングループのハートビートステータスがFAILの場合、このオプションを選択します。

   • 2: システムは、Logtailがログを収集するときにエラーが発生するかどうかをチェックします。 マシングループのハートビートステータスがOKで、ログファイルが収集されていない場合は、このオプションを選択します。

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

1を入力してマシングループのハートビートステータスを確認すると、Logtailの自動診断ツールは次のチェックを実行します。

1. 基本環境が安定しているかどうかを確認します。

   • Logtailがインストールされているかどうかを確認します。

   • Logtailが実行中かどうかを確認します。

   • SSL暗号化の状態が正常かどうかを確認してください。

   • LogtailとSimple Log Service間のネットワーク接続が正常かどうかを確認します。

   [Info]:     Logtail checking tool version : 0.3.0
   [Input]:  please choose which item you want to check :
                   1. MachineGroup heartbeat fail.
                   2. MachineGroup heartbeat is ok, but log files have not been collected.
           Item : 1
   [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_0.14.2 exists.               [ OK ]
   [Info]:     Logtail version :                                                   [ OK ]
   [Info]:     Check logtail running status
   [Info]:     Logtail is runnings.                                                [ OK ]
   [Info]:     Check network status
   [Info]:     Logtail is using ip: 11.XX.XX.187
   [Info]:     Logtail is using UUID: 0DF18E97-0F2D-486F-B77F-XXXXXXXXXXXX
   [Info]:     Check SSL status
   [Info]:     SSL status OK.                                                      [ OK ]
   [Info]:     Check logtail config server
   [Info]:     config server address: http://config.sls.aliyun-inc.com
   [Info]:     Logtail config server OK                                            [ OK ]

   [エラー] メッセージが表示された場合は、プロンプトに従ってエラーを修正します。

2. サーバーが現在のAlibaba Cloudアカウントに属するElastic Compute Service (ECS) インスタンスであるかどうかを確認します。

   [Input]: Is your server non-Alibaba Cloud ECS or not belong to the same account with the current Project of Log Service ? (y/N)

   • お使いのサーバーが現在のAlibaba Cloudアカウントに属するECSインスタンスである場合、Nを入力します。

   • お使いのサーバーが、Simple Log Serviceとは異なるAlibaba Cloudアカウントに属するECSインスタンス、データセンター内のサーバー、またはサードパーティのクラウドサービスプロバイダーのサーバーの場合、yを入力します。

     yを入力すると、診断ツールはローカルで設定されたユーザー識別子に関する情報を返します。 Alibaba CloudアカウントのIDが含まれているかどうかを確認します。 Alibaba CloudアカウントのIDが含まれていない場合は、ユーザー識別子を設定します。 詳細については、「ユーザー識別子の設定」をご参照ください。

     [Input]:  Is your server non-Alibaba Cloud ECS or not belong to the same account with the current Project of Log Service ? (y/N)y
     [Info]:     Check aliyun user id(s)
     [Info]:     aliyun user id : 126XXXXXXXXXX79 .                                 [ OK ]
     [Info]:     aliyun user id : 165XXXXXXXXXX50 .                                 [ OK ]
     [Info]:     aliyun user id : 189XXXXXXXXXX57 .                                 [ OK ]
     [Input]:  Is your project owner account ID is the above IDs ? (y/N)

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

   [Input]: please make sure your project is in this region : { cn-hangzhou } (y/N) :

   リージョンが異なる場合は、Logtailを再インストールします。 詳細については、「LinuxサーバーへのLogtailのインストール」をご参照ください。

4. マシングループ内のIPアドレスまたはカスタム識別子が、返されたメッセージに表示されるIPアドレスまたはカスタム識別子と同じかどうかを確認します。

   [Input]:  please make sure your machine group's ip is same with : { 11.XX.XX.187 } or your machine group's userdefined-id is in : { XX-XXXXX } (y/N) :

   IPアドレスまたはカスタム識別子が異なる場合は、マシングループのIPアドレスまたはカスタム識別子を変更します。 詳細については、「マシングループの変更」をご参照ください。

Logtailがログを収集するときにエラーが発生するかどうかを確認する

Logtailがログを収集するときにエラーが発生するかどうかを確認するために2を入力すると、Logtailの自動診断ツールは次のチェックを実行します。

1. マシングループのIPアドレスが、返されたメッセージに表示されるIPアドレスと同じかどうかを確認します。

   [Input]:  please make sure your machine group's ip is same with : { 11.XX.XX.187 } (y/N) :

   IPアドレスが異なる場合は、マシングループ内のIPアドレスを変更します。 詳細については、「マシングループの変更」をご参照ください。

2. Logtail設定がマシングループに適用されているかどうかを確認します。

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

   マシングループにLogtail設定が適用されていない場合は、マシングループにLogtail設定を適用します。 詳細については、「マシングループへのLogtail設定の適用」をご参照ください。

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

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

   ログファイルのパスが無効な場合は、Logtail設定を変更して1分間待ちます。 次に、スクリプトを実行してチェックを繰り返します。 Logtail設定を変更する方法の詳細については、「Logtail設定の変更」をご参照ください。

   [Input]:  please input your log file's full path (eg. /var/log/nginx/access.log) :/disk2/logs/access.log
   [Info]:     Check specific log file
   [Info]:     Check if specific log file [ /disk2/logs/access.log ] is included by user config.
   [Warning]:  Specific log file doesnt exist.                                     [ Warning ]
   [Info]:     Matched config found:                                               [ OK ]
   [Info]:     [Project] -> sls-zc-xxxxxx
   [Info]:     [Logstore] -> release-xxxxxxx
   [Info]:     [LogPath] -> /disk2/logs
   [Info]:     [FilePattern] -> *.log

すべてのチェックに合格しても問題が解決しない場合は、チケットを起票してください

[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

送信する ticket スクリプトの出力をチケットに含める必要があります。

クイックチェックを実行する

一般的なLogtail収集エラー

Logtailの自動診断ツールを使用して、Logtailがログを収集するときに発生するエラーの原因を特定し、原因に基づいてエラーを修正できます。 次の表に、一般的なLogtail収集エラーの原因と関連する解決策を示します。

診断ツールの一般的なパラメータ