Para entender as relações entre aplicativos, serviços e cargas de trabalho, consulte o gráfico de topologia. Esse gráfico dinâmico ajuda você a entender o fluxo de tráfego e identificar incidentes. Para aplicativos registrados no App Hub, é possível conferir a topologia no nível do aplicativo. Também é possível conferir um gráfico de topologia no nível do limite de gerenciamento de aplicativos, que permite entender como um aplicativo interage com serviços e cargas de trabalho externos.
Para explorar mais seus aplicativos, use a App Topology no Cloud Hub. É possível criar consultas personalizadas e correlacionar dados de alerta e informações de trânsito com outras informações.
Entender o gráfico de topologia
O gráfico de topologia do aplicativo é totalmente interativo e oferece uma visão dinâmica e útil dos seus aplicativos, serviços e cargas de trabalho. Essa visualização ajuda você a monitorar e resolver problemas de desempenho.
A imagem a seguir mostra um gráfico de topologia para um limite de gerenciamento de aplicativos:
Esse gráfico tem os seguintes elementos:
Círculos azuis: cada círculo azul representa um aplicativo registrado no App Hub. O exemplo mostra vários aplicativos:
Para dois aplicativos, o círculo azul mostra um botão Fechar unfold_less. Para esses aplicativos, os serviços e as cargas de trabalho são mostrados.
Para um aplicativo, um único nó é mostrado, e o círculo azul exibe o botão Expandir . O valor no botão é o número de serviços e cargas de trabalho registrados.
Para receber informações sobre atributos e incidentes do aplicativo, selecione o círculo azul dele.
Nós: cada nó representa um serviço ou carga de trabalho registrada ou descoberta. O ícone do nó mostra uma das seguintes opções:
- Agente ()
- Servidor MCP (
) - Serviço (
) - Carga de trabalho (
)
Para receber informações sobre atributos e incidentes, selecione o nó.
Conexões: representam o tráfego entre dois nós. Para receber informações sobre métricas importantes, como a taxa de erros e o 95º percentil de latência, selecione a conexão:
Limitações
- As conexões mostram informações de latência e taxa de erros que o Application Monitoring deriva da hora mais recente de dados. Não é possível mudar o período usado pelo Application Monitoring.
- Os menus flutuantes mostram apenas incidentes das últimas 24 horas:
- Para aplicativos, serviços e cargas de trabalho registrados, o gráfico de topologia mostra apenas incidentes de políticas de alertas com rótulos de aplicativos. Para serviços e cargas de trabalho descobertos, o Application Monitoring usa rótulos de recursos para identificar incidentes.
- O gráfico de topologia mostra no máximo 1.000 nós ou conexões. Para cada região do App Hub compatível, o gráfico mostra no máximo 100 serviços e 100 cargas de trabalho descobertos.
- Não é possível registrar um serviço ou uma carga de trabalho com um aplicativo arrastando o nó correspondente para o círculo azul de um aplicativo. O círculo é um guia visual, não um contêiner.
Para os recursos a seguir, o gráfico de topologia só mostra conexões quando o serviço ou a carga de trabalho correspondente tem um status de registro do App Hub de
discovered:- Recursos do Firestore
- Recursos do Spanner
- Recursos do Cloud Storage
- Servidores MCP do Google Cloud
Um serviço ou uma carga de trabalho tem um status de registro
discoveredquando faz parte do limite de gerenciamento de aplicativos, mas não está registrado em nenhum aplicativo.
Antes de começar
Para gerar um gráfico de topologia de um aplicativo, os dados de rastreamento precisam conter rótulos específicos do aplicativo. Esses rótulos só estão disponíveis quando você instrumenta seu app com o OpenTelemetry, envia os dados de rastreamento para a API Telemetry e registra seu aplicativo no App Hub.
Para começar, faça o seguinte:
- Configure o Application Monitoring conforme descrito em Configurar o Application Monitoring. A configuração do Application Monitoring inclui a configuração do escopo de trace padrão para listar todos os projetos que armazenam seus dados de trace.
-
Ative as APIs Observability, App Topology, Cloud Trace e Telemetry.
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (
roles/serviceusage.serviceUsageAdmin), que contém a permissãoserviceusage.services.enable. Saiba como conceder papéis. -
Para receber as permissões necessárias para visualizar a topologia do aplicativo, peça ao administrador para conceder a você o papel do IAM de Leitor da App Topology (
roles/apptopology.viewer) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.Esse papel predefinido contém as permissões necessárias para visualizar a topologia do aplicativo. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para visualizar a topologia do aplicativo:
-
Para gerar a topologia:
apptopology.applicationTopologies.generate
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
-
Para gerar a topologia:
- Instrumente seu aplicativo para usar o OpenTelemetry e para enviar dados de rastreamento ao endpoint OTLP.
Ver a topologia do limite de gerenciamento de aplicativos
-
No console do Google Cloud , acesse a página Monitoramento de aplicativos:
Acessar Monitoramento de aplicativos
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
No seletor de projetos do console Google Cloud , selecione o projeto host ou de gerenciamento do App Hub.
Clique na guia Topologia. O gráfico de topologia do aplicativo aparece.
No gráfico de topologia interativo, é possível fazer o seguinte:
Mude a visualização aumentando ou diminuindo o zoom, reposicionando nós ou recolhendo ou expandindo um círculo azul.
Para receber informações sobre atributos e incidentes associados, selecione um aplicativo ou um nó.
Para serviços e cargas de trabalho descobertos, o painel vai mostrar um nome do Inventário de recursos do Cloud. O Google Cloud Observability usa o nome do recurso para determinar quais dados um painel mostra.
Para receber informações sobre o tráfego entre nós, selecione a conexão. Um menu suspenso mostra os nomes dos nós e as principais métricas, como a taxa de erros e o 95º percentil de latência.
Ver o gráfico de topologia de um aplicativo
-
No console do Google Cloud , acesse a página Monitoramento de aplicativos:
Acessar Monitoramento de aplicativos
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
No seletor de projetos do console Google Cloud , selecione o projeto host ou de gerenciamento do App Hub.
Selecione um aplicativo na lista.
Clique na guia Topologia. O gráfico de topologia do aplicativo aparece.
No gráfico de topologia interativo, é possível fazer o seguinte:
Mude a visualização aumentando ou diminuindo o zoom ou reposicionando os nós.
Selecione um nó para receber informações sobre atributos e incidentes.
Para receber informações sobre o tráfego entre nós, selecione a conexão. Um menu suspenso mostra os nomes dos nós e as principais métricas, como a taxa de erros e o 95º percentil de latência.
Resolver problemas
Para informações que podem ajudar você a entender por que o gráfico de topologia do aplicativo não mostra dados, consulte Solucionar problemas do Application Monitoring.
A seguir
- Confira os gráficos de topologia no Cloud Hub.