すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:Logtail 診断

最終更新日:Apr 26, 2025

Logtail を使用してログを収集すると、正規表現の解析エラー、ファイルパスの誤り、Shard サービス容量を超えるトラフィックなどの問題が発生する可能性があります。Simple Log Service は、Logtail 収集エラーを迅速に特定するのに役立つ診断機能を提供します。

前提条件

  • ログは Logtail を使用して収集されます。詳細については、「データ収集」をご参照ください。

  • Logtail 構成が属するプロジェクトで重要なログ収集が有効になっています。詳細については、「サービスログの有効化」をご参照ください。

背景情報

Logtail の問題を診断するには、コンソール診断と Logtail 自動診断ツールの 2 つの方法があります。

  • コンソール診断には、詳細診断と基本診断が含まれます。

    • 詳細診断(推奨):過去のものも含め、Logtail の例外の詳細を表示およびクエリするためのダッシュボードを提供します。

      重要

      詳細診断のダッシュボードは、プロジェクト内の重要なログに依存します。詳細については、「サービスログの種類」をご参照ください。

    • 基本診断:直前の 1 時間の例外に関する情報のみを提供します。

  • Logtail 自動診断ツールは Linux サーバーでのみサポートされており、ネットワーク接続チェックには curl ツールが必要です。プロセスは次のとおりです。

コンソール診断

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

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

    image

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

    image

  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 ファイル。

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 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 コンソールで関連パラメーターのエラーログを表示します。詳細については、「コンソール診断」をご参照ください。

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

一般的なパラメーター

説明

--help

ヘルプドキュメントを表示します。

--logFile [LogFileFullPath]

Logtail が LogFileFullPath パスからログを収集するかどうかを確認します。次に、インストールファイルの整合性、実行ステータス、Alibaba Cloud アカウント ID、ネットワーク接続など、Logtail の基本的なランタイム環境を確認します。

--logFileOnly [LogFileFullPath]

Logtail が LogFileFullPath パスからログを収集するかどうかのみを確認します。

--envOnly

Logtail のランタイム環境のみを確認します。

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

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

説明

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

問題

解決策

インストールファイルが見つかりません。

Logtail を再インストールします。

Logtail が実行されていません。

/etc/init.d/ilogtaild start コマンドを実行して Logtail を起動します。

複数の Logtail プロセスが存在します。

  1. /etc/init.d/ilogtaild stop コマンドを実行して Logtail を停止します。

  2. /etc/init.d/ilogtaild start コマンドを実行して Logtail を起動します。

ポート 443 が無効になっています。

ファイアウォールを構成してポート 443 を有効にします。

構成サーバーが見つかりません。

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

Logtail が Linux サーバーにインストールされていない場合は、インストールコマンドを再実行します。詳細については、「Linux サーバーへの Logtail のインストール」をご参照ください。

ユーザー構成が存在しません。

次の操作が実行されているかどうかを確認します。

  1. Logtail 構成が作成されている。

  2. サーバーがマシン グループに含まれている。

  3. Logtail 構成がマシン グループに適用されている。

指定されたログファイルが見つかりません。

Logtail 構成が有効かどうかを確認します。

指定されたログファイルが複数の Logtail 構成と一致します。

ログファイルが複数の Logtail 構成と一致する場合、Logtail はランダムに 1 つを選択します。ログファイルと一致させる Logtail 構成は 1 つだけ使用してください。