Använda Programmets livevy med Azure Spring Apps Enterprise-planen

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för: ❎ Basic/Standard ✅ Enterprise

Den här artikeln visar hur du använder Application Live View för VMware Tanzu med Azure Spring Apps Enterprise-planen.

Application Live View för VMware Tanzu är ett enkelt verktyg för insikter och felsökning som hjälper apputvecklare och appoperatörer att titta i appar som körs.

Programmets livevy stöder endast Spring Boot-program.

Förutsättningar

• En Azure-prenumeration. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

• Förstå och uppfylla avsnittet Krav i Enterprise-plan på Azure Marketplace.

• Azure CLI med Azure Spring Apps-tillägget. Använd följande kommando för att ta bort tidigare versioner och installera det senaste tillägget. Om du tidigare har installerat spring-cloud tillägget avinstallerar du det för att undvika konfigurations- och versionsmatchningar.

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

Aktivera programmets livevy

Du kan aktivera Application Live View när du etablerar en Azure Spring Apps Enterprise-planinstans. Om du redan har en etablerad Azure Spring Apps Enterprise-resurs kan du läsa avsnittet Hantera programmets livevy i befintliga Enterprise-planinstanser i den här artikeln.

Du kan aktivera Programmets livevy med hjälp av Azure Portal eller Azure CLI.

Azure-portalen

Använd följande steg för att aktivera programmets livevy med hjälp av Azure Portal:

1. Navigera till Azure-portalen.

2. På fliken Grundläggande väljer du Företagsnivå i prissättning, anger andra indatafält och väljer sedan Nästa.

3. På fliken VMware Tanzu-inställningar väljer du Aktivera appens livevy.

   

4. Ange andra inställningar och välj sedan Granska och Skapa.

5. Kontrollera att Aktivera programmets livevy och Aktivera Dev Tools-portalen är inställda på Ja på fliken Granska och skapa och välj sedan Skapa för att skapa enterprise-planinstansen.

Azure CLI

Använd följande steg för att etablera en Azure Spring Apps-tjänstinstans med hjälp av Azure CLI.

1. Använd följande kommando för att logga in på Azure CLI och ange din aktiva prenumeration:

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

2. Använd följande kommando för att acceptera juridiska villkor och sekretesspolicyer för Enterprise-planen. Det här steget är bara nödvändigt om din prenumeration aldrig har använts för att skapa en Enterprise-planinstans av 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. Välj en plats. Den här platsen måste vara en plats som stöder Azure Spring Apps Enterprise-planen. Mer information finns i Vanliga frågor och svar om Azure Spring Apps.

4. Använd följande kommando för att skapa en resursgrupp:

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

   Mer information om resursgrupper finns i Vad är Azure Resource Manager?

5. Förbered ett namn för din Azure Spring Apps-tjänstinstans. Namnet måste vara mellan 4 och 32 tecken långt och får endast innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.

6. Använd följande kommando för att skapa en Azure Spring Apps-tjänstinstans:

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

Övervaka programmets livevy

Azure Spring Apps kör appens livevy i anslutningsläge.

Komponent	beskrivning
Programmets livevyserver	Den centrala serverkomponenten som innehåller en lista över registrerade appar. Application Live View Server ansvarar för att proxyservern skickar begäran om att hämta aktuatorinformationen som är relaterad till appen.
Anslutningsprogram för livevisning av program	Komponenten som ansvarar för att identifiera appen som körs och registrera instanserna på Programmets livevyserver för att den ska kunna observeras. Anslutningsappen för livevisning av program ansvarar också för proxykörning av aktuatorfrågor till appen.

När du har etablerat Azure Spring Apps Enterprise-planinstansen kan du hämta dess körningstillstånd och resursförbrukning eller hantera Programmets livevy.

Du kan övervaka programmets livevy med hjälp av Azure Portal eller Azure CLI.

Azure-portalen

Du kan visa tillståndet för Programmets livevy i Azure Portal på fliken Översikt på sidan Utvecklingsverktyg.

Azure CLI

Använd följande kommando för att visa programmets livevy:

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

Konfigurera Dev Tools för att få åtkomst till programmets livevy

För att få åtkomst till Programmets livevy måste du konfigurera Tanzu Dev Tools. Mer information finns i Konfigurera Tanzu Dev Tools i Azure Spring Apps Enterprise-planen.

Använda Programmets livevy för att övervaka dina appar

Med Programmets livevy kan du visa livemått för Spring Boot-program och Spring Native-program. Programmets livevy baseras på begreppet Spring Boot-aktuatorer.

Använd följande steg för att distribuera en app och övervaka den i programmets livevy:

1. Lägg till följande beroende i programmets pom.xml-fil .

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

2. Lägg till följande körningsmål i maven-plugin-programmet i pom.xml-filen för att exponera bygginformation:

   <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. Aktivera aktuatorslutpunkten genom att lägga till följande konfiguration i application.properties:

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

4. Använd följande kommando för att skapa paketet lokalt:

   mvn clean package -DskipTests
   

