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

Simple Log Service:Logtailの起動パラメーターの設定

最終更新日:Aug 20, 2024

Simple Log Serviceは、Logtailの収集パフォーマンスを抑制して、Logtailが過剰なサーバーリソースを消費するのを防ぎます。 Logtailが過剰なサーバーリソースを消費すると、サーバー上の他のサービスが影響を受ける可能性があります。 Logtailの収集パフォーマンスを向上させたい場合は、Logtailの起動パラメーターを変更できます。

シナリオ

次のシナリオでは、Logtailのスタートアップパラメーターを変更できます。

  • 大量のログファイルからログを収集する必要があり、ログファイルは大量のメモリを占有します。 たとえば、100を超えるファイルからログを収集する必要がある場合や、ログ監視ディレクトリに5,000を超えるログファイルが含まれている場合などです。

  • ログデータは高速で送信されるため、CPUの使用率が高くなります。 たとえば、Logtailは、シンプルモードでは2メガバイト/秒を超える速度で、フル正規表現モードでは1メガバイト/秒を超える速度でログデータを収集します。

  • Logtailは、10メガバイト/秒を超える速度でデータをSimple Log Serviceに送信します。

推奨パラメーター値

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_並行性

    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_並行性

    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のスタートアップパラメーターを変更する必要があります。 ConfigMapsは一部の環境変数によって参照され、ConfigMapsへのパスはconfigmap > kube-system > alibaba-log-configurationです。

    • LogtailのバージョンがLogtail-ds 1.7.3より前の場合、DaemonSet関連の環境変数を変更してLogtailのスタートアップパラメーターを変更する必要があります。 ConfigMapsは一部の環境変数によって参照され、ConfigMapsへのパスはconfigmap > kube-system > alibaba-log-configurationです。 daemonset > kube-system > logtail-dsresources.limits.cpuおよびresources.limits.memoryを変更して、コンテナーリソースの過度の使用を防ぐこともできます。

上記の表の [収集速度が40 MB/sを超える] 列の値に基づいてLogtailの起動パラメーターを設定した場合、Logtailの収集パフォーマンスは上限に近づきます。 この場合、より多くのスレッドが作成されてもパフォーマンスは大幅に向上しません。 次の表に、Logtailがさまざまな収集モードで提供できる収集パフォーマンスの上限を示します。

説明

実際の収集パフォーマンスは、テスト環境や本番環境などの環境によって異なる場合があります。

収集モード

上限

シンプルモード

440 MB/s

フル正規表現モード:

70 MB/s

区切り記号モード

75 MB/s

JSON モード

75 MB/s

