Per comprendere le relazioni tra applicazioni, servizi e carichi di lavoro, visualizza il grafico della topologia. Questo grafico dinamico ti aiuta a comprendere il flusso di traffico e a identificare gli incidenti. Per le applicazioni registrate con App Hub, puoi visualizzare la topologia a livello di applicazione. Puoi anche visualizzare un grafico della topologia a livello di confine di gestione delle applicazioni, che ti consente di capire in che modo un'applicazione interagisce con servizi e workload esterni.
Per esplorare ulteriormente le tue applicazioni, puoi utilizzare App Topology in Cloud Hub. Puoi creare query personalizzate e correlare i dati di avvisi e dati sul traffico con altri dati.
Informazioni sul grafico della topologia
Il grafico della topologia delle applicazioni è completamente interattivo e fornisce una visualizzazione dinamica e utile delle applicazioni, dei servizi e dei workload. Questa visualizzazione ti aiuta a monitorare e risolvere i problemi di prestazioni.
La seguente immagine mostra un grafico della topologia per un limite di gestione delle applicazioni:

Questo grafico include i seguenti elementi:
Cerchi blu: ogni cerchio blu rappresenta un'applicazione registrata in App Hub. L'esempio mostra diverse applicazioni:
Per due applicazioni, il cerchio blu mostra un pulsante unfold_less Comprimi. Per queste applicazioni, vengono visualizzati i servizi e i workload.
Per un'applicazione, viene mostrato un singolo nodo e il cerchio blu visualizza il pulsante Espandi. Il valore nel pulsante è il numero di servizi e workload registrati.
Per visualizzare informazioni su attributi e incidenti per l'applicazione, seleziona il cerchio blu.
Nodi: ogni nodo rappresenta un servizio o un workload registrato o rilevato. L'icona del nodo mostra uno dei seguenti elementi:
- Agente ()
- Server MCP (
) - Servizio (
) - Workload (
)
Per ottenere informazioni su attributi e incidenti, seleziona il nodo.
Connessioni: rappresentano il traffico tra due nodi. Per ottenere informazioni sulle metriche chiave, come il tasso di errore e il percentile di latenza 95, seleziona la connessione:
Limitazioni
- Le connessioni mostrano informazioni su latenza e tasso di errore che Application Monitoring ricava dall'ultima ora di dati. Non puoi modificare l'intervallo di tempo utilizzato da Application Monitoring.
- I riquadri visualizzano solo gli incidenti delle ultime 24 ore:
- Per applicazioni, servizi e workload registrati, il grafico della topologia mostra solo gli incidenti delle norme di avviso con etichette dell'applicazione. Per i servizi e i workload rilevati, Application Monitoring utilizza le etichette delle risorse per identificare gli incidenti.
- Il grafico della topologia mostra al massimo 1000 nodi o connessioni. Per ogni regione App Hub supportata, il grafico mostra al massimo 100 servizi rilevati e 100 workload rilevati.
- Non puoi registrare un servizio o un workload con un'applicazione trascinando il nodo corrispondente nel cerchio blu di un'applicazione. Il cerchio è una guida visiva, non un contenitore.
Per le seguenti risorse, il grafico della topologia mostra le connessioni solo quando il servizio o il workload corrispondente ha uno stato di registrazione di App Hub pari a
discovered:- Risorse Firestore
- Risorse Spanner
- Risorse di Cloud Storage
- Server MCP di Google Cloud
Un servizio o un workload ha lo stato di registrazione
discoveredquando fa parte del limite di gestione delle applicazioni, ma non è registrato in nessuna applicazione.
Prima di iniziare
Per generare un grafico della topologia per un'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:
- 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.
-
Abilita le API Observability, App Topology, Cloud Trace e Telemetry.
Se hai aggiunto altri progetti all'ambito della traccia, ti consigliamo di abilitare l'API Observability anche per questi progetti. Il grafico della topologia dell'applicazione mostra solo le connessioni di traccia dai progetti di ambito di traccia che si trovano nella stessa organizzazione del progetto App Hub.Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (
roles/serviceusage.serviceUsageAdmin), che include l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli. -
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) nel 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.
-
Per generare la topologia:
- Instrumenta la tua applicazione per utilizzare OpenTelemetry e per inviare i dati di traccia all'endpoint OTLP.
Visualizzare la topologia per il limite di gestione delle applicazioni
-
Nella console Google Cloud , vai alla pagina Monitoraggio delle applicazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nel selettore di progetti della console Google Cloud , seleziona il progetto host di App Hub o il progetto di gestione.
Fai clic sulla scheda Topologia. Viene visualizzato il grafico della topologia per la tua applicazione.
Dal grafico della topologia interattivo puoi:
Modifica la visualizzazione aumentando o diminuendo lo zoom, riposizionando i nodi o comprimendo o espandendo un cerchio blu.
Per ottenere informazioni sugli attributi e sugli incidenti associati, seleziona un'applicazione o un nodo.
Per i servizi e i carichi di lavoro rilevati, il riquadro a comparsa potrebbe mostrare un nome Cloud Asset Inventory. Google Cloud Observability utilizza il nome dell'asset per determinare quali dati vengono visualizzati in una dashboard.
Per visualizzare informazioni sul traffico tra i nodi, seleziona la connessione. Un menu a comparsa mostra i nomi dei nodi e le metriche chiave, come la percentuale di errori e il 95° percentile di latenza.
Visualizzare il grafico della topologia per un'applicazione
-
Nella console Google Cloud , vai alla pagina Monitoraggio delle applicazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nel selettore di progetti della console Google Cloud , seleziona il progetto host di App Hub o il progetto di gestione.
Seleziona un'applicazione dall'elenco.
Fai clic sulla scheda Topologia. Viene visualizzato il grafico della topologia per la tua applicazione.
Dal grafico della topologia interattivo puoi:
Modifica la visualizzazione aumentando o diminuendo lo zoom o riposizionando i nodi.
Ricevi informazioni su attributi e incidenti selezionando un nodo.
Per visualizzare informazioni sul traffico tra i nodi, seleziona la connessione. Un menu a comparsa mostra i nomi dei nodi e le metriche chiave, come il tasso di errore e il 95° percentile di latenza.
Risoluzione dei problemi
Per informazioni che potrebbero aiutarti a capire perché il grafico della topologia dell'applicazione non mostra i dati, consulta Risolvere i problemi di monitoraggio delle applicazioni.
Passaggi successivi
- Esplora i grafici della topologia in Cloud Hub.