すべてのプロダクト
Search

このプロダクト

    Simple Log Service:Logtail と LoongCollector の互換性

    ドキュメントセンター

    Simple Log Service:Logtail と LoongCollector の互換性

    最終更新日:Mar 02, 2026

    このトピックでは、Logtail と LoongCollector のバージョンの違いについて説明します。また、Logtail から LoongCollector へのアップグレード方法と、LoongCollector から Logtail へのロールバック方法についても説明します。

    バージョンの比較

    バージョンの命名規則の変更

    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 より前では、この値は調整できません。バージョン 2.0 以降では、グローバル制御パラメーターは default_reader_flush_timeout で、収集構成レベルの制御パラメーターは FlushTimeoutSecs です。ご利用のアプリケーションが遅延に敏感な場合は、これらのパラメーターを調整できます。これらのパラメーターを 0 に設定しないでください。ログの切り捨てが発生する可能性があります。

    タグ処理メカニズムの変更

    拡張機能によって処理されたタグは、content 構造ではなく、データモデルの tags 構造に書き込まれます。この方法により、スペースを大幅に節約できます。

    • これはデータ消費シナリオに影響を与え、互換性の処理が必要になります。

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

    コンテナーログ収集パスの変更

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

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

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

    ホストシナリオでの Logtail から LoongCollector へのアップグレード

    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 スクリプトを再度ダウンロードする必要があります。古い 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;