Logtailの起動パラメーターの設定

  1. を開きます。Open the/usr/local/ilogtail/ilogtail_config.jsonLogtailがインストールされているサーバー上のファイル

    サーバーからログを収集する場合は、この手順を実行してLogtailの起動パラメーターを設定できます。

    コンテナーまたはKubernetesクラスターからログを収集する場合は、DaemonSet関連の環境変数を変更することで、Logtailのスタートアップパラメーターを変更できます。 ConfigMapsは一部の環境変数によって参照され、ConfigMapsへのパスはconfigmap > kube-system > alibaba-log-configurationです。

  2. ビジネス要件に基づいて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使用率のしきい値。 計算は単一のコアに基づいています。

    • 有効値: 現在のサーバーのCPUコア数に0.1

    • デフォルト値: 0.4

    警告

    cpu_usage_limitはソフトリミットを指定します。 Logtailの実際のCPU使用率が制限を超える可能性があります。 LogtailのCPU使用率が5分間この制限を超えたままである場合、システムは回路ブレーカーをトリガーします。 その後、Logtailが自動的に再起動します。

    たとえば、パラメーターを0.4に設定し、単一コアに基づいてLogtailのCPU使用率が5分間40% を超えたままである場合、Logtailは自動的に再起動します。

    ほとんどの場合、単一のコアは、シンプルモードで約100メガバイト/秒、フル正規表現モードで約20メガバイト/秒の収集速度をサポートします。

    説明

    Logtail-ds 1.7.3以降のバージョンのLogtailがACKクラスターにデプロイされている場合、ACKコンソールでCPU使用率のしきい値を指定することを推奨します。 アドオンページで、logtail-dsコンポーネントのLogtailDSLimitCPUパラメーターを変更します。 詳細については、「コンポーネントの管理」をご参照ください。

    "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コンソールでメモリ使用量のしきい値を指定することを推奨します。 アドオンページで、logtail-dsコンポーネントのLogtailDSLimitMemoryパラメーターを変更します。 詳細については、「コンポーネントの管理」をご参照ください。

    "mem_usage_limit" : 384

    max_bytes_per_sec

    int

    Logtailが生データを送信する最高速度。 単位: 1秒あたりのバイト数。

    • 有効な値: 1024〜52428800

    • デフォルト値: 20971520

      重要

      パラメーターを20971520を超える値に設定した場合、Logtailがデータを送信する速度は制限されません。 値20971520は、速度が20メガバイト/秒であることを示す。

    たとえば、パラメーターを2097152に設定すると、Logtailは最大2メガバイト/秒の速度でデータを送信できます。

    説明

    Logtail-ds 1.7.3以降のバージョンのLogtailがACKクラスターにデプロイされている場合、ACKコンソールで最大速度を指定することを推奨します。 アドオンページで、logtail-dsコンポーネントのLogtailDSMaxBytePerSecパラメーターを変更します。 詳細については、「コンポーネントの管理」をご参照ください。

    "max_bytes_per_sec" : 2097152

    process_thread_count

    int

    Logtailがデータを処理するために使用するスレッドの数。

    • 有効値: 1 ~ 64

    • デフォルト値:1

    ほとんどの場合、スレッドはシンプルモードで24メガバイト/秒、フル正規表現モードで12メガバイト/秒の書き込み速度を提供します。 このパラメーターのデフォルト値を保持することを推奨します。

    説明

    Logtail-ds 1.7.3以降のバージョンのLogtailがACKクラスターにデプロイされている場合、ACKコンソールでスレッド数を指定することを推奨します。 アドオンページで、logtail-dsコンポーネントのLogtailDSProcessThreadCountパラメーターを変更します。 詳細については、「コンポーネントの管理」をご参照ください。

    "process_thread_count" : 1

    send_request_並行性

    int

    データを非同期に送信するためにLogtailによって送信される同時要求の数。

    • 有効な値: 1 ~ 1000

    • デフォルト値: 20

    Simple Log Serviceが1秒あたりのトランザクション数 (TPS) が高い場合、このパラメーターをより大きな値に設定できます。 各同時リクエストは、0.5メガバイト/秒対1メガバイト/秒のネットワークスループットをサポートします。 同時リクエストの実際のネットワークスループットは、ネットワークの待ち時間によって異なります。

    説明
    • このパラメーターの値が大きい場合、同時要求で使用されるネットワークポートの数が多すぎる可能性があります。 この場合、TCP関連のパラメーターの値を変更する必要があります。

    • Logtail-ds 1.7.3以降のバージョンのLogtailがACKクラスターにデプロイされている場合、ACKコンソールで同時リクエスト数を指定することを推奨します。 [アドオン] ページで、logtail-dsコンポーネントのLogtailDSSendRequestConcurrencyパラメーターを変更します。 詳細については、「コンポーネントの管理」をご参照ください。

    "send_request_concurrency" : 4

    buffer_file_num

    int

    キャッシュできるファイルの最大数。

    • 有効値:1~100 。

    • デフォルト値: 25

    ネットワークエラーが発生した場合、または書き込まれたデータの量が指定したしきい値を超えた場合、Logtailは解析されたログをインストールディレクトリのローカルファイルにキャッシュします。 ネットワークが回復し、データがしきい値内に書き込まれた後、Logtailはキャッシュされたログの送信を再試行します。

    "buffer_file_num" : 25

    buffer_file_サイズ

    int

    キャッシュされたファイルの最大サイズ。 単位:バイト

    • 有効な値: 1048576〜104857600

    • デフォルト値: 20971520

    キャッシュされたファイルが占有できる最大ディスク容量は、buffer_file_sizeパラメーターの値にbuffer_file_numパラメーターの値を掛けることによって計算されます。

    "buffer_file_size" : 20971520

    buffer_file_パス

    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_パス

    String

    Logtail設定を格納するファイルへのパス。 ファイル名はuser_log_config.jsonで、Logtailプロセス用に作成されたBINファイルのディレクトリに保存されます。

    "user_config_file_path" : user_log_config.json

    docker_file_cache_パス

    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_サイズ

    long

    Logtailが読み取ることができるログの最大サイズ。 単位:バイト デフォルト値: 524288。最大サイズが512 KBであることを示します。 最大値: 8388608。最大サイズが8 MBであることを示します。 単位:バイト

    ログのサイズが524,288バイトを超える場合、このパラメーターの値を変更できます。

    "max_read_buffer_size" : 524288

    oas_connect_timeout

    long

    Logtail設定またはAccessKeyペアを取得するためのリクエストを送信するためにLogtailによって確立された接続のタイムアウト期間。 既定値:5 単位は秒です。

    ネットワークの状態が悪いためにタイムアウト期間内に接続を確立できない場合は、このパラメーターの値を変更できます。

    "oas_connect_timeout" : 5

    oas_request_timeout

    long

    Logtail設定またはAccessKeyペアを取得するためにLogtailによって送信されるリクエストのタイムアウト期間。 デフォルト値は 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_調整

    Boolean

    enable_log_time_auto_adjustパラメーターをtrueに設定した場合、ログ時間はサーバーのローカル時間に適合します。

    データのセキュリティを確保するため、Simple Log Serviceは、Logtailによってリクエストが送信された時刻など、リクエストの時刻情報をチェックします。 この情報は、要求が送信された時刻を示す。 Simple Log Serviceは、Simple Log Serviceの時刻より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_ホスト

    String

    Dockerとの通信に使用されるソケットアドレス。 環境変数を使用してソケットアドレスを設定する必要があります。

    このパラメーターはデフォルトで空です。これは、デフォルトのソケットアドレスunix:/// var/run/docker.sockが使用されていることを示します。

    DOCKER_HOST=unix:/// var/run/docker.sock

    CONTAINERD_SOCK_パス

    String

    containerdとの通信に使用されるソケットアドレス。 環境変数を使用してソケットアドレスを設定する必要があります。

    このパラメーターはデフォルトで空です。これは、デフォルトのソケットアドレスunix:/// run/containerd/containerd.sockが使用されていることを示します。 K3sクラスターが使用されている場合は、デフォルトのソケットアドレスをこの例で指定した値に変更できます。

    CONTAINERD_SOCK_PATH=/run/k3s/containerd/containerd.sock

    logreader_max_rotate_queue_サイズ

    Int

    ファイルがローテーションされるキューの最大長。 デフォルト値は 20 です。 ログの収集がブロックまたは遅延した場合、ログを収集するファイルにはファイルハンドルが割り当てられ、キューで待機します。

    ログ収集が遅延し、最大ディスク使用量を管理する必要がある場合は、このパラメーターを小さい値に設定できます。

    警告

    遅延ファイルの数がこのパラメーターの値を超える場合、Logtailは新しいファイルからログを収集しません。

    "logreader_max_rotate_queue_size" : 10

    force_release_deleted_file_fd_タイムアウト

    Int

    ファイルハンドルのリリースのタイムアウト期間。 コンテナが終了した後、またはファイルが削除された後にファイルハンドルを解放する場合は、このパラメーターを設定できます。 単位は秒です。 デフォルト値: -1。機能が無効になっていることを示します。 値0は、ファイルハンドルが直ちに解放されることを示す。 単位は秒です。

    containerdコンテナーの最大破棄レイテンシを管理する場合は、このパラメーターを設定できます。

    警告

    ログ収集が遅延し、レイテンシが指定されたしきい値を超えると、収集されなかったデータが失われます。

    "force_release_deleted_file_fd_timeout" : 0

    default_max_inotify_watch_num

    Int

    inotifyを使用して監視されるディレクトリの最大数。 ディレクトリはサブディレクトリを含む。 既定値:3000。

    "default_max_inotify_watch_num" : 5000

    data_endpoint_ポリシー

    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

  3. 新しい設定を有効にするには、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の起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.32以降

  • Windows Logtail V0.16.32.0以降

