Share via

Hantera och övervaka appen med Spring Boot-ställdon

  • Artikel

Kommentar

Azure Spring Apps är det nya namnet på Azure Spring Cloud-tjänsten. Även om tjänsten har ett nytt namn ser du det gamla namnet på vissa platser ett tag medan vi arbetar med att uppdatera tillgångar som skärmbilder, videor och diagram.

Den här artikeln gäller för: ✔️ Java ❌ C#

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Spring Boot-aktuator ger dina appar produktionsklara funktioner. Du kan enkelt övervaka din app, samla in mått och förstå status- eller databasaktiviteten med det här verktyget. Du får tillgång till verktyg i professionell kvalitet utan att behöva bygga dem från grunden.

Ställdonet exponerar viktiga driftdata om ditt program som körs, till exempel hälsostatus, mått, information med mera. Ställdonet använder HTTP-slutpunkter eller Java Management Extensions (JMX), vilket gör det enkelt att interagera med. När du har integrerat den innehåller den flera standardslutpunkter, och precis som andra Spring-moduler är det enkelt att konfigurera och utöka.

Azure Spring Apps använder ställdonet för att berika mått via JMX. Det kan också fungera med Application Live View i Enterprise-planen för att hjälpa dig att få och interagera med data från appar.

Diagram som visar dataflödet med Spring Boot-ställdonet.

Konfigurera Spring Boot-ställdon

I följande avsnitt beskrivs hur du konfigurerar ställdonet.

Lägga till ett ställdonsberoende

Lägg till följande beroende för att lägga till ställdonet i ett Maven-baserat projekt:

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

Den här konfigurationen fungerar med valfri Spring Boot-version eftersom versionerna beskrivs i Spring Boot Bill of Materials (BOM).

Konfigurera aktuatorslutpunkt

Som standard exponerar health ett Spring Boot-program endast slutpunkten. Om du vill se konfigurationen och den konfigurerbara miljön använder du följande steg för att även aktivera slutpunkterna env och configprops :

  1. Gå till appöversiktsfönstret, välj Konfiguration på inställningsmenyn och gå sedan till konfigurationssidan miljövariabler.

  2. Lägg till följande egenskaper som i formuläret "key:value". Den här miljön öppnar följande Spring Actuator-slutpunkter: health, envoch configprops.

    management.endpoints.web.exposure.include: health,env,configprops

  3. Välj Spara. Programmet startas om automatiskt och läser in de nya miljövariablerna.

Nu kan du gå tillbaka till appöversiktsfönstret och vänta tills etableringsstatusen har ändrats till Lyckades.

Information om hur du visar alla inbyggda slutpunkter och relaterade konfigurationer finns i avsnittet Exponera slutpunkter i Spring Boot-produktionsklara funktioner.

Slutpunkt för säker aktuator

När du öppnar appen för allmänheten exponeras även dessa aktuatorslutpunkter för allmänheten. Vi rekommenderar att du döljer alla slutpunkter genom att ange management.endpoints.web.exposure.exclude=*, eftersom egenskapen exclude har företräde framför include egenskapen. Den här åtgärden blockerar Programmets livevy i Enterprise-planen och andra appar eller verktyg som förlitar sig på http-slutpunkten för aktuatorn.

I Enterprise-planen finns det två sätt att skydda åtkomsten:

  • Du kan inaktivera den offentliga slutpunkten för appar och konfigurera en routningsregel i VMware Spring Cloud Gateway för att inaktivera aktuatoråtkomst från allmänheten. Mer information finns i Konfigurera VMware Spring Cloud Gateway.

  • Du kan konfigurera ställdonet så att det lyssnar på en annan HTTP-port än huvudprogrammet. I ett fristående program är ställdonets HTTP-port som standard samma som http-huvudporten. Ange egenskapen för att programmet ska lyssna på en annan port management.server.port . Programmets livevy kan inte identifiera den här portändringen automatiskt, så du måste också konfigurera egenskapen för en Azure Spring Apps-distribution. Ställdonet är sedan inte offentligt tillgängligt, men programmets livevy kan läsas från aktuatorslutpunkten via en annan port. Mer information finns i Använda programmets livevy med Azure Spring Apps Enterprise-planen.

Nästa steg