記載代理程式的發行說明

請參閱此版本說明以瞭解. 的更新內容 記載代理程式。

2026年7月13日

記載代理程式 版本發布 1.9.0

記載代理程式 1.9.0 版本適用於、、、RHEL 9、20、22、24、11、12 以及 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v5.0.6。

此版本包含以下變更：

  • 已將 Fluent Bit 的主要版本更新至 5.0.6。
  • 改進了除錯記錄與診斷功能。
  • 已啟用對使用者自訂映像拉取密鑰及映像名稱的 Helm 支援。

以下新的 記載代理程式 套件現已推出。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Ubuntu20

Ubuntu 22

Ubuntu 24

Debian 11

Debian 12

Windows

2026 年 4 月 6 日

發佈 記載代理程式 版本 1.8.1

記載代理程式 1.8.1 版本適用於、、、RHEL 9、20、22、24、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v4.2.2.

此版本包括以下顯著變更：

  • 修正 JSON-Array（例如字串、陣列和映射的混合物）的正確處理。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Ubuntu 22

Ubuntu 24

Debian 12

Windows

2026 年 2 月 20 日

發佈 記載代理程式 版本 1.8.0

記載代理程式 1.8.0 版本適用於、、、RHEL 9、20、22、24、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v4.2.2.

此版本包括以下顯著變更：

  • 更新 Fluent Bit 主版本為 4.2.2
  • 新增對 Ubuntu 24 平台的支援
  • 新增對 Helm 的支援，可在輸出中使用正規表達式進行比對，以便根據記錄的標籤值有選擇性地傳送記錄

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Ubuntu 22

Ubuntu 24

Debian 12

Windows

2025年12月15日

版本 記載代理程式 發佈 1.7.1

記載代理程式 版本 1.7.1 適用於 RHEL 9、Ubuntu 20 Red Hat OpenShift on IBM Cloud、Ubuntu 22 RHEL8、Debian 11 IBM Cloud Kubernetes Service、Debian 12 以及 Windows。 此版本基於 Fluent Bit v4.0.8.

此版本包括以下顯著變更：

  • 修改以確保記錄具備正確的時間戳記與元數據
  • failed log 平台指標現已正確回報，不再顯示為實際遺漏日誌數量的兩倍

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 10 月 30 日

發佈 記載代理程式 版本 1.7.0

記載代理程式 版本 1.7.0 適用於 IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11、Debian 12 和 Windows。 此版本基於 Fluent Bit v4.0.8.

此版本包括以下顯著變更：

  • 更新 Fluent Bit 主版本至 4.0.8。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 9 月 12 日

發佈 記載代理程式 版本 1.6.3

記載代理程式 1.6.3 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v3.2.10.

此版本包括以下顯著變更：

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 8 月 26 日

發佈 記載代理程式 版本 1.6.2

記載代理程式 1.6.2 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v3.2.10.

此版本包括以下顯著變更：

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 6 月 26 日

發佈 記載代理程式 版本 1.6.1

記載代理程式 1.6.1 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v3.2.10.

此版本包括以下顯著變更：

  • 您可以設定每個記錄所包含的 Kubernetes 元資料欄位。 預設情況下，只保留必要欄位，例如 pod_name, namespace_name，和 container_name。 這有助於減少與每個日誌一起儲存的元資料數量，並降低儲存成本。 如需詳細資訊，請參閱 啟用 Kubernetes 過濾器，以 Kubernetes 元資料豐富日誌 內容。

  • 能夠為所有區段新增自訂組態。

    每個服務、分析器和管道（輸入、處理器、過濾器和輸出）都可選擇配置預設配置不一定會顯示的其他設定。

    必要時，下列設定可用於更進階的設定：

    • additionalServiceOptions
    • additionalKubeLogInputProcessors
    • additionalInputs
    • additionalFilters (可能的話，請使用 ) additionalKubeLogInputProcessors
    • additionalOutputs
    • additionalParsers

  • 增強系統檔案處理 /var/log (例如 syslog, messages, kubelet.log)。

    使用 systemLogs 設定取代 additionalLogSourcePaths 設定，以獲得更詳細的主機檔案：

    • 時間戳會根據 syslog 檔案的格式進行解析。
    • 跳過 Kubernetes 過濾器，這將減少日誌中的警告並改善效能。
    • 在 IBM Cloud Logs 中，subsystemName 是主機檔案名稱，不含路徑。
    • 在 IBM Cloud Logs 中，applicationName 是節點的主機名稱。
    • 群集名稱仍會記錄在 kubernetes.cluster_name 中，以便與容器日誌一致，以便過濾。

  • 多行模式更容易設定。

    enableMultiline: true 選項可與 multilinePreprocessor 一起使用，以覆寫預設的多行處理器，使其更適合您的情況。

  • 跳過 Kubernetes 過濾器的選項

    enableKubernetesFilter: false 選項可用於繞過 Kubernetes 外掛程式。 這意味著 Kubernetes 的某些元資料將無法使用，而 Kubernetes 過濾器所提供的某些進階解析功能（例如使用容器註解來控制解析器）也將無法使用。

  • 在 記載代理程式 和 IBM Cloud Logs 之間的連線初步測試成功之後，所有失敗的記錄傳輸都會重試，不論收到的是什麼錯誤。

  • 修正了在 values.yaml 檔案中設定 defaultMetadata 時會導致設定無效的錯誤。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 6 月 5 日

