LogListener設定ガイド
ダウンロード
フォーカスモード
フォントサイズ
インストールパス
/opt/loglistener/を例に、/opt/loglistener/confパスで以下のコマンドを実行して、LogListener設定ファイルを表示および設定できます。vim loglistener.yaml
説明：
新アーキテクチャのLogListener（バージョン≥3.4.0）では、キー内容は設定ファイルに公開されません。キー内容を置き換える必要がある場合や一時キーを使用する場合は、以下のコマンドを使用してください：
キーの置き換え（非一時キーシナリオ）：
./loglistener ak -a update -s ${secret_id} -k ${secret_key}
一時キーを置き換えます：
./loglistener ak -a update -u -s ${secret_id} -k ${secret_key} -t ${token}
パラメータの説明
パラメータ名 | パラメータ説明 | デフォルト値 | 値の範囲 |
agent_ip | デフォルトでは自動的にネットワークインターフェースのIPを取得します。LogListenerの初期化時にIPを指定した場合は、初期化時に指定したIPとなります。 | - | |
agent_labels | マシン識別子です。設定後、マシングループは設定されたマシン識別子を介してこのマシンに関連付けることができます。詳細はマシングループを参照してください。複数の識別子を設定できます。yaml形式では「-」による改行区切りをサポートしています。右図に示すとおりです。 注意： マシン識別子が設定されたマシンは、マシン識別子によってのみマシングループに関連付けることができ、IPによって関連付けることはできません。 | デフォルト値はありません。初期化時に指定するか、または設定ファイルで変更します。複数設定する場合は下図を参照してください。  | - |
dynamic_instance_id | インスタンスIDを動的に生成/更新するかどうかです。 | false | true、false |
dynamic_ip | 動的IP自動検出機能を有効にするかどうかを制御します。入力をtrueにすると、IP変更時にリアルタイムで更新できます（マシン識別子のシナリオのみ対応し、IPアドレス関連付けのシナリオではこの機能はサポートされません）。 | false | true、false |
load_server_config | サービスの収集設定を読み込みます。 | true | true、false |
load_user_config | ローカル収集設定を読み込みます。 | false | true、false |
memory_limit | 最大メモリ使用量（Bytes）です。 | 314572800 | 0より大きい整数 |
cpu_limit | 最大CPU使用量です。単位は単一CPUコアの1000分の1（mCPU）です。 例えば、500は0.5コアを表します。つまり、単一CPUコア使用率の50%です。 | 1000 | 1 - 1000 |
max_dir | 最大監視ディレクトリ数です。 | 5000 | 0より大きい整数 |
max_file | 最大監視ファイル数です。 | 15000 | 0より大きい整数 |
enable_polling_discovery | ローテーション方式でログファイルを検出するかどうかです。 | true | true、false |
enable_inotify_discovery | Inotify方式でログファイルを検出するかどうかです。 | true | true、false |
max_read_size | 1回のログファイル読み取りにおける最大バイト数（Bytes）です。 | 1048576 | 1048576 - 8388608 |
timeout | ログをCLSに送信する際のネットワークリクエストタイムアウト時間（秒）です。 | 60 | 0より大きい整数 |
port | ポートです。デフォルトは80です。https暗号化転送を使用する場合は、443を指定してください。 | 80 | 80、443 |
max_send_retry_times | 日志发送失败后的最大重试次数。 | 10800 | 0より大きい整数 |
endpoint | CLS接続ドメイン名です。CLSが所在するリージョンに対応します。 | ap-guangzhou.cls.tencentyun.com | CLS Endpoint |
concurrency_count | ログを同時送信する際の最大並列数です。 | 2000 | 0より大きい整数 |
switch_endpoint | 予備ドメイン名を有効にします。デフォルトはfalseです。trueを入力した場合、メインドメイン名のネットワークに障害が発生すると予備ドメイン名が使用されます。 trueを入力した後、設定ファイルにbackup_endpointsフィールド（予備ドメイン名）が追加され、システムが自動的に予備ドメイン名を入力します。 ユーザーが内部ネットワークアクセスとして初期化した場合、backup_endpointsは自動的にパブリックネットワークとして設定されます。 ユーザーがパブリックネットワークアクセスとして初期化した場合、backup_endpointsは自動的に内部ネットワークとして設定されます。 | false | true、false |
backup_endpoints | 予備ドメイン名の内容です。 | - | - |
compress | 圧縮方式です。デフォルトはlz4（デフォルト）で、zstdを選択できます。 注意： このパラメータはホットアップデートをサポートしていません。変更後、systemctl restart loglistenerコマンドを実行してコレクターを再起動してください。 | lz4 | lz4、zstd |
インストールパス
/usr/local/を例に、/usr/local/loglistener/etcパスで以下のコマンドを実行して、LogListener設定ファイルを表示および設定できます。vim loglistener.conf
パラメータの説明
パラメータ名 | パラメータ説明 | デフォルト値 | 値の範囲 |
proxy_host | 対象CLSサービスのアクセスドメイン名です。 | LogListener初期化時に地域（-region）および内外ネットワークアクセス方式（-network）を指定した場合、ここには指定地域に対応するCLS内部ネットワークまたは外部ネットワークドメインがデフォルトで設定されます。 LogListener初期化時に地域（-region）を指定せず、ドメイン（-domain）を指定した場合、ここにはデフォルトでドメインが設定されます。 | 利用可能なリージョンの設定を参照してください。 |
secret_id | APIキーIDです。 | LogListener初期化時に指定されたキーIDです。 | APIキー管理に移動してキーIDを取得してください。 |
secret_key | APIキーKeyです。 | LogListener初期化時に指定されたキーKeyです。 | APIキー管理に移動してキーKeyを取得してください。 |
encryption | LogListenerの初期化時にencryption（キー情報を暗号化して保存するかどうか）をtrueに指定した場合、ここはtrueになります。逆の場合はfalseになります。 | true、false | |
group_ip | デフォルトでは自動的にネットワークインターフェースのIPを取得します。LogListenerの初期化時にIPを指定した場合は、初期化時に指定したIPとなります。 | - | |
group_label | 注意： マシン識別子が設定されたマシンは、マシン識別子によってのみマシングループに関連付けることができ、IPによって関連付けることはできません。 | - | - |
max_connection | 同一時刻における、ログアップロードリクエストの最大並列数です。 | 10 | 0より大きい整数 |
max_mem | 最大メモリ使用量（Bytes）です。 | 2097152000 | 0より大きい整数 |
max_dir | 最大監視ディレクトリ数です。この設定は、LogListener v2.8.8以降のバージョンでのみサポートされます。 | 5000 | 0より大きい整数 |
max_file | 最大監視ファイル数です。 | 15000 | 0より大きい整数 |
cpu_usage_thres | 単一コアの最大CPU使用率（%）です。0は無制限を表します。 | 0 | 1 - 100 |
max_send_rate | 最大アップロード速度（Bytes/s）です。0は無制限を表します。 | 0 | 0より大きい整数 |
max_depth | 最大収集ディレクトリ深度です。この設定は、に対する下探深度を制御できます。0は下探しないことを表します。 | 10 | 0より大きい整数 |
request_compression | ログを圧縮してアップロードするかどうかです。 | true | true、false |
replace_special_characters | 収集したログに特殊文字が含まれる場合、スペースに置き換えるかどうかです。この設定は、LogListener v2.8.8以降のバージョンでのみサポートされます。 | false | true、false |
memory_tight_mode | メモリ節約モードを有効にするかどうかです。 | false | true、false |
max_send_retrys | 日志上传请求失败时、最大重试次数。0代表不断尝试。 | 0 | 0より大きい整数 |
max_send_retry_time | ログアップロードリクエストが失敗して再試行する場合の最大タイムアウト時間（s）です。 | 10800 | 0より大きい整数 |
send_retry_period | ログアップロードリクエストが失敗した場合の最大再試行間隔（s）です。 | 3 | 0より大きい整数 |
dynamic_config | 収集設定を動的に更新するかどうかです。パラメータがtrueの場合、収集設定パラメータを更新する際にコレクターの再起動は不要です。 | false（LogListener 3.4.0以前のバージョン） true（LogListener 3.4.0以降のバージョン） | true、false |
設定変更後、以下のコマンドを実行してLogListenerを再起動し、設定変更を有効にします。（dynamic_configがtrueの場合、以下の手順を実行する必要はありません）
LogListener 2.8.3以降、かつオペレーティングシステムにsystemdが搭載されている場合に適用されます。
systemctl restart loglistenerd
/etc/init.d/loglistenerd checkを実行して、再起動が成功したかどうかを確認します：
LogListener 2.8.3以前、またはLogListener 2.8.3以降でオペレーティングシステムにsystemdがない場合に適用されます。
/etc/init.d/loglistenerd restart
/etc/init.d/loglistenerd checkを実行して、再起動が成功したかどうかを確認します：
Windowsの場合、インストールパス
C:\\Program Files (x86)\\Tencent\\LogListener を例にすると、インストールディレクトリで loglistener.yaml を見つけ、任意のエディタで開きます。パラメータの説明
パラメータ名 | パラメータ説明 | デフォルト値 | 値の範囲 |
host | 対象CLSサービスのアクセスドメイン名です。 | LogListener初期化時に地域（--region）および内外ネットワークアクセス方式（--network）を指定した場合、ここには指定地域に対応するCLS内部ネットワークまたは外部ネットワークドメインがデフォルトで設定されます。 LogListener初期化時に地域（--region）を指定せず、ドメイン（--endpoint）を指定した場合、ここにはデフォルトでドメインが設定されます。 | 利用可能なリージョンの設定を参照してください。 |
agent_ip | デフォルトでは自動的にネットワークインターフェースのIPを取得します。LogListenerの初期化時にIPを指定した場合は、初期化時に指定したIPとなります。 | - | |
secret_id | APIキーIDです。 | LogListener初期化時に指定されたキーIDです。 | APIキー管理を参照してキーIDを取得してください。 |
secret_key | APIキーKeyです。 | LogListener初期化時に指定されたキーKeyです。 | APIキー管理を参照してキーKeyを取得してください。 |
agent_labels | 注意： マシン識別子が設定されたマシンは、マシン識別子によってのみマシングループに関連付けることができ、IPによって関連付けることはできません。 | - | - |
check_net | インストールプロセス中にネットワーク接続性チェックを実行するかどうかです。デフォルト値はtrueです。trueを入力した場合、ネットワーク異常時にインストールが失敗します。ネットワーク環境のチェックが不要な場合はfalseを入力します。（Windowsイベント収集ではサポートされません） | true | true、false |
設定変更後、以下のコマンドを実行してLogListenerを再起動し、設定変更を有効にします。
管理者としてWindows PowerShellを実行し、インストールパス
C:\\Program Files (x86)\\Tencent\\LogListenerで以下のコマンドを実行してLogListenerを再起動します：.\\loglistener_daemon.exe -action restart
フィードバック