Simple Log Service は、Logtail が過剰なサーバーリソースを消費するのを防ぐために、Logtail の収集パフォーマンスを調整します。Logtail が過剰なサーバーリソースを消費すると、サーバー上の他のサービスに影響を与える可能性があります。Logtail の収集パフォーマンスを向上させるには、Logtail の起動パラメータを変更します。
シナリオ
以下のシナリオでは、Logtail の起動パラメータを変更できます。
多数のログファイルからログを収集する必要があり、ログファイルが大量のメモリを占有している場合。たとえば、100 を超えるファイルからログを収集する必要がある場合や、ログ監視ディレクトリに 5,000 を超えるログファイルが含まれている場合。
ログデータが高速で転送され、CPU 使用率が高くなる場合。たとえば、Logtail がシンプルモードで 2 MB/s を超える速度で、完全正規表現モードで 1 MB/s を超える速度でログデータを収集する場合。
Logtail が Simple Log Service に 10 MB/s を超える速度でデータを送信する場合。
推奨パラメータ値
JSON ファイルからログを収集する場合は、以前の経験に基づいて推奨される以下のパラメータ値を使用します。完全正規表現モードとデリミタモードでの Logtail の収集パフォーマンスは、JSON モードでの Logtail の収集パフォーマンスと同様です。シンプルモードでの Logtail の収集パフォーマンスは、JSON モードでの Logtail の収集パフォーマンスの 5 倍です。データとルールの複雑さと、ログを収集するディレクトリとファイルの数によって、CPU 使用率とメモリ使用量が異なります。以下のパラメータは、表の値とビジネス要件に基づいて設定することをお勧めします。
ホスト環境
パラメータ
デフォルトの収集速度
10 MB/s を超える収集速度
20 MB/s を超える収集速度
40 MB/s を超える収集速度
cpu_usage_limit
0.4
1
2
4
mem_usage_limit
384
1024
2048
4096
max_bytes_per_sec
20971520
209715200
209715200
209715200
process_thread_count
1
2
4
8
send_request_concurrency
4
20
40
80
コンテナまたは Kubernetes 環境
環境変数
デフォルトの収集速度
10 MB/s を超える収集速度
20 MB/s を超える収集速度
40 MB/s を超える収集速度
cpu_usage_limit
2
3
5
9
mem_usage_limit
2048
2048
2048
4096
max_bytes_per_sec
209715200
209715200
209715200
209715200
process_thread_count
1
2
4
8
send_request_concurrency
20
20
40
80
resources.limits.cpu
500M
1000M
2000M
4000M
resources.limits.memory
2 Gi
2 Gi
3 Gi
5 Gi
次のセクションでは、コンテナまたは Kubernetes 環境で Logtail の起動パラメータを変更する方法について説明します。
バージョンが Logtail-ds 1.7.3 以降の Logtail が Container Service for Kubernetes (ACK) クラスタにデプロイされている場合は、ACK コンソールで Logtail の起動パラメータを変更することをお勧めします。[アドオン] ページで、[logtail-ds] コンポーネントのパラメータを変更します。
バージョンが Logtail-ds 1.7.3 以降の Logtail がセルフマネージドコンテナまたは Kubernetes クラスタにデプロイされている場合は、DaemonSet 関連の環境変数を変更することで、Logtail の起動パラメータを変更する必要があります。ConfigMap は一部の環境変数によって参照され、ConfigMap へのパスは
です。Logtail のバージョンが Logtail-ds 1.7.3 より前の場合は、DaemonSet 関連の環境変数を変更することで、Logtail の起動パラメータを変更する必要があります。ConfigMap は一部の環境変数によって参照され、ConfigMap へのパスは resources.limits.cpuresources.limits.memory の と を変更して、コンテナリソースの過剰使用を防ぐこともできます。
です。
上記の表の 40 MB/s を超える収集速度 列の値に基づいて Logtail の起動パラメータを設定すると、Logtail の収集パフォーマンスは上限に近づきます。この場合、スレッドをさらに作成してもパフォーマンスは大幅に向上しません。次の表に、Logtail がさまざまな収集モードで提供できる収集パフォーマンスの上限を示します。
実際の収集パフォーマンスは、テスト環境や本番環境などの環境によって異なる場合があります。
収集モード | 上限 |
シンプルモード | 440 MB/s |
完全正規表現モード | 70 MB/s |
デリミタモード | 75 MB/s |
JSON モード | 75 MB/s |
Logtail の起動パラメータを設定する
Logtail がインストールされているサーバーで、/usr/local/ilogtail/ilogtail_config.json ファイルを開きます。
サーバーからログを収集する場合は、この手順を実行して Logtail の起動パラメータを設定できます。
コンテナまたは Kubernetes クラスタからログを収集する場合は、DaemonSet 関連の環境変数を変更することで、Logtail の起動パラメータを変更できます。ConfigMap は一部の環境変数によって参照され、ConfigMap へのパスは
です。ビジネス要件に基づいて、Logtail の起動パラメータを設定します。
次の例は、Logtail の起動パラメータを示しています。
{ ... "cpu_usage_limit" : 0.4, "mem_usage_limit" : 384, "max_bytes_per_sec" : 20971520, "process_thread_count" : 1, "send_request_concurrency" : 4, "buffer_file_num" : 25, "buffer_file_size" : 20971520, "buffer_file_path" : "", ... }
説明次の表に、Logtail の一般的な起動パラメータを示します。他の起動パラメータにはデフォルト値を使用できます。
ビジネス要件に基づいて、起動パラメータを追加または変更できます。
表 1. Logtail の起動パラメータ
パラメータ
タイプ
説明
例
cpu_usage_limit
Double
Logtail の CPU 使用率のしきい値。計算はシングルコアに基づいています。
有効な値: 0.1 から現在のサーバーの CPU コア数まで
デフォルト値: 0.4
警告cpu_usage_limit はソフト制限を指定します。Logtail の実際の CPU 使用率は制限を超える場合があります。Logtail の CPU 使用率がこの制限を 5 分間超え続けると、システムはサーキットブレーカーをトリガーします。その後、Logtail は自動的に再起動します。
たとえば、パラメータを 0.4 に設定し、Logtail の CPU 使用率がシングルコアベースで 40% を 5 分間超え続けると、Logtail は自動的に再起動します。
ほとんどの場合、シングルコアはシンプルモードで約 100 MB/s、完全正規表現モードで約 20 MB/s の収集速度をサポートします。
説明バージョンが Logtail-ds 1.7.3 以降の Logtail が ACK クラスタにデプロイされている場合は、ACK コンソールで CPU 使用率のしきい値を指定することをお勧めします。[アドオン] ページで、[logtaildslimitcpu] コンポーネントの [logtail-ds] パラメータを変更します。詳細については、「コンポーネントの管理」をご参照ください。
"cpu_usage_limit" : 0.4
mem_usage_limit
Int
Logtail のメモリ使用量のしきい値。単位: MB。
有効な値: 128 から 8192 まで
デフォルト値: ホスト環境の場合は 384、ACK コンポーネントの場合は 2048
警告mem_usage_limit はソフト制限を指定します。Logtail の実際のメモリ使用量は制限を超える場合があります。Logtail のメモリ使用量がこの制限を 5 分間超え続けると、システムはサーキットブレーカーをトリガーします。その後、Logtail は自動的に再起動します。
収集速度、監視対象ディレクトリ、ログファイルの数、および同期して送信されるリクエストの数は、mem_usage_limit パラメータに関連しています。詳細については、「Logtail の制限」をご参照ください。
説明バージョンが Logtail-ds 1.7.3 以降の Logtail が ACK クラスタにデプロイされている場合は、ACK コンソールでメモリ使用量のしきい値を指定することをお勧めします。[アドオン] ページで、[logtaildslimitmemory] コンポーネントの [logtail-ds] パラメータを変更します。詳細については、「コンポーネントの管理」をご参照ください。
"mem_usage_limit" : 384
max_bytes_per_sec
Int
Logtail が生データを送信する最高速度。単位: バイト/秒。
有効な値: 1024 から 52428800 まで
デフォルト値: 20971520
重要パラメータを 20971520 より大きい値に設定すると、Logtail がデータを送信する速度は制限されません。値 20971520 は、速度が 20 MB/s であることを示します。
たとえば、パラメータを 2097152 に設定すると、Logtail は最大 2 MB/s の速度でデータを送信できます。
説明バージョンが Logtail-ds 1.7.3 以降の Logtail が ACK クラスタにデプロイされている場合は、ACK コンソールで最大速度を指定することをお勧めします。[アドオン] ページで、[logtaildsmaxbytepersec] コンポーネントの [logtail-ds] パラメータを変更します。詳細については、「コンポーネントの管理」をご参照ください。
"max_bytes_per_sec" : 2097152
process_thread_count
Int
Logtail がデータの処理に使用するスレッドの数。
有効な値: 1 から 64 まで
デフォルト値: 1
ほとんどの場合、スレッドはシンプルモードで 24 MB/s、完全正規表現モードで 12 MB/s の書き込み速度を提供します。このパラメータにはデフォルト値を保持することをお勧めします。
説明バージョンが Logtail-ds 1.7.3 以降の Logtail が ACK クラスタにデプロイされている場合は、ACK コンソールでスレッド数を指定することをお勧めします。[アドオン] ページで、[logtaildsprocessthreadcount] コンポーネントの [logtail-ds] パラメータを変更します。詳細については、「コンポーネントの管理」をご参照ください。
"process_thread_count" : 1
send_request_concurrency
Int
Logtail がデータを非同期で送信するために送信する同時リクエストの数。
有効な値: 1 から 50 まで
デフォルト値: 20
Simple Log Service が高いトランザクション/秒 (TPS) を提供する場合は、このパラメータを大きい値に設定できます。各同時リクエストは、0.5 MB/s から 1 MB/s のネットワークスループットをサポートします。同時リクエストの実際のネットワークスループットは、ネットワークレイテンシによって異なります。
説明このパラメータの値が大きい場合、同時リクエストが過剰な数のネットワークポートを使用する可能性があります。この場合、TCP 関連のパラメータの値を変更する必要があります。
バージョンが Logtail-ds 1.7.3 以降の Logtail が ACK クラスタにデプロイされている場合は、ACK コンソールで同時リクエストの数を指定することをお勧めします。[アドオン] ページで、[logtaildssendrequestconcurrency] コンポーネントの [logtail-ds] パラメータを変更します。詳細については、「コンポーネントの管理」をご参照ください。
"send_request_concurrency" : 4
buffer_file_num
Int
キャッシュできるファイルの最大数。
有効な値: 1 から 100 まで
デフォルト値: 25
ネットワークエラーが発生した場合、または書き込まれたデータ量が指定したしきい値を超えた場合、Logtail は解析されたログをインストールディレクトリのローカルファイルにキャッシュします。ネットワークが回復し、データがしきい値内で書き込まれると、Logtail はキャッシュされたログの送信を再試行します。
"buffer_file_num" : 25
buffer_file_size
Int
キャッシュファイルの最大サイズ。単位: バイト。
有効な値: 1048576 から 104857600 まで
デフォルト値: 20971520
キャッシュファイルが占有できるディスク容量の最大値は、buffer_file_size パラメータの値に buffer_file_num パラメータの値を掛けた値で計算されます。
"buffer_file_size" : 20971520
buffer_file_path
String
キャッシュファイルが格納されるディレクトリ。このパラメータはデフォルトで空であり、キャッシュファイルが Logtail のインストールディレクトリに格納されることを示します。デフォルトのディレクトリは /usr/local/ilogtail です。
このパラメータに値を指定する場合は、名前が logtail\_buffer\_file_\* に一致するキャッシュファイルを Logtail のインストールディレクトリから指定したディレクトリに移動する必要があります。こうすることで、Logtail はキャッシュファイルを読み取り、送信し、削除できます。
"buffer_file_path" : ""
bind_interface
String
Logtail がインストールされているサーバーに関連付けられているネットワークインターフェースコントローラ (NIC) の名前。このパラメータはデフォルトで空であり、サーバーが使用可能な NIC に自動的に関連付けられることを示します。
このパラメータに値 (eth1 など) を指定すると、Logtail は NIC を使用してログをアップロードします。
このパラメータは、Logtail が Linux サーバーで実行されている場合にのみ使用できます。
"bind_interface" : ""
check_point_filename
String
Logtail のチェックポイントファイルへのパス。デフォルト値: /tmp/logtail_check_point。
"check_point_filename" : /tmp/logtail_check_point
check_point_dump_interval
Int
Logtail がチェックポイントファイルを更新する間隔。デフォルト値: 900。単位: 秒。デフォルト値を保持すると、Logtail は 15 分間隔でチェックポイントファイルを更新します。
このパラメータは、Linux Logtail V1.0.19 以降または Windows Logtail V1.0.19.0 以降でのみ使用できます。
"check_point_dump_interval" : 900
user_config_file_path
String
Logtail 構成を格納するファイルへのパス。ファイル名は user_log_config.json で、Logtail プロセス用に作成された BIN ファイルのディレクトリに格納されます。
"user_config_file_path" : user_log_config.json
docker_file_cache_path
String
コンテナファイルとホストファイル間のパスマッピングを記録するファイルへのパス。デフォルトでは、パスは /usr/local/ilogtail/docker_path_config.json です。
このパラメータは、Linux Logtail V0.16.54 以降または Windows Logtail V0.16.54.0 以降でのみ使用できます。
"docker_file_cache_path": /usr/local/ilogtail/docker_path_config.json
discard_old_data
Boolean
履歴ログを破棄するかどうかを指定します。デフォルト値: true。この値は、現在の時刻の 12 時間以上前に生成されたログが破棄されることを示します。
"discard_old_data" : true
ilogtail_discard_interval
Int
ログを破棄するための時間のしきい値。ログが生成された時刻と現在の時刻の差がしきい値を超えると、ログは破棄されます。デフォルト値: 43200。単位: 秒。値 43200 は、しきい値が 12 時間であることを示します。
"ilogtail_discard_interval": 43200
working_ip
String
Logtail によって Simple Log Service に報告されるサーバー IP アドレス。このパラメータはデフォルトで空であり、Simple Log Service が Logtail がインストールされているサーバーの IP アドレスを自動的に取得することを示します。
"working_ip" : ""
working_hostname
String
Logtail によって Simple Log Service に報告されるサーバーホスト名。このパラメータはデフォルトで空であり、Simple Log Service が Logtail がインストールされているサーバーのホスト名を自動的に取得することを示します。
"working_hostname" : ""
max_read_buffer_size
Long
Logtail が読み取ることができるログの最大サイズ。単位: バイト。デフォルト値: 524288。これは、最大サイズが 512 KB であることを示します。最大値: 8388608。これは、最大サイズが 8 MB であることを示します。単位: バイト。
ログのサイズが 524,288 バイトを超える場合は、このパラメータの値を変更できます。
"max_read_buffer_size" : 524288
oas_connect_timeout
Long
Logtail が Logtail 構成または AccessKey ペアを取得するためのリクエストを送信するために確立する接続のタイムアウト期間。デフォルト値: 5。単位: 秒。
ネットワークの状態が悪いためにタイムアウト期間内に接続を確立できない場合は、このパラメータの値を変更できます。
"oas_connect_timeout" : 5
oas_request_timeout
Long
Logtail が Logtail 構成または AccessKey ペアを取得するために送信するリクエストのタイムアウト期間。デフォルト値: 10。単位: 秒。
ネットワークの状態が悪いためにタイムアウト期間内に接続を確立できない場合は、このパラメータの値を変更できます。
"" : 10
data_server_port
Long
data_server_port パラメータを 443 に設定すると、Logtail は HTTPS 経由で Simple Log Service にデータを転送します。
このパラメータは、Linux Logtail V1.0.10 以降または Windows Logtail V1.0.10.0 以降でのみ使用できます。
"data_server_port": 443
enable_log_time_auto_adjust
Boolean
enable_log_time_auto_adjust パラメータを true に設定すると、ログ時間はサーバーのローカル時間に合わせて調整されます。
データセキュリティを確保するため、Simple Log Service はリクエストの時間情報 (Logtail によってリクエストが送信された時刻を含む) をチェックします。この情報は、リクエストが送信された時刻を示します。Simple Log Service は、Simple Log Service の時刻の 15 分前または 15 分後に送信されたリクエストを拒否します。リクエストの時間情報は、サーバーのローカル時間と見なされます。一部のテストシナリオでは、ローカル時間を将来の時点に変更する必要があります。サーバーのローカル時間を変更すると、Simple Log Service は Logtail からのリクエストを拒否し、Simple Log Service にデータを書き込むことができなくなります。このパラメータを使用して、ログ時間をサーバーのローカル時間に合わせて調整できます。
このパラメータは、Linux Logtail V1.0.19 以降または Windows Logtail V1.0.19.0 以降でのみ使用できます。
重要enable_log_time_auto_adjust パラメータを true に設定すると、Simple Log Service の時刻とサーバーのローカル時間のオフセットがログ時間に追加されます。オフセットは、Simple Log Service によってリクエストが拒否された場合にのみ更新されます。したがって、Simple Log Service によって照会されるログの時間は、ログが書き込まれた時間と異なる場合があります。
Logtail のロジックの一部は、システム時間の増分に基づいて変更されます。サーバーのローカル時間を変更した後、Logtail を再起動することをお勧めします。
"enable_log_time_auto_adjust": true
accept_multi_config
Boolean
Logtail が複数の Logtail 構成を使用して同じファイルからデータを収集することを許可するかどうかを指定します。デフォルト値: false。この値は、Logtail が複数の Logtail 構成を使用して同じファイルからデータを収集できないことを示します。
デフォルトでは、Logtail は 1 つの Logtail 構成のみを使用してファイルからデータを収集できます。Logtail が複数の Logtail 構成を使用してファイルからデータを収集することを許可する場合は、このパラメータを true に設定できます。各 Logtail 構成には独立した収集プロセスがあります。複数の Logtail 構成を使用して同じファイルからデータを収集すると、CPU 使用率とメモリ使用量が増加します。
このパラメータは、Linux Logtail V0.16.26 以降または Windows Logtail V0.16.26.0 以降でのみ使用できます。
"accept_multi_config": true
enable_checkpoint_sync_write
Boolean
同期書き込み機能を有効にするかどうかを指定します。デフォルト値: false。この値は、同期書き込み機能が無効になっていることを示します。
同期書き込み機能は、ExactlyOnce 書き込み機能と組み合わせて使用されます。ExactlyOnce 書き込み機能を有効にすると、Logtail はファイルごとに詳細なチェックポイントを Logtail がインストールされているサーバーのディスクに記録します。デフォルトでは、Logtail は同期関数を呼び出してチェックポイントをディスクに書き込みません。ただし、サーバーの再起動時にバッファリングされたデータがディスクに書き込まれなかった場合、チェックポイントが失われる可能性があります。この場合、enable_checkpoint_sync_write パラメータを true に設定して、同期書き込み機能を有効にすることができます。詳細については、「Logtail 構成」をご参照ください。
このパラメータは、Linux Logtail V1.0.20 以降または Windows Logtail V1.0.20.0 以降でのみ使用できます。
"enable_checkpoint_sync_write": false
enable_env_ref_in_config
Boolean
Logtail 構成で環境変数置換機能を有効にするかどうかを指定します。デフォルト値: false。
この機能を有効にすると、Simple Log Service コンソールで Logtail 構成を作成するときに、
${xxx}
を環境変数xxx
のプレースホルダーとして使用できます。たとえば、ログパスを/${xxx}/logs
に設定し、環境変数をxxx=user
に設定すると、Logtail は/user/logs
パスからログを収集します。${
と}
が Logtail 構成で使用されている場合は、$${
と$}
を使用して文字をエスケープできます。このパラメータは、Linux Logtail V1.0.31 以降または Windows Logtail V1.0.31.0 以降でのみ使用できます。
"enable_env_ref_in_config": false
docker_config_update_interval
Int
コンテナパスが更新される最小間隔。
このパラメータは、max_docker_config_update_times パラメータと組み合わせて使用されます。2 つのパラメータのいずれかの値に達すると、コンテナパスは更新されなくなります。
Linux Logtail V1.0.32 以降または Windows Logtail V1.0.32.0 以降では、デフォルト値は 3 です。単位: 秒
バージョンが 1.0.32 より前の Linux Logtail またはバージョンが 1.0.32.0 より前の Windows Logtail では、デフォルト値は 10 です。単位: 秒。
"docker_config_update_interval": 3
max_docker_config_update_times
Int
3 分以内にコンテナパスを更新できる最大回数。デフォルトでは、コンテナパスが 3 分以内に 3 回以上更新されると、3 分後までコンテナパスを再度更新できません。
Linux Logtail V1.0.32 以降または Windows Logtail V1.0.32.0 以降では、デフォルト値は 10 です。
バージョンが 1.0.32 より前の Linux Logtail またはバージョンが 1.0.32.0 より前の Windows Logtail では、デフォルト値は 3 です。
"max_docker_config_update_times": 10
DOCKER_HOST
String
Docker と通信するために使用されるソケットアドレス。環境変数を使用してソケットアドレスを設定する必要があります。
このパラメータはデフォルトで空であり、デフォルトのソケットアドレス unix:///var/run/docker.sock が使用されることを示します。
DOCKER_HOST=unix:///var/run/docker.sock
CONTAINERD_SOCK_PATH
String
containerd と通信するために使用されるソケットアドレス。環境変数を使用してソケットアドレスを設定する必要があります。
このパラメータはデフォルトで空であり、デフォルトのソケットアドレス unix:///run/containerd/containerd.sock が使用されることを示します。K3s クラスタを使用する場合は、デフォルトのソケットアドレスを例で示されている値に変更できます。
CONTAINERD_SOCK_PATH=/run/k3s/containerd/containerd.sock
logreader_max_rotate_queue_size
Int
ファイルがローテーションされるキューの最大長。デフォルト値: 20。ログ収集がブロックまたは遅延された場合、ログを収集するファイルにはファイルハンドルが割り当てられ、キューで待機します。
ログ収集が遅延し、ディスク使用量の最大値を管理する必要がある場合は、このパラメータを小さい値に設定できます。
警告遅延ファイルの数がこのパラメータの値を超えると、Logtail は新しいファイルからログを収集しません。
"logreader_max_rotate_queue_size" : 10
force_release_deleted_file_fd_timeout
Int
ファイルハンドルの解放のタイムアウト期間。コンテナの終了後またはファイルの削除後にファイルハンドルを解放する場合は、このパラメータを設定できます。単位: 秒。デフォルト値: -1。これは、機能が無効になっていることを示します。値 0 は、ファイルハンドルがすぐに解放されることを示します。単位: 秒。
containerd コンテナの最大破壊レイテンシを管理する場合は、このパラメータを設定できます。
警告ログ収集が遅延し、レイテンシが指定されたしきい値を超えると、収集されないデータは失われます。
"force_release_deleted_file_fd_timeout" : 0
data_endpoint_policy
String
Logtail のエンドポイント切り替えポリシー。有効な値:
説明ilogtail_config.json ファイルの data_server_list パラメータによってデフォルトエンドポイントが指定されているかどうかを確認できます。詳細については、「起動構成ファイル (ilogtail_config.json)」をご参照ください。
designated_first (デフォルト)
リージョンのデフォルトエンドポイントが指定されていて、デフォルトエンドポイントが使用可能な場合、システムはデフォルトエンドポイントを使用します。
リージョンのデフォルトエンドポイントが指定されていて、デフォルトエンドポイントが使用できない場合、システムは自動的に別の使用可能なエンドポイントを選択します。
リージョンのデフォルトエンドポイントが指定されていない場合、システムは自動的に使用可能なエンドポイントを選択します。
designated_locked
リージョンのデフォルトエンドポイントが指定されている場合、システムはエンドポイントが使用可能かどうかを問わず、デフォルトエンドポイントを使用します。
リージョンのデフォルトエンドポイントが指定されていない場合、システムは自動的に使用可能なエンドポイントを選択します。
このパラメータは、Linux Logtail V1.5.0 以降または Windows Logtail V1.5.0.0 以降でのみ使用できます。
"data_endpoint_policy" : "designated_first"
inotify_black_list
Array<String>
inotify のブラックリスト。完全一致のみがサポートされています。inotify はブラックリストに指定されたディレクトリをリッスンしません。
"inotify_black_list": ["/tmp"]
host_path_blacklist
String
グローバルホストパスブラックリスト。部分文字列一致のみがサポートされています。
Linux サーバーでは、複数の部分文字列をコロン (:) で区切ります。
Windows サーバーでは、複数の部分文字列をセミコロン (;) で区切ります。
たとえば、
"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"
は、NAS マウント関連のデータが収集されないことを示します。このパラメータは、Linux Logtail V1.8.0 以降または Windows Logtail V1.8.0.0 以降でのみ使用できます。
"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"
LOGTAIL_LOG_LEVEL
String
ログのレベル。環境変数を使用してログレベルを設定する必要があります。このパラメータはデフォルトで空であり、ログレベルが info であることを示します。有効な値: trace、debug、info、warning、error、および fatal。
このパラメータは、Linux Logtail V1.8.0 以降または Windows Logtail V1.8.0.0 以降でのみ使用できます。
LOGTAIL_LOG_LEVEL=info
FORCE_RELEASE_STOP_CONTAINER_FILE
Boolean
構成方法: 構成は環境変数を使用してのみサポートされます。
機能の説明: このパラメータを true に設定すると、Logtail はビジネスコンテナの終了時にコンテナファイルハンドルをすぐに解放します。これにより、解放されていないファイルハンドルが原因でコンテナが正常に終了できないのを防ぎます。
サポートされているバージョン: Linux 用 Logtail V2.1.6 以降。
説明この場合、コンテナ内のデータ収集の整合性は保証されません。ログ収集を完了するために、サービスが終了する前に数秒の遅延を追加することをお勧めします。
"FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"
新しい設定を有効にするには、Logtail を再起動します。
/etc/init.d/ilogtaild stop && /etc/init.d/ilogtaild start
Logtail を再起動した後、
/etc/init.d/ilogtaild status
コマンドを実行して Logtail のステータスを確認できます。
付録: 環境変数
次の表に、環境変数と Logtail の起動パラメータ間のマッピングを示します。
表 2 環境変数と Logtail の起動パラメータ間のマッピング
パラメータ | 環境変数 | 優先度 | サポートされているバージョン |
cpu_usage_limit | cpu_usage_limit | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
mem_usage_limit | mem_usage_limit | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
max_bytes_per_sec | max_bytes_per_sec | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
process_thread_count | process_thread_count | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
send_request_concurrency | send_request_concurrency | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
check_point_filename | check_point_filename または ALIYUN_LOGTAIL_CHECK_POINT_PATH | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
docker_file_cache_path | docker_file_cache_path | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
user_config_file_path | user_config_file_path | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
discard_old_data | discard_old_data | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
working_ip | working_ip または ALIYUN_LOGTAIL_WORKING_IP | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
working_hostname | working_hostname または ALIYUN_LOGTAIL_WORKING_HOSTNAME | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
max_read_buffer_size | max_read_buffer_size | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
oas_connect_timeout | oas_connect_timeout | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
oas_request_timeout | oas_request_timeout | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
data_server_port | data_server_port | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
accept_multi_config | accept_multi_config | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
enable_log_time_auto_adjust | enable_log_time_auto_adjust | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
check_point_dump_interval | check_point_dump_interval | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
enable_checkpoint_sync_write | enable_checkpoint_sync_write | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
docker_config_update_interval | docker_config_update_interval または ALIYUN_LOGTAIL_DOCKER_CONFIG_UPDATE_INTERVAL | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
max_docker_config_update_times | max_docker_config_update_times または ALIYUN_LOGTAIL_MAX_DOCKER_CONFIG_UPDATE_TIMES | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
logreader_max_rotate_queue_size | logreader_max_rotate_queue_size | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、構成ファイルからの変更が有効になります。 |
|
force_release_deleted_file_fd_timeout | force_release_deleted_file_fd_timeout | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|
host_path_blacklist | host_path_blacklist | 環境変数と構成ファイルを使用して Logtail の起動パラメータを変更した場合、環境変数からの変更が有効になります。 |
|