發佈 記載代理程式 版本 1.6.0

記載代理程式 1.6.0 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 Fluent Bit v3.2.10.

此版本包括以下顯著變更：

  • 更新 Fluent Bit 至版本 3.2.10
  • 現在可以設定代理使用 代理。
  • IBM Cloud Kubernetes Service 和 Red Hat OpenShift on IBM Cloud 所提供的 helm 圖表現在使用 Fluent Bit yaml 基於設定的檔案。 這取代了將在 2025 年底被 Fluent Bit 廢棄的經典配置。 在 1.6.0 之前的 helm 版本中使用的 helm values.yaml 檔案與 1.6.0 相容。 自訂組態的使用者可能需要在套用此版本的舵手圖之前採取行動。 如果您是在部署 helm 圖之後編輯配置映射檔案，那麼您需要對您的程序進行變更。 1.6.0 會介紹一些額外的設定值，讓您的代理程式設定更具彈性。 如需詳細資訊，請參閱 使用 1.6.x Helm 圖表部署 記載代理程式 的範本。

向後相容性：您仍然可以使用您現有的 logs-values.yaml 檔案，從版本 1.5.x 到版本 1.6.0。 過渡的設計不會造成干擾。

已廢棄 到 2025 年底，Fluent Bit 將正式不支援經典組態模式。 我們建議儘快轉移至 YAML 格式，以便與未來的更新保持一致。 您可以在較新版本的 Fluent Bit 代理中繼續使用之前基於經典配置模式的 Helm 圖表版本，但到 2025 年底，Fluent Bit 將不支援經典配置模式。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 5 月 12 日

發佈 記載代理程式 版本 1.5.2

記載代理程式 1.5.2 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 fluentbit v3.2.7.

此版本包括以下顯著變更：

  • 透過確保可接受的值，改善嚴重性解析。 如需詳細資訊，請參閱 瞭解記錄代理如何解析嚴重性。
  • 解決了代理程式以反序列化錯誤回應報告丟失記錄訊息的情況。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 3 月 25 日

發佈 記載代理程式 版本 1.5.1

記載代理程式 1.5.1 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 fluentbit v3.2.7.

此版本包括以下顯著變更：

  • 在 記載代理程式 下載中新增通知檔案，以提供授權資訊。
  • 將包含 JSON key 的代理日誌行變更為 # 號，以避免在 IBM Cloud Logs 中查詢日誌行時發生錯誤。
  • 配置 SecurityContextConstraints 時，請使用 openshift.io/required-scc 註解，而非 priority 配置，以避免與其他 OpenShift 元件衝突。
  • 修正漏洞。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2025 年 3 月 7 日

發佈 記載代理程式 版本 1.5.0

記載代理程式 1.5.0 版本適用於、、、RHEL 9、20、22、11、12 和 Windows。IBM Cloud Kubernetes Service Red Hat OpenShift on IBM Cloud RHEL8 Ubuntu Ubuntu Debian Debian 此版本基於 fluentbit v3.2.7.

此版本包括以下顯著變更：

  • 更新流暢位元版本至 v3.2.7。
  • 已在 helm 中新增設定，以便在部署變更時重新啟動 Pod，但只更新機密或配置表。
  • 修正了 Trusted Profile for VSI 令牌更新的錯誤，當令牌過期時，該錯誤會間歇性地報告 401 錯誤。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2024 年 12 月 13 日

發行 記載代理程式 1.4.2 版

記載代理程式 1.4.2 版適用於 IBM Cloud Kubernetes Service, Red Hat OpenShift on IBM Cloud, RHEL8, RHEL 9, Ubuntu 20, Ubuntu 22，以及 Debian 11, Debian 12，和 Windows。 此版本基於 Fluentbit v3.1.9。

此版本包括以下顯著變更：

  • 將代理快取移至主機儲存，以確保代理重新啟動時能夠使用快取。
  • 已新增 PriorityClass 用於代理 Helm 安裝，以確保已部署 daemonsets。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2024 年 12 月 6 日

發布記載代理程式版本1.4.1

記載代理程式版本1.4.1適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11、Debian 12 和 Windows。 此版本基於 Fluentbit v3.1.9。

此版本包括以下顯著變更：

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

Windows

2024 年 11 月 21 日

發布記載代理程式版本1.4.0

記載代理程式版本1.4.0適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.1.9。

此版本包括以下顯著變更：

  • IBM Cloud Logs輸出外掛程式中的並發處理變更。
    • 用戶可能需要更新輸出插件以包含 workers 選項。
  • 改進了直接將資料傳送到IBM Cloud Logs時連接問題的錯誤處理。
  • 解決了某些日誌條目錯誤地分組到 ibm-subsystem-not found 子系統中的問題。
  • 支援自訂 IAM 環境。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 10 月 24 日

發布記載代理程式版本1.3.2

記載代理程式版本1.3.2適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.1.9。

此版本包括以下顯著變更：

  • 將 Fluentbit 版本更新為 v3.1.9。
  • VSI 可信任設定檔支援直接傳送到IBM Cloud Logs。
  • 支援使用不同驗證表單的多個IBM Cloud Logs輸出。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 10 月 10 日

發布記載代理程式版本1.3.1

記載代理程式版本1.3.1適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.1.4。

此版本包括以下顯著變更：

  • logger-icl-output-plugin 現在使用高解析度時間戳來保持日誌順序。
  • 刪除了輸出插件中的雙重 JSON 封送處理。
  • 並發性和性能改進。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 9 月 2 日

發布記載代理程式版本1.3.0

記載代理程式版本1.3.0適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.1.4。

此版本包括以下顯著變更：

  • logger-agent-plugin 現在支援特定於節的 API 金鑰。
  • systemd 插件現已啟用。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 8 月 7 日

發布記載代理程式版本1.2.4

記載代理程式版本1.2.4適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.1.4。

此版本包括以下顯著變更：

  • 更新至 Fluentbit 版本
  • logSourceCRN 重新命名為 customerCRN
  • 變更向IBM Cloud Logs傳送訊息時代理程式中的重試邏輯
  • 能夠以 JSON 格式將日誌傳送到IBM Cloud Logs

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 7 月 11 日

發布記載代理程式版本1.2.3

記載代理程式版本1.2.3適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.0.4。

此版本包括以下顯著變更：

  • 新增了可以作為容器 sidecar 運行的記載代理程式映像。
    • icr.io/ibm/observe/logs-router-agent-sidecar
  • 修復了與處理有效負載效率相關的錯誤。
  • 使用者現在可以使用可選的 --send-directly-to-icl 標誌將日誌直接傳送到Linux代理程式中的IBM Cloud Logs

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 6 月 10 日

發布記載代理程式版本1.2.2

記載代理程式版本1.2.2適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL8、RHEL 9、Ubuntu 20、Ubuntu 22、Debian 11 和Debian 12。 此版本基於 Fluentbit v3.0.4。

此版本包括以下顯著變更：

  • 啟用每條訊息確認。 借助此功能，代理程式傳送至攝取器的每個事件包都會指派一個 ID，並且一旦事件包透過資料平面傳送IBM Cloud Logs Routing攝取器就會向代理程式傳送確認。 這有助於避免遺失日誌事件，例如由於異常連接關閉或網路中斷，因為代理將重新發送未確認的套件。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 8

RHEL 9

Debian 11

Ubuntu20

Debian 12 和Ubuntu 22

2024 年 5 月 29 日

發布記載代理程式版本1.2.0

記載代理程式版本1.2.0適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL 9、Ubuntu 22 和Debian 12. 此版本基於 Fluentbit v3.0.4，其中包括針對內部追蹤介面中的漏洞的關鍵安全修復。 強烈建議您升級到此代理版本。

此版本包括以下顯著變更：

  • 修復了 CVE-2024-4323。
  • 修正了 kubernetes 過濾器中的錯誤，當多個 pod 或命名空間共享公共基本子字串時，可能會套用錯誤的標籤和註解。
  • 為非容器化代理程式（直接在Linux主機上執行的代理程式）啟用 IAM 可信任設定檔。
  • 將Kubernetes init 容器重新命名為 logs-router-agent-init。 先前的 logger-agent-init 標籤仍然可以使用，但 logger-agent-init 標籤將來將被停用，鼓勵使用者更新其部署 yaml 檔案以引用新的鏡像標籤。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 9

Debian 12 和Ubuntu 22

2024 年 5 月 1 日

發布記載代理程式版本1.1.1

記載代理程式版本1.1.1適用於IBM Cloud Kubernetes Service、Red Hat OpenShift on IBM Cloud、RHEL 9、Ubuntu 22 和Debian 12. 此版本基於 Fluentbit v3.0.2，其中包括一個關鍵修復，用於將背壓訊號從特定過濾器插件傳遞到輸入插件。

以下新的記載代理程式套件可用。

安裝需要這兩個軟體包。

RHEL 9

Debian 12 和Ubuntu 22

2024 年 4 月 29 日

發布記載代理程式版本1.1.0

以下新的記載代理程式套件可用：

安裝需要這兩個軟體包。

RHEL 9

Debian 12 和Ubuntu 22

RHEL 8

Debian 11

Ubuntu20