Este documento descreve como ver o mapa de topologia que a monitorização de aplicações cria para as suas aplicações, serviços e cargas de trabalho do App Hub. O mapa de topologia da aplicação oferece uma vista dinâmica das relações da sua aplicação para ajudar a monitorizar alertas e tráfego, bem como a resolver problemas.
Compreenda o mapa de topologia
O mapa de topologia da aplicação oferece uma vista dinâmica e acionável do desempenho da sua aplicação, simplificando a monitorização e a resolução de problemas. O mapa de topologia representa a sua aplicação através de nós e limites, da seguinte forma:
Os nós representam os serviços e as cargas de trabalho da sua aplicação:
Os limites representam o tráfego da sua aplicação entre os seus serviços e cargas de trabalho:
O mapa de topologia é totalmente interativo. Pode aumentar e diminuir o zoom, bem como mover os nós para ajudar a visualizar a relação entre os seus serviços e cargas de trabalho. Para abrir um painel que faculta detalhes adicionais sobre o estado de um nó ou um limite específico, clique no nó ou no limite.
Antes de começar
Para gerar o mapa de topologia da aplicação, os dados de rastreio têm de conter etiquetas específicas da aplicação. Estas etiquetas só estão disponíveis quando instrumenta a sua app com o OpenTelemetry, envia os dados de rastreio para a API Telemetry e regista a sua aplicação no App Hub.
Para começar, faça o seguinte:
- Configure a monitorização de aplicações conforme descrito em Configure a monitorização de aplicações. A configuração da monitorização de aplicações inclui a configuração do âmbito de rastreio predefinido para listar todos os projetos que armazenam os seus dados de rastreio.
- Se estiver a usar uma
pasta ativada para apps,
o seu projeto tem uma política de restrição de utilização de serviços predefinida
que impede a utilização da API App Topology. Para resolver este problema,
alguém com a função de
administrador da política da organização
tem de adicionar
apptopology.googleapis.comà lista de autorizações da política para o projeto de gestão de pastas ativado para apps. Tenha em atenção que também pode existir uma política em vigor ao nível da organização. Para mais informações, consulte o artigo Restringir a utilização de recursos. -
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 theserviceusage.services.enablepermission. Learn how to grant roles. -
Para receber as autorizações de que precisa para ver a topologia da aplicação, peça ao seu administrador para lhe conceder a função Visualizador de topologia de apps (
roles/apptopology.viewer) do IAM no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.Esta função predefinida contém as autorizações necessárias para ver a topologia da aplicação. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para ver a topologia da aplicação:
-
Para gerar a topologia:
apptopology.applicationTopologies.generate
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
-
Para gerar a topologia:
- Instrumente a sua aplicação para usar o OpenTelemetry e para enviar os seus dados de rastreio para o ponto final OTLP.
Veja o mapa de topologia
-
Na Google Cloud consola, aceda à página Monitorização de aplicações:
Aceda a Monitorização de aplicações
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
No seletor de projetos da Google Cloud consola, selecione o projeto de anfitrião do App Hub ou o projeto de gestão.
Selecione uma aplicação na lista.
Clique no separador Topologia. É apresentado o mapa de topologia da sua aplicação.
O mapa de topologia é totalmente interativo. Pode aumentar e diminuir o zoom, bem como mover os nós para ajudar a visualizar a relação entre os seus serviços e cargas de trabalho. Também pode ver detalhes sobre um nó ou uma aresta:
- Para ver alertas ou atributos abertos de um serviço ou uma carga de trabalho, selecione o nó.
- Para ver a latência e a taxa de erro entre dois nós, selecione a aresta.
Resolver problemas
Para ver informações que podem ajudar a compreender por que motivo o mapa de topologia da aplicação não apresenta dados, consulte o artigo Resolva problemas de monitorização de aplicações.