Simple Log Service: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 クラスターからコンテナログを収集する場合：

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

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

ホストシナリオ

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

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

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

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;

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

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 にロールバックします。

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;

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;

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/x86_64/logtail-linux64.tar.gz;