mem_usage_limit

mem_usage_limit

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.32以降

  • Windows Logtail V0.16.32.0以降

max_bytes_per_sec

max_bytes_per_sec

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.32以降

  • Windows Logtail V0.16.32.0以降

process_thread_count

process_thread_count

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.32以降

  • Windows Logtail V0.16.32.0以降

send_request_並行性

send_request_並行性

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.32以降

  • Windows Logtail V0.16.32.0以降

check_point_filename

check_point_filenameまたはALIYUN_LOGTAIL_CHECK_POINT_PATH

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V0.16.36以降

  • Windows Logtail V0.16.36.0以降

docker_file_cache_パス

docker_file_cache_パス

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.54以降

  • Windows Logtail V0.16.54.0以降

user_config_file_パス

user_config_file_パス

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

discard_old_data

discard_old_data

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

working_ip

working_ipまたはALIYUN_LOGTAIL_WORKING_IP

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

working_hostname

working_hostnameまたはALIYUN_LOGTAIL_WORKING_HOSTNAME

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

max_read_buffer_サイズ

max_read_buffer_サイズ

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

oas_connect_timeout

oas_connect_timeout

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

oas_request_timeout

oas_request_timeout

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.56以降

  • Windows Logtail V0.16.56.0以降

data_server_port

