Visualizzare la topologia dell'applicazione

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento descrive come visualizzare la mappa della topologia che Application Monitoring crea per le applicazioni, i servizi e i 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 utilizzabile del rendimento dell'applicazione, semplificando il monitoraggio e la risoluzione dei problemi. La mappa della topologia rappresenta l'applicazione utilizzando nodi e bordi, come segue:

• I nodi rappresentano i servizi e i carichi di lavoro dell'applicazione:

  

• I bordi rappresentano il traffico dell'applicazione tra i servizi e i carichi di lavoro:

  

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

Nota: se utilizzi i Controlli di servizio VPC e limiti l' API App Hub, l'API Observability, l'API Telemetry, l'API Cloud Logging o l'API App Topology, Google Cloud Observability non può creare una mappa della topologia.

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 l'app con OpenTelemetry, invii i dati di traccia all'API Telemetry e registri l'applicazione con App Hub.

Per iniziare:

1. Configura Application Monitoring come descritto in Configurare Application Monitoring. 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 app, il tuo progetto avrà una policy di limitazione di Service Usage predefinita che ti impedisce di utilizzare l'API App Topology. Per risolvere il problema, un utente con il ruolo Amministratore delle policy dell'organizzazione deve aggiungere apptopology.googleapis.com all'elenco consentiti delle policy per il progetto di gestione della cartella app. Tieni presente che potrebbe essere in vigore anche una policy a livello di organizzazione. Per saperne di più, consulta Limitare l'utilizzo delle risorse.

3. Abilita le API Observability, App Topology, Cloud Trace e Telemetry.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore di Service Usage (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

   Abilitare le API

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

4. Per ottenere le autorizzazioni necessarie per visualizzare la topologia di App Topology, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore della topologia dell'app (roles/apptopology.viewer) nel tuo 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. Strumenta l'applicazione per utilizzare OpenTelemetry e inviare i dati di traccia all'endpoint OTLP.

Visualizzare la mappa della topologia

1. Nella Google Cloud console, vai alla pagina Application Monitoring:

   Vai a Application Monitoring

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

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

3. Seleziona un'applicazione dall'elenco.

4. Fai clic sulla scheda Topologia. Viene visualizzata la mappa della topologia dell'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 bordo:

• Per visualizzare gli avvisi o gli attributi aperti per un servizio o un carico di lavoro, seleziona il nodo.
• Per visualizzare la latenza e la percentuale di errori 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, consulta Risolvere i problemi di Application Monitoring.