tencent cloud

Cloud Log Service

LogListenerの制限事項

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:07:52
AI翻訳
本文では、LogListenerがデータを収集する際の、ファイル収集、設定、リソース、パフォーマンス、エラー処理などにおける機能と制限事項、および関連する使用方法について説明します。

ファイル収集の制限事項

プロジェクト
能力と制限
ファイルエンコーディング
UTF8、GBK形式のエンコードをサポートします。
注意:
GBKエンコーディング形式には、LogListener 2.6.2以降が必要です。
シンボリックリンク
サポートします。
1件あたりのログサイズ
1行のログサイズは1MBに制限されています。ログが1MBを超えた場合、切り捨てられ、先頭の1MBのみが保持されます。
複数行ログは行頭の正規表現に基づいて分割された後(先頭行を判定する際、\\n の前のデータを読み取って判定します)、1本のログの最大サイズは2MBに制限されます。ログが2MBを超えた場合、切り捨てられ、先頭の2MBのみが保持されます。
正規表現
正規表現タイプはPerl互換正規表現をサポートします。
初回ログ収集動作
LogListenerは全量収集/増分収集戦略をサポートします:
全量収集:LogListenerを初めてインストールして起動した後、条件を満たすすべてのログが収集されます。これには、すでに書き込みが行われていないファイルも含まれます。
増分収集:LogListenerを初めてインストールして起動した後、既存ファイルは最新の位置から収集が開始されます。
注意:
増分/全量収集には、LogListener 2.6.2以降が必要です。
ログファイルローテーション
サポートします。(ローテーション後のファイル名が、収集ワイルドカードパスに覆われないようにすることを推奨します)
注意:
ファイルローテーション後60秒以内に、新規ログがローテーション後のログファイルに書き込まれない場合、ローテーション後のログファイルは収集されなくなります。それ以外の場合は、ローテーション後のログファイルが継続的に収集されます。
ログ解析失敗時の収集動作
解析失敗アップロード機能を有効にすることを推奨します。有効にすると、解析に失敗したログは単行全文形式でプリセットインデックスにアップロードされます。無効の場合、解析失敗ログは破棄されます。
ファイルオープン動作
LogListenerは、収集時にファイルを読み取る際に開き、読み取り完了後に閉じます。
フィルタールール
単一・複数行の全文収集では、最大1つのフィルタリングルールを設定できます。
区切り文字、正規表現抽出モード、JSON形式では、最大5つのフィルタリングルールを設定できます。
Keyフィールド長
区切り文字、正規表現抽出モードのKeyフィールド長は最大128Byteです。
Key-Valueグループ数
すべての解析モードにおいて、抽出されるKey-Valueグループの数は最大1000個です。超過分は破棄されます。
LogListenerの最大接続数
LogListenerの最大接続数制限:1024。
メモリ使用量
LogListenerのメモリ使用量は、通常の場合最大50MBです。
CPU使用率
LogListenerのCPU使用率は、5MB/sのログ量において、業務プロセス合計でシングルコアの20%を超えません。
収集設定の反映遅延
収集設定を更新した後、反映までに1分の遅延が発生します。
ログファイル
LogListenerが収集対象とするログファイルのサイズは500MB未満を推奨します。

Checkpoint管理

プロジェクト
能力と制限
Checkpoint の保存場所
LogListener < 3.4.0:保存パスはデフォルトでLogListenerインストールディレクトリ配下のdataディレクトリです。LogListener設定ファイル内のcheckpoint_cache_fileパラメータで変更できます。
LogListener ≥ 3.4.0:保存パスはLogListenerインストールディレクトリ配下のdata/checkpointディレクトリに固定されており、設定パラメータによる変更はサポートされていません。
Checkpoint 保存ポリシー
LogListenerには2つのcheckpointメタデータが保存されています。
1つはアップロード済みのチェックポイント情報のみを記録し、リアルタイムでディスクに永続化します。
1つは完了済みチェックポイント情報と収集済みだが未完了のチェックポイント情報を同時に記録し、定期的にディスクへ永続化します。プログラム終了時にも優先的に永続化が行われます。

リソースとパフォーマンスの制限事項

プロジェクト
能力と制限
デフォルトのCPUコア数制限。
LogListenerはシングルコアでのみ動作します。
デフォルトのCPUリソース制限。
LogListenerはデフォルトでCPUリソースを制限していません。制限が必要な場合は、LogListener設定ガイドを参照し、LogListener設定ファイルのcpu_usage_thresで最大CPU使用率を変更してください。現在のLogListenerの実装アーキテクチャでは、CPUリソースを制限していない場合、単一コアのCPU使用率は最大で約110%に達する可能性があります(業務スレッド最大100%、管理スレッド約10%)。
デフォルトのスレッド数制限。
LogListener 2.x.xバージョンはシングルスレッドでのみ動作します。LogListener 3.x.xバージョンはマルチスレッドに対応しています。
デフォルトのメモリリソース制限。
LogListenerのデフォルトメモリ閾値は2Gに設定されています。制限が必要な場合は、LogListener設定ガイドを参照し、LogListener設定ファイル内の設定を変更してください。
max_memで最大メモリ使用量を変更します。300M以上を推奨します。
デフォルトの帯域幅リソース制限。
LogListenerはデフォルトで帯域幅リソースを制限していません。制限が必要な場合は、LogListener設定ガイドを参照し、LogListener設定ファイルのmax_send_rateを変更して、プログラムが使用するネットワーク帯域幅を制限してください。
リソース超過時の処理ポリシー。
LogListenerが関連するCPUおよびメモリリソースを最大制限を超えて5分以上占有した場合、収集プログラムは強制的に自動再起動されます。
ログ圧縮
収集ログはデフォルトで圧縮後にアップロードされます。圧縮が不要な場合は、LogListener設定ガイドを参照し、LogListener設定ファイルのrequest_compressionを変更して圧縮アップロードを無効にしてください。
監視対象ディレクトリ数
デフォルトの最大監視ディレクトリ数は5000です。これを超えると、収集に失敗する可能性があります。
監視対象ファイル数
推奨最大監視ファイル数は10000です。これを超えると、収集に失敗する可能性があります。
監視対象イベント数
Pollingモードでは、推奨最大イベント数は10000です。これを超えると、収集に失敗する可能性があります。

