Configuración de Kibana en DNA Center para la visualización de registros

Introducción

Este documento describe cómo usar Kibana para buscar registros específicos entre diferentes servicios del Centro DNA de Cisco.

Prerequisites

Requirements

Debe tener acceso a Cisco DNA Center a través de la GUI con ROL DE ADMINISTRADOR también, debe estar familiarizado con los nombres y el uso de los servicios de Cisco DNA Center.

Componentes Utilizados

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

  

Kibana es un plugin de visualización de datos de código abierto para Elasticsearch. Proporciona capacidades de visualización sobre el contenido indexado en un clúster de Elastic Search que están disponibles en Cisco DNA Center.

Puede acceder a Kibana de dos maneras:

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

Página web predeterminada de Kibana

Configurar Kibana para visualización de registros

Desplácese al menú de la barra izquierda y haga clic en Discover:

Kibana tiene varios campos, que se destacan en la siguiente imagen:

Agregar campos en Kibana

Vaya a Filtros > Campos disponibles

Los campos que debe agregar para la visualización de registros son:

• Kubernetes.labels.serviceName: servicio que muestra el registro específico
• Registro: contenido sin formato del registro

Haga clic en el botón Agregar

Asegúrese de que dispone de la siguiente configuración:

Añadir y editar filtros en Kibana

Para agregar un filtro, realice la siguiente actividad:

• Haga clic en Agregar filtro
• Campo seleccionado: Kubernetes.labels.serviceName
• Selección de operador: es
• Valor: seleccione el servicio que le interese
• Haga clic en el botón Guardar

Observe el siguiente ejemplo en el que el servicio seleccionado es apic-em-Inventory-manager-service:

Puede agregar más filtros según sea necesario.

En el siguiente ejemplo, se agregó un nuevo filtro en el que aparece Field:log, operator:is y Value: error:

Obtener registros de una fecha específica

Puede agregar un elemento time a los criterios de búsqueda. 

Utilice una de las siguientes opciones del campo Intervalo de tiempo:

• Absoluto: de una fecha específica a otra fecha específica. 
• Relativo: desde los últimos X minutos, horas, días o semanas hasta una fecha específica.
• Ahora: establecer la hora en "ahora" significa que en cada actualización esta hora se establecerá en la hora de la actualización.

Casos prácticos con Lucene

Lucene es una biblioteca de motores de búsqueda de texto de alto rendimiento y con numerosas funciones. Es una tecnología adecuada para casi cualquier aplicación que requiera búsqueda de texto completo.

Navegue hasta la barra de búsqueda y inhabilite KQL para habilitar Lucene:

Obtener registros de un servicio específico

Escriba la siguiente consulta en la barra de filtros y pulse el botón Actualizar

kubernetes.labels.serviceName:<service-name>

Vea el siguiente ejemplo con task-service:

kubernetes.labels.serviceName:task-service

Obtener registros que contienen una palabra específica

Sugerencia: las entradas de registro más comunes que indican problemas contienen " Error " , " Error " y " Excepción "; sin embargo, puede modificar la cadena para que sea cualquier otra cadena común que pueda guiarle en la solución de problemas.

Escriba la siguiente consulta en la barra de filtros y pulse el botón Actualizar

log:error

Mezcla y combina tu búsqueda

Puede buscar entradas que coincidan con una combinación de cadenas utilizando AND (o &&) entre las cadenas.

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

Nota: no se pueden realizar búsquedas en todos los campos.

Si sólo desea ver los campos en los que se pueden buscar en el panel Campos disponibles, seleccione la rueda dentada y personalice la vista. También puede definir el tipo de búsqueda que desea utilizar, por ejemplo, cadena, Booleano, número, etc.

Buscar un error en dos servicios diferentes al mismo tiempo

Incluya dos o más servicios en los criterios de búsqueda. Asegúrese de que los nombres de los servicios se introducen entre paréntesis y sepárelos con OR.

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

Referencia

• Opciones comunes de búsqueda elástica
• Apache Lucene - Sintaxis del analizador de consultas