Este tópico descreve as novidades, melhorias e correções incluídas em cada versão do LoongCollector.
Repositório de imagens: aliyun-observability-release-registry.${region}.cr.aliyuncs.com/loongcollector/loongcollector
Exemplos:
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.10
Data de lançamento: 13/08/2026
Tag da imagem: v3.3.10.0-3c7ddcb-aliyun
Alterações incompatíveis
Remoção do plugin de saída obsoleto
flusher_kafka. Configurações de coleta que ainda utilizamflusher_kafkadeixam de funcionar após a atualização para a versão 3.3.10, pois o plugin não está mais registrado. Migre paraflusher_kafka_v2antes de atualizar.
Novos recursos
O plugin
input_agentsightadicionou a opçãoRawHttpsFallbackpara relatório de fallback HTTPS bruto. Essa opção vem desativada por padrão. O tráfego HTTPS que não pode ser analisado como uma chamada LLM padrão e que seria descartado passa a ser relatado como eventos brutos de requisição e resposta HTTP. Isso melhora a observabilidade para tráfego LLM fora do padrão.
Correções
Correção de um problema em que os metadados de rótulos do Kubernetes não eram atualizados prontamente após a reconstrução in-place de um Pod.
Aprimoramento da precisão da medição de RTT ICMP para sondagem de rede (netping). Agora há suporte para latências sub-milissegundo, e o endereço de origem configurado é vinculado às sondas para aumentar a precisão da verificação.
Resolução de uma falha no AgentSight que sobrescrevia o nome da chamada de ferramenta (
tool_call) com um valor vazio ao coletar dados de modelos específicos, como respostas em streaming compatíveis com OpenAI. Consequentemente, o nome relatado ficava vazio.Correção do relato incorreto do campo
host_ipem configurações de coleta do Prometheus.
Melhorias
Reforço das verificações de integridade para solicitações de configuração e validação do identificador de conta (
aliuid).
3.3.9
Data de lançamento: 22/07/2026
Novos recursos
Adição do plugin eBPF
input_agentsightpara fornecer capacidades de coleta de observabilidade de LLM.O plugin de entrada
service_sysloginclui agora a opçãoAutoConfigRsyslog, que gera e valida automaticamente configurações de encaminhamento rsyslog, além de suportar filtragem porfacilityeseverity.Suporte à plataforma Windows no plugin de coleta do Prometheus.
Flexibilização das restrições de combinação entre plugins de entrada nativos e plugins Go. Plugins de entrada nativos podem agora ser combinados livremente com plugins de processamento e saída Go. Anteriormente, tais configurações falhavam na análise. Apenas um pequeno número de combinações incompatíveis permanece restrito.
Inclusão do parâmetro
working_interface. É possível especificar uma interface de rede para resolver o IP do host e usar essa mesma interface como saída para dados. Isso resolve relatos imprecisos de IP do host causados quando a resolução de hostname retornava um endereço incorreto ou de loopback.
3.3.8
Data de lançamento: 25/06/2026
Correções
Correção de uma falha de processo (SIGSEGV) que podia ocorrer em versões do OpenSSL anteriores à 1.1.0 durante requisições HTTP concorrentes multithread.
Resolução de um problema de aumento contínuo de uso de memória em clusters Kubernetes de grande escala quando nós e recursos mudavam frequentemente durante a coleta de metadados.
Correção de um erro de análise de tempo de log que ocorria quando a string de tempo continha caracteres finais que não correspondiam à string de formato, como um sufixo de fuso horário (
+08:00).
3.3.7
Data de lançamento: 09/06/2026
Melhorias
Aprimoramento da detecção de alterações de arquivo e da lógica de saída no modo
whole_file.
3.3.6
Data de lançamento: 29/05/2026
Novos recursos
Adição do plugin de entrada
service_etwpara suportar coleta ETW analítica de DNS no Windows. O plugin captura eventos de consulta e resposta DNS em tempo real por meio de uma sessão independente de consumo ETW.
3.3.5
Data de lançamento: 27/05/2026
Novos recursos
O gerador de entidades Kubernetes agora suporta Custom Resources (CR) e modelagem de associação entre workflows Argo e namespaces, expandindo as capacidades de topologia de entidades Kubernetes.
3.3.4
Data de lançamento: 17/04/2026
Tag da imagem: v3.3.4.0-e8c9e38-aliyun
Novos recursos
Logs multilinha (multiline) ganharam o modo
whole_file, que coleta um arquivo inteiro como uma única entrada de log. Se o log for muito longo, ele é dividido automaticamente por campo. Este modo aplica-se a cenários que exigem que todo o conteúdo do arquivo seja processado como um único registro.
Melhorias
Atualização do motor de processamento SPL.
Melhoria na lógica de resolução de hostname para IP para ignorar interfaces de rede bloqueadas durante a resolução. Anteriormente, em hosts com múltiplas interfaces de rede ou NICs virtuais, o IP do host podia ser resolvido para um endereço de NIC virtual, causando relatórios imprecisos. A precisão na identificação do IP do host foi aumentada.
3.3.3
Data de lançamento: 19/03/2026
Tag da imagem: v3.3.3.0-f44ebb3-aliyun
Novos recursos
Adição de um pipeline de backup ao monitoramento de host para failover quando o pipeline principal estiver indisponível.
Movimentação do parâmetro
force_release_deleted_file_fd_timeoutpara o módulo CRI Golang para forçar a liberação de descritores de arquivo de containers excluídos após um tempo limite.Inclusão da flag
disable_identity_detectpara pular processos de detecção de identidade, como aquisição de metadados ECS. Útil para implantações que não requerem reconhecimento de identidade cloud.
Correções
Correção de múltiplas condições de corrida no módulo ContainerManager C++ que ocorriam durante atualizações de informações de container e contenção de locks.
3.3.2
Data de lançamento: 10/02/2026
Correções
Correção de um vazamento de descritor de arquivo causado pela execução dupla da operação
pop_frontno array de leitores durante o tratamento de eventos, o que impedia a liberação correta dos descritores.Resolução de uma exceção do SPL v2.11.6 em chaves vazias: campos de valor nulo em
PipelineEventGroupOutputusavam lógica condicional incorreta.Correção da resolução incorreta de caminhos de links simbólicos no modo Copy Truncate após atualização de um checkpoint antigo. Checkpoints antigos armazenavam o caminho do symlink, não o caminho real, o que quebrava a correspondência de arquivos.
3.3.1
Data de lançamento: 21/01/2026
Correções
Correção de uma falha de processo (sinal 6) que ocorria durante a detecção de dispositivos GPU.
Resolução de uma condição de corrida no destrutor do runner de monitoramento de host quando uma reinicialização ocorria antes do término da parada anterior (comportamento indefinido). Adição de verificação de estado de parada e flag de saída forçada para gerenciamento de ciclo de vida thread-safe.
Correção de um pânico de ponteiro nulo no plugin Go durante exportação de métricas quando
ExportMetricRecordsrecebia Context ou MetricsRecords nulos. Adição de verificação de nil para pular registros inválidos.
Melhorias
Atualização do motor SPL para v2.11.6 e da imagem de build para v2.1.14.
3.3.0
Data de lançamento: 14/01/2026
Novos recursos
A observabilidade de rede eBPF agora analisa requisições e respostas MySQL e exporta métricas, logs e spans para visibilidade de protocolos da camada de aplicação.
O Forward Service agora emite métricas de automonitoramento para sua própria saúde e operação.
O gerenciamento de Configuração Única (Onetime Config) agora rastreia hashes de entrada e impõe tempos limite de execução, permitindo que execuções sejam tentadas novamente em caso de alteração de conteúdo e que configurações expiradas sejam limpas automaticamente.
Adição de suporte a configuração de subdomínio e simplificação do tratamento de cabeçalhos de requisição HTTP.
Correções
Correção da sondagem de domínio da edição Enterprise que ignorava o cache DNS, acionando buscas extras e aumentando a latência.
Resolução de retentativas imediatas após respostas HTTP 401. Adição de backoff de 1 segundo para reduzir rajadas de requisições inválidas.
Correção do monitoramento de host que contava apenas os cinco principais processos em vez de todos, distorcendo as métricas.
Resolução de deadlock no StaticFileServer ao remover um mutex desnecessário durante exclusão de entrada, evitando que o pipeline de arquivo estático travasse.
Redução da frequência de chamadas à API TagResources para evitar gatilhos de limitação (throttling).
Melhorias
Substituição do motor regex pelo regexp2 para filtragem de stdout Docker baseada em Go, melhorando compatibilidade e desempenho de correspondência regex.
Definição de
ForceRerunWhenUpdateno PipelineConfig como falso por padrão (antes era verdadeiro) para evitar reinícios desnecessários de pipeline e lacunas de coleta durante atualizações de configuração.
3.2.6
Tag da imagem: v3.2.6.0-109e584-aliyun
Data de lançamento: 19/12/2025
Correções
Correção de um problema onde logs eram descartados quando a fila de processos estava bloqueada.
Melhorias
Alteração do módulo de correspondência de metadados de container C++ de
regex_matchpararegex_searchpara manter suporte a configurações existentes.Adição de ID do host aos dados de automonitoramento.
Melhoria na atualização de caminho real e detecção de rotação no StaticFileServer.
3.2.5
Tag da imagem: v3.2.5.0-355f573-aliyun
Data de lançamento: 08/12/2025
Correções
Correção de um problema onde alguns eventos de checkpoint não eram processados durante atualizações de container C++.
Resolução de falha na análise de dados de métricas em cenários de encaminhamento.
Melhorias
Remoção de operação de sleep desnecessária no sink HTTP para melhorar o desempenho.
3.2.4
Tag da imagem: v3.2.4.0-984bb5f-aliyun
Data de lançamento: 02/12/2025
Novos recursos
Atualização do Go para a versão 1.23.12 e do Docker Go SDK.
Correções
Correção de um problema onde dados de monitoramento de host falhavam ao serem enviados do buffer de disco.
Resolução de bug no cálculo de uso médio de CPU para processos.
Correção de falha do
input_fileno Docker v29 e posteriores.Resolução de condição de corrida no future do Prometheus.
3.2.3
Data de lançamento: 27/11/2025
Novos recursos
Adição do processador
ProcessorTimestampFilterNativepara filtragem nativa de timestamp.Ativação do monitoramento de GPU no pipeline HostMonitor integrado.
Correções
Remoção de entradas inválidas do coletor GPU.
Melhoria no tratamento de erros e logging para a fila flusher e sender.
Remoção do protocolo pb não suportado para scraping do Prometheus.
Melhorias
Aprimoramento do tratamento de mudanças de estado de container e compatibilidade com formatos de checkpoint mais antigos.
Melhoria na compatibilidade para coleta de métricas de rede.
Remoção do índice de eventos de log para aumentar eficiência.
Adição de métrica de taxa de busca (fetch ratio) ao monitor de pipeline.
3.2.2
Data de lançamento: 25/11/2025
Novos recursos
Ativação do monitoramento de GPU no pipeline HostMonitor integrado.
Adição de métricas de automonitoramento para monitoramento de host.
input_fileagora suporta coleta de múltiplos caminhos.O flusher SLS agora suporta adição de cabeçalhos e metadados extras.
Prometheus agora suporta modo de scrape apenas para host.
Correções
Remoção de entradas inválidas do coletor GPU.
Correção de bug onde o coletor de disco falhava ao coletar dados de discos não montados.
Resolução de falha (crash) no coletor de processos.
Correção de problema onde FileServer não era pausado ao trocar tipos de entrada.
Resolução de impossibilidade de criar leitor para arquivo de link simbólico.
Correção de retorno incorreto de evento único ao pool de eventos.
Resolução de erro em
ConfigWatcherUnittest.Correção de erro de cálculo para a métrica
config_count.Resolução de problema de loop de conflito singleton.
Correção de atualização de metadados ECS.
Melhorias
Aprimoramento do desempenho de serialização e desserialização de span.
Redução de cópia de strings no monitoramento de host.
Adição de mecanismo de recozimento temporal (time annealing) ao módulo de ajuste de concorrência.
Inclusão de lógica de timeout no código de controle de concorrência para prevenir retentativas frequentes.
Melhoria no tratamento de erros e logging para filas flusher e sender.
Aprimoramento do gerenciamento de filas com lógica de retentativa e métricas.
Relato de métricas de
process_queueao pipeline.Adição de tag de destino à fila sender.
Implementação de throttling em
MetricSenderpara evitar queextraBufferfique cheio.Resolução de problema de desvio de tempo (drift) em Go que ocorria quando tarefas estavam lentas.
Correção de problema que causava elementos duplicados em
regionconfig.
3.2.1
Data de lançamento: 29/10/2025
Novos recursos
Adição de coletor de métricas GPU baseado no NVIDIA Data Center GPU Manager (DCGM).
Integração de relato de métricas no StaticFileServer.
Criação de pipeline integrado para relatar metadados de container.
input_static_file_onetimeagora suporta relato de status de tarefa.Adição de contador
retry_totalao flusher SLS.
Correções
Correção de problema onde leitores não eram limpos quando um arquivo era excluído, causando truncamento ao reutilizar o inode.
Resolução de problemas de build no Windows.
Correção de falha de carregamento causada por formato incorreto no dump de informações de região.
Resolução de problema com stacks de crash no Windows.
Correção de falha no Windows que ocorria quando
ExcludeDirscontinha caracteres chineses.Resolução de problema de tratamento do diretório de trabalho atual (
cwd) para caminhos bind mount na entrada de segurança.
Melhorias
Habilitação de relato de status de tarefa.
Adição de estatísticas de plugin às métricas de status.
Enriquecimento de metadados ECS com mais informações.
Inclusão de metadados ECS nas métricas de status.
Migração da lógica de correspondência de metadados de container para implementação C++.
3.2.0
Data de lançamento: 23/09/2025
Novos recursos
Habilitação de
input_static_file_onetimee adição de testes básicos ponta a ponta (E2E).Adição de configurações internas para monitoramento de host.
Integração da biblioteca simdjson para análise JSON de alto desempenho.
LoongCollector agora suporta autenticação RAM.
Correções
Correção de múltiplos problemas com gerenciamento de plugin eBPF e tratamento de eventos.
Resolução de problema de concorrência na classe Timer que causava perda de pontos de monitoramento.
Correção da lógica de leitura de arquivo em
InitFromFile.Resolução de problema de throttling no runner flusher.
Correção de falha do coletor de rede ao obter informações IPv6.
Resolução de vazamento de memória no coletor de processos.
Correção de problema que fazia a função
ParseConfigtruncar arquivos inesperadamente.Resolução de vazamento de descritor de arquivo em containers ao restaurar leitor de checkpoint.
Adição de cache
GetFileSystemInformationpara o coletor de disco.Adição de testes E2E para coleta de arquivos eBPF.
Correção de problemas de compilação para edição comercial no Windows e atualização do manual de release.
Melhorias
Garantia de consistência de dados entre múltiplos pipelines de monitoramento de host.
Adição de avisos e alertas para potencial perda de dados em
LogFileReader.Redução da criação de grupos para melhorar uso de memória.
Otimização da pegada de memória de entidades de metadados Kubernetes.
Uso de string view para melhorar desempenho de análise de strings.
Renomeação de flags de métricas em
MetricSender.cpp.
3.1.7
Data de lançamento: 11/11/2025
Novos recursos
Adição de informações ECS, incluindo ACS e ECI, às métricas do agente.
Inclusão de métrica para limite atual do throttler.
Correções
Correção de problema onde leitores não eram limpos ao excluir arquivo, causando truncamento na reutilização de inode.
Resolução de problema com stacks de crash no Windows.
Correção de falha no Windows ocorrida quando
ExcludeDirscontinha caracteres chineses.Resolução de problemas de compilação para edição comercial no Windows e atualização do manual de release.
Melhorias
Adição de metadados ECS às métricas de status.
3.1.6
Data de lançamento: 11/10/2025
Correções
Correção de problemas com gerenciamento de plugin eBPF e tratamento de eventos.
Resolução da lógica de leitura de metadados do arquivo host.
Correção de throttling inesperado no runner flusher.
Melhorias
Adição de alertas e avisos de perda de dados ao
LogFileReader.Inclusão de informações ECS, incluindo ACS e ECI, nas métricas do agente.
Adição de contador de retentativas ao flusher SLS.
3.1.5
Data de lançamento: 09/09/2025
Correções
Correção de truncamento de arquivo na função
ParseConfig.Resolução de problema de liberação de descritor de arquivo de container ao restaurar de checkpoint.
Correção de desinstalação inesperada do pipeline integrado.
Resolução de problema onde feedback causava remoção (pop) de eventos de timeout.
Melhorias
Otimização da pegada de memória de entidades de metadados Kubernetes.
3.1.4
Data de lançamento: 27/08/2025
Novos recursos
Adição de suporte para obtenção de informações de runtime do kernel.
Inclusão de prefixo de variável de ambiente
LOONG_, mantendo compatibilidade retroativa comALIYUN_.
Correções
Correção da ausência de automonitoramento para entradas de pipeline v2.
Resolução de problema de segurança de memória com valores de cache de processo.
Aprimoramento de avisos de timeout e regex de largura zero para processadores
Desensitize,GrokeStringReplace.
Melhorias
Melhoria no desempenho da coleta de arquivos eBPF.
EntityCollector agora suporta versões anteriores do K8s (1,21 e anteriores).
Adição de buffer de source extra ao
PipelineEventGroup.
3.1.3
Data de lançamento: 08/08/2025
Novos recursos
Adição de
ProcessCollector.Inclusão de
NetCollector.
Correções
Correção de coleta duplicada de dados ao restaurar progresso de checkpoints antigos.
Melhorias
Aprimoramento do desempenho de análise regex multithread.
Otimização da transmissão de metadados K8s via protobuf.
Modificação da implementação do coletor CPU.
NetworkObserveragora suporta múltiplas configurações.Plugins eBPF agora usam epoll uniformemente para obter dados.
Adição de verificação de tipo para alterações de configuração.
Inclusão de níveis de alerta nas informações de alerta.
3.1.2
Data de lançamento: 25/07/2025
-
Correções
Correção de falha na coleta de metadados K8s.
Resolução de problema onde
HashKeysnão eram aplicadas durante transformação de dados.Correção da vinculação incorreta da biblioteca SSL devido à compilação gRPC.
Resolução de problema onde
RotatorReadernão fechava arquivos quando container parava.Correção de perda de tags ao adicionar novas configurações de variáveis de ambiente.
Resolução de problemas de compatibilidade de conjunto de instruções e adição de script de verificação de recursos CPU ao CI para validar ambientes de build.
-
Melhorias
Refatoração do modelo de threads do eBPF Server para melhorar concorrência e estabilidade.
Atualização da configuração de metadados K8s para adicionar lógica upsert para entidades de cluster.
3.1.1
Data de lançamento: 02/07/2025
-
Correções
Correção de falha no modo tail para coleta de logs journal no Ubuntu.
Resolução de problema onde
RotatorReadernão fechava arquivos ao parar container.Correção de falha ocorrida ao processar métricas de automonitoramento durante
DoSnapshot.Resolução de timeouts de
docker inspect.Correção de overflow de
start_timenas métricas de automonitoramento do módulo de análise eBPF.Interface de gerenciamento agora suporta modo reforçado para metadados ECS.
-
Melhorias
Refatoração do modelo de threads do eBPF Server para melhorar concorrência e estabilidade.
Atualização da configuração de metadados K8s para adicionar lógica upsert para entidades de cluster.
-
Correções
Correção de falha na coleta de saída padrão em cenários ACS com nova versão.
Resolução de falha causada por análise incorreta de log JSON com codificação GBK.
Correção de falha causada por verificação incorreta de valor nulo quando runtime de container estava instável.
Remoção de caracteres nulos (
\0) para melhorar precisão no processamento de dados.
-
Novos recursos
Adição de suporte para casos de uso de segurança eBPF.
-
Correções
-
Correção de problema na lógica de detecção de runtime de container onde status do cliente Docker era determinado incorretamente durante retentativa.
Resolução de problema que causava texto corrompido porque ponteiros de dados eram liberados em momento incorreto durante atualizações de pipeline.
Uso do tempo atual como fallback quando tempo de análise SPL é inválido.
Atualização da biblioteca de dependência client-go para corrigir geração anormal de eventos no iLogtail.
Correção de travamento do módulo de logging Go quando disco estava cheio, interrompendo coleta de logs.
-
-
Correções
Correção de exceção de ponteiro nulo para alguns tipos de dados em metadados K8s.
Resolução de falha causada por uso incorreto de
weak_ptr.Correção de problema onde plugin antigo de coleta de saída padrão não completava coleta da última parte dos logs ao parar container.
-
Melhorias
Lógica de detecção de runtime de container agora suporta Container Runtime Interface (CRI) v1, tornando-a compatível com containerd 2.0.
Atualização dos tipos de associação de metadados K8s.
Adição de restrição à associação de metadados K8s, permitindo apenas que recursos nível-cluster sejam associados a um cluster.
-
Correções
LoongCollector agora ignora arquivos de cache anormais no disco durante reinicializações.
Atualização da biblioteca runc para corrigir vulnerabilidade de vazamento de descritor de arquivo.
-
Melhorias
Habilitação de suporte multithread para divisão de logs multilinha visando melhorar desempenho.
-
Correções
Correção de problema com entrega de configuração de instância para edição comercial.
Resolução de problema onde informações de stack de log estavam incorretas quando módulo C++ falhava.
-
Correções
Correção de problema no Linux onde caminho de diretório era concatenado incorretamente quando caminho na configuração de coleta era diretório raiz.
Metadados K8s agora suportam entidades namespace.
Resolução de problema em cenários de container onde escritas concorrentes causavam informações de montagem incorretas nos detalhes do container.
Correção de deadlock causado por timeouts de envio.
Adição de suporte para
DiscardingNonUTF8no plugin de filtragem nativa.
-
Melhorias
Atualização da versão SPL.
Envio de dados de métricas agora suporta dados fora de ordem com granularidade de um minuto.
-
Correções
Correção de problema de ponteiro use-after-free no módulo de envio por timeout durante atualizações de configuração de coleta
AliyunPipelineConfig.
-
Correções
Correção de problema onde formato de métrica SLS estava desativado por padrão para envio de dados de métricas.
Resolução da lógica de tratamento de exceções no plugin Kafka Input para prevenir retornos prematuros.
-
Novos recursos
Adição de suporte para definir campo TCP Type of Service (TOS) em curl.
-
Correções
Correção de vazamento de memória em Go causado por referência circular que impedia objetos
LogStoreconfigde serem recuperados pelo garbage collector.Resolução de falha de envio causada por configurações locais ao atualizar de iLogtail para LoongCollector.
Correção de interrupção de coleta para arquivos PersistentVolume (PV) ocorrida porque estado do container era identificado incorretamente como parado.
-
Melhorias
Adição de nomes de configuração às informações de alerta.
-
Correções
Correção de problema com tags de origem C++ incorretas.
Resolução de problema de análise na última linha de log em cenários de saída padrão de container.
Correção de deadlock em
LogtailMonitordurante autoterminação.
-
Limitações
Apenas o recurso de coleta de logs é suportado.
3.1.0
Data de lançamento: 16/06/2025
3.0.12
Data de lançamento: 04/06/2025
3.0.11
Data de lançamento: 22/05/2025
3.0.10
Data de lançamento: 24/04/2025
3.0.9
Data de lançamento: 07/04/2025
3.0.8
Data de lançamento: 01/04/2025
3.0.7
Data de lançamento: 14/03/2025
3.0.6
Data de lançamento: 03/03/2025
3.0.5
Data de lançamento: 20/02/2025
3.0.4
Data de lançamento: 14/02/2025
3.0.2
Data de lançamento: 07/02/2025