Esta página se tradujo automáticamente con la API de traducción de Google Cloud.
Algunas páginas se pueden leer mejor en su totalidad.
Spring Boot Actuator es un subproyecto del marco Spring Boot que proporciona funciones listas para producción para ayudarlo a monitorear y administrar su aplicación. También le ayuda a la información auditada y de salud acerca de su aplicación. Spring Boot Actuator no está habilitado de forma predeterminada. Debe usar las anotaciones @EnableAutoConfiguration
o @SpringBootApplication
para habilitarlo.
Para habilitar Spring Boot Actuator en su aplicación Spring Boot, debe agregar la dependencia spring-boot-starter-actuator
a su archivo pom.xml
:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
También puede habilitar Spring Boot Actuator en su aplicación agregando las siguientes propiedades a su archivo application.properties
:
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always
Spring Boot Actuator proporciona una serie de puntos finales listos para producción que puede usar para monitorear y administrar su aplicación. La siguiente tabla enumera los puntos finales más importantes:
punto final | Descripción |
---|---|
/salud |
Muestra información sobre el estado de la aplicación (predeterminado en "ARRIBA"). |
/información |
Muestra información de aplicación arbitraria. |
/métricas |
Muestra información de métricas de la aplicación. |
/rastreo |
Muestra información de seguimiento de la aplicación. |
/volcado |
Realiza un volcado de subprocesos. |
/joloquia |
Expone beans JMX sobre HTTP (requiere jolokia-core ). |
/archivo de registro |
Devuelve el contenido del archivo de registro (si está configurado el registro). |
/actualizar |
Actualizar cachés de configuración y aplicaciones. |
/ruta de vuelo |
Muestra cualquier migración de base de datos de Flyway que se haya aplicado. |
/liquibase |
Muestra cualquier migración de base de datos de Liquibase que se haya aplicado. |
Los extremos /health
e /info
están protegidos de forma predeterminada. Para que sean de acceso público, debe agregar las siguientes propiedades a su archivo application.properties
:
management.security.enabled=false
Spring Boot Actuator ofrece varias formas de personalizar su comportamiento.
De manera predeterminada, Spring Boot Actuator usa el puerto 8080
para el servidor de administración. Puede cambiar esto agregando la siguiente propiedad a su archivo application.properties
:
management.server.port=<port>
De manera predeterminada, Spring Boot Actuator usa la ruta /actuator
para el servidor de administración. Puede cambiar esto agregando la siguiente propiedad a su archivo application.properties
:
management.server.servlet.path=/<path>
De forma predeterminada, Spring Boot Actuator usa los ID de punto final de la tabla anterior. Puede cambiarlos agregando la siguiente propiedad a su archivo application.properties
:
management.endpoints.web.exposure.include=<endpoint1>,<endpoint2>,...
De forma predeterminada, Spring Boot Actuator usa las rutas de puntos finales de la tabla anterior. Puede cambiarlos agregando la siguiente propiedad a su archivo application.properties
:
management.endpoint.<endpoint>.path=/<path>
De forma predeterminada, Spring Boot Actuator expone información confidencial en los cuerpos de respuesta del punto final. Puede cambiar esto agregando la siguiente propiedad a su archivo application.properties
:
management.endpoint.health.show-details=<value>
Donde <valor>
puede ser uno de los siguientes:
Valor | Descripción |
---|---|
siempre |
Mostrar siempre los detalles. |
nunca |
Nunca muestres detalles. |
cuando_autorizado |
Mostrar detalles cuando el usuario está autorizado. |
De forma predeterminada, Spring Boot Actuator usa la autenticación básica HTTP para los puntos finales. Puede cambiar esto agregando la siguiente propiedad a su archivo application.properties
:
management.security.enabled=false
De forma predeterminada, Spring Boot Actuator usa el nombre de usuario usuario
y la contraseña contraseña
para los puntos finales. Puede cambiarlos agregando las siguientes propiedades a su archivo application.properties
:
management.security.user.name=<username>
management.security.user.password=<password>
En este artículo, analizamos cómo usar Spring Boot Actuator para monitorear y administrar su aplicación. También hemos visto cómo personalizar el comportamiento del actuador.