O recurso de logs do Alibaba Cloud Logstash permite localizar conteúdo específico nos logs por meio de palavras-chave e intervalos de tempo. Isso facilita a identificação rápida de problemas no cluster e a execução de tarefas de manutenção diária. Este tópico descreve como consultar logs e explica os tipos de log disponíveis.
Procedimento
Acesse a página Logstash Clusters.
-
Localize o cluster desejado.
Na barra de navegação superior, selecione a região onde o cluster está localizado.
Na página Logstash Clusters, localize o cluster e clique em seu ID.
-
No painel de navegação à esquerda, clique em Logs para visualizar os logs de execução do cluster.
O Alibaba Cloud Logstash oferece suporte a quatro tipos de log: cluster log, slow log, gc log e debug log. A tabela a seguir descreve cada tipo de log e seus casos de uso. Para mais informações, consulte Detalhes dos logs.
Tipo de log
Descrição
Caso de uso
cluster log
Registra o status operacional do cluster.
Utilize os cluster logs para verificar a integridade de cada nó e o status dos pipelines. Isso inclui solucionar problemas de conectividade entre origens e destinos, validar alterações na configuração de pipelines e identificar erros de execução.
ImportanteCaso sua aplicação apresente problemas, verifique primeiro o cluster log e os dados de monitoramento do cluster. Essa prática ajuda a descartar gargalos de desempenho ou falhas na configuração do pipeline.
slow log
Registra eventos de pipeline que ultrapassam um limiar de tempo especificado.
ImportantePara auxiliar na solução de problemas, os slow logs são ativados por padrão no arquivo YML. Não remova essa configuração de slow log. Para mais informações, consulte Configurar um arquivo YML.
Se você notar lentidão nas operações de escrita, verifique o slow log. As causas mais comuns incluem:
-
A origem ou o destino na configuração do pipeline atingiu um gargalo de recursos. Recomendamos aumentar os recursos da origem ou do destino.
-
A configuração Pipeline Workers do Logstash está muito baixa. Aumente o Pipeline Batch Size e o Pipeline Workers. Para mais informações, consulte Gerenciar pipelines usando arquivos de configuração.
gc log
Registra eventos de coleta de lixo (GC) do heap da Java Virtual Machine (JVM). Os gc logs fornecem informações detalhadas sobre a coleta de lixo, incluindo os mecanismos Old GC, CMS GC, Full GC e Minor GC.
Quando um cluster apresenta gargalo de desempenho, utilize os gc logs para obter detalhes sobre a coleta de lixo e verificar se há eventos demorados ou frequentes.
debug log
Exibe os dados de saída após o processamento pelo pipeline. Esse recurso vem desativado por padrão. Para ativá-lo, instale o plug-in logstash-output-file_extend e configure o parâmetro file_extend na seção output.
Utilize debug logs quando precisar visualizar a saída de uma configuração de pipeline diretamente no console para depuração.
-
-
Na caixa de pesquisa da página Logs, insira uma consulta, selecione as datas de início e fim e clique em Search.
É possível consultar logs dos últimos sete dias. Por padrão, os logs aparecem em ordem cronológica inversa. O Alibaba Cloud Logstash suporta sintaxe de consulta baseada em Lucene. Para mais informações, consulte Query string syntax.
Por exemplo, para consultar um cluster log em que o campo content contenha a palavra-chave running, o level seja info e o host seja 172,16.xx.xx, use a seguinte consulta:
host:172.16.xx.xx AND level:info AND content:running.O Alibaba Cloud Logstash exibirá os resultados da pesquisa na página Logs.
Detalhes dos logs
Cluster log
Um cluster log exibe os logs de execução de um cluster, incluindo horário de geração, endereço IP do nó de origem e informações detalhadas do log.
|
Parâmetro |
Descrição |
|
Time |
Horário em que o log foi gerado. |
|
Node IP Address |
Endereço IP do nó que gerou o log. |
|
Content |
Detalhes do log, compostos principalmente por level, host, time e content:
|
GC log
Os gc logs são ativados por padrão e compartilham a mesma estrutura do cluster log.
Slow log
Os slow logs vêm ativados por padrão. É possível visualizar ou modificar a configuração padrão de slow log no arquivo YML da sua instância Logstash. Para mais informações, consulte Configurar um arquivo YML.
Para facilitar futuras soluções de problemas no Alibaba Cloud Logstash, não remova esta configuração de slow log.
Debug log
Depurar um pipeline pode ser um processo demorado quando os dados de saída não correspondem ao esperado. Para simplificar essa tarefa, o Alibaba Cloud Logstash oferece um recurso de depuração de pipeline. Para mais informações, consulte Usar o recurso de depuração de configuração de pipeline.
Os debug logs são desativados por padrão. Para ativá-los, execute as etapas a seguir:
Instale o plug-in logstash-output-file_extend. Para mais informações, consulte Instalar ou remover um plug-in.
Na seção output da configuração do pipeline, configure o parâmetro file_extend. Para mais informações, consulte Gerenciar pipelines usando arquivos de configuração.
Após ativar os debug logs, visualize os dados de saída processados pelo pipeline na aba Debug Log.