Todos os produtos
Search

Este produto

    Simple Log Service:Diagnosticar e monitorar o status de execução do LoongCollector

    Central de documentação

    Simple Log Service:Diagnosticar e monitorar o status de execução do LoongCollector

    Última atualização: Sep 10, 2026

    O Simple Log Service oferece recursos de diagnóstico para identificar erros de coleta, como falhas na análise por regex, caminhos de arquivo incorretos ou tráfego que excede a capacidade do shard. Use também as regras de alerta integradas para monitorar o coletor em tempo real e receber notificações via DingTalk ou outros canais.

    Pré-requisitos

    • Coletor configurado para coletar logs. Collect text logs from a host.

    • Habilitar logs importantes para o projeto de destino

      Ative os service logs necessários. Enable service logs.

      1. Faça login no console do Simple Log Service. Na lista de projetos, clique em no projeto de destino. Na página de detalhes do projeto, clique em na aba Service Log e, em seguida, clique em Enable Service Logs.

      2. No painel Enable Detailed Logs, selecione Important Logs e Job Operational Logs e clique em OK.

        • Um projeto chamado log-service-{user-id}-{region} é criado automaticamente na região de destino.

        • A ingestão, o armazenamento, a consulta e a análise de logs importantes e logs operacionais de jobs são gratuitos. A transformação e o envio de dados seguem o modelo de pagamento conforme o uso.

    Diagnosticar problemas de execução

    Dois modos de diagnóstico estão disponíveis:

    • Advanced Diagnostics (Recomendado): Exibe um painel de exceções com erros relacionados ao coletor e permite consultas em intervalos de tempo mais longos.

    • Basic Diagnostics: Mostra exceções de coleta da última hora.

    Casos de uso

    • Status anormal do coletor: falhas de heartbeat, processos inativos ou erros de certificado SSL.

    • Falhas na coleta de logs: logs não coletados, alta latência ou erros de análise, como incompatibilidade de regex.

    • Erros de configuração: caminhos de arquivo incorretos, IPs de machine group incompatíveis ou problemas de permissão entre contas.

    • Gargalos de desempenho: taxa de coleta próxima ou acima do limite padrão (20 MB/s), causando perda de logs.

    • Problemas na coleta de logs de contêineres: reinicializações frequentes de pods ou rotação rápida de logs resultando em coleta incompleta.

    • Problemas com plugins e coleta personalizada: falhas em plugins personalizados (por exemplo, análise Grok) ou erros na coleta de fontes de dados HTTP.

    • Problemas de confiabilidade dos dados: perda de logs devido a um LoongCollector inativo ou rotação excessivamente rápida de logs.

    • Alteração de parâmetros de configuração de coleta: parâmetros de análise, como condições de correspondência multilinha, não podem ser editados diretamente na lista de configurações de coleta. Abra o fluxo de modificação dessa configuração e altere-os na etapa de análise de log.

    • Coleta de múltiplos caminhos em uma única configuração: cada configuração de coleta suporta apenas um caminho de log e padrão de nome de arquivo. Não há suporte para vários caminhos diferentes na mesma configuração. Crie uma configuração de coleta separada para cada caminho e aplique-as ao mesmo machine group.

    • Falha na validação do corpo da requisição ao criar uma configuração de coleta via API ou Terraform: se a requisição de criação retornar um erro de validação como PostBodyInvalid, verifique se todos os campos em inputDetail estão presentes e com os tipos corretos. Em particular, localStorage deve ser um valor booleano (true ou false).

    • Coexistência com outros softwares de coleta de logs: solução de problemas de uso de porta, conflitos de processos ou coleta duplicada quando o LoongCollector executa junto com outros softwares, como Filebeat, no mesmo servidor.

    • Origem dos logs desconhecida: quando a origem dos logs em um LogStore não é clara, determine se foram coletados pelo LoongCollector/Logtail ou gravados diretamente por uma aplicação via SDK. Verifique se existe uma configuração de coleta correspondente no servidor e se o código da aplicação contém lógica de escrita via SDK.

    • Tipo de dados alvo fora do escopo de coleta suportado: confirme se o objeto alvo, como métricas de desempenho de aplicação ou métricas de aplicação .NET, é um tipo de coleta suportado pelo LoongCollector. Isso evita confundir um alvo não suportado com uma falha de coleta.

    • Logs stdin ou stdout de contêineres não coletados: solução de problemas para casos em que logs stdin e stdout de contêineres em um cluster ACK não são coletados.

    • Acúmulo de memória ou limitação de escrita ao gravar diretamente via SDK: quando uma aplicação grava logs diretamente pelo Java SDK ou Producer e a memória continua crescendo, há acúmulo de dados ou limitação de escritas, solucione o problema verificando também a cota de escrita do LogStore e a taxa de geração de logs na aplicação.

    • O campo __tag__:__hostname__ é null: isso indica que não foi possível obter o hostname durante a coleta de logs. Causas comuns incluem a ausência do rótulo de hostname na configuração do Logtail, fontes de log como escritas via API ou alguns ambientes de contêiner que não carregam metadados de hostname, ou um coletor de dados incapaz de resolver o hostname em uma máquina específica. Verifique as configurações do rótulo de hostname na configuração de coleta e os metadados da source de log.

    • Falha na coleta porque o firewall bloqueia o acesso aos endereços IP de comunicação do Simple Log Service: bloquear o acesso aos IPs de comunicação do Simple Log Service pode impedir a gravação de logs, causar falhas em consultas, consumo e alertas, além de atrasar ou interromper a coleta. Adicione os endereços IP de comunicação do Simple Log Service à lista de permissões do firewall para garantir o funcionamento adequado desses recursos.

    • O status da tarefa de avaliação do SLS Agent é Failed: o status Failed indica que o processo de avaliação encontrou um erro explícito. Possíveis causas incluem erros de lógica interna, formatos de dados inválidos ou permissões e recursos insuficientes. Utilize a mensagem de erro específica da tarefa de avaliação para solucionar problemas de formato de dados, configuração de permissões e lógica de execução do SLS Agent.

    Procedimento

    1. Faça login no console do Simple Log Service. Na lista de projetos, clique em no projeto de destino.

    2. Clique em image Log Storage. Na lista de LogStores, passe o mouse sobre o LogStore desejado e clique em no ícone Logtail configuration management.

    3. Clique em Advanced Diagnostics ou Basic Diagnostics para visualizar as informações de diagnóstico.

    4. Visualize os resultados do diagnóstico.

      Basic diagnostics

      O painel Log Collection Error lista todos os erros de coleta do LoongCollector para o LogStore. Clique em em um código de erro para ver os detalhes. Common data collection errors.

      Advanced diagnostics

      A página LoongCollector/Logtail Exception Monitoring exibe métricas como Active Collection Agent Count e Complete Error Information. Para detalhes do painel, consulte View data reports. Para códigos de erro, consulte Common data collection errors.

    5. Após resolver um problema, verifique se há novos erros. Erros históricos permanecem visíveis até expirarem — ignore-os e confirme que nenhum novo erro apareceu. O LoongCollector reporta erros a cada 10 minutos.

      Para visualizar logs completos descartados devido a falhas de análise, verifique os logs de execução do LoongCollector:
      Para hosts: o arquivo /usr/local/ilogtail/loongcollector.LOG no servidor.
      Para contêineres: o arquivo /usr/local/ilogtail/loongcollector.LOG no contêiner.

    Como limpar o uso excessivo de disco por um contêiner Docker do LoongCollector?

    1. Execute docker system df para verificar o uso de disco do contêiner Docker do LoongCollector.

    2. Acesse o contêiner e verifique se os arquivos de log em /usr/local/ilogtail/ estão consumindo espaço excessivo. Limpe os arquivos ou ajuste a política de rotação de logs conforme necessário.

    Monitorar o status de execução

    O SLS fornece políticas de alerta integradas para monitorar o coletor em tempo real:

    • Monitorar heartbeats do coletor

      Consulte o LogStore internal-diagnostic_log buscando logs com __topic__:logtail_status para contar máquinas com heartbeats normais. Configure uma regra de alerta para disparar quando a contagem de heartbeats ficar abaixo do valor esperado, identificando máquinas inativas ou com problemas de rede.

    • Configurar alertas para exceções de coleta

      Execute a consulta __topic__: logtail_alarm para analisar exceções nos últimos 15 minutos, como arquivos ilegíveis, permissões insuficientes e falhas de análise. Isso ajuda a identificar e corrigir problemas de configuração para evitar perda de logs.

    • Receber avisos sobre gargalos de desempenho

      Utilize o painel de monitoramento de exceções do Logtail para visualizar a contagem de LoongCollectors ativos, histórico de reinicializações e mensagens de erro. Monitore o status de execução e o uso de recursos (CPU, memória) para identificar gargalos de desempenho ou reinicializações anormais.

    • Monitorar a coleta centralizada de logs

      Use o painel de monitoramento de coleta de arquivos do LoongCollector para acompanhar a quantidade de arquivos coletados, latência média e taxas de falha de análise. Gerencie centralmente o status da coleta de logs em cenários multiconta ou multirregião.

    Procedimento

    1. Configure uma action policy para definir como as notificações são enviadas quando o status de um alerta muda.

      1. Faça login no console do Simple Log Service.

      2. Na lista de projetos, clique em no projeto onde você habilitou os logs importantes.

      3. No painel de navegação à esquerda, clique em image Alerts. Na página Alert Center, escolha Notification Management > Action Policy.

      4. Na lista de action policies, localize a policy sls.app.logtail.builtin e clique em Modify na coluna Actions.

      5. Na caixa de diálogo Edit Action Policy, selecione e configure um canal de notificação conforme sua necessidade. Notification channels. Em seguida, clique em Confirm.

    2. Crie uma regra de alerta para disparar quando o status de execução do LoongCollector atingir um limiar especificado.

      1. Na página Alert Center, clique em na aba Alert Rules e, em seguida, clique em no ícone image ao lado de Create Alert.

      2. Clique em Create from Template. No painel Create from Template, clique em Logtail Fault Monitor em All Templates e selecione o cartão desejado.

      3. No painel Create Alert, revise a configuração. A regra de alerta integrada inclui parâmetros predefinidos. Clique em OK. Create an alert rule.