Introduction
Ce document décrit comment utiliser Kibana afin de rechercher des journaux spécifiques parmi différents services Cisco DNA Center.
Conditions préalables
Exigences
Vous devez avoir accès à Cisco DNA Center via l'interface utilisateur graphique avec le RÔLE ADMIN. Vous devez également connaître les noms et l'utilisation des services Cisco DNA Center.
Composants utilisés
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
Kibana est un plugin de visualisation de données open source pour Elasticsearch. Il offre des fonctionnalités de visualisation en plus du contenu indexé sur un cluster Elasticsearch disponible dans Cisco DNA Center.
Vous pouvez accéder à Kibana de deux manières :
- https://<Cisco DNA Center ip>/kibana
- Menu principal > Système > Système 360 -> Outils de cluster -> Explorateur de journaux
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-00.png)
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-01.png)
Page Web Kibana par défaut
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-02.png)
Configurer Kibana pour la visualisation des journaux
Accédez au menu de la barre de gauche et cliquez sur Discover:
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-03.png)
Kibana a plusieurs champs, qui sont mis en surbrillance dans l'image suivante :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-04.png)
Ajouter des champs dans Kibana
Accédez à Filtres > Champs disponibles
Les champs que vous devez ajouter pour la visualisation des journaux sont les suivants :
- Kubernetes.labels.serviceName - Service qui affiche le journal spécifique
- Journal - Contenu brut du journal
Cliquez sur le bouton Ajouter
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-05.png)
Assurez-vous que vous disposez de la configuration suivante :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-06.png)
Remarque : le champ Heure est ajouté par défaut.
Ajouter et modifier des filtres dans Kibana
Afin d'ajouter un filtre, effectuez l'exercice suivant :
- Cliquez dans Ajouter un filtre
- Sélection de champ : Kubernetes.labels.serviceName
- Opérateur sélectionner : est
- Valeur : sélectionnez le service qui vous intéresse
- Cliquez sur le bouton Enregistrer
Regardez l'exemple suivant où le service sélectionné est apic-em-inventory-manager-service :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-07.png)
Vous pouvez ajouter d'autres filtres selon vos besoins.
Dans l'exemple suivant, un nouveau filtre a été ajouté où l'erreur Field : log, operator : is et Value :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-08.png)
Obtenir les journaux à partir d'une date spécifique
Vous pouvez ajouter un élément temps à vos critères de recherche.
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-09.png)
Utilisez l'une des options suivantes du champ Intervalle de temps :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-10.png)
- Absolu - D'une date spécifique à une autre date spécifique.
- Relatif - Des X dernières minutes, heures, jours ou semaines à une date spécifique.
- Maintenant - Définir l'heure sur « maintenant » signifie que cette heure sera définie sur l'heure de l'actualisation à chaque actualisation.
Exemples d'utilisation avec Lucene
Lucene est une bibliothèque de moteurs de recherche de texte multifonctions et performante. Il s'agit d'une technologie adaptée à presque toutes les applications nécessitant une recherche en texte intégral.
Naviguez jusqu'à la barre de recherche et désactivez KQL afin d'activer Lucene :
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-11.png)
Obtenir les journaux d'un service spécifique
Tapez la requête suivante dans la barre de filtre et appuyez sur le bouton Actualiser
kubernetes.labels.serviceName:<service-name>
Regardez l'exemple suivant avec task-service :
kubernetes.labels.serviceName:task-service
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-12.png)
Obtenir les journaux qui contiennent un mot spécifique
Conseil : les entrées de journal les plus courantes qui indiquent des problèmes contiennent « Erreur » , « Échec » et « Exception ». Cependant, vous pouvez modifier la chaîne pour qu'elle soit n'importe quelle autre chaîne commune qui peut vous guider dans votre dépannage.
Tapez la requête suivante dans la barre de filtre et appuyez sur le bouton Actualiser
log:error
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-13.png)
Mélanger et faire correspondre votre recherche
Vous pouvez rechercher des entrées qui correspondent à une combinaison de chaînes à l'aide de l'opérateur AND (ou &&) entre les chaînes.
log:error AND kubernetes.labels.serviceName:onboarding-service
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-14.png)
Remarque : certains champs ne sont pas disponibles pour la recherche.
Si vous souhaitez afficher uniquement les champs pouvant être recherchés dans le volet Champs disponibles, sélectionnez la roue dentée et personnalisez l'affichage. Vous pouvez également définir le type de recherche que vous souhaitez utiliser, par exemple, chaîne, booléen, nombre, etc.
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-15.png)
Rechercher une erreur dans deux services différents en même temps
Inclure deux services ou plus dans vos critères de recherche. Assurez-vous que les noms de services sont entrés entre parenthèses et séparez-les par OR.
log:error && (kubernetes.labels.serviceName:onboarding-service OR kubernetes.labels.serviceName:telemetry-agent)
![Interface graphique utilisateur](/c/dam/en/us/support/docs/cloud-systems-management/dna-center/213928-how-to-use-kibana-in-digital-network-arc-16.png)
Référence