5. Använd följande kommando för att distribuera binärfilen:

   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. När appen har distribuerats kan du övervaka den med hjälp av instrumentpanelen För livevisning för program på Dev Tools-portalen. Mer information finns i Övervaka appar efter programmets livevy.

   Om du redan har aktiverat Dev Tools-portalen och exponerat en offentlig slutpunkt använder du följande kommando för att hämta URL:en för Dev Tools-portalens instrumentpanel. Lägg till suffixet /app-live-view för att skapa slutpunkten för att få åtkomst till programmets livevy.

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

   Du kan också komma åt programmets livevy med hjälp av Visual Studio Code (VS Code). Mer information finns i avsnittet Använda programmets livevy i VS Code i den här artikeln.

Hantera programmets livevy i befintliga Enterprise-planinstanser

Du kan aktivera Application Live View i en befintlig Azure Spring Apps Enterprise-planinstans med hjälp av Azure Portal eller Azure CLI.

Om du har aktiverat Dev Tools-portalen och exponerat en offentlig slutpunkt använder du Ctrl+F5 för att inaktivera webbläsarens cacheminne när du har aktiverat Programmets livevy.

Azure-portalen

Använd följande steg för att hantera programmets livevy med hjälp av Azure Portal:

1. Gå till din Azure Spring Apps-tjänstinstans och välj sedan Utvecklarverktyg.

2. Välj Hantera verktyg.

   

3. Markera kryssrutan Aktivera app livevy och välj sedan Spara.

   

4. Du kan sedan visa tillståndet för Programmets livevy i utvecklarverktygen.

Azure CLI

Använd följande kommando för att aktivera Programmets livevy med hjälp av Azure CLI:

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

För att få åtkomst till instrumentpanelen för Program livevisning måste du aktivera Dev Tools-portalen och tilldela en offentlig slutpunkt. Använd följande kommando för att aktivera Dev Tools-portalen och tilldela en offentlig slutpunkt:

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

Konfigurera anpassad Spring Boot-aktuator

Programmets livevy kan automatiskt ansluta och övervaka Spring Boot-appar med standardinställningar för aktuatorer. Standard-HTTP-porten för aktuatorslutpunkterna är samma som HTTP-porten för programmet och alla aktuatorslutpunkter är tillgängliga som standardkontextsökvägen för programmet, som har suffixet /actuator .

Om porten (management.server.port=) eller kontextsökvägen (management.endpoints.web.base-path=/) har anpassats för en app slutar Program live-vyn att ansluta och övervaka appen och rapporterar 404 för appen. Använd följande steg för att konfigurera appdistributionen för att anpassa aktuatorslutpunkterna för att aktivera Program live-vyn för att fortsätta övervaka sådana appar.

Azure-portalen

Använd följande steg för att konfigurera distributionen med hjälp av Azure Portal:

1. Gå till din Azure Spring Apps-tjänstinstans och gå sedan till sidan Appar och välj ett program.

2. Välj Konfiguration i navigeringsfönstret.

3. På fliken Allmänna inställningar uppdaterar du spring boot-aktuatorporten och spring boot-ställdonets sökvägsvärden och väljer sedan Spara.

   

Azure CLI

Använd följande kommando för att distribuera ditt program med anpassade aktuatorinställningar i 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>

Kommentar

Du kan ange den här konfigurationen för en app eller en distribution. När du konfigurerar en app börjar den faktiskt gälla för den aktuella aktiva distributionen, men påverkar inte automatiskt nya distributioner.

Använda programmets livevy i VS Code

Du kan komma åt Application Live View direkt i VS Code för att övervaka dina appar i Azure Spring Apps Enterprise-planen.

Förutsättningar

• Visual Studio Code
• Azure Spring Apps-tillägg för Visual Studio Code

Visa programmets livevisningsinstrumentpanel

Använd följande steg för att visa instrumentpanelen för Program livevisning för en tjänstinstans:

1. Öppna Azure Spring Apps-tillägget i Visual Studio Code och logga sedan in på ditt Azure-konto.

2. Expandera den tjänstinstans som du vill övervaka och högerklicka för att välja tjänstinstansen.

3. Välj Öppna programmets livevy på menyn för att öppna instrumentpanelen För livevisning av program i standardwebbläsaren.

   

Visa appens livevysida för en app

Använd följande steg för att visa appens livevisningssida för en app:

1. Öppna Azure Spring Apps-tillägget i Visual Studio Code och logga sedan in på ditt Azure-konto.

2. Expandera tjänstinstansen och den app som du vill övervaka. Högerklicka på appen.

3. Välj Öppna programmets livevy på menyn för att öppna appens livevysida i standardwebbläsaren.

   

Felsöka problem med livevisning av program

Om du försöker öppna Programmets livevy för en tjänstinstans eller en app som inte har aktiverat Programmets livevy eller exponerat en offentlig slutpunkt visas ett felmeddelande.

Använd antingen Azure Portal eller Azure CLI för att aktivera Live View för program och exponera offentlig slutpunkt. Mer information finns i avsnittet Hantera programmets livevy i befintliga Enterprise-planinstanser i den här artikeln.

Nästa steg

• Azure Spring Apps