すべてのプロダクト
Search

このプロダクト

    Simple Log Service:Logtail および LoongCollector の互換性

    ドキュメントセンター

    Simple Log Service:Logtail および LoongCollector の互換性

    最終更新日:Jun 18, 2026

    Logtail と LoongCollector は、異なる名称で呼ばれる同一のログ収集ソフトウェアです。本トピックでは、バージョン間での動作変更点を説明し、アップグレードおよびロールバック手順を提供します。

    バージョン間の動作変更

    バージョン命名

    Logtail、iLogtail、および LoongCollector は同一のソフトウェアを指します。

    • Logtail/iLogtail：バージョン 3.0 より前のバージョン。

    • LoongCollector：バージョン 3.0 以降。

    ログおよびタグの解析標準化

    1. ログエンティティ内の重複キー：

      • バージョン 1.8 以降：ログエンティティ内に重複キーは許可されません。たとえば、入力が content: xxx, content: yyy の場合、content: xxx のみが保持されます。

      • バージョン 1.8 より前：すべての重複キーが保持され、リネームされます。たとえば、出力は content: xxx, content_0: yyy となります。

    2. ログタグ内の重複キー：

      • バージョン 1.8 以降：ログタグ内に重複キーは許可されません。たとえば、入力が __tag__:tag: xxx, __tag__:tag: yyy の場合、__tag__:tag: xxx のみが保持されます。

      • バージョン 1.8 より前：すべての重複キーが保持され、リネームされます。たとえば、出力は __tag__:tag: xxx, __tag__:tag_0: yyy となります。

    単一行および複数行ログの処理

    1. 例外処理：

      • バージョン 2.x：デフォルトで、ログは \n で分割されます。一致しないコンテンツを破棄するには、Multiline.UnmatchedContentTreatment パラメーターを discard に設定します。

      • バージョン 1.x：ログが複数行開始パターンに一致しない場合、コンテンツ全体が単一行ログとして処理されます。

    2. 最終ログ行の処理：

      • バージョン 1.8 より前：改行で終わらない最終ログ行、または最終マルチラインセグメントは、改行または次のマルチラインセグメントを受信するまで出力されません。

      • バージョン 1.8 以降：この動作はタイムアウト機構によって制御されます。最終セグメントの整合性を確保するため、デフォルト遅延は 60 秒です。バージョン 2.0 以降では、グローバル制御パラメーターは default_reader_flush_timeout、収集設定レベルの制御パラメーターは FlushTimeoutSecs です。アプリケーションで低遅延が求められる場合は、これらのパラメーターを調整してください。ただし、ログが切り捨てられる可能性があるため、これらのパラメーターを 0 に設定しないでください。

    タグ処理

    拡張によって処理されたタグは、content 構造ではなく、データモデル の tags 構造に書き込まれます。これによりストレージ容量が削減されます。

    • データ消費シナリオに影響があります。ダウンストリームコンシューマーとの互換性を確認してください。

    • クエリシナリオには影響しません。

    コンテナログ収集パスの深さ

    ACK クラスターからコンテナログを収集する際、ACK コンソール を使用して構成を作成する場合：

    • バージョン 2.0 以降：フォルダのデフォルト最大再帰深さは 0 です。収集パスに /**/ が含まれる場合、深さは 10 になります。

    • バージョン 2.0 より前：デフォルト最大再帰深さは 100 です。

    ホストシナリオ

    Logtail から LoongCollector へのアップグレード

    ご利用のホストオペレーティングシステムに基づき、適切なコマンドを実行して Logtail を LoongCollector にアップグレードします。

    ホストタイプ

    オペレーティングシステム

    ダウンロード方法

    インストール方法

    Linux

    ARM

    ホストがインターネットにアクセス可能な場合、スクリプトを直接ダウンロードします。

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    ネットワーク環境に応じてインストールコマンドを選択します。

    # パブリックネットワークからインストール
chmod +x loongcollector.sh; ./loongcollector.sh upgrade

    x86-64

    ARM

    ホストがオフラインの場合、まずパブリックネットワークにアクセス可能なサーバーでインストールスクリプトとパッケージをダウンロードします。

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

    インストールスクリプトとパッケージをご利用の LoongCollector インストール先サーバーにコピーし、インストールコマンドを実行します。

    # ローカルからインストール
chmod +x loongcollector.sh; ./loongcollector.sh upgrade-local

    x86-64

    ホストがオフラインの場合、まずパブリックネットワークにアクセス可能なサーバーでインストールスクリプトとパッケージをダウンロードします。

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    以下の出力が表示された場合、アップグレードは成功しています。

    Try to stop ilogtail ...
kill process Name: ilogtail pid: 878
kill process Name: ilogtail pid: 879
stop successfully
Stop ilogtail successfully.
Upgrading loongcollector files ...
Upgrade loongcollector files successfully.
Starting loongcollector ...
loongcollector is running
Upgrade loongcollector successfully.

    LoongCollector から Logtail へのロールバック

    LoongCollector を Logtail にロールバックするには、適切なコマンドを実行します。

    説明

    logtail.sh スクリプトを再度ダウンロードしてください。古いスクリプトを再利用しないでください。

    オペレーティングシステム

    ダウンロード方法

    アップグレード方法

    ARM および x86-64

    ホストがインターネットにアクセス可能な場合：

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

    ダウンロード完了後、アップグレードコマンドを実行します。

    chmod +x logtail.sh; sudo ./logtail.sh upgrade;

    特定のバージョンを指定する場合は、代わりに以下のコマンドを実行します。

    # 例：バージョン 1.8.7 を使用する場合。必要に応じてバージョン番号を置き換えてください。
chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

    ARM

    ホストがオフラインの場合、まずインターネットにアクセス可能なサーバーでインストールスクリプトとパッケージをダウンロードします。

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz;

    インストールスクリプトとパッケージを対象サーバーにコピーし、アップグレードコマンドを実行します。

    chmod +x logtail.sh; ./logtail.sh upgrade-local;

    x86-64

    ホストがオフラインの場合、まずインターネットにアクセス可能なサーバーでインストールスクリプトとパッケージをダウンロードします。

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz;