# LoongCollector 发布记录 ## 最新稳定版从哪里看？ **下载地址、校验和、每条 Release 正文中列出的容器镜像 tag，一律以** [**GitHub — alibaba/loongcollector Releases**](https://github.com/alibaba/loongcollector/releases) **为唯一事实源**；更新文档或脚本前请打开 [当前 latest release 页面](https://github.com/alibaba/loongcollector/releases/latest) 核对（撰写本节时最新 stable tag 为 **v3.3.2**，仅作占位，**以后以页面为准**）。 ### 容器镜像与 `latest` 标签（避免误用） 同一条 Release（例如 [v3.3.2](https://github.com/alibaba/loongcollector/releases/tag/v3.3.2)）正文中通常会并列给出： * **`ghcr.io/alibaba/loongcollector:<版本号>`** 与 **`ghcr.io/alibaba/loongcollector:latest`**（`latest` 由发布流程维护，指向该渠道下的当前最新镜像）。 * **`sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:<版本号>`**（国内镜像同步 **带版本号的 tag**）。 **阿里云该仓库不提供与 GHCR 对等的 `latest` 浮动 tag**；在文档、YAML、`docker pull` 中若省略版本而写 `:latest`，请勿默认阿里云地址可用——**应写明确版本号（如 `3.3.2`），或改用 `ghcr.io/alibaba/loongcollector:latest`。** ### 稳定版索引（摘自 GitHub，LoongCollector 主产品线） 下列为仓库内 **非 prerelease**、且 tag 为 `v3.x` / `loongcollector-0.2.0` 的发布入口，便于跳转；细节与下载表以对应 Release 为准。 | 版本 | 发布日期（UTC） | 备注 | Release | | -------------------- | ---------- | ------------------------------------------------ | --------------------------------------------------------------------------------- | | v3.3.2 | 2026-03-22 | 撰写时的 **latest stable** 。**说明**：该版 arm 架构容器镜像不可用。 | [链接](https://github.com/alibaba/loongcollector/releases/tag/v3.3.2) | | v3.2.6 | 2025-12-23 | **说明**：该版 Release 容器镜像不可用。 | [链接](https://github.com/alibaba/loongcollector/releases/tag/v3.2.6) | | v3.1.4 | 2025-08-28 | | [链接](https://github.com/alibaba/loongcollector/releases/tag/v3.1.4) | | v3.0.11 | 2025-05-28 | | [链接](https://github.com/alibaba/loongcollector/releases/tag/v3.0.11) | | v3.0.5 | 2025-02-26 | | [链接](https://github.com/alibaba/loongcollector/releases/tag/v3.0.5) | | loongcollector-0.2.0 | 2024-11-27 | Alpha 0.2，历史背景见下文 | [链接](https://github.com/alibaba/loongcollector/releases/tag/loongcollector-0.2.0) | 更早的 **v2.x / v1.x** 见文末 iLogtail 发布记录或 [Releases 列表](https://github.com/alibaba/loongcollector/releases)。 ## v3.3.2 以下为 [v3.3.2 Release 正文](https://github.com/alibaba/loongcollector/releases/tag/v3.3.2) 中 **What's Changed** 的归纳，完整列表与 PR 链接见 GitHub。 * 发布与工程化：自动发布工作流重构与测试清理；Release Dockerfile 增补 Kafka 等运行时依赖。 * 配置与采集配置：一次性配置（onetime）处理增强；`PipelineConfig` 中 `ForceRerunWhenUpdate` 默认改为 `false`。 * 主机与容器：`host monitor` 相关问题修复与竞态修复；宿主机模式 stdout 采集优化；Go Docker stdout 使用 regexp2 做容器过滤；CRI 支持 `force_release_deleted_file_fd_timeout`；`ContainerManager` 竞态与文件描述符泄漏类修复。 * 网络与插件：401 鉴权重试前增加延迟；内网域名相关同步；Go metric 崩溃修复；GPU 检测异常处理；**Redis 协议**支持；host monitor 支持 back pipeline。 * 文件采集：旧 checkpoint 含符号链接时，升级后 copy truncate 模式路径解析修复。 * SPL 与构建：`spl` 2.11.6（含空 key 修复）；`loongcollector-build-linux` 镜像 2.1.13→2.1.14。 * 其他：企业版相关插件命名与配置能力；README 社区会议信息；文档 `developer.md` Committer 描述修正等。 **Full Changelog**： ## v3.2.6 以下为 [v3.2.6 Release 正文](https://github.com/alibaba/loongcollector/releases/tag/v3.2.6) 中 **New Features** 与 **What's Changed** 的归纳，完整列表与 PR 链接见 GitHub。 > **说明**：该版 Release 置顶曾提示**容器镜像存在问题、修复中**，拉镜像或投产前请以页面最新说明为准。 * **新特性（Release 置顶列举）**：Host Monitor；原生 `input_static_file_onetime`、`processor_timestamp_filter_native`；Kafka / Doris Flusher；兼容 **Docker v29+**、**containerd v2.0+**。 * **采集与插件**：原生 `input_forward`；**MySQL 协议**；`input_file` 多路径；Kafka Flusher（动态 Topic、Router、TLS、Kerberos、Headers 等）；SLS Flusher 重试计数与扩展头；容器元数据匹配**迁移至 C++**；主机监控多 pipeline 数据一致性、自监控与回灌路径等。 * **性能与数据路径**：集成 **simdjson**；string\_view 解析、span 序列化；按字节限界的 process queue；减少 group 创建；发送侧并发与退火、队列重试与指标增强。 * **稳定性与边缘场景**：容器 FD 释放、checkpoint 与软链 reader、inode 复用与 truncate、文件真正删除后 reader 清理；eBPF 多插件与事件处理；GPU 采集条目修正；**StaticFileServer** 死锁与真实路径/轮转；Windows 中文路径崩溃；进程采集与 JSON 配置截断等问题修复。 * **工程与版本**：Go **1.23.12**；自动发布 CI；`loongcollector-build-linux` **2.1.13**；README LoongSuite、clangd CompilationDatabase、Copilot 说明等。 **Full Changelog**： ## v3.1.4 以下为 [v3.1.4 Release 正文](https://github.com/alibaba/loongcollector/releases/tag/v3.1.4) 中 Milestone **v3.1.4** 下 Features / Fixed / Documentation 的归纳，完整列表与 PR 链接见 GitHub。 * **平台与依赖**：**社区版 Windows** 构建与运行；Enterprise Windows 构建；**Go 升级至 1.23.10**；升级 **client-go** 等依赖。 * **采集配置与行为**：`input_static_file` 与**一次性采集配置**；采集配置热更时若 **Input 类型变化**则完整停止 pipeline；内置 pipeline 误卸载等问题修复。 * **Host Monitor 与系统指标**：实例标签注入 host monitor 指标；**多值指标**发 SLS；系统信息采集扩展（**Load / Mem / Net / Process / Disk / CPU** 等）及多项算法与内存安全修复。 * **eBPF 与安全**：进程 eBPF 乱序事件与缓存管理重构；**文件安全事件**采集；多类 eBPF 插件**统一 epoll** 取数；关闭 process security 局部容器元数据路径等。 * **网络与扩展 Input**：**networkobserver** 支持多配置；**gRPC Input runner** 基础能力；内层 **PipelineEventGroup PB** 解析 Processor；**KafkaSerializer**（含单测）等储备。 * **配置与生态**：支持 **`LOONG_`** 为主的环境/config 前缀，保留 **`ALIYUN_`** 兼容；APM/CMS 后端适配、实体采集兼容低版本 K8s、K8s 元数据 protobuf 与关系类型优化等。 * **构建与质量**：CMake 依赖现代化、消除编译告警；告警级别；**自动发布 workflow**；文档与 benchmark 报告补全等。 * **稳定性修复**：SPL 时间解析失败时 `__time__` 为 0；`JsonLogFileReader` 缓冲区；pipeline 更新时 processor 生命周期；docker inspect 超时；自监控快照崩溃；HashKeys 转换；Windows 路径与 CGO 等。 **Full Changelog**： ## v3.0.11 以下为 [v3.0.11 Release 正文](https://github.com/alibaba/loongcollector/releases/tag/v3.0.11) 中 **What's Changed** 的归纳，完整列表与 PR 链接见 GitHub。 * **Host Monitor 与 Prometheus**：**Host Monitor**；`input_host` CPU 指标；Prometheus target label / agent 信息与 **HPA、Rebalance** 相关能力；指标事件 **map→vector** 标签；Prom **401** 换票；跨分钟 metrics batch。 * **Flusher 与投递**：**FlusherV2 Kafka**；Kafka consumer 循环错误处理；Flusher **未就绪**时新旧 pipeline 数据合并；`flusher_file`、JsonSerializer 等优化。 * **eBPF 输入**：**InputNetworkObserver**、**InputProcessSecurity**、**InputNetworkSecurity**；libbpf/BTF 兼容性更新。 * **容器与 CRI**：**CRI v1**；容器挂载路径并发排序、元数据路径 join；rotator/stdout 在容器停止等场景的文件句柄与尾部采集问题；edge 镜像 arm64 与体积优化等。 * **指标与自监控**：全局 Metric 注册供多模块使用；默认 SLS metric 格式开关调整；自监控目录与 `ExportMetricRecords` 等整理；disk buffer 跳过损坏段。 * **性能与其它**：多行日志切分多线程性能；超时 **Flush** 死锁与 pipeline 退出前释放；pathjoin 根路径拼接；README/benchmark 与开发镜像多次升级；移除 config-server 等工程项。 **Full Changelog**： ## v3.0.5 [v3.0.5 Release](https://github.com/alibaba/loongcollector/releases/tag/v3.0.5) 正文以**下载表与镜像**为主，未附与后续版本同格式的 **What's Changed** 列表，本节按 Release 声明归纳为下。 * **制品**：Linux **amd64**、**arm64** 压缩包与 **SHA256**；**阿里云**社区版容器镜像 `…/loongcollector:3.0.5`。 * **兼容构建**：单独提供面向 **glibc 2.12** 的 **linux-amd64** 包路径（见 Release 表格）。 * **功能明细**：若需自 **Alpha 0.2** 至该 tag 的历史提交对比，可查：（范围较大，适合粗览）。 ## Alpha 版（0.2） 经过几个月的努力与技术演进，现在 LoongCollector Alpha 版（ 0.2 ）发布，我们诚挚邀请广大开发者下载试用，并希望基于实际使用体验向我们提供宝贵的反馈意见。感谢您的支持！ LoongCollector 源自阿里云可观测性团队所开源的 iLogtail 项目，在继承了 iLogtail 强大的日志采集与处理能力的基础上，进行了全面的功能升级与扩展。从原来单一日志场景，逐步扩展为可观测数据采集、本地计算、服务发现的统一体。 LoongCollector 是一款集卓越性能、超强稳定性和灵活可编程性于一身的数据采集器，专为构建下一代可观测 Pipeline 设计。愿景是：打造业界领先的“统一可观测 Agent（Unified Observability Agent）”与“端到端可观测 Pipeline（End-to-End Observability Pipeline）”。 ### 新特性 1. 从日志到全面数据可观测 相对于 iLogtail 专注于日志采集，LoongCollector 将实现采集能力的全面升级，做到可观测采集的 OneAgent 化。 | Input 插件（含文档） | 描述 | 状态（含提案，已发布的可不提供） | | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------- | | [input\_container\_stdio](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/shu-ru-cha-jian/yuan-sheng-shu-ru-cha-jian/input-container-stdio) | 高性能、高可靠容器标准输出。 | 已发布 | | [service\_kubernetes\_meta](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/shu-ru-cha-jian/kuo-zhan-shu-ru-cha-jian/service-kubernetesmeta-v2) | 定时采集Kubernetes元数据，包括Pod、Deployment等资源及其之间的关系。 | 已发布 | | input\_prometheus | 高性能 Prometheus 抓取。 | 开发中 [Prometheus采集能力提案](https://github.com/alibaba/loongcollector/discussions/1920) | | input\_file\_security input\_process\_security input\_network\_security | 基于 eBPF 采集文件、进程、网络相关安全事件。 | 开发中 | | input\_network\_observer | 基于 eBPF 采集网络可观测数据。 | 已发布 [网络可观测提案链接](https://github.com/alibaba/loongcollector/discussions/1919) | | 主机指标 | 定时采集主机系统指标（CPU、内存等）和主机、进程元数据（工作目录、进程语言等） | 开发中 [主机指标提案链接](https://github.com/alibaba/loongcollector/discussions/1921) | 2. 性能与稳定性 * K8s 标准输出采集性能、稳定性提升（已发布） * 通过重构标准输出采集插件，推出了新版插件 input\_container\_stdio，该插件支持日志轮转队列，显著增强了标准输出采集的稳定性。 * 在性能方面，新插件表现优异，在 containerd 和 Docker 环境下，单行日志的平均采集速度分别达到了 250MB/s 和 150MB/s，相比旧版新版插件 service\_docker\_stdout，提升了至少100%。 * 日志典型场景：极简模式、多行切分性能提升 （已发布） * 通过 Event 池化与内存零拷贝等手段，对框架组件的性能进行调优。 * 单行日志与多行日志的平均采集性能分别达到 300MB/s 和 125MB/s，单行日志采集相比 iLogtail 提升了100%。 * 基础稳定性 （已发布） * 支持采集配置热加载隔离，避免了单个采集配置变更导致其它采集配置短时暂停。 * C++ 处理、发送队列实现 Pipeline 级隔离。 3. 更灵活的可编程流水线 * C++ 全面插件化（已发布）：同时提供了充足的组件可供插件自由组合，极大地方便社区新增高性能的输入和输出能力，C++原生插件开发指南详见[如何开发原生Input插件](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/developer-guide/cha-jian-kai-fa/yuan-sheng-cha-jian-kai-fa/how-to-write-native-input-plugins)和[如何开发原生Flusher插件](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/developer-guide/cha-jian-kai-fa/yuan-sheng-cha-jian-kai-fa/how-to-write-native-flusher-plugins)。 * C++ Input 可使用原生 Processor（已发布）：C++ Input插件能够与原生及扩展的Processor插件配合使用，并支持SPL插件。这意味着C++ Input插件不仅可以利用原生Processor提供的高性能来解析日志，还能通过丰富的扩展Processor功能进一步处理日志，具体详情请参阅文档[什么是处理插件](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/chu-li-cha-jian/processors)和[什么是输入插件](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/shu-ru-cha-jian/inputs)。 * Golang Input 可使用原生 Processor （开发中）：Go Input 支持多种灵活的数据源输入，而原生处理插件提供了高性能的数据处理。结合两者的优势，可以构建出既高效又能适应多种应用场景的数据处理采集配置。详见 [Issue](https://github.com/alibaba/loongcollector/issues/1917)。 * SPL 处理模式（已发布）：SPL 处理模式支持用户通过 SPL 语句实现对数据的处理。无需编写代码开发插件，极大地拓展了 LoongCollector 可应用的场景。详见文档 [SPL 处理](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/chu-li-cha-jian/spl-chu-li-cha-jian/processor-spl-native)。 4. [全新的管控协议](https://github.com/alibaba/loongcollector/blob/main/config_server/protocol/v2/README.md) * 协议修订：约定注册、心跳、配置拉取、状态上报等核心管控流程。 * 功能增强：支持心跳数据压缩，支持配置结果反馈上报，使用标志位支持功能兼容扩展。 * 管控范围：从仅持续采集配置（collection pipeline）扩展为**持续采集配置**、**一次性采集配置**与\*\*实例级配置（instance\_config）\*\*的统一管控。 * 整体进展：协议完成、客户端支持、服务端开发中。 [\[Discussion\] ConfigServer v2 Implementation](https://github.com/alibaba/loongcollector/discussions/1916) 5. [LoongCollector 目录结构优化](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/installation/loongcollector-dir)（已发布） iLogtail 开源初期有较多历史包袱，造成了工作目录结构不清晰。LoongCollector 专门进行了目录结构优化，将配置、日志、运行数据等进行分离。 6. [自监控全面优化](https://github.com/alibaba/loongcollector/discussions/1928)，更完整、清晰展示 Loongcollector 自身运行状态 针对 Loongcollector 的自监控指标，进行了全面的优化改进，使得自身运行状态的展示更加完整和清晰。用户可以直观地了解到各项指标的实时变化，快速定位潜在问题。此外，通过合理的数据分类和分级展示，用户可以更方便地进行系统调优和资源管理，从而提高整体运行效率。我们将自监控指标改造为了内置采集配置（collection pipeline），可以将自监控指标自定义发送到不同的位置。 7. [全新的官网](https://observability.cn/project/loongcollector/readme) （已发布） 鉴于 gitbook 网络不稳定，将官网移植到“可观测中文社区”，以便享受更便捷的文档服务。 可观测中文社区作为一个以“运维可观测”为核心的开放、包容、分享的技术社区，旨在聚集运维专家、开发者和爱好者，共同探讨、学习和分享可观测最佳实践与最新技术。 ### 限制说明 1. eBPF 相关 Pipeline 支持的最低内核版本为 4.19，支持的架构为 x86 64 位，操作系统支持 Linux。 2. Prometheus 指标数据采集依赖 Operator 提供的 TargetAllocator 能力，暂未开源。 3. Windows 版暂未推出，敬请期待。 ### 不兼容变更说明 1. 文件目录布局与文件命名跟 iLogtail 2.0 版本有所变化，如果某些环境对特定目录、文件有所依赖，则需要注意该变化。 2. 部分自监控指标命名跟 iLogtail 2.0 版本不一致，LoongCollector 重新规范了所有自监控指标的命名和上报方式。 3. 开发镜像升级，新增部分依赖库。使用 iLogtail 开发镜像开发 Loongcollector 会出现依赖库链接错误。建议使用loongcollector 开发镜像 2.1.2 版本及以上。 ### 版本发布时间 2024.11.27 ### Download | **Filename** | **OS** | **Arch** | **SHA256 Checksum** | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [loongcollector-0.2.0.linux-amd64.tar.gz](https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/0.2.0/loongcollector-0.2.0.linux-amd64.tar.gz) | Linux | x86-64 | [loongcollector-0.2.0.linux-amd64.tar.gz.sha256](https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/0.2.0/loongcollector-0.2.0.linux-amd64.tar.gz.sha256) | | [loongcollector-0.2.0.linux-arm64.tar.gz](https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/0.2.0/loongcollector-0.2.0.linux-arm64.tar.gz) | Linux | arm64 | [loongcollector-0.2.0.linux-arm64.tar.gz.sha256](https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/0.2.0/loongcollector-0.2.0.linux-arm64.tar.gz.sha256) | ### Docker Image Docker Pull Command ```bash docker pull sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:0.2.0 ``` ## iLogtail 版本 [iLogtail 发布记录(2.x版本)](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/installation/fa-bu-ji-lu/release-notes-ilogtail-2x) [iLogtail 发布记录(1.x版本)](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/installation/fa-bu-ji-lu/release-notes-ilogtail-1x)