Condividi tramite

Gestire e monitorare l'app con spring boot

  • Articolo

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a:✅ Java ❎ C#

Questo articolo si applica a:✅ Basic/Standard ✅ Enterprise

Spring BootIntune offre funzionalità pronte per la produzione per le app. È possibile monitorare facilmente l'app, raccogliere le metriche e comprendere lo stato o l'attività del database con questo strumento. Si ottiene l'accesso a strumenti di livello professionale senza bisogno di crearli da zero.

L'attuatore espone dati operativi vitali sull'applicazione in esecuzione, ad esempio lo stato di integrità, le metriche, le informazioni e altro ancora. L'attuatore usa endpoint HTTP o JMX (Java Management Extensions), semplificando l'interazione. Dopo l'integrazione, fornisce diversi endpoint predefiniti e, come altri moduli Spring, è facilmente configurabile ed estendibile.

Azure Spring Apps usa l'attuatore per arricchire le metriche tramite JMX. Può anche usare Application Live View nel piano Enterprise per ottenere e interagire con i dati dalle app.

Diagramma che mostra il flusso di dati usando l'azionamento Spring Boot.

Configurare l'azionamento spring boot

Le sezioni seguenti descrivono come configurare l'attuatore.

Aggiungere la dipendenza dell'attuatore

Per aggiungere l'attuatore a un progetto basato su Maven, aggiungere la dipendenza seguente:

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

Questa configurazione funziona con qualsiasi versione di Spring Boot perché le versioni sono descritte nella distinta base di Spring Boot.

Configurare l'endpoint dell'attuatore

Per impostazione predefinita, un'applicazione Spring Boot espone solo l'endpoint health . Per osservare la configurazione e l'ambiente configurabile, seguire questa procedura per abilitare anche gli env endpoint e configprops :

  1. Passare al riquadro Panoramica dell'app, selezionare Configurazione nel menu delle impostazioni e quindi passare alla pagina Configurazione variabili di ambiente.

  2. Aggiungere le proprietà seguenti come nel modulo "key:value". Questo ambiente apre gli endpoint seguenti dell'attuatore Spring: health, enve configprops.

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

  3. Seleziona Salva. L'applicazione viene riavviata automaticamente e carica le nuove variabili di ambiente.

È ora possibile tornare al riquadro Panoramica dell'app e attendere che lo stato del provisioning cambi in Operazione completata.

Per visualizzare tutti gli endpoint predefiniti e le configurazioni correlate, vedere la sezione Esposizione degli endpoint delle funzionalità pronte per la produzione Spring Boot.

Endpoint dell'attuatore sicuro

Quando si apre l'app al pubblico, questi endpoint dell'attuatore vengono esposti anche al pubblico. È consigliabile nascondere tutti gli endpoint impostando management.endpoints.web.exposure.exclude=*, perché la exclude proprietà ha la precedenza sulla include proprietà . Questa azione blocca la visualizzazione dinamica dell'applicazione nel piano Enterprise e in altre app o strumenti che si basano sull'endpoint HTTP attuatore.

Nel piano Enterprise sono disponibili due modi per proteggere l'accesso:

  • È possibile disabilitare l'endpoint pubblico delle app e configurare una regola di routing in VMware Spring Cloud Gateway per disabilitare l'accesso degli attuatori dal pubblico. Per altre informazioni, vedere Configurare VMware Spring Cloud Gateway.

  • È possibile configurare l'attuatore per l'ascolto su una porta HTTP diversa dall'applicazione principale. In un'applicazione autonoma, per impostazione predefinita la porta HTTP dell'attuatore corrisponde alla porta HTTP principale. Affinché l'applicazione sia in ascolto su una porta diversa, impostare la management.server.port proprietà . Application Live View non è in grado di rilevare automaticamente questa modifica della porta, quindi è anche necessario configurare la proprietà in una distribuzione di Azure Spring Apps. L'attuatore non è quindi accessibile pubblicamente, ma Application Live View può leggere dall'endpoint dell'attuatore tramite un'altra porta. Per altre informazioni, vedere Usare Visualizzazione in diretta dell’applicazione con il piano Azure Spring Apps Enterprise.

Passaggi successivi