Introdução
Este documento descreve como usar o Kibana para pesquisar logs específicos entre diferentes serviços do Cisco DNA Center.
Pré-requisitos
Requisitos
Você também deve ter acesso ao Cisco DNA Center através da GUI com FUNÇÃO DE ADMINISTRADOR, você deve estar familiarizado com os nomes e o uso dos serviços do Cisco DNA Center.
Componentes Utilizados
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Informações de Apoio
Kibana é um plugin de visualização de dados de código aberto para Elasticsearch. Ele fornece recursos de visualização sobre o conteúdo indexado em um cluster Elasticsearch que está disponível no Cisco DNA Center.
Você pode acessar o Kibana de duas maneiras:
- https://<Cisco DNA Center ip>/kibana
- Menu principal > Sistema > System 360 -> Cluster Tools -> Log Explorer
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-00.png)
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-01.png)
Página Web padrão do Kibana
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-02.png)
Configurar o Kibana para visualização de logs
Navegue até o menu da barra esquerda e clique em Discover:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-03.png)
Kibana tem vários campos, que estão destacados na próxima imagem:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-04.png)
Adicionar campos em Kibana
Navegue até Filtros > Campos disponíveis
Os campos que você deve adicionar para visualização de logs são:
- Kubernetes.labels.serviceName - Serviço que exibe o log específico
- Log - Conteúdo bruto do log
Clique no botão Adicionar
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-05.png)
Certifique-se de ter a próxima configuração:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-06.png)
Observação: o campo Hora é adicionado por padrão.
Adicionar e editar filtros no Kibana
Para adicionar um filtro, execute a próxima atividade:
- Clique em Adicionar filtro
- Seleção de campo: Kubernetes.labels.serviceName
- Operador select: is
- Valor: selecione o serviço de seu interesse
- Clique no botão Salvar
Examine o próximo exemplo onde o serviço selecionado é apic-em-inventory-manager-service:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-07.png)
Você pode adicionar mais filtros conforme necessário.
No próximo exemplo, um novo filtro foi adicionado, onde o erro Field:log, operator:is e Value:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-08.png)
Obter logs de uma data específica
Você pode adicionar um elemento de tempo aos seus critérios de pesquisa.
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-09.png)
Use uma das próximas opções do campo Intervalo de tempo:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-10.png)
- Absoluto - De uma data específica para outra.
- Relativo - Dos últimos X minutos, horas, dias ou semanas até uma data específica.
- Agora - Definir o horário como "agora" significa que, em cada atualização, esse horário será definido como o horário da atualização.
Casos de uso com Lucene
Lucene é uma biblioteca de mecanismo de pesquisa de texto completo de alto desempenho. É uma tecnologia adequada para praticamente qualquer aplicativo que exija pesquisa de texto completo.
Navegue para a barra de pesquisa e desative o KQL para ativar o Lucene:
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-11.png)
Obter logs de um serviço específico
Digite a próxima consulta na barra de filtros e pressione o botão Atualizar
kubernetes.labels.serviceName:<service-name>
Dê uma olhada no próximo exemplo com task-service:
kubernetes.labels.serviceName:task-service
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-12.png)
Obter logs que contenham uma palavra específica
Dica: as entradas de log mais comuns que indicam problemas contêm " Erro " , " Falha " e " Exceção "; no entanto, você pode modificar a string para ser qualquer outra string comum que possa orientá-lo na solução de problemas.
Digite a próxima consulta na barra de filtros e pressione o botão Atualizar
log:error
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-13.png)
Combine e agrupe sua pesquisa
Você pode pesquisar entradas que correspondam a uma combinação de strings usando AND (ou &&) entre as strings.
log:error AND kubernetes.labels.serviceName:onboarding-service
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-14.png)
Observação: nem todos os campos são pesquisáveis.
Se quiser ver apenas campos pesquisáveis no painel Campos disponíveis, selecione a roda dentada e personalize a exibição. Você também pode definir o tipo de pesquisa que deseja usar, por exemplo, string, Booleano, número e assim por diante.
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-15.png)
Procurar um erro em dois serviços diferentes ao mesmo tempo
Inclua dois ou mais serviços em seus critérios de pesquisa. Certifique-se de que os nomes dos serviços sejam inseridos entre parênteses e separe-os com OR.
log:error && (kubernetes.labels.serviceName:onboarding-service OR kubernetes.labels.serviceName:telemetry-agent)
![Interface gráfica do usuário](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-16.png)
Referência