Vue d’ensemble

La page Vue d’ensemble fournit des informations sur une instance d’application Spring Boot gérée. Elle présente des métadonnées techniques, des informations d’exécution et des détails de build dans un format organisé et facile à lire.

Captures d’écranLes captures d’écran correspondent à la dernière version mineure d’Axelix.

page principale des détails

Page Vue d’ensemble dans l’interface Axelix

Cette page est accessible à tout utilisateur authentifié : VIEWER, EDITOR, ADMIN et SUPER_ADMIN peuvent tous l’ouvrir et déclencher l’export Download state. Notez que les fichiers de propriétés d’environnement et de propriétés de configuration contenus dans l’archive exportée restent soumis au masquage appliqué selon les autorisations de chaque page : les utilisateurs qui ne disposent pas des autorités environment.values:read / config-properties.values:read obtiennent ****** à la place de ces valeurs. Consultez Rôles et autorités pour obtenir la matrice complète des rôles et des autorités.

En-tête interne des informations sur le service

  • Instance Name : nom de l’instance d’application. Le suffixe peut varier selon l’environnement d’exécution et de découverte d’Axelix Master.
  • Download state : exporte l’état de l’instance sous la forme d’un seul fichier .zip, afin que vous puissiez analyser un problème ultérieurement ou joindre ce fichier à un rapport de bug.

Composants de Download state

Dans la boîte de dialogue, vous choisissez les éléments à inclure. Ils sont regroupés sous JVM et Spring :

  • Heap Dump : tous les objets en mémoire, dans un fichier .hprof. Pour analyser les fuites mémoire.
  • Thread Dump : traces de la pile de tous les threads. Pour analyser les blocages et la contention.
  • Beans : tous les beans avec leur portée, leur type et leurs dépendances.
  • Caches : gestionnaires de caches et caches.
  • Conditions : raisons pour lesquelles chaque auto-configuration a été appliquée ou non.
  • Configuration Properties : beans @ConfigurationProperties et leurs valeurs liées, avec masquage des valeurs sensibles.
  • Environment : sources de propriétés dans leur ordre de priorité, avec masquage des valeurs sensibles.
  • Scheduled Tasks : tâches cron, à fréquence fixe et à délai fixe.

Avant le téléchargement, la boîte de dialogue affiche la taille estimée de l’archive. Chaque élément, à l’exception du dump de heap, occupe moins de 1 Mo. Le dump de heap a à peu près la même taille que le heap utilisé, souvent plusieurs centaines de Mo, et l’application cesse de répondre pendant son écriture. Le dump de heap contient également tout ce qui se trouve en mémoire, y compris les mots de passe et les jetons : conservez-le donc comme un secret.

Accès au dump de heap

PubliéDisponible depuis la version: 1.3.0

À partir d’Axelix 1.3.0, l’export d’un dump de heap dans le cadre de l’état de l’application nécessite l’autorité heap-dump:read. Sans cette autorité, l’option est désactivée, mais vous pouvez toujours exporter les autres composants. Les rôles ADMIN et SUPER_ADMIN disposent de cette autorité par défaut.

Informations Git

Affiche les métadonnées du système de gestion de versions (lorsqu’elles sont disponibles) :

ChampDescriptionExemple
Commit SHAHash court du commita1b2c3d
BranchNom de la branche Gitmain
Commit's AuthorNom de l’auteur du commitJohn Doe
Author's EmailE-mail de l’auteur du commitjohn@example.com
Commit's TimestampDate et heure du commit2024-01-15T10:15:30Z

Informations de build

Affiche des détails sur le build de l’application (lorsqu’ils sont disponibles) :

ChampDescriptionExemple
Artifact IDID de l’artefact Maven/Gradlespring-petclinic
VersionVersion de l’application3.2.0
Group IDID du groupe du projetorg.springframework.samples
Build TimestampDate et heure du build de l’application2024-01-15T14:30:22Z

Informations sur l’environnement d’exécution

Informations détaillées sur Java et l’environnement d’exécution :

ChampDescriptionExemple
JavaVersion de la JVM17.0.17
KotlinVersion de Kotlin
(si l’instance utilise Kotlin)
1.9.22
JDK VendorFournisseur de la distribution JavaLiberica, OpenJDK, Amazon Corretto
Garbage CollectorGC actif dans l’applicationG1, ZGC, GEN_SHENADOAH, EPSILONGC

Détails de Spring Framework

Versions de l’écosystème Spring :

ChampDescriptionExemple
Spring BootVersion du framework Spring Boot3.3.0
Spring FrameworkVersion de Spring Framework Core6.2.0
Spring CloudVersion de Spring Cloud (si utilisé)2023.0.0

Informations sur le système d’exploitation

Détails au niveau du système :

ChampDescriptionExemple
OS FamilyNom du système d’exploitationLinux, Windows Server
Kernel VersionVersion du système d’exploitation6.12.96, 2022
CPU ArchitectureArchitecture du processeuramd64, arm64
PIDID du processus de l’application1
Process UserUtilisateur OS qui exécute le processus de l’applicationroot, app

PID et Process User sont disponibles à partir d’Axelix 1.3.0. Un processus exécuté en tant que root dans un conteneur mérite d’être examiné de plus près, car il dispose de plus de droits que nécessaire pour l’application.

Activer l’endpoint Actuator dédié

ObsolèteNécessaire uniquement avant la version: 1.2.0.

Si vous utilisez Axelix 1.2.0 ou une version ultérieure, aucune de ces étapes n’est nécessaire : le starter enregistre lui-même ses endpoints actuator personnalisés, et Axelix ne nécessite plus l’activation des endpoints health/info : il fonctionne parfaitement sans eux. Aucune configuration n’est nécessaire ici.

Cette page repose sur l’endpoint actuator axelix-details fourni par l’Axelix Spring Boot Starter. Exposez-le à l’aide des propriétés standard de Spring Boot Actuator. Consultez Configuration du Spring Boot Starter pour obtenir la liste complète des endpoints Axelix et les informations de configuration associées :

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

Voir aussi

Sur cette page

Modifier sur GitHubSignaler un problème