Analizar registros con Elastic (ELK) mediante las configuraciones de diagnóstico

Nota:

Los planes Básico, Estándar y Enterprise entraron en un período de retirada el 17 de marzo de 2025. Para obtener más información, consulte el anuncio de retirada de Azure Spring Apps.

Este artículo se aplica a:✅ Java ✅ C#

Este artículo se aplica a:✅ Básico/Estándar ✅ Enterprise

En este artículo se muestra cómo usar la funcionalidad de diagnóstico de Azure Spring Apps para analizar registros con Elastic (ELK).

En el vídeo siguiente se presenta la observabilidad unificada para las aplicaciones Spring Boot que usan Elastic.


Configuración de valores de diagnóstico

Para configurar las opciones de diagnósticos, siga estos pasos:

  1. En el Portal de Azure, vaya a su instancia de Azure Spring Apps.
  2. Seleccione la opción Configuración de diagnóstico y después, Add diagnostics setting (Agregar configuración de diagnósticos).
  3. Escriba un nombre para la configuración, elija Send to partner solution(Enviar a la solución de asociado) y, después, seleccione Elastic y una implementación de Elastic a la que desee enviar los registros.
  4. Seleccione Guardar.

Captura de pantalla del portal de Azure que muestra la página de Configuración de diagnóstico con las opciones seleccionadas y el nombre especificado para la configuración.

Nota:

Puede haber un intervalo de hasta 15 minutos entre el momento en que se emiten los registros y el momento en que aparecen en la implementación de Elastic. Si se elimina o mueve la instancia de Azure Spring Apps, la operación no se aplica en cascada a los recursos de configuración de diagnóstico. Debe eliminar manualmente los recursos de configuración de diagnóstico antes de realizar la operación en su elemento primario, la instancia de Azure Spring Apps. De lo contrario, si aprovisiona una nueva instancia de Azure Spring Apps con el mismo identificador de recurso que el eliminado, o si vuelve a mover la instancia de Azure Spring Apps, los recursos de configuración de diagnóstico anteriores seguirán extendiéndose.

Análisis de los registros con Elastic

Para obtener más información sobre la implementación de Elastic en Azure, consulte Cómo implementar y administrar Elastic en Microsoft Azure.

Siga estos pasos para analizar los registros:

  1. En la página de resumen de implementación de Elastic en el portal de Azure, abra Kibana.

    Captura de pantalla del portal de Azure que muestra la página Elasticsearch (Elastic Cloud) con la URL de implementación de Kibana resaltada.

  2. En Kibana, en la barra de búsqueda superior, escriba Spring Cloud type:dashboard.

    Captura de pantalla de Elastic /Kibana que muestra los resultados de búsqueda de Spring Cloud type:dashboard.

  3. Seleccione [Registros Azure] Descripción general de los registros de Azure Spring Apps en los resultados.

    Captura de pantalla de Elastic / Kibana que muestra los registros de la consola de aplicaciones de Azure Spring Apps.

  4. Busque en los paneles predeterminados de Azure Spring Apps usando consultas como las siguientes:

    azure.springcloudlogs.properties.app_name : "visits-service"
    

Análisis de los registros con el lenguaje de consulta Kibana en Discover

Los registros de aplicaciones proporcionan información crítica y registros detallados sobre el estado de la aplicación, el rendimiento y mucho más. Siga estos pasos para analizar los registros:

  1. En Kibana, en la barra de búsqueda de la parte superior, escriba Discovery, a continuación, seleccione el resultado.

    Captura de pantalla de Elastic /Kibana que muestra los resultados de búsqueda de Discover.

  2. En la aplicación Discover, seleccione el patrón de índice logs- si aún no está seleccionado.

    Captura de pantalla de Elastic /Kibana que muestra la página de registros en la aplicación Discover.

  3. Use consultas como las de las secciones siguientes para ayudarle a comprender los estados actuales y pasados de su aplicación.

Para obtener más información sobre las distintas consultas, vea Guide to Kibana Query Language (Guía sobre el lenguaje de consultas de Kibana).

Mostrar todos los registros de Azure Spring Apps

Para revisar una lista de registros de aplicaciones de Azure Spring Apps, ordenados por tiempo con los registros más recientes que se muestran en primer lugar, ejecute la consulta siguiente en el cuadro Search:

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring"

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con todos los registros mostrados.

Mostrar tipos de registro específicos de Azure Spring Apps

Para revisar una lista de registros de aplicaciones de Azure Spring Apps, ordenados por tiempo con los registros más recientes que se muestran en primer lugar, ejecute la consulta siguiente en el cuadro Search:

azure.springcloudlogs.category : "ApplicationConsole"

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con registros específicos mostrados.

Visualización de las entradas de registro con errores o excepciones

Para revisar las entradas de registro sin ordenar que mencionan un error o una excepción, ejecute la siguiente consulta:

azure_log_forwarder.resource_type : "Microsoft.AppPlatform/Spring" and (log.level : "ERROR" or log.level : "EXCEPTION")

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con registros de errores y excepciones mostrados.

El lenguaje de consulta de Kibana le ayuda a crear consultas proporcionando texto autocompletado y sugerencias que le ayudarán a obtener conclusiones de los registros. Use su consulta para buscar errores o modificar los términos de la consulta para encontrar códigos de error específicos o excepciones.

Visualización de entradas de registro de un servicio específico

Para revisar las entradas de registro generadas por un servicio específico, ejecute la consulta siguiente:

azure.springcloudlogs.properties.service_name : "sa-petclinic-service"

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con registros de servicio específicos mostrados.

Visualización de registros de Config Server que contienen advertencias o errores

Para revisar los registros de Config Server, ejecute la consulta siguiente:

azure.springcloudlogs.properties.type : "ConfigServer" and (log.level : "ERROR" or log.level : "WARN")

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con los registros de Config Server mostrados.

Mostrar registros del Registro de Servicio

Para revisar los registros del Registro de servicio, ejecute la consulta siguiente:

azure.springcloudlogs.properties.type : "ServiceRegistry"

Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con los registros del Registro de servicio mostrados.

Visualización de registros de Azure Spring Apps con Elastic

Kibana permite visualizar datos con paneles y un ecosistema enriquecido de visualizaciones. Para más información, consulte Panel y visualización.

Siga estos pasos para mostrar los distintos niveles de registro en los registros para que pueda evaluar el estado general de los servicios.

  1. En la lista de campos disponibles a la izquierda en Discover, busque log.level en el cuadro de búsqueda dentro del patrón de índice logs-.

  2. Seleccione el campo log.level. En el panel informativo flotante sobre log.level, seleccione Visualizar.

    Captura de pantalla de Elastic/Kibana que muestra la aplicación Discover con niveles de registro mostrados.

  3. Desde aquí, puede elegir agregar más datos desde el panel izquierdo o elegir entre varias sugerencias cómo desea visualizar los datos.

    Captura de pantalla de Elastic /Kibana que muestra la aplicación Discover con opciones de visualización.

Pasos siguientes