Utiliser Application Live View avec le plan Azure Spring Apps Entreprise

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à :❌ De base/Standard ✔️ Entreprise

Cet article explique comment utiliser Application Live View pour VMware Tanzu avec le plan Azure Spring Apps Enterprise.

Application Live View pour VMware Tanzu est un outil léger d’insights et de résolution des problèmes qui permet aux développeurs et aux opérateurs d'applications de visualiser les applications en cours d'exécution.

Application Live View prend uniquement en charge les applications Spring Boot.

Prérequis

• Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

• Comprendre la section Exigences du plan niveau Enterprise dans la place de marché Azure et y répondre.

• Azure CLI avec l’extension Azure Spring Apps. Utilisez la commande suivante pour supprimer les versions précédentes et installer la dernière extension. Si vous avez déjà installé l’extension spring-cloud, désinstallez-la pour éviter les incompatibilités de configuration et de version.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

Activer Application Live View

Vous pouvez activer Application Live View lorsque vous approvisionnez une instance de plan Azure Spring Apps Entreprise. Si vous disposez déjà d’une ressource Azure Spring Apps Enterprise approvisionnée, consultez la section Gérer Application Live View dans les instances de plan Entreprise existantes de cet article.

Vous pouvez activer Application Live View à l’aide du Portail Azure ou d’Azure CLI.

Azure portal

Pour activer Application Live View à l’aide du Portail Azure, procédez comme suit :

1. Accédez au portail Azure.

2. Sous l’onglet Concepts de base, sélectionnez Niveau Entreprise dans la tarification, spécifiez d’autres champs d’entrée, puis sélectionnez Suivant.

3. Sous l’onglet Paramètres de VMware Tanzu, sélectionnez Activer la vue en direct d’application.

   

4. Spécifiez d’autres paramètres, puis sélectionnez Vérifier et créer.

5. Assurez-vous que les options Activer Application Live View et Activer le portail des outils de développement sont définies sur Oui dans l'onglet Réviser et créer, puis sélectionnez Créer pour créer l'instance du plan Entreprise.

Azure CLI

Procédez comme suit pour approvisionner une instance de service Azure Spring Apps à l’aide d’Azure CLI.

1. Utilisez la commande suivante pour vous connecter à l’interface Azure CLI et préciser votre abonnement actif :

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. Utilisez la commande suivante pour accepter les conditions d’utilisation et la déclaration de confidentialité du niveau Enterprise. Cette étape est nécessaire uniquement si votre abonnement n’a jamais été utilisé pour créer une instance de niveau Entreprise d’Azure Spring Apps.

   az provider register --namespace Microsoft.SaaS
   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

3. Sélectionnez un emplacement. Cet emplacement doit être un emplacement prenant en charge le plan Azure Spring Apps Enterprise. Pour plus d’informations, consultez Questions fréquentes (FAQ) sur Azure Spring Apps.

4. Utilisez la commande suivante pour créer un groupe de ressources :

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   Pour plus d’informations sur les groupes de ressources, consultez Qu’est-ce qu’Azure Resource Manager ?.

5. Préparez un nom pour votre instance de service Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et contenir uniquement des lettres minuscules, des chiffres et des traits d’union. Le premier caractère du nom du service doit être une lettre, et le dernier doit être une lettre ou un chiffre.

6. Utilisez la commande suivante pour créer une instance de service Azure Spring Apps :

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise \
       --enable-application-live-view
   

Monitorer Application Live View

Azure Spring Apps exécute Application Live View en mode connecteur.

Composant	Description
Serveur Application Live View	Composant serveur central qui contient une liste d’applications enregistrées. Le serveur Application Live View est chargé d'acheminer la demande afin de récupérer les informations relatives à l'actionneur de l'application.
Connecteur Application Live View	Composant responsable de la découverte de l’application en cours d’exécution et de l’enregistrement des instances auprès du serveur Application Live View pour qu'elles puissent être observées. Le connecteur Application Live View est également chargé de transmettre les requêtes des actionneurs à l'application.

