すべてのプロダクト
Search

このプロダクト

    Simple Log Service:LoongCollector のランタイムステータスの診断と監視

    ドキュメントセンター

    Simple Log Service:LoongCollector のランタイムステータスの診断と監視

    最終更新日:Aug 27, 2026

    Simple Log Service (SLS) は、正規表現の解析失敗、不正なファイルパス、シャード容量を超えるトラフィックなどの収集エラーを特定するための診断機能を提供します。また、組み込みのアラートルールを使用してコレクターをリアルタイムで監視し、DingTalk や他のチャネルを通じて通知を受け取ることもできます。

    前提条件

    • コレクターがログを収集するように設定されていること。 詳細については、「ホストからテキストログを収集する」をご参照ください。

    • 宛先プロジェクトで重要なログを有効にする

      必要なサービスログを有効にします。 詳細については、「サービスログの有効化」をご参照ください。

      1. Simple Log Service コンソールにログオンします。プロジェクトリストで、目的のプロジェクトをクリックします。プロジェクト詳細ページで、サービスログ タブをクリックし、次に 操作ログを有効にする をクリックします。

      2. 「詳細ログの有効化」パネルで、重要ログ と ジョブ実行ログ を選択し、OK をクリックします。

        • log-service-{user-id}-{region} という名前のプロジェクトが、宛先リージョンに自動的に作成されます。

        • 重要なログとジョブ運用ログの取り込み、ストレージ、クエリ、分析は無料です。 データ変換とデータ転送は、従量課金で請求されます。

    ランタイム問題の診断

    利用可能な診断モードは 2 つあります：

    • 詳細診断 (推奨)： コレクター関連の例外を含む例外ダッシュボードを表示し、より長い期間のクエリをサポートします。

    • 基本診断： 過去 1 時間の収集例外を表示します。

    ユースケース

    • コレクターの異常なステータス： ハートビートの失敗、非アクティブなプロセス、または SSL 証明書のエラー。

    • ログ収集の失敗： ログが収集されない、高レイテンシー、または正規表現の不一致などの解析エラー。

    • 設定エラー： 不正なファイルパス、マシン グループ IP の不一致、またはクロスアカウント権限の問題。

    • パフォーマンスのボトルネック： 収集レートがデフォルトの上限 (20 MB/s) に近いかそれを超え、ログがドロップされる。

    • コンテナログ収集の問題： 頻繁な Pod の再起動や急激なログローテーションによる不完全な収集。

    • プラグインとカスタム収集の問題： カスタムプラグインの失敗 (例: Grok 解析) や HTTP データソースの収集エラー。

    • データの信頼性の問題： 非アクティブな LoongCollector や過度に速いログローテーションによるログの損失。

    • 収集設定パラメーターの変更が必要： 複数行のマッチング条件などの解析パラメーターは、収集設定リストで直接編集できません。 その設定の変更フローを開き、ログ解析ステップで変更する必要があります。

    • 1 つの設定で複数のパスを収集： 1 つの収集設定では、1 つのログパスとファイル名パターンのみがサポートされます。 1 つの設定で複数の異なるパスはサポートされていません。 パスごとに個別の収集設定を作成し、それらの設定を同じマシン グループに適用する必要があります。

    • API または Terraform を介して収集設定を作成する際にリクエスト本文の検証が失敗する： 作成リクエストが PostBodyInvalid のようなリクエスト本文の検証エラーを返す場合、inputDetail のすべてのフィールドが存在し、正しく型指定されていることを確認してください。 特に、localStorage はブール値 (true または false) である必要があります。

    • 他のログ収集ソフトウェアとの共存： LoongCollector が同じサーバー上で Filebeat などの他の収集ソフトウェアと並行して実行される場合の、ポート使用、プロセス競合、または重複収集のトラブルシューティング。

    • どの収集方法でログが生成されたかが不明： LogStore 内のログの出所が不明な場合、それらが LoongCollector/Logtail によって収集されたものか、アプリケーションによって SDK を介して直接書き込まれたものかを確認してください。 サーバー上に一致する収集設定が存在するか、またアプリケーションコードに SDK の書き込みロジックが含まれているかを確認してください。

    • ターゲットデータ型がサポートされている収集範囲外： アプリケーションパフォーマンスメトリクスや .NET アプリケーションメトリクスなどのターゲットオブジェクトが、LoongCollector がサポートする収集タイプであるかを確認し、サポートされていないターゲットが収集の失敗と誤認されないようにしてください。

    • コンテナの stdin または stdout ログが収集されない： ACK クラスター内のコンテナの stdin および stdout ログが収集されない場合のトラブルシューティング。

    • SDK を介して直接書き込む際のメモリバックログまたは書き込みスロットリング： アプリケーションが Java SDK またはプロデューサーを介してログを直接書き込み、メモリが増え続け、データがバックアップされるか、書き込みがスロットリングされる場合、LogStore の書き込みクォータとアプリケーション側のログ生成レートと合わせてトラブルシューティングを行ってください。

    手順

    1. Simple Log Service コンソールにログインします。 プロジェクトリストで、宛先プロジェクトをクリックします。

    2. image [ログストレージ] をクリックします。 LogStore リストで、ターゲット LogStore にカーソルを合わせ、Logtail configuration management アイコンをクリックします。

    3. 診断 (Advanced Edition) または 診断 (Basic Edition) をクリックして、診断情報を表示します。

    4. 診断結果を表示します。

      基本診断

      （ログ収集エラー） パネルには、LogStore のすべての LoongCollector 収集エラーが一覧表示されます。 エラーコードをクリックすると、詳細を表示できます。 一般的なデータ収集エラー。

      詳細診断

      [LoongCollector/Logtail 例外モニタリング] ページには、[アクティブな収集エージェント数] や [完全なエラー情報] などのメトリックが表示されます。ダッシュボードの詳細については、「データレポートの表示」をご参照ください。エラーコードについては、「一般的なデータ収集エラー」をご参照ください。

    5. 問題を解決した後、新しいエラーがないか確認してください。 過去のエラーは期限切れになるまで表示されたままになりますが、これらは無視し、新しいエラーが表示されないことを確認してください。 LoongCollector は 10 分ごとにエラーを報告します。

      解析の失敗によりドロップされた完全なログを表示するには、LoongCollector のランタイムログを確認してください：
      ホストの場合： サーバー上の /usr/local/ilogtail/loongcollector.LOG ファイル。
      コンテナの場合： コンテナ内の /usr/local/ilogtail/loongcollector.LOG ファイル。

    ランタイムステータスの監視

    SLS は、コレクターをリアルタイムで監視するための組み込みのアラートポリシーを提供します：

    • コレクターのハートビートの監視

      internal-diagnostic_log LogStore で __topic__:logtail_status を持つログをクエリし、正常なハートビートを持つマシンの数をカウントします。ハートビート数が期待値を下回ったときにトリガーされるアラートルールを設定することで、ダウンしているか、ネットワークに問題があるマシンを特定できます。

    • 収集例外のアラート設定

      __topic__: logtail_alarm クエリを実行して、読み取り不能なファイル、権限不足、解析の失敗など、15 分以内に発生した例外を分析します。これにより、設定の問題を特定して修正し、ログの損失を防ぐことができます。

    • パフォーマンスボトルネックに関する警告の受信

      Logtail 例外監視ダッシュボードを使用して、アクティブな LoongCollector の数、再起動履歴、およびエラーメッセージを表示します。 ランタイムステータスとリソース使用量 (CPU、メモリ) を監視して、パフォーマンスのボトルネックや異常な再起動を特定します。

    • 集中ログ収集の監視

      LoongCollector ファイル収集監視ダッシュボードを使用して、収集されたファイル数、平均レイテンシー、および解析失敗率を追跡します。 複数アカウントまたは複数リージョンのシナリオにわたるログ収集ステータスを集中管理します。

    手順

    1. アラートステータスが変更されたときに通知を送信する方法を定義するアクションポリシーを設定します。

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

      2. プロジェクトリストで、重要なログを有効にしたプロジェクトをクリックします。

      3. 左側のナビゲーションペインで、[imageアラート] をクリックします。アラートセンター ページで、[通知管理] > アクションポリシー を選択します。

      4. アクションポリシーリストで、sls.app.logtail.builtin アクションポリシーを見つけ、アクション 列の 変更 をクリックします。

      5. [アクションポリシーの編集] ダイアログボックスで、必要に応じて 通知チャネル を選択して設定します。次に、確認 をクリックします。

    2. LoongCollector のランタイムステータスが指定されたしきい値を満たしたときにトリガーされるアラートルールを作成します。

      1. アラートセンター ページで、アラートルール タブをクリックし、次に アラートの作成 の横にある image アイコンをクリックします。

      2. [テンプレートから作成] をクリックします。[テンプレートから作成] パネルで、すべてのテンプレートの下にある [Logtail 障害監視] をクリックし、次に目的のカードをクリックします。

      3. アラートの作成 パネルで設定を確認します。 組み込みのアラートルールには、プリセットパラメーターが含まれています。 OK をクリックします。 アラートルールを作成する。