This topic describes what's new, improved, and fixed in each LoongCollector release.
Image repository: aliyun-observability-release-registry.${region}.cr.aliyuncs.com/loongcollector/loongcollector
Examples:
China (Hangzhou):
aliyun-observability-release-registry.cn-hangzhou.cr.aliyuncs.com/loongcollector/loongcollector:${image_tag}Asia Pacific SE 1 (Singapore):
aliyun-observability-release-registry.ap-southeast-1.cr.aliyuncs.com/loongcollector/loongcollector:${image_tag}
3.3.3
Release date: 2026-03-19
Image tag: v3.3.3.0-f44ebb3-aliyun
New features
Added a back pipeline to host monitoring for failover when the primary pipeline is unavailable.
Moved the
force_release_deleted_file_fd_timeoutparameter to the Golang CRI module to force the release of file descriptors for deleted containers after a timeout.Added the
disable_identity_detectflag to skip identity detection processes, such as ECS metadata acquisition. This is useful for deployments that do not require cloud identity recognition.
Fixes
Fixed multiple race conditions in the C++ ContainerManager module that occurred during container information updates and lock contention.
3.3.2
Release date: 2026-02-10
Fixes
Fixed a file descriptor leak caused by performing the
pop_frontoperation twice on the reader array during event handling, which prevented file descriptors from being released correctly.Fixed an SPL v2.11.6 exception on empty keys: null value fields in
PipelineEventGroupOutputused the wrong conditional logic.Fixed Copy Truncate mode resolving symbolic link paths incorrectly after an upgrade from an older checkpoint. Older checkpoints stored the symlink path, not the real path, which broke file matching.
3.3.1
Release date: 2026-01-21
Fixes
Fixed a process crash (signal 6) that occurred during GPU device detection.
Fixed a race in the host monitoring runner destructor when a restart ran before the previous stop finished (undefined behavior). Added a stop-state check and a forced-exit flag for thread-safe lifecycle handling.
Fixed a null pointer panic in the Go plugin during metric export when
ExportMetricRecordsreceived a nil Context or MetricsRecords. Added a nil check to skip invalid records.
Improvements
Bumped the SPL engine to v2.11.6 and the build image to v2.1.14.
3.3.0
Release date: 2026-01-14
New features
eBPF network observability now parses MySQL requests and responses and exports metrics, logs, and spans for application-layer protocol visibility.
The Forward Service now emits self-monitoring metrics for its own health and operation.
Onetime Config management now tracks input hashes and enforces execution timeouts so runs retry on content changes and expired configs clear automatically.
Added subdomain configuration support and streamlined HTTP request header handling.
Fixes
Fixed Enterprise edition domain probing ignoring the DNS cache, which triggered extra lookups and latency.
Fixed immediate retries after HTTP 401 responses. Added a 1-second backoff to reduce invalid request bursts.
Fixed host monitoring counting only the top five processes instead of all processes, which skewed metrics.
Fixed a StaticFileServer deadlock by dropping an unnecessary mutex during input deletion so the static file pipeline no longer hangs.
Reduced the call frequency to the TagResources API to avoid triggering throttling.
Improvements
Replaced the regex engine with regexp2 for Go-based Docker stdout filtering to improve regex matching compatibility and performance.
Set
ForceRerunWhenUpdatein PipelineConfig to default to false (was true) to avoid needless pipeline restarts and collection gaps during config updates.
3.2.6
Image tag: v3.2.6.0-109e584-aliyun
Release date: 2025-12-19
Fixes
Fixed an issue where logs were dropped when the process queue was blocked.
Improvements
Switched the C++ container metadata matching module from
regex_matchtoregex_searchto support existing configurations.Added a host ID to self-monitoring data.
Improved real-path refresh and rotation detection in StaticFileServer.
3.2.5
Image tag: v3.2.5.0-355f573-aliyun
Release date: 2025-12-08
Fixes
Fixed an issue where some checkpoint events were not processed during C++ container updates.
Fixed a metric data parsing failure in forwarding scenarios.
Improvements
Removed an unnecessary sleep operation in the HTTP sink to improve performance.
3.2.4
Image tag: v3.2.4.0-984bb5f-aliyun
Release date: 2025-12-02
New features
Upgraded Go to version 1.23.12 and updated the Docker Go SDK.
Fixes
Fixed an issue where host monitoring data failed to be sent from the disk buffer.
Fixed a bug in the calculation of average CPU usage for processes.
Fixed an issue where
input_filefailed on Docker v29 and later.Fixed a race condition in the Prometheus future.
3.2.3
Release date: 2025-11-27
New features
Added the
ProcessorTimestampFilterNativeprocessor for native timestamp filtering.Enabled GPU monitoring in the built-in HostMonitor pipeline.
Fixes
Removed invalid GPU collector entries.
Improved error handling and logging for the flusher and sender queue.
Removed the unsupported pb protocol for Prometheus scraping.
Improvements
Improved handling of container state changes and compatibility with older checkpoint formats.
Improved compatibility for network metric collection.
Removed the index from log events to improve efficiency.
Added a fetch ratio metric to the pipeline monitor.
3.2.2
Release date: 2025-11-25
New features
Enabled GPU monitoring in the built-in HostMonitor pipeline.
Added self-monitoring metrics for host monitoring.
input_filenow supports collection from multiple paths.The SLS flusher now supports adding extra headers and metadata.
Prometheus now supports a host-only scrape mode.
Fixes
Removed invalid GPU collector entries.
Fixed a bug where the disk collector failed to collect data from unmounted disks.
Fixed a crash in the process collector.
Fixed an issue where FileServer was not paused when switching input types.
Fixed an issue where a reader could not be created for a symbolic link file.
Fixed an issue where a single event was not returned to the event pool.
Fixed an error in
ConfigWatcherUnittest.Fixed a calculation error for the
config_countmetric.Fixed a singleton conflict loop issue.
Fixed an issue with ECS metadata updates.
Improvements
Improved the performance of span serialization and deserialization.
Reduced string copying in host monitoring.
Added a time annealing mechanism to the concurrency adjustment module.
Added timeout logic to the concurrency control code to prevent frequent retries.
Improved error handling and logging for the flusher and sender queue.
Enhanced queue management by adding retry logic and metrics.
Reported
process_queuemetrics to the pipeline.Added a target tag to the sender queue.
Added throttling to
MetricSenderto prevent theextraBufferfrom becoming full.Resolved a Go time drift issue that occurred when tasks were slow.
Fixed an issue that caused duplicate elements in
regionconfig.
3.2.1
Release date: 2025-10-29
New features
Added a GPU metric collector based on the NVIDIA Data Center GPU Manager (DCGM).
Integrated metric reporting in StaticFileServer.
Added a built-in pipeline to report container metadata.
input_static_file_onetimenow supports reporting task status.Added a
retry_totalcounter to the SLS flusher.
Fixes
Fixed an issue where readers were not cleaned up when a file was deleted, which caused truncation when the inode was reused.
Fixed build issues on Windows.
Fixed a loading failure caused by an incorrect format in the region information dump.
Fixed an issue with crash stacks on Windows.
Fixed a crash on Windows that occurred when
ExcludeDirscontained Chinese characters.Fixed an issue with current working directory (
cwd) handling for bind mount paths in the security input.
Improvements
Enabled reporting of task status.
Added plugin statistics to the status metrics.
Enriched ECS metadata with more information.
Added ECS metadata to the status metrics.
Migrated the container metadata matching logic to a C++ implementation.
3.2.0
Release date: 2025-09-23
New features
Enabled
input_static_file_onetimeand added basic end-to-end (E2E) tests.Added internal configurations for host monitoring.
Integrated the simdjson library for high-performance JSON parsing.
LoongCollector now supports RAM authentication.
Fixes
Fixed multiple issues with eBPF plugin management and event handling.
Fixed a concurrency issue in the Timer class that caused monitoring points to be lost.
Corrected the file reading logic in
InitFromFile.Fixed a throttling issue in the flusher runner.
Fixed an issue where the network collector failed to obtain IPv6 information.
Fixed a memory leak in the process collector.
Fixed an issue that caused the
ParseConfigfunction to unexpectedly truncate files.Fixed a file descriptor leak in containers when restoring a reader from a checkpoint.
Added a
GetFileSystemInformationcache for the disk collector.Added E2E tests for eBPF file collection.
Fixed compilation issues for the commercial edition on Windows and updated the release manual.
Improvements
Ensured data consistency between multiple host monitoring pipelines.
Added warnings and alerts for potential data loss in
LogFileReader.Reduced group creation to improve memory usage.
Optimized the memory footprint of Kubernetes metadata entities.
Used string view to improve string parsing performance.
Renamed metric flags in
MetricSender.cpp.
3.1.7
Release date: 2025-11-11
New features
Added ECS information, including for ACS and ECI, to agent metrics.
Added a metric for the current throttler limit.
Fixes
Fixed an issue where readers were not cleaned up when a file was deleted, which caused truncation issues when the inode was reused.
Fixed an issue with crash stacks on Windows.
Fixed a crash on Windows that occurred when
ExcludeDirscontained Chinese characters.Fixed compilation issues for the commercial edition on Windows and updated the release manual.
Improvements
Added ECS metadata to the status metrics.
3.1.6
Release date: 2025-10-11
Fixes
Fixed issues with eBPF plugin management and event handling.
Fixed the logic for reading metadata from the host file.
Fixed an unexpected throttling issue in the flusher runner.
Improvements
Added data loss alerts and warnings to
LogFileReader.Added ECS information, including for ACS and ECI, to agent metrics.
Added a retry counter to the SLS flusher.
3.1.5
Release date: 2025-09-09
Fixes
Fixed a file truncation issue in the
ParseConfigfunction.Fixed an issue with container file descriptor release when restoring from a checkpoint.
Fixed an issue where the built-in pipeline was unexpectedly uninstalled.
Fixed an issue where feedback caused timeout events to be popped.
Improvements
Optimized the memory footprint of Kubernetes metadata entities.
3.1.4
Release date: 2025-08-27
New features
Added support for obtaining runtime information from the kernel.
Added the
LOONG_environment variable prefix, maintaining backward compatibility withALIYUN_.
Fixes
Fixed an issue where self-monitoring was missing for v2 pipeline inputs.
Fixed a memory safety issue with process cache values.
Enhanced timeout and zero-width regex warnings for the
Desensitize,Grok, andStringReplaceprocessors.
Improvements
Improved the performance of eBPF file collection.
EntityCollector now supports earlier versions of K8s (1.21 and earlier).
Added an extra source buffer to
PipelineEventGroup.
3.1.3
Release date: 2025-08-08
New features
Added the
ProcessCollector.Added the
NetCollector.
Fixes
Fixed an issue that caused duplicate data collection when restoring progress from older checkpoints.
Improvements
Improved the performance of multi-threaded regex parsing.
Optimized K8s metadata transmission over protobuf.
Modified the implementation of the CPU collector.
NetworkObservernow supports multiple configurations.eBPF plugins now uniformly use epoll to obtain data.
Added type checking for configuration changes.
Added alert levels to alert information.
3.1.2
Release date: 2025-07-25
-
Fixes
Fixed a crash issue in K8s metadata collection.
Fixed an issue where
HashKeyswere not applied during data transformation.Fixed an issue where the SSL library was not correctly linked due to gRPC compilation.
Fixed an issue where
RotatorReaderdid not close files when a container stopped.Fixed an issue where tags were lost when new environment variable configurations were added.
Fixed instruction-set compatibility issues and added a CPU feature check script to CI to validate build environments.
-
Improvements
Refactored the eBPF Server thread model to improve concurrency and stability.
Updated the K8s metadata configuration to add upsert logic for cluster entities.
3.1.1
Release date: 2025-07-02
-
Fixes
Fixed an issue on Ubuntu where the tail mode for journal log collection failed.
Fixed an issue where
RotatorReaderdid not close files when a container stopped.Fixed a crash that occurred when self-monitoring metrics were processed during
DoSnapshot.Fixed
docker inspecttimeouts.Fixed a
start_timeoverflow issue in the self-monitoring metrics of the eBPF parsing module.The management interface now supports the hardened mode for ECS metadata.
-
Improvements
Refactored the eBPF Server thread model to improve concurrency and stability.
Updated the K8s metadata configuration to add upsert logic for cluster entities.
3.1.0
Release date: 2025-06-16
-
Fixes
Fixed a standard output collection failure in ACS scenarios with the new version.
Fixed a crash caused by incorrect JSON log parsing with the GBK encoding format.
Fixed a crash caused by an incorrect null value check when the container runtime was unstable.
Removed null characters (
\0) to improve data processing accuracy.
-
New features
Added support for eBPF security use cases.
3.0.12
Release date: 2025-06-04
-
Fixes
-
Fixed an issue in the container runtime detection logic where the Docker client status was incorrectly determined during a retry.
Fixed an issue that caused garbled text because data pointers were released at an incorrect time during pipeline updates.
Used the current time as a fallback when the SPL parsing time is invalid.
Updated the client-go dependency library to fix an issue with abnormal event generation in iLogtail.
Fixed an issue where the Go logging module would hang when the disk was full, causing log collection to be interrupted.
-
3.0.11
Release date: 2025-05-22
-
Fixes
Fixed a null pointer exception for some data types in K8s metadata.
Fixed a crash caused by the incorrect use of
weak_ptr.Fixed an issue where the older standard output collection plugin did not completely collect the last part of logs when a container stopped.
-
Improvements
The container runtime detection logic now supports the Container Runtime Interface (CRI) v1, making it compatible with containerd 2.0.
Updated K8s metadata association types.
Added a restriction to K8s metadata association, allowing only cluster-level resources to be associated with a cluster.
3.0.10
Release date: 2025-04-24
-
Fixes
LoongCollector now skips abnormal cache files on disk during restarts.
Updated the runc library to fix a file descriptor leak vulnerability.
-
Improvements
Enabled multi-threaded support for multi-line log splitting to improve performance.
3.0.9
Release date: 2025-04-07
-
Fixes
Fixed an issue with instance configuration delivery for the commercial edition.
Fixed an issue where log stack information was incorrect when a C++ module crashed.
3.0.8
Release date: 2025-04-01
-
Fixes
Fixed an issue on Linux where the directory path was concatenated incorrectly when the path in the collection configuration was the root directory.
K8s metadata now supports namespace entities.
Fixed an issue in container scenarios where concurrent writes caused incorrect mount information in the container details.
Fixed a deadlock issue caused by send timeouts.
Added support for
DiscardingNonUTF8in the native filtering plugin.
-
Improvements
Updated the SPL version.
Metric data sending now supports out-of-order data at a one-minute granularity.
3.0.7
Release date: 2025-03-14
-
Fixes
Fixed a use-after-free pointer issue in the timeout sending module during
AliyunPipelineConfigcollection configuration updates.
3.0.6
Release date: 2025-03-03
-
Fixes
Fixed an issue where the SLS metric format was disabled by default for metric data sending.
Fixed the exception handling logic in the Kafka Input plugin to prevent premature returns.
-
New features
Added support for setting the TCP Type of Service (TOS) field in curl.
3.0.5
Release date: 2025-02-20
-
Fixes
Fixed a memory leak in Go caused by a circular reference that prevented
LogStoreconfigobjects from being reclaimed by the garbage collector.Fixed a sending failure caused by local configurations when upgrading from iLogtail to LoongCollector.
Fixed a collection interruption for PersistentVolume (PV) files that occurred because the container state was incorrectly identified as stopped.
-
Improvements
Added configuration names to alert information.
3.0.4
Release date: 2025-02-14
-
Fixes
Fixed an issue with incorrect C++ source tags.
Fixed a parsing issue with the last log line in container standard output scenarios.
Fixed a deadlock issue in
LogtailMonitorduring self-termination.
3.0.2
Release date: 2025-02-07
-
Limitations
Only the log collection feature is supported.