Configurazione di Kibana in DNA Center per la visualizzazione del log

Introduzione

Questo documento descrive come usare Kibana per cercare log specifici tra diversi servizi Cisco DNA Center.

Prerequisiti

Requisiti

È necessario disporre dell'accesso a Cisco DNA Center tramite GUI con ruolo di amministratore, nonché conoscere i nomi e l'utilizzo dei servizi di Cisco DNA Center.

Componenti usati

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse

  

Kibana è un plug-in di visualizzazione dati open source per Elasticsearch. Fornisce funzionalità di visualizzazione su contenuto indicizzato in un cluster Elasticsearch disponibile in Cisco DNA Center.

È possibile accedere a Kibana in due modi:

• https://<Cisco DNA Center ip>/kibana
• Menu principale > Sistema > System 360 -> Strumenti cluster -> Esplora log

Pagina Web Kibana predefinita

Configura Kibana per la visualizzazione del log

Accedere al menu della barra di sinistra e fare clic su Discover:

Kibana ha diversi campi, che sono evidenziati nell'immagine seguente:

Aggiungi campi in Kibana

Selezionare Filtri > Campi disponibili

I campi da aggiungere per la visualizzazione dei log sono:

• Kubernetes.labels.serviceName - Servizio che visualizza il registro specifico
• Registro - Contenuto non elaborato del registro

Fare clic sul pulsante Aggiungi

Accertarsi di disporre della configurazione successiva:

Aggiungi e modifica filtri in Kibana

Per aggiungere un filtro, eseguire l'attività successiva:

• Fare clic in Aggiungi filtro
• Selezione campo: Kubernetes.labels.serviceName
• Operatore select: è
• Valore: selezionare il servizio desiderato
• Fare clic sul pulsante Salva

Osservare l'esempio successivo in cui il servizio selezionato è apic-em-inventory-manager-service:

È possibile aggiungere altri filtri in base alle esigenze.

Nell'esempio successivo è stato aggiunto un nuovo filtro dove Field:log, operator:is e Value: error:

Ottieni registri da una data specifica

È possibile aggiungere un elemento temporale ai criteri di ricerca. 

Utilizzare una delle opzioni successive del campo Intervallo di tempo:

• Assoluto - Da una data specifica a un'altra data specifica. 
• Relativo: a partire dagli ultimi X minuti, ore, giorni o settimane fino a una data specifica.
• Ora - Se si imposta l'ora su "adesso", ad ogni aggiornamento questa ora verrà impostata sull'ora dell'aggiornamento.

Casi d'uso con Lucene

Lucene è una libreria di motori di ricerca di testo ad alte prestazioni e con funzionalità complete. Si tratta di una tecnologia adatta a quasi tutte le applicazioni che richiedono la ricerca full-text.

Passare alla barra di ricerca e disabilitare KQL per abilitare Lucene:

Ottieni registri per un servizio specifico

Digitare la query successiva nella barra dei filtri e premere il pulsante Aggiorna

kubernetes.labels.serviceName:<service-name>

Osservare l'esempio successivo con task-service:

kubernetes.labels.serviceName:task-service

Ottiene i registri che contengono una parola specifica

Suggerimento: le voci più comuni del registro che indicano problemi contengono " Errore " , " Errore " e " Eccezione ". Tuttavia, è possibile modificare la stringa in modo che sia qualsiasi altra stringa comune che possa essere utile per la risoluzione dei problemi.

Digitare la query successiva nella barra dei filtri e premere il pulsante Aggiorna

log:error

Combinazione e corrispondenza con la ricerca

È possibile cercare le voci che corrispondono a una combinazione di stringhe utilizzando l'operatore AND (o &&) tra le stringhe.

log:error AND kubernetes.labels.serviceName:onboarding-service

Nota: non tutti i campi sono ricercabili.

Se si desidera visualizzare solo i campi in cui è possibile eseguire ricerche nel riquadro Campi disponibili, selezionare la ruota dentata e personalizzare la visualizzazione. È inoltre possibile definire il tipo di ricerca da utilizzare, ad esempio stringa, booleano, numero e così via.

Ricerca di un errore in due servizi diversi contemporaneamente

Includere due o più servizi nei criteri di ricerca. Assicurarsi che i nomi dei servizi siano inseriti tra parentesi e separarli con OR.

log:error && (kubernetes.labels.serviceName:onboarding-service OR kubernetes.labels.serviceName:telemetry-agent)

Riferimento

• Opzioni comuni di ricerca elastica
• Apache Lucene - Sintassi parser query