LoongCollector 发布记录

最新稳定版从哪里看？

下载地址、校验和、每条 Release 正文中列出的容器镜像 tag，一律以 GitHub — alibaba/loongcollector Releases 为唯一事实源；更新文档或脚本前请打开 当前 latest release 页面 核对（撰写本节时最新 stable tag 为 v3.3.2，仅作占位，以后以页面为准）。

容器镜像与 `latest` 标签（避免误用）

同一条 Release（例如 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 架构容器镜像不可用。	链接
v3.2.6	2025-12-23	说明：该版 Release 容器镜像不可用。	链接
v3.1.4	2025-08-28		链接
v3.0.11	2025-05-28		链接
v3.0.5	2025-02-26		链接
loongcollector-0.2.0	2024-11-27	Alpha 0.2，历史背景见下文	链接

更早的 v2.x / v1.x 见文末 iLogtail 发布记录或 Releases 列表。

v3.3.2

以下为 v3.3.2 Release 正文 中 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：https://github.com/alibaba/loongcollector/compare/v3.2.6...v3.3.2

v3.2.6

以下为 v3.2.6 Release 正文 中 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：https://github.com/alibaba/loongcollector/compare/v3.1.4...v3.2.6

v3.1.4

以下为 v3.1.4 Release 正文 中 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：https://github.com/alibaba/loongcollector/compare/v3.0.11...v3.1.4

v3.0.11

以下为 v3.0.11 Release 正文 中 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：https://github.com/alibaba/loongcollector/compare/v3.0.5...v3.0.11

v3.0.5

v3.0.5 Release 正文以下载表与镜像为主，未附与后续版本同格式的 What's Changed 列表，本节按 Release 声明归纳为下。

• 制品：Linux amd64、arm64 压缩包与 SHA256；阿里云社区版容器镜像 …/loongcollector:3.0.5。
• 兼容构建：单独提供面向 glibc 2.12 的 linux-amd64 包路径（见 Release 表格）。
• 功能明细：若需自 Alpha 0.2 至该 tag 的历史提交对比，可查：https://github.com/alibaba/loongcollector/compare/loongcollector-0.2.0...v3.0.5（范围较大，适合粗览）。

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	高性能、高可靠容器标准输出。	已发布
   service_kubernetes_meta	定时采集Kubernetes元数据，包括Pod、Deployment等资源及其之间的关系。	已发布
   input_prometheus	高性能 Prometheus 抓取。	开发中 Prometheus采集能力提案
   input_file_security  input_process_security  input_network_security	基于 eBPF 采集文件、进程、网络相关安全事件。	开发中
   input_network_observer	基于 eBPF 采集网络可观测数据。	已发布 网络可观测提案链接
   主机指标	定时采集主机系统指标（CPU、内存等）和主机、进程元数据（工作目录、进程语言等）	开发中 主机指标提案链接

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插件和如何开发原生Flusher插件。
   • C++ Input 可使用原生 Processor（已发布）：C++ Input插件能够与原生及扩展的Processor插件配合使用，并支持SPL插件。这意味着C++ Input插件不仅可以利用原生Processor提供的高性能来解析日志，还能通过丰富的扩展Processor功能进一步处理日志，具体详情请参阅文档什么是处理插件和什么是输入插件。
   • Golang Input 可使用原生 Processor （开发中）：Go Input 支持多种灵活的数据源输入，而原生处理插件提供了高性能的数据处理。结合两者的优势，可以构建出既高效又能适应多种应用场景的数据处理采集配置。详见 Issue。
   • SPL 处理模式（已发布）：SPL 处理模式支持用户通过 SPL 语句实现对数据的处理。无需编写代码开发插件，极大地拓展了 LoongCollector 可应用的场景。详见文档 SPL 处理。

4. 全新的管控协议

   • 协议修订：约定注册、心跳、配置拉取、状态上报等核心管控流程。
   • 功能增强：支持心跳数据压缩，支持配置结果反馈上报，使用标志位支持功能兼容扩展。
   • 管控范围：从仅持续采集配置（collection pipeline）扩展为持续采集配置、一次性采集配置与**实例级配置（instance_config）**的统一管控。
   • 整体进展：协议完成、客户端支持、服务端开发中。 [Discussion] ConfigServer v2 Implementation

5. LoongCollector 目录结构优化（已发布）

   iLogtail 开源初期有较多历史包袱，造成了工作目录结构不清晰。LoongCollector 专门进行了目录结构优化，将配置、日志、运行数据等进行分离。

6. 自监控全面优化，更完整、清晰展示 Loongcollector 自身运行状态

   针对 Loongcollector 的自监控指标，进行了全面的优化改进，使得自身运行状态的展示更加完整和清晰。用户可以直观地了解到各项指标的实时变化，快速定位潜在问题。此外，通过合理的数据分类和分级展示，用户可以更方便地进行系统调优和资源管理，从而提高整体运行效率。我们将自监控指标改造为了内置采集配置（collection pipeline），可以将自监控指标自定义发送到不同的位置。

7. 全新的官网 （已发布）

   鉴于 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	Linux	x86-64	loongcollector-0.2.0.linux-amd64.tar.gz.sha256
loongcollector-0.2.0.linux-arm64.tar.gz	Linux	arm64	loongcollector-0.2.0.linux-arm64.tar.gz.sha256

Docker Image

Docker Pull Command

docker pull sls-opensource-registry.cn-shanghai.cr.aliyuncs.com/loongcollector-community-edition/loongcollector:0.2.0

iLogtail 版本

iLogtail 发布记录(2.x版本)

iLogtail 发布记录(1.x版本)