エラー処理

プロジェクト
能力と制限
ネットワークエラー処理
特別な処理が必要な異常(ログトピックの削除など)を除き、その他のエラーはすべて再試行されます(ネットワーク異常、タイムアウト、頻度制御、残高不足など)。
タイムアウト最大再試行時間
データの送信が1時間以上継続して失敗した場合、そのデータは破棄されます。
デフォルトの動作は間隔を空けた再試行であり、再試行間隔は徐々に長くなり、最終的にタイムアウト最大試行時間を超えます。
再試行回数
loglistener.conf設定ファイルで設定できます。デフォルトでは設定されません。この場合、デフォルトでは最大再試行時間を超えるまで再試行を続け、その後破棄します。
再試行回数を設定した場合、再試行回数に従って再試行し、最大回数を超えると破棄します。
改行文字の欠落
収集時に、単一ログの末尾に改行文字がない場合、収集エージェントは5分間待機します。5分以内に改行文字が検出されない場合、自動的に改行文字を補完し、そのまま収集を継続します。

ファイル収集ルール

プロジェクト
能力と制限
ログアップロードポリシー
LogListenerは同一ファイルのログを自動的に集約してアップロードします。集約条件は、10000件のログ、ログ集合の合計サイズが1Mに達する、またはログ収集時間が3秒を超える、のいずれかの条件を満たすとアップロード動作がトリガーされます。
ファイル収集の処理ポリシー
単一の対象ファイル(収集パスがマッチする1つのファイル)は、1つのログトピックへのログアップロードのみをサポートします。複数のtopicの収集パスが同じファイルをカバーすることはサポートされません。1つのファイルを複数のログトピックにアップロードする場合は、シンボリックリンクを使用して行うことができます。同じ対象ファイルに対して複数のシンボリックリンクを作成し、異なるログトピックが異なるシンボリックリンクを収集します。
ログ収集遅延
リアルタイム収集の場合、1分以内にデータの収集、転送、ストレージへの書き込みが完了し、コンソールで検索可能な状態になります。
ログの生成量が非常に多い場合、または収集プログラムが使用するリソースを小さく制限している場合、一定の収集遅延が発生します。

ログトピック関連ルール

プロジェクト
能力と制限
収集設定数の制限
1つのログトピックに関連付けられる収集設定の数の上限は100個です。

マシングループ関連ルール

プロジェクト
能力と制限
マシングループのロジック
現在、マシングループは2種類に分かれています。この2種類の使用方法は互いに独立しており、互換性がありません。混在して使用した場合、収集マシンは正しい収集設定を取得できず、収集が行われない現象が発生します。
IPマシングループの場合、マシンIPをコンソール上で手動でマシングループに追加する必要があります。対応するマシン上のloglistener.confのgroup_labelは空である必要があります。
マシン識別子タイプのマシングループ:コンソールでマシン識別子を設定し、対応するマシン上のloglistener.confのgroup_labelを同じマシン識別子に設定する必要があります。
マシングループとログトピックの関係
1つのログトピックには、複数のマシングループをバインドできます。
1つのマシングループは、複数のログトピックにバインドできます。
マシングループと収集マシンの関係
1台の収集マシンは複数のマシングループに関連付けることができ、関連付けるマシングループの数に制限はありません。
マシン識別子の制限
1つのマシン識別子の最大長は128文字です。
1つのマシン識別子タイプのマシングループには、デフォルトで最大50個のマシン識別子を設定できます。クォータを引き上げる必要がある場合は、申請を提出して調整できます。

収集パス/収集拒否リストの使用方法

プロジェクト
能力と制限
収集拒否リスト
この機能は、収集パス配下で収集を無視するコンテンツを指定するために使用されます。現在、収集拒否リストは2種類に分かれています。
ファイルパスパターン:収集パス配下で、収集を無視する必要がある完全なファイルパスです。ワイルドカードパターンをサポートします。
ディレクトリパスパターン:収集パス配下で、収集を無視する必要があるディレクトリプレフィックスです。ワイルドカードパターンをサポートします。
注意:
FILE/PATHモードは同時に使用できます。
収集拒否リストは収集パス配下で除外を行うものです。そのため、ファイルパスパターンであっても、ディレクトリパスパターンであっても、指定するパスは収集パスのサブセットである必要があります。


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック