O gráfico de topologia no Monitoramento de Aplicativos permite visualizar as relações entre seus aplicativos, serviços e cargas de trabalho. Use esse gráfico dinâmico para inspecionar o fluxo de tráfego, a latência, as taxas de erro e os alertas abertos. Para aplicativos registrados no App Hub, é possível visualizar a topologia de um único aplicativo ou no nível de limite de gerenciamento de aplicativos para ver como seus aplicativos interagem com serviços e cargas de trabalho externos.
Para executar consultas personalizadas e correlacionar dados de alerta e tráfego com outras telemetrias, use a App Topology no Cloud Hub.
Entender o gráfico de topologia
O gráfico de topologia do aplicativo é totalmente interativo e oferece uma visualização dinâmica e útil dos seus aplicativos, serviços e cargas de trabalho. Essa visualização ajuda 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 unfold_less Fechar. 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 alertas do aplicativo, selecione o círculo azul dele.
Nós: cada nó representa um serviço ou uma 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 alertas, selecione o nó.
Conexões: representam o tráfego entre dois nós. Para receber informações sobre as principais métricas, 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 alterar o período usado pelo Application Monitoring.
- O gráfico de topologia e os painéis mostram apenas alertas das últimas 24 horas.
- Para aplicativos, serviços e cargas de trabalho registrados, o gráfico de topologia mostra alertas de políticas de alertas com rótulos de recursos, não 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 alertas.
- O gráfico de topologia exibe 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 descobertos e 100 cargas de trabalho descobertas.
- Não é possível registrar um serviço ou uma carga de trabalho em 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 carga de trabalho tem um status de registro de
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 para um aplicativo, os dados de trace 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 trace para a API Telemetry e registra o aplicativo no App Hub.
Para começar, faça o seguinte:
- Configure o monitoramento de aplicativos conforme descrito em Configurar o monitoramento de aplicativos. A configuração do Monitoramento de Aplicativos inclui definir o 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, se ainda não estiverem ativadas.
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da permissão
serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis. -
Para receber as permissões necessárias para visualizar uma topologia de aplicativo, peça ao administrador para conceder a você o papel do IAM de App Topology viewer (
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 uma topologia de 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 uma topologia de aplicativo:
-
Receba dados de recursos descobertos:
apptopology.discoveredResourcesTopologies.generate -
Receber dados de recursos:
apptopology.sreDomainTopologies.generate
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
-
Receba dados de recursos descobertos:
- Instrumente seu aplicativo para usar o OpenTelemetry e envie seus dados de trace para o endpoint do OTLP.
Ver a topologia do limite de gerenciamento de aplicativos
-
No console do Google Cloud , acesse a página Monitoramento de aplicativos:
Acesse 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 do Google Cloud , selecione seu projeto host ou de gerenciamento .
Clique na guia Topologia. O gráfico de topologia do limite de gerenciamento de aplicativos é exibido.
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 alertas associados, selecione um aplicativo ou um nó.
Para serviços e cargas de trabalho descobertos, o painel pode exibir um nome do Inventário de recursos do Cloud. O Google Cloud Observability usa o nome do recurso para determinar quais dados um painel exibe.
Selecione a conexão para receber informações sobre o tráfego entre os nós. Um menu suspenso exibe 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:
Acesse 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 do Google Cloud , selecione seu projeto host ou de gerenciamento .
Selecione um aplicativo na lista.
Clique na guia Topologia. O gráfico de topologia do aplicativo é exibido.
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 ver informações sobre atributos e alertas.
Selecione a conexão para receber informações sobre o tráfego entre os nós. Um menu suspenso exibe 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 a entender por que o gráfico de topologia do aplicativo não exibe dados, consulte Resolver problemas do Application Monitoring.
A seguir
- Analisar gráficos de topologia no Cloud Hub.