すべてのプロダクト
Search

このプロダクト

    Simple Log Service:構成管理

    ドキュメントセンター

    Simple Log Service:構成管理

    最終更新日:Oct 10, 2026

    インストール後に LoongCollector のライフサイクル、起動パラメーター、ランタイム構成を管理します。

    LoongCollector の一般的なコマンド

    LoongCollector の起動、停止、再起動

    データ収集に特定のパフォーマンス要件がある場合は、LoongCollector を起動する前に 起動パラメーター設定ファイル (ilogtail_config.json) を変更してください。
    sudo /etc/init.d/loongcollectord start # 開始
sudo /etc/init.d/loongcollectord stop # 停止
sudo /etc/init.d/loongcollectord restart # 再起動

    LoongCollector のステータス確認

    sudo /etc/init.d/loongcollectord status # 「loongcollector is running」と表示されると、エージェントは正常に起動しています。

    LoongCollector のバージョンの確認

    cat /usr/local/ilogtail/app_info.json # バージョンは loongcollector_version フィールドにあります。

    起動パラメーター設定ファイル (ilogtail_config.json)

    • LoongCollector の起動パラメータを設定します。設定が不適切な場合、収集パフォーマンスの低下やエラーが発生することがあります。

    • ファイルパス： /usr/local/ilogtail/ilogtail_config.json

    • ユースケース： SLS は、LoongCollector によるサーバーリソースの過剰な消費や他のサービスへの影響を防ぐため、LoongCollector の収集パフォーマンスを制限しています。LoongCollector の収集パフォーマンスが要件を満たさない場合は、起動パラメーターを変更できます。具体的なユースケースの詳細については、「設定の変更による一般的な収集問題の解決」をご参照ください。

    • ファイル例：

      {
    "primary_region" : "cn-beijing", // デフォルトリージョン。このパラメーターは無視できます。
    "config_servers" : // 収集設定を取得するためのアドレス。
    [
        "http://logtail.cn-beijing.log.aliyuncs.com"
    ],
    "data_servers" : // Simple Log Service (SLS) とのデータ転送用のアドレス。
    [
        {
            "region" : "cn-beijing",
            "endpoint_list": [
                "cn-beijing.log.aliyuncs.com"
            ]
        }
    ],
    "cpu_usage_limit" : 0.4,
    "mem_usage_limit" : 384,
    "max_bytes_per_sec" : 20971520,
    "bytes_per_sec" : 1048576,
    "buffer_file_num" : 25,
    "buffer_file_size" : 20971520,
    "buffer_map_num" : 5
}

    • 以下の表は、一般的な起動パラメーターの一覧です。必要に応じて追加または変更し、記載されていないパラメーターについてはデフォルト値を保持してください。

      ilogtail_config.json 起動パラメーター

      パラメーター

      タイプ

      説明

      例

      cpu_usage_limit

      double

      単一 CPU コアに基づく CPU 使用率のしきい値。

      • 有効な値：0.1 からマシン上の CPU コア数まで。

      • デフォルト値：0.4

      警告

      cpu_usage_limit パラメーターはソフトリミットです。実際の CPU 使用率はこの値を超える場合があります。5 分間連続してこの制限を超えると、サーキットブレーカーがトリガーされ、LoongCollector が自動的に再起動します。

      たとえば、このパラメーターを 0.4 に設定した場合、SLS はコレクターの CPU 使用率を単一 CPU コアの 40% に制限しようとします。使用率がこの制限を超えると、LoongCollector が再起動します。

      通常、単一コアはミニマリストモードで約 100 MB/s、完全正規表現モードで約 20 MB/s のデータ処理能力があります。

      "cpu_usage_limit" : 0.4

      mem_usage_limit

      int

      メモリ使用量のしきい値 (メガバイト単位)。

      • 有効な値：128 MB から 8192 MB まで

      • デフォルト値：384 MB (ホストの場合)、2048 MB (ACK コンポーネントの場合)

      警告

      mem_usage_limit パラメーターはソフトリミットです。実際のメモリ使用量はこの値を超える場合があります。5 分間連続してこの制限を超えると、サーキットブレーカーがトリガーされ、LoongCollector が自動的に再起動します。

      mem_usage_limit パラメーターは、収集速度、監視対象のディレクトリとファイルの数、送信輻輳に影響します。詳細については、「制限」をご参照ください。

      "mem_usage_limit" : 384

      max_bytes_per_sec

      int

      生データの最大送信速度 (バイト/s)。

      • 有効な値：1,024 バイト/s から 52,428,800 バイト/s まで

      • デフォルト値：20,971,520 バイト/s (20 MB/s = 20 × 1024 × 1024 = 20,971,520 バイト/s)

        重要

        20,971,520 バイト/s (20 MB/s) を超える値は、速度制限がないことを意味します。

      たとえば、このパラメーターを 1048576 に設定した場合、データ送信速度は 1 MB/s になります。

      "max_bytes_per_sec" : 1048576

      process_thread_count

      int

      データ処理スレッドの数。

      • 有効な値：1 から 64 まで

      • デフォルト値：1

      単一スレッドは通常、ミニマリストモードで 24 MB/s、完全正規表現モードで 12 MB/s のデータ書き込みスループットに対応できます。通常の状況では、このパラメーター値を調整する必要はありません。

      "process_thread_count" : 1

      send_request_concurrency

      int

      非同期同時実行のレベル。

      • 有効な値：15 から 80 まで

      • デフォルト値：15

      書き込み TPS が高い場合は、より高い非同期同時実行値を設定できます。1 つの同時リクエストは、ネットワークレイテンシーに応じて、約 0.5 MB/s から 1 MB/s のネットワークスループットをサポートすると見積もることができます。

      説明

      非同期同時実行値を高く設定しすぎると、多くのネットワークポートを消費する可能性があり、TCP 関連パラメーターの調整が必要になります。

      "send_request_concurrency" : 15

      buffer_file_num

      int

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

      • 有効な値：1 から 100 まで

      • デフォルト値：25

      ネットワークの問題または書き込みクォータ超過が発生した場合、コレクターは解析されたログをインストールディレクトリ内のローカルファイルにキャッシュします。問題が解決した後、送信を再試行します。

      "buffer_file_num" : 25

      buffer_file_size

      int

      単一キャッシュファイルの最大サイズ (バイト単位)。

      • 有効な値：1,048,576 バイトから 104,857,600 バイトまで

      • デフォルト値：20,971,520 バイト

      キャッシュファイルの最大ディスク容量は buffer_file_size × buffer_file_num です。

      "buffer_file_size" : 20971520

      buffer_file_path

      String

      キャッシュファイルが保存されるディレクトリ。デフォルト値は空で、キャッシュファイルがインストールディレクトリ /usr/local/ilogtail に保存されることを意味します。

      このパラメーターを設定する場合、logtail_buffer_file_* という名前のファイルを元のディレクトリから新しいディレクトリに手動で移動する必要があります。これにより、コレクターがキャッシュファイルを読み取り、データを送信してからファイルを削除できるようになります。

      "buffer_file_path" : ""

      bind_interface

      String

      バインドするネットワークインターフェイスカードの名前。空のままにすると、LoongCollector は自動的に利用可能なネットワークインターフェイスにバインドします。

      このパラメーターを eth1 などの特定のネットワークインターフェイスカードに設定すると、LoongCollector はそのネットワークインターフェイスを使用してログをアップロードします。

      説明

      working_interface の使用を推奨します。両方を設定した場合、working_interface の値が優先されます。

      "bind_interface" : ""

      working_interface

      String

      バインドするネットワークインターフェイスカードの名前。空のままにすると、LoongCollector は自動的に利用可能なネットワークインターフェイスにバインドします。

      このパラメーターを eth1 などの特定のネットワークインターフェイスカードに設定すると、LoongCollector はそのネットワークインターフェイスを使用してログをアップロードします。

      "working_interface" : ""

      check_point_filename

      String

      チェックポイントファイルが保存されるパス。デフォルト値： /tmp/logtail_check_point

      "check_point_filename" : "/tmp/logtail_check_point"

      check_point_dump_interval

      int

      チェックポイントファイルを更新する間隔 (秒単位)。デフォルト値は 900 (15 分) です。

      "check_point_dump_interval" : 900

      user_config_file_path

      String

      設定ファイルが保存されるパス。デフォルトでは、プロセスバイナリのあるディレクトリで、ファイル名は user_log_config.json です。

      "user_config_file_path" : "user_log_config.json"

      discard_old_data

      ブール値

      履歴ログを破棄するかどうかを指定します。デフォルト値は true です。このパラメーターを true に設定すると、12 時間より古いログは破棄されます。

      "discard_old_data" : true

      ilogtail_discard_interval

      int

      履歴ログを破棄する経過時間のしきい値 (秒単位)。デフォルト値：43200 (12 時間)。

      "ilogtail_discard_interval": 43200

      working_ip

      String

      サーバーが通知する IP アドレスを指定します。空のままにすると、IP アドレスはサーバーから自動的に取得されます。

      "working_ip" : ""

      working_hostname

      String

      サーバーが通知するホスト名を指定します。空のままにすると、ホスト名はサーバーから自動的に取得されます。

      "working_hostname" : ""

      max_read_buffer_size

      long

      単一ログエントリの最大サイズ (バイト単位)。デフォルト値：524,288 (512 KB)。最大値：8,388,608 (8 MB)。

      単一ログエントリが 524,288 バイトを超える場合は、このパラメーターの値を増やしてください。

      "max_read_buffer_size" : 524288

      oas_connect_timeout

      long

      収集設定または AccessKey 情報を取得するリクエストの接続タイムアウト (秒単位)。デフォルト値：5

      ネットワーク接続が遅い場合は、この値を増やしてください。

      "oas_connect_timeout" : 5

      oas_request_timeout

      long

      収集設定または AccessKey 情報を取得するリクエストの合計リクエストタイムアウト (秒単位)。デフォルト値：10

      ネットワークが遅いためにリクエストがタイムアウトする場合は、この値を増やしてください。

      "oas_request_timeout" : 10

      data_server_port

      long

      data_server_port を 443 に設定すると、データは HTTPS 経由で SLS に送信されます。

      "data_server_port": 443

      enable_log_time_auto_adjust

      ブール値

      enable_log_time_auto_adjust を true に設定すると、ログ時刻がサーバーのローカル時刻に自動的に調整されます。

      データセキュリティのため、SLS は LoongCollector からのリクエストを含む各リクエストのタイムスタンプを検証します。SLS サーバー時刻と 15 分以上異なるタイムスタンプを持つリクエストは拒否されます。コレクターはリクエストにサーバーのローカル時刻を含めます。サーバーのローカル時刻が変更された場合 (たとえば、テスト用に将来の時刻に変更された場合)、リクエストが拒否され、データ書き込みが失敗する可能性があります。このパラメーターを使用して、ログ時刻をサーバーのローカル時刻に適応させることができます。

      重要

      • この機能が有効な場合、SLS 時刻とサーバーのローカル時刻の差がログ時刻に追加されます。この差は SLS サーバーによってリクエストが拒否されたときにのみ更新されるため、SLS で照会するログ時刻は実際の書き込み時刻と一致しない場合があります。

      • LoongCollector のロジックの一部は単調増加するシステム時刻に依存しています。マシンの時刻を調整した後は、コレクターを再起動することを推奨します。

      "enable_log_time_auto_adjust": true

      accept_multi_config

      ブール値

      複数の収集設定が同じファイルからログを収集することを許可するかどうかを指定します。デフォルト値は false です。

      デフォルトでは、ファイルは 1 つの収集設定によってのみ収集できます。このパラメーターを使用して、この制限を解除できます。各収集設定の処理は独立しています。複数の設定が同じファイルから収集することを許可すると、CPU とメモリの消費量が倍増します。

      "accept_multi_config": true

      enable_checkpoint_sync_write

      ブール値

      同期書き込み機能を有効にするかどうかを指定します。デフォルト値は false です。

      同期書き込み機能は、主に ExactlyOnce 書き込み機能と併用されます。ExactlyOnce が有効になっている場合、コレクターは詳細なファイルレベルのチェックポイント情報をローカルディスクに記録します。ただし、パフォーマンス上の理由から、チェックポイントの書き込み時にデフォルトでは sync 呼び出しが使用されません。バッファデータがディスクに書き込まれる前にマシンが再起動すると、チェックポイントが失われる可能性があります。この場合、enable_checkpoint_sync_write を true に設定して同期書き込みを有効にできます。詳細については、「Logtail 設定 (旧バージョン)」をご参照ください。

      "enable_checkpoint_sync_write": false

      enable_env_ref_in_config

      ブール値

      収集設定で環境変数の置換を有効にするかどうかを指定します。デフォルト値は false です。

      この機能を有効にすると、コンソールの収集設定で ${xxx} を環境変数 xxx のプレースホルダーとして使用できます。たとえば、収集パスを /${xxx}/logs に設定し、環境変数が xxx=user の場合、有効な収集パスは /user/logs になります。

      設定でリテラル文字 ${ または } を使用する必要がある場合、$${ と $} を使用してエスケープできます。

      "enable_env_ref_in_config": false

      logreader_max_rotate_queue_size

      int

      ローテーションキューの最大長。デフォルト値：20。ログ収集がブロックまたは遅延した場合、収集待ちのファイルはファイルハンドルを保持し、このキューで待機します。

      収集が遅延し、最大ディスク使用量を制御する必要がある場合は、この値を減らすことを検討してください。

      警告

      遅延ファイルの数がこの値を超えると、新しいファイルの収集はスキップされます。

      "logreader_max_rotate_queue_size" : 10

      data_endpoint_policy

      String

      SLS エンドポイントの切り替えポリシー。有効な値：

      説明

      ilogtail_config.json ファイルの data_server パラメーターを確認して、デフォルトのエンドポイントが設定されているかどうかを確認してください。

      • designated_first (デフォルト)

        • リージョンにデフォルトのエンドポイントが指定されており、利用可能な場合、システムはデフォルトのエンドポイントを使用します。

        • リージョンにデフォルトのエンドポイントが指定されているが利用できない場合、システムは自動的に利用可能なエンドポイントを選択します。

        • リージョンにデフォルトのエンドポイントが指定されていない場合、システムは自動的に利用可能なエンドポイントを選択します。

      • designated_locked

        • リージョンにデフォルトのエンドポイントが指定されている場合、システムは可用性に関係なく、そのエンドポイントのみを使用します。

        • リージョンにデフォルトのエンドポイントが指定されていない場合、システムは自動的に利用可能なエンドポイントを選択します。

      "data_endpoint_policy" : "designated_first"

      inotify_black_list

      Array<String>

      inotify リスナーの完全一致ブラックリスト。このリスト内のディレクトリは inotify 監視から除外されます。

      "inotify_black_list": ["/tmp"]

      host_path_blacklist

      String

      ホストパスのグローバルブラックリスト。部分文字列で一致します。Linux では、複数の部分文字列をコロン (:) で区切ります。

      たとえば、"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-" は、NAS マウントからのデータ収集を防ぎます。

      "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"

      LOGTAIL_LOG_LEVEL

      String

      ログレベル。環境変数として設定する必要があります。デフォルト値は空で、info に相当します。有効な値は trace、debug、info、warning、error、fatal です。

      LOGTAIL_LOG_LEVEL=info

      FORCE_RELEASE_STOP_CONTAINER_FILE

      ブール値

      • 設定：このパラメーターは環境変数としてのみ設定できます。

      • 説明：このパラメーターを true に設定すると、アプリケーションコンテナが停止したときに、コレクターは直ちにコンテナのファイルハンドルを解放します。この操作により、未解放のファイルハンドルが原因でコンテナが終了できなくなることを防ぎます。

      • 注意事項：

        • この設定は、コンテナからのデータ収集の完全性を保証するものではありません。

        • すべてのログが確実に収集されるように、アプリケーションが終了する前に数秒の遅延を追加することを推奨します。

      FORCE_RELEASE_STOP_CONTAINER_FILE=true

    パフォーマンスチューニング

    SLS は、他のサービスへの影響を防ぐため、LoongCollector のリソース消費を制限します。起動パラメーターを変更することで、収集パフォーマンスが向上します。

    推奨パラメーター値

    一般的な JSON ファイルを収集する場合は、以下の値を推奨します。フル正規表現モードと区切り文字モードは JSON モードと同様のパフォーマンスを示し、ミニマリストモードは約 5 倍高速です。データの複雑さ、ルールの複雑さ、監視対象のディレクトリとファイルの数はすべて、CPU とメモリの消費量に影響します。要件に基づいてパラメーターを調整してください。

    /usr/local/ilogtail/ilogtail_config.json のパラメーター値を追加または変更し、LoongCollector を再起動すると変更が有効になります。以下の表に、収集レートごとの推奨値を示します。

    説明

    表の レート > 40 MB/s 列に基づいて起動パラメーターを設定する場合、収集パフォーマンスは限界に近づきます。

    パラメーター

    説明

    レート > 10 MB/s

    レート > 20 MB/s

    レート > 40 MB/s

    cpu_usage_limit

    単一 CPU コアあたりの CPU 使用量のしきい値。

    • 有効な値：0.1～マシンの CPU コア数

    • デフォルト値：0.4

    値が0.4 の場合、SLS はコレクターの CPU 使用量を単一コアの40%に制限しようと試みます。使用量がこの制限を超えると、LoongCollector は自動的に再起動します。

    これはソフトリミットです。実際の CPU 使用量がこの値を超える場合があります。5 分間連続してこの制限を超えると、サーキットブレーカーが作動し、LoongCollector が自動的に再起動します。

    1

    2

    4

    mem_usage_limit

    メモリ使用量のしきい値。

    • 有効な値：128 MB ～ 8,192 MB

    • デフォルト値：384 MB

    このパラメーターは、収集レート、監視対象のディレクトリとファイルの数、送信の輻輳に影響します。詳細については、「制限」をご参照ください。

    これはソフトリミットです。実際のメモリ使用量がこの値を超える場合があります。5 分間連続してこの制限を超えると、サーキットブレーカーが作動し、LoongCollector が自動的に再起動します。

    1024

    2048

    4096

    process_thread_count

    データ処理用のスレッド数。

    • 有効な値：1～64

    • デフォルト値：1

    単一スレッドで、ミニマリストモードでは 24 MB/秒、フル正規表現モードでは 12 MB/秒のデータ書き込みを処理できます。通常の状況では、このパラメーター値を調整する必要はありません。

    2

    4

    8

    max_bytes_per_sec

    生データの最大送信レート (単位：バイト/秒)。

    • 有効な値：1,024 バイト/秒 ～ 52,428,800 バイト/秒

    • デフォルト値：20,971,520 バイト/秒

    重要

    20,971,520 バイト/秒 (20 MB/秒) を超える値は、速度制限がないことを示します。

    52,428,800

    52,428,800

    52,428,800

    send_request_concurrency

    非同期の同時実行数。

    • 有効な値：15～80

    • デフォルト値：15

    書き込み TPS が高い場合は、非同期の同時実行数をより大きい値に設定できます。各同時リクエストが処理できるネットワークスループットは、ネットワーク遅延にもよりますが、0.5 MB/秒 ～ 1 MB/秒と見積もられます。

    20

    40

    80

    その他の一般的な設定ファイル

    LoongCollector は、ランタイムに以下の設定ファイルおよび情報ファイルを使用します。

    収集設定 (user_log_config.json)

    • 説明：LoongCollector が Simple Log Service (SLS) から取得した収集設定を記録します。収集設定が変更されるたびに、このファイルは更新されます。AccessKey やデータベースのパスワードなどの機密情報を手動で設定する場合を除き、このファイルは変更しないでください。

    • パス： /usr/local/ilogtail/user_log_config.json

    • ユースケース：このファイルを確認することで、収集設定がサーバーに配信されているかどうかがわかります。このファイルが存在し、内容が SLS の収集設定と一致している場合、設定は正常に配信されています。

    AppInfo ファイル (app_info.json)

    • 説明： LoongCollector の起動時刻、取得した IP アドレス、ホスト名を記録します。このファイルは読み取り専用です。変更しても有効にはなりません。

    • パス： /usr/local/ilogtail/app_info.json

    • ユースケース： Simple Log Service (SLS) が識別したサーバー IP アドレスを確認し、IP ベースのマシングループ内の IP アドレスと一致するかどうかを検証します。通常、IP ベースのマシングループにおけるハートビート障害のトラブルシューティングに使用します。

      LoongCollector は、次の優先順位で IP アドレスを取得します： ilogtail_config.json の working_ip パラメーター、サーバーの /etc/hosts ファイル内のホスト名と IP の対応付け、最初のネットワークインターフェイスカードの IP アドレス。

    LoongCollector ランタイムログ (loongcollector.LOG)

    • 説明： LoongCollector のランタイムログが記録されます。ログレベルは、低い順に INFO、WARN、ERROR です。

    • パス： /usr/local/ilogtail/loongcollector.LOG

    • ユースケース：収集エラーが発生した場合は、まず LoongCollector の診断と監視 を使用してエラーを確認します。次に、ログ収集エラータイプ と LoongCollector ランタイムログを使用して問題のトラブルシューティングを行います。

    ユーザー ID ファイル

    • 説明： 収集したログが属するプロジェクトの Alibaba Cloud アカウント ID が含まれます。ファイル名はサフィックスなしのアカウント ID です。このファイルが存在することは、このアカウントがこのサーバーからログを収集する権限を持つことを意味します。

    • パス： /etc/ilogtail/users/{Alibaba Cloud account ID}。

    • ユースケース： ユーザー ID の設定は、他のアカウント配下の ECS インスタンス、自己管理サーバー、または他のクラウドプロバイダーのサーバーからログを収集する場合にのみ必要です。複数のアカウントが同一サーバーからログを収集する必要がある場合は、そのサーバー上に複数のユーザー ID ファイルを作成します。

    カスタム識別子ファイル

    • 説明：カスタム識別子マシン グループの値として使用するカスタム識別子を設定します。これにより、SLS はサーバー上の LoongCollector を検出し、ハートビートを確立できるようになります。

    • パス：/etc/ilogtail/user_defined_id。

    • ユースケース：カスタム識別子マシン グループを使用する場合に必要です。詳細については、「マシン グループと収集設定の関連付け」をご参照ください。

    チェックポイントファイル

    • 説明：データの整合性を確保するため、現在の収集位置を記録します。

    • パス：デフォルトのパスは /tmp/logtail_check_point です。

    • ユースケース：起動パラメーターファイルを変更して、チェックポイントファイルを管理します。詳細については、「制限」をご参照ください。