Detalles

La página Details proporciona información sobre una instancia gestionada de una aplicación Spring Boot. Presenta metadatos técnicos, información de ejecución y detalles de compilación de forma organizada y fácil de leer.

Capturas de pantallaLas capturas muestran la última versión menor de Axelix.

Página principal de detalles

Página Details tal como aparece en la interfaz de Axelix

La página está disponible para cualquier usuario autenticado: VIEWER, EDITOR, ADMIN y SUPER_ADMIN pueden abrirla e iniciar la exportación Download state. Los archivos de propiedades del entorno y de configuración incluidos en el archivo exportado siguen sujetos al enmascaramiento según los permisos de cada página: quienes no tienen environment.values:read / config-properties.values:read reciben ****** para esos valores. Consulte Roles y permisos para ver la matriz completa de roles y permisos.

Cabecera interna de información del servicio

  • Instance Name: el nombre de la instancia de la aplicación. El sufijo puede variar según el entorno de ejecución y de descubrimiento de Axelix Master.
  • Download state: exporta el estado de la instancia como un archivo .zip, para analizar un problema más tarde o adjuntarlo a un informe de error.

Componentes de Download state

En el cuadro de diálogo se elige qué incluir. Los elementos se agrupan en JVM y Spring:

  • Heap Dump: todos los objetos en memoria, en un archivo .hprof. Para investigar fugas de memoria.
  • Thread Dump: trazas de pila de todos los hilos. Para investigar bloqueos y contención.
  • Beans: todos los beans con su ámbito, tipo y dependencias.
  • Caches: gestores de cachés y cachés.
  • Conditions: por qué se aplicó o no cada autoconfiguración.
  • Configuration Properties: beans @ConfigurationProperties y sus valores enlazados, con los valores sensibles enmascarados.
  • Environment: orígenes de propiedades por orden de precedencia, con los valores sensibles enmascarados.
  • Scheduled Tasks: tareas cron, de frecuencia fija y de demora fija.

Antes de descargar, el cuadro de diálogo muestra el tamaño estimado del archivo. Todos los elementos, excepto el volcado del heap, ocupan menos de 1 MB. El volcado del heap ocupa aproximadamente lo mismo que el heap utilizado, a menudo cientos de MB, y la aplicación deja de responder mientras se escribe. El volcado también contiene todo lo que hay en memoria, incluidas contraseñas y tokens, por lo que debe almacenarse como una credencial.

Acceso al volcado del heap

PublicadoDisponible desde la versión: 1.3.0

A partir de Axelix 1.3.0, exportar un volcado del heap como parte del estado de la aplicación requiere el permiso heap-dump:read. Sin él, esta opción está deshabilitada, pero se pueden seguir exportando los demás componentes. ADMIN y SUPER_ADMIN tienen este permiso de forma predeterminada.

Información de Git

Muestra metadatos del control de versiones, cuando están disponibles:

CampoDescripciónEjemplo
Commit SHAHash corto del commita1b2c3d
BranchNombre de la rama de Gitmain
Commit's AuthorNombre del autor del commitJohn Doe
Author's EmailCorreo del autor del commitjohn@example.com
Commit's TimestampCuándo se realizó el commit2024-01-15T10:15:30Z

Información de compilación

Muestra detalles de la compilación de la aplicación, cuando están disponibles:

CampoDescripciónEjemplo
Artifact IDID del artefacto Maven/Gradlespring-petclinic
VersionVersión de la aplicación3.2.0
Group IDID del grupo del proyectoorg.springframework.samples
Build TimestampCuándo se compiló la aplicación2024-01-15T14:30:22Z

Información del entorno de ejecución

Información detallada de Java y del entorno de ejecución:

CampoDescripciónEjemplo
JavaVersión de la JVM17.0.17
KotlinVersión de Kotlin
(si la instancia utiliza Kotlin)
1.9.22
JDK VendorProveedor de la distribución de JavaLiberica, OpenJDK, Amazon Corretto
Garbage CollectorGC activo en la aplicaciónG1, ZGC, GEN_SHENADOAH, EPSILONGC

Detalles de Spring Framework

Versiones del ecosistema Spring:

CampoDescripciónEjemplo
Spring BootVersión de Spring Boot3.3.0
Spring FrameworkVersión del núcleo de Spring Framework6.2.0
Spring CloudVersión de Spring Cloud (si se utiliza)2023.0.0

Información del sistema operativo

Detalles del sistema:

CampoDescripciónEjemplo
OS FamilyNombre del sistema operativoLinux, Windows Server
Kernel VersionVersión del sistema operativo6.12.96, 2022
CPU ArchitectureArquitectura de CPUamd64, arm64
PIDID del proceso de la aplicación1
Process UserUsuario del sistema operativo con el que se ejecuta el proceso de la aplicaciónroot, app

PID y Process User aparecen a partir de Axelix 1.3.0. Conviene revisar un proceso que se ejecuta como root dentro de un contenedor, porque tiene más permisos de los que necesita la aplicación.

Habilitar el endpoint dedicado de Actuator

Versiones anterioresSolo necesario antes de la versión: 1.2.0.

En Axelix 1.2.0 o posterior, nada de esto es necesario: el starter registra por sí mismo sus endpoints personalizados de Actuator y Axelix ya no requiere habilitar los endpoints health/info. Funciona correctamente sin ellos. No se necesita ninguna configuración aquí.

La página utiliza el endpoint de Actuator axelix-details, aportado por Axelix Spring Boot Starter. Expóngalo mediante las propiedades estándar de Spring Boot Actuator. Consulte Configuración de Spring Boot Starter para ver la lista completa de endpoints de Axelix y el resto de la configuración:

management.endpoints.web.exposure.include=axelix-details

Véase también

En esta página

Editar en GitHubInformar de un problema