Après avoir approvisionné l'instance du plan Azure Spring Apps Enterprise, vous pouvez obtenir son état de fonctionnement et sa consommation de ressources, ou gérer Application Live View.

Vous pouvez monitorer Application Live View à l'aide du Portail Azure ou de Azure CLI.

Azure portal

Vous pouvez afficher l’état d’Application Live View dans le Portail Azure sous l’onglet Vue d’ensemble de la page Outils de développement.

Azure CLI

Utilisez la commande suivante pour afficher Application Live View :

az spring application-live-view show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Configurer Dev Tools pour accéder à Application Live View

Pour accéder à Application Live View, vous devez configurer Tanzu Dev Tools. Pour plus d’informations, consultez Configurer Tanzu Dev Tools dans le plan Azure Spring Apps Entreprise.

Utiliser Application Live View pour surveiller vos applications

Application Live View vous permet d’afficher les métriques en direct pour les applications Spring Boot et Spring Native. L’affichage en direct de l’application (Application Live View) est basé sur le concept d’actionneurs Spring Boot.

Procédez comme suit pour déployer une application et la surveiller dans Application Live View :

1. Ajoutez la dépendance suivante au fichier pom.xml de votre application.

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

2. Ajoutez l’objectif d’exécution suivant à votre plug-in Maven dans le fichier pom.xml pour exposer les informations de build :

   <plugin>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-maven-plugin</artifactId>
   <executions>
       <execution>
       <goals>
           <goal>build-info</goal>
       </goals>
       <configuration>
           <additionalProperties>
           <spring.boot.version>${project.parent.version}</spring.boot.version>
           </additionalProperties>
       </configuration>
       </execution>
   </executions>
   </plugin>
   

3. Activez le point de terminaison d’actionneur en ajoutant la configuration suivante dans application.properties :

   management.endpoints.web.exposure.include=info,health
   

4. Utilisez la commande suivante pour générer votre package localement :

   mvn clean package -DskipTests
   

5. Utilisez la commande suivante pour déployer le fichier binaire :

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name>
   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name> \
       --artifact-path <jar-file-in-target-folder>
   

6. Une fois l’application déployée, vous pouvez la surveiller à l’aide du tableau de bord Application Live View sur le portail Dev Tools. Pour plus d’informations, consultez Surveiller des applications par Application Live View.

   Si vous avez déjà activé le Portail Dev Tools et exposé un point de terminaison public, utilisez la commande suivante pour obtenir l’URL du tableau de bord du Portail Dev Tools. Ajoutez le suffixe /app-live-view pour composer le point de terminaison pour accéder à Application Live View.

   az spring dev-tool show --service <Azure-Spring-Apps-service-instance-name> \
       --resource-group <resource-group-name> \
       --query properties.url \
       --output tsv
   

   Vous pouvez également accéder à Application Live View à l’aide de Visual Studio Code (VS Code). Pour obtenir plus d’informations, consultez la section Utiliser Application Live View dans VS Code de cet article.

Gérer Application Live View dans les instances de plan Entreprise existantes

Vous pouvez activer Application Live View sous une instance de plan Azure Spring Apps Entreprise existante à l’aide du Portail Azure ou d’Azure CLI.

Si vous avez activé le Portail Dev Tools et exposé un point de terminaison public, utilisez Ctrl+F5 pour désactiver le cache du navigateur après avoir activé Application Live View.

Azure portal

Pour gérer Application Live View à l’aide du Portail Azure, procédez comme suit :

1. Accédez à votre instance de service Azure Spring Apps, puis sélectionnez Outils de développement.

2. Sélectionnez Gérer les outils.

   

3. Cochez la case Activer la vue en direct de l’application, puis sélectionnez Enregistrer.

   

4. Vous pouvez ensuite afficher l’état de Application Live View sur les Outils de développement.

Azure CLI

Utilisez la commande suivante pour activer Application Live View à l’aide d’Azure CLI :

