Usare Application Live View con il piano Enterprise di Azure Spring Apps

Questo articolo si applica a:❌ Basic/Standard ✔️ Enterprise

Questo articolo illustra come usare Application Live View per VMware Tanzu con il piano Enterprise di Azure Spring Apps.

Application Live View per VMware Tanzu è uno strumento leggero per informazioni dettagliate e risoluzione dei problemi che consente agli sviluppatori di app e agli operatori di app di guardare all'interno delle app in esecuzione.

Application Live View supporta solo le applicazioni Spring Boot.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Comprendere e soddisfare la sezione Requisiti del piano Enterprise in Azure Marketplace.

• Interfaccia della riga di comando di Azure con l'estensione Azure Spring Apps. Usare il comando seguente per rimuovere le versioni precedenti e installare l'estensione più recente. Se l'estensione spring-cloud è stata installata in precedenza, disinstallarla per evitare la mancata corrispondenza della configurazione e della versione.

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

Abilitare la visualizzazione dinamica dell'applicazione

È possibile abilitare Application Live View quando si effettua il provisioning di un'istanza del piano Enterprise di Azure Spring Apps. Se si dispone già di una risorsa azure Spring Apps Enterprise di cui è stato effettuato il provisioning, vedere la sezione Gestire la visualizzazione dinamica delle applicazioni nelle istanze del piano enterprise esistenti di questo articolo.

È possibile abilitare Application Live View usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Monitorare la visualizzazione dinamica dell'applicazione

App Spring di Azure esegue la visualizzazione dinamica dell'applicazione in modalità connettore.

Dopo aver effettuato il provisioning dell'istanza del piano Enterprise di Azure Spring Apps, è possibile ottenere lo stato di esecuzione e l'utilizzo delle risorse oppure gestire Application Live View.

È possibile monitorare Application Live View usando il portale di Azure o l'interfaccia della riga di comando di Azure.

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

Configurare Dev Tools per accedere a Application Live View

Per accedere a Application Live View, è necessario configurare Tanzu Dev Tools. Per altre informazioni, vedere Configurare gli strumenti di sviluppo Tanzu nel piano Enterprise Azure Spring Apps.

Usare Application Live View per monitorare le app

Application Live View consente di visualizzare le metriche in tempo reale per le applicazioni Spring Boot e le applicazioni Spring Native. Application Live View si basa sul concetto di attuatori Spring Boot.

Usare la procedura seguente per distribuire un'app e monitorarla in Application Live View:

1. Aggiungere la dipendenza seguente al file di pom.xml dell'applicazione.

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

2. Aggiungere l'obiettivo di esecuzione seguente al plug-in Maven nel file pom.xml per esporre le informazioni di compilazione:

   <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. Abilitare l'endpoint dell'attuatore aggiungendo la configurazione seguente in application.properties:

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

4. Usare il comando seguente per compilare il pacchetto in locale:

   mvn clean package -DskipTests
   

5. Usare il comando seguente per distribuire il file binario:

   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. Dopo aver distribuito correttamente l'app, è possibile monitorarla usando il dashboard di Application Live View nel portale di Dev Tools. Per altre informazioni, vedere Monitorare le app in base alla visualizzazione dinamica delle applicazioni.

   Se è già stato abilitato il portale di Dev Tools ed è stato esposto un endpoint pubblico, usare il comando seguente per ottenere l'URL del dashboard del portale di Dev Tools. Aggiungere il suffisso /app-live-view per comporre l'endpoint per accedere a 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
   

   È anche possibile accedere alla visualizzazione live dell'applicazione usando Visual Studio Code (VS Code). Per altre informazioni, vedere la sezione Use Application Live View in VS Code di questo articolo.

Gestire la visualizzazione dinamica delle applicazioni nelle istanze del piano enterprise esistenti

È possibile abilitare Application Live View in un'istanza del piano enterprise di Azure Spring Apps esistente usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Se è stato abilitato il portale di Dev Tools ed è stato esposto un endpoint pubblico, usare CTRL+F5 per disattivare la cache del browser dopo aver abilitato Application Live View.

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

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

Configurare un attuatore Spring Boot personalizzato

Application Live View può connettersi e monitorare automaticamente le app Spring Boot con le impostazioni predefinite degli attuatori. La porta HTTP predefinita degli endpoint dell'attuatore è uguale alla porta HTTP dell'applicazione e tutti gli endpoint dell'attuatore sono accessibili dal percorso di contesto predefinito dell'applicazione, con il /actuator suffisso .

Se la porta (management.server.port=) o il percorso di contesto (management.endpoints.web.base-path=/) sono personalizzati per un'app, Application Live View interrompe la connessione e il monitoraggio dell'app e segnala 404 per l'app. Per abilitare Application Live View per continuare a monitorare tali app, seguire questa procedura per configurare la distribuzione dell'app per personalizzare gli endpoint dell'attuatore.

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>

Usare la visualizzazione dinamica dell'applicazione in VS Code

È possibile accedere direttamente a Application Live View in VS Code per monitorare le app nel piano Azure Spring Apps Enterprise.

Prerequisiti

• Visual Studio Code
• Estensione Azure Spring Apps per Visual Studio Code

Visualizzare il dashboard visualizzazione dinamica dell'applicazione

Usare la procedura seguente per visualizzare il dashboard di Application Live View per un'istanza del servizio:

1. In Visual Studio Code, aprire l'estensione Azure Spring Apps ed accedere all'account Azure.

2. Espandere l'istanza del servizio da monitorare e fare clic con il pulsante destro del mouse per selezionare l'istanza del servizio.

3. Selezionare Apri visualizzazione dinamica applicazione dal menu per aprire il dashboard visualizzazione dinamica dell'applicazione nel browser predefinito.

   

Visualizzare la pagina Visualizzazione dinamica dell'applicazione per un'app

Usare la procedura seguente per visualizzare la pagina Application Live View per un'app:

1. In Visual Studio Code, aprire l'estensione Azure Spring Apps ed accedere all'account Azure.

2. Espandere l'istanza del servizio e l'app da monitorare. Fare clic con il pulsante destro del mouse sull'app.

3. Selezionare Apri visualizzazione dinamica applicazione dal menu per aprire la pagina Visualizzazione dinamica dell'applicazione per l'app nel browser predefinito.

   

Risolvere i problemi di Visualizzazione dinamica delle applicazioni

Se si tenta di aprire Application Live View per un'istanza del servizio o un'app che non ha abilitato Application Live View o esposto un endpoint pubblico, viene visualizzato un messaggio di errore.

Per abilitare Application Live View ed esporre l'endpoint pubblico, usare il portale di Azure o l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere la sezione Gestire la visualizzazione dinamica delle applicazioni nelle istanze del piano enterprise esistenti di questo articolo.

Passaggi successivi

• Azure Spring Apps