Visualizzare la topologia dell'applicazione

Questo documento descrive come visualizzare la mappa della topologia che Application Monitoring crea per le tue applicazioni, i tuoi servizi e i tuoi carichi di lavoro di App Hub. La mappa della topologia dell'applicazione fornisce una visualizzazione dinamica delle relazioni dell'applicazione per aiutarti a monitorare gli avvisi e il traffico e a risolvere i problemi.

Informazioni sulla mappa della topologia

La mappa della topologia dell'applicazione fornisce una visualizzazione dinamica e attuabile delle prestazioni dell'applicazione, semplificando il monitoraggio e la risoluzione dei problemi. La mappa della topologia rappresenta la tua applicazione utilizzando nodi e archi, come segue:

  • I nodi rappresentano i servizi e i workload della tua applicazione:

    Topologia di un'applicazione di esempio.

  • Gli edge rappresentano il traffico della tua applicazione tra i tuoi servizi e i tuoi carichi di lavoro:

    I bordi mostrano la latenza e il tasso di errore.

La mappa della topologia è completamente interattiva. Puoi aumentare e diminuire lo zoom e spostare i nodi per visualizzare la relazione tra i servizi e i carichi di lavoro. Per aprire un riquadro che fornisce ulteriori dettagli sullo stato di un nodo o un bordo specifico, fai clic sul nodo o sul bordo.

Prima di iniziare

Per generare la mappa della topologia dell'applicazione, i dati di traccia devono contenere etichette specifiche dell'applicazione. Queste etichette sono disponibili solo quando instrumenti la tua app con OpenTelemetry, invii i dati di traccia all'API Telemetry e registri la tua applicazione con App Hub.

Per iniziare:

  1. Configura il monitoraggio delle applicazioni come descritto in Configurare il monitoraggio delle applicazioni. La configurazione di Application Monitoring include la configurazione dell'ambito della traccia predefinito per elencare tutti i progetti che archiviano i dati di traccia.
  2. Se utilizzi una cartella abilitata alle app, il tuo progetto avrà una policy di limitazione dell'utilizzo dei servizi predefinita che ti impedisce di utilizzare l'API App Topology. Per risolvere il problema, un utente con il ruolo Amministratore criteri dell'organizzazione deve aggiungere apptopology.googleapis.com alla lista consentita del progetto di gestione delle cartelle abilitato per l'app. Tieni presente che potrebbe essere in vigore anche una policy a livello di organizzazione. Per saperne di più, consulta Limitazione dell'utilizzo delle risorse.

  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    Se hai aggiunto altri progetti all'ambito della traccia, ti consigliamo di attivare anche l'API Observability per questi progetti. La mappa della topologia dell'applicazione mostra solo i bordi delle tracce dei progetti nell'ambito delle tracce che si trovano nella stessa organizzazione del tuo progetto App Hub.

  4. Per ottenere le autorizzazioni necessarie per visualizzare la topologia dell'applicazione, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore topologia app (roles/apptopology.viewer) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare la topologia dell'applicazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

    Autorizzazioni obbligatorie

    Per visualizzare la topologia dell'applicazione sono necessarie le seguenti autorizzazioni:

    • Per generare la topologia: apptopology.applicationTopologies.generate

    Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

  5. Instrumenta la tua applicazione per utilizzare OpenTelemetry e per inviare i dati di traccia all'endpoint OTLP.

Visualizzare la mappa della topologia

  1. Nella console Google Cloud , vai alla pagina Monitoraggio delle applicazioni:

    Vai a Application Monitoring

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nel selettore di progetti della console Google Cloud , seleziona il progetto host di App Hub o il progetto di gestione.

  3. Seleziona un'applicazione dall'elenco.

  4. Fai clic sulla scheda Topologia. Viene visualizzata la mappa della topologia della tua applicazione.

La mappa della topologia è completamente interattiva. Puoi aumentare e diminuire lo zoom e spostare i nodi per visualizzare la relazione tra i servizi e i carichi di lavoro. Puoi anche visualizzare i dettagli di un nodo o di un arco:

  • Per visualizzare gli avvisi o gli attributi aperti per un servizio o un workload, seleziona il nodo.
  • Per visualizzare la latenza e il tasso di errore tra due nodi, seleziona il bordo.

Risoluzione dei problemi

Per informazioni che potrebbero aiutarti a capire perché la mappa della topologia dell'applicazione non mostra i dati, vedi Risolvere i problemi di monitoraggio delle applicazioni.