Compartir vía

Administración y supervisión de aplicaciones con el accionador de Spring Boot

  • Artículo

Nota:

Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.

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

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

El accionador de Spring Boot aporta características listas para producción a sus aplicaciones. Puede supervisar sin esfuerzo la aplicación, recopilar métricas y comprender el estado o la actividad de la base de datos con esta herramienta. Obtiene acceso a herramientas de nivel profesional sin necesidad de compilarlas desde cero.

El accionador expone datos operativos vitales sobre la aplicación en ejecución, como el estado de mantenimiento, las métricas, la información, etc. El accionador usa puntos de conexión HTTP o Extensiones de administración de Java (JMX), lo que facilita la interacción. Después de integrarlo, proporciona varios puntos de conexión predeterminados y, al igual que otros módulos de Spring, se puede configurar y ampliar fácilmente.

Azure Spring Apps usa el accionador para enriquecer las métricas a través de JMX. También puede trabajar con Application Live View en el plan Enterprise para ayudarle a obtener e interactuar con los datos de las aplicaciones.

Diagrama que muestra el flujo de datos mediante el accionador de Spring Boot.

Configurar el accionador de Spring Boot

En las siguientes secciones se describe cómo configurar el accionador.

Adición de dependencia del actuador

Para agregar el actuador a un proyecto basado en Maven, agregue la dependencia siguiente:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

Esta configuración funciona con cualquier versión de Spring Boot porque las versiones se tratan en la lista de materiales de Spring Boot (BOM).

Configuración del punto de conexión del accionador

De forma predeterminada, una aplicación de Spring Boot solo expone el punto de conexión health. Para observar la configuración y el entorno configurable, siga estos pasos para habilitar también los puntos de conexión env y configprops:

  1. Vaya al panel Información general de la aplicación, seleccione Configuración en el menú de configuración y, a continuación, vaya a la página de configuración Variables de entorno.

  2. Agregue las siguientes propiedades como en el formulario "clave: valor". Este entorno abre los siguientes puntos de conexión del accionador de Spring: health, env y configprops.

    management.endpoints.web.exposure.include: health,env,configprops

  3. Seleccione Guardar. La aplicación se reinicia automáticamente y carga las nuevas variables de entorno.

Ahora puede volver al panel Información general de la aplicación y esperar a que el estado del aprovisionamiento cambie a Correcto.

Para ver todos los puntos de conexión integrados y configuraciones relacionadas, consulte la sección Exponer puntos de conexión de las características listas para producción de Spring Boot.

Punto de conexión seguro del accionador

Al abrir la aplicación al público, estos puntos de conexión del accionador también se exponen al público. Se recomienda ocultar todos los puntos de conexión estableciendo management.endpoints.web.exposure.exclude=*, ya que la propiedad exclude tiene prioridad sobre la propiedad include. Tenga en cuenta que esta acción bloquea Application Live View en el plan Enterprise y otras aplicaciones o herramientas que dependen del punto de conexión HTTP del accionador.

En el plan Enterprise, hay dos maneras de proteger el acceso:

  • Puede deshabilitar el punto de conexión público de las aplicaciones y configurar una regla de enrutamiento en Spring Cloud Gateway de VMware para deshabilitar el acceso del accionador desde el público. Para obtener más información, consulte Configuración de Spring Cloud Gateway para VMware.

  • Puede configurar el accionador para que escuche en un puerto HTTP diferente de la aplicación principal. En una aplicación independiente, el puerto HTTP del accionador tiene como valor predeterminado el mismo que el puerto HTTP principal. Para que la aplicación escuche en un puerto diferente, establezca la propiedad management.server.port. Application Live View no puede detectar automáticamente este cambio de puerto, por lo que también debe configurar la propiedad en una implementación de Azure Spring Apps. A continuación, el accionador no es accesible públicamente, pero Application Live View puede leer desde el punto de conexión del accionador a través de otro puerto. Para obtener más información, consulte Uso de Application Live View con el plan Enterprise de Azure Spring Apps.

Pasos siguientes