az spring application-live-view create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Pour accéder au tableau de bord Application Live View, vous devez activer le Portail Dev Tools et attribuer un point de terminaison public. Utilisez la commande suivante pour activer le Portail Dev Tools et attribuer un point de terminaison public :

az spring dev-tool create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-service-instance-name> \
   --assign-endpoint

Configurer un actionneur Spring Boot personnalisé

Application Live View peut se connecter et surveiller automatiquement les applications Spring Boot avec les paramètres d’actionneur par défaut. Le port HTTP par défaut des points de terminaison d’actionneur est le même que le port HTTP de l’application et tous les points de terminaison sont accessibles par le chemin d’accès de contexte par défaut de l’application qui a le suffixe /actuator.

Si le porte (management.server.port=) ou le chemin d’accès de contexte (management.endpoints.web.base-path=/) sont personnalisés pour une application, Application Live View arrête la connexion et la surveillance de l’application et signale 404 pour l’application. Pour permettre à Application Live View de continuer à surveiller ces applications, utilisez les étapes suivantes pour configurer le déploiement de l’application afin de personnaliser les points de terminaison de l’actionneur.

Azure portal

Utilisez les étapes suivantes pour configurer le déploiement en utilisant le Portail Azure :

1. Accédez à votre instance de service Azure Spring Apps, puis à la page Applications, enfin sélectionnez une application.

2. Sélectionnez Configuration dans le volet de navigation.

3. Sous l’onglet Paramètres généraux, mettez à jour les valeurs de Port d’actionneur Spring Boot et Chemin d’accès d’actionneur Spring Boot, puis sélectionnez Enregistrer.

   

Azure CLI

Utilisez la commande suivante pour déployer votre application avec les paramètres d’actionneur personnalisés dans l’interface Azure CLI :

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --artifact-path <jar-file-in-target-folder> \
    --custom-actuator-path <another-path-for-actuator> \
    --custom-actuator-port <another-port-for-actuator>

Remarque

Vous pouvez définir cette configuration sur une application ou un déploiement. Lorsque vous configurez une application, son application prend effectivement effet sur le déploiement actif actuel, mais elle n’affecte pas automatiquement les nouveaux déploiements.

Utiliser Application Live View dans VS Code

Vous pouvez accéder directement à Application Live View dans VS Code pour surveiller vos applications dans le plan Azure Spring Apps Enterprise.

Prérequis

• Visual Studio Code
• Extension Azure Spring Apps pour Visual Studio Code

Afficher le tableau de bord Application Live View

Pour afficher le tableau de bord Application Live View pour une instance de service, procédez comme suit :

1. Dans Visual Studio Code, ouvrez l’extension Azure Spring Apps, puis connectez-vous à votre compte Azure.

2. Développez l’instance de service que vous souhaitez surveiller et cliquez avec le bouton droit pour sélectionner l’instance de service.

3. Sélectionnez Ouvrir Application Live View dans le menu pour ouvrir le tableau de bord Application Live View dans votre navigateur par défaut.

   

Afficher la page Application Live View pour une application

Procédez comme suit pour afficher la page Application Live View pour une application :

1. Dans Visual Studio Code, ouvrez l’extension Azure Spring Apps, puis connectez-vous à votre compte Azure.

2. Développez l’instance de service et l’application que vous souhaitez surveiller. Faites un clic droit sur l’application.

3. Sélectionnez Ouvrir Application Live View dans le menu pour ouvrir la page Application Live View pour l’application dans votre navigateur par défaut.

   

Résoudre les problèmes liés à Application Live View

Si vous essayez d’ouvrir Application Live View pour une instance de service ou une application qui n’a pas activé Application Live View ou exposé un point de terminaison public, un message d’erreur s’affiche.

Pour activer Application Live View et exposer un point de terminaison public, utilisez le Portail Azure ou Azure CLI. Pour obtenir plus d’informations, consultez la section Gérer Application Live View dans les instances de plan Entreprise existantes de cet article.

Étapes suivantes

• Azure Spring Apps