data_server_port

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.10以降

  • Windows Logtail V1.0.10.0以降

accept_multi_config

accept_multi_config

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.26以降

  • Windows Logtail V0.16.26.0以降

enable_log_time_auto_調整

enable_log_time_auto_調整

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.19以降

  • Windows Logtail V1.0.19.0以降

check_point_dump_interval

check_point_dump_interval

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.19以降

  • Windows Logtail V1.0.19.0以降

enable_checkpoint_sync_write

enable_checkpoint_sync_write

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.20以降

  • Windows Logtail V1.0.20.0以降

docker_config_update_interval

docker_config_update_intervalまたはALIYUN_LOGTAIL_DOCKER_CONFIG_UPDATE_INTERVAL

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.29以降

  • Windows Logtail V1.0.29.0以降

max_docker_config_update_times

max_docker_config_update_timesまたはALIYUN_LOGTAIL_MAX_DOCKER_CONFIG_UPDATE_TIMES

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V1.0.29以降

  • Windows Logtail V1.0.29.0以降

logreader_max_rotate_queue_サイズ

logreader_max_rotate_queue_サイズ

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、設定ファイルからの変更が有効になります。

  • Linux Logtail V0.16.54以降

  • Windows Logtail V0.16.54.0以降

force_release_deleted_file_fd_タイムアウト

force_release_deleted_file_fd_タイムアウト

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linux Logtail V1.21.1以降

  • Windows Logtail V1.21.1.0以降

host_path_blacklist

host_path_blacklist

環境変数と設定ファイルを使用してLogtailの起動パラメーターを変更すると、環境変数からの変更が有効になります。

  • Linxu Logtail V1.8.0以降

  • Windows Logtail V1.8.0.0以降