Configureren van Kibana in DNA Center voor logvisualisatie

Inleiding

Dit document beschrijft hoe u Kibana moet gebruiken om specifieke logs te doorzoeken tussen verschillende services van Cisco DNA Center.

Voorwaarden

Vereisten

U moet toegang hebben tot Cisco DNA Center via GUI met ADMIN ROL ook, u moet bekend zijn met de namen en het gebruik van Cisco DNA Center-services.

Gebruikte componenten

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

  

Kibana is een opensource-datavisualisatieplug-in voor Elasticsearch. Het biedt visualisatiemogelijkheden bovenop de inhoud die is geïndexeerd in een Elasticsearch-cluster die beschikbaar zijn in Cisco DNA Center.

U heeft toegang tot Kibana op twee manieren:

• https://<Cisco DNA Center ip>/kibana
• Hoofdmenu > Systeem > System 360 -> Cluster Tools -> Log Explorer

Standaard Kibana webpagina

Kibana configureren voor logvisualisatie

Navigeer naar het menu links en klik op Discover:

Kibana heeft verschillende velden die in de volgende afbeelding gemarkeerd worden:

Voeg velden toe in Kibana

Navigeren naar filters > Beschikbare velden

De velden die u moet toevoegen voor logboekvisualisatie zijn:

• Kubernetes.labels.serviceName - Service die het specifieke logbestand weergeeft
• Log - Ruwe inhoud van het logboek

Klik op de knop Toevoegen

Zorg ervoor dat u de volgende configuratie hebt:

Filters toevoegen en bewerken in Kibana

Voer de volgende activiteit uit om een filter toe te voegen:

• Klik in Filter toevoegen
• Veldselectie: Kubernetes.labels.serviceName
• Selecteer de operator: is
• Waarde: selecteer de dienst van uw belang
• Klik in de knop Opslaan

Neem een kijkje in het volgende voorbeeld waar de geselecteerde dienst apic-em-inventaris-manager-service is:

U kunt meer filters toevoegen als u dat nodig hebt.

In het volgende voorbeeld is een nieuw filter toegevoegd waar het veld:log, operator:is en Value: error:

Ontvang logbestanden vanaf een specifieke datum

U kunt een tijdselement toevoegen aan uw zoekcriteria. 

Gebruik een van de volgende opties uit het veld Tijdbereik:

• Absoluut - Van een specifieke datum naar een andere specifieke datum. 
• Relatief - Van de laatste X minuten, uren, dagen of weken tot een specifieke datum.
• Nu - Het instellen van de tijd op "nu" betekent dat bij elke vernieuwing deze tijd wordt ingesteld op de tijd van de vernieuwing.

Gebruik cases met Lucene

Lucene is een hoogwaardige, volledig uitgeruste tekstzoekmachine bibliotheek. Het is een technologie die geschikt is voor vrijwel elke toepassing die full-text zoeken vereist.

Navigeer naar de zoekbalk en schakel KQL uit om Lucene in te schakelen:

Ontvang logbestanden voor een specifieke service

Typ de volgende query in de filterbalk en druk op de knop Vernieuwen

kubernetes.labels.serviceName:<service-name>

Neem een kijkje bij het volgende voorbeeld met de taakdienst:

kubernetes.labels.serviceName:task-service

Ontvang logbestanden die een specifiek woord bevatten

Tip: de meest gebruikelijke logitems die wijzen op problemen bevatten " Error ", " Failure " en " Exception ", maar u kunt de string wijzigen in een andere gemeenschappelijke string die u kan begeleiden bij de probleemoplossing.

Typ de volgende query in de filterbalk en druk op de knop Vernieuwen

log:error

Meng en stem overeen met uw zoekopdracht

U kunt items die overeenkomen met een combinatie van strings zoeken met behulp van AND (of &&) tussen de strings.

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

N.B.: U kunt niet alle velden doorzoeken.

Als u alleen doorzoekbare velden wilt zien in het deelvenster Beschikbare velden, selecteert u het tandwiel en past u de weergave aan. U kunt ook het type zoekopdracht definiëren dat u wilt gebruiken, bijvoorbeeld string, Boolean, number, enzovoort.

Op hetzelfde moment twee verschillende services zoeken voor een fout

Neem twee of meer diensten op in uw zoekcriteria. Zorg ervoor dat de namen van de services tussen haakjes worden ingevoerd en scheid ze van OR.

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

Referentie

• Elastische zoekfunctie voor algemene opties
• Apache Lucene - Query Parser Syntax