Ver a topologia do aplicativo

Neste documento, descrevemos como visualizar o mapa de topologia que o Application Monitoring cria para seus aplicativos, serviços e cargas de trabalho do App Hub. O mapa de topologia do aplicativo oferece uma visão dinâmica das relações do aplicativo para ajudar você a monitorar alertas e tráfego e resolver problemas.

Entender o mapa de topologia

O mapa de topologia do aplicativo oferece uma visão dinâmica e prática do desempenho do seu aplicativo, simplificando o monitoramento e a solução de problemas. O mapa de topologia representa seu aplicativo usando nós e arestas, da seguinte forma:

  • Os nós representam os serviços e as cargas de trabalho do seu aplicativo:

    Topologia de um aplicativo de exemplo.

  • As arestas representam o tráfego do aplicativo entre os serviços e as cargas de trabalho:

    As arestas mostram a latência e a taxa de erros.

O mapa de topologia é totalmente interativo. É possível aumentar e diminuir o zoom e mover os nós para ajudar a visualizar a relação entre os serviços e as cargas de trabalho. Para abrir um painel com mais detalhes sobre o status de um nó ou uma aresta específica, clique no nó ou na aresta.

Antes de começar

Para gerar o mapa de topologia do 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:

  1. 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.
  2. Se você estiver usando uma pasta habilitada para gerenciar apps, seu projeto terá uma política padrão de restrição de uso do serviço que impede o uso da API App Topology. Para resolver isso, alguém com o papel de Administrador de políticas da organização precisa adicionar apptopology.googleapis.com à lista de permissões da política para o projeto de gerenciamento de pastas ativado para apps. Também pode haver uma política em vigor no nível da organização. Para mais informações, consulte Como restringir o uso de recursos.

  3. 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 the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    Se você adicionou outros projetos ao escopo de rastreamento, recomendamos que também ative a API Observability para eles. O mapa de topologia do aplicativo mostra apenas as bordas de rastreamento de projetos de escopo de rastreamento que estão na mesma organização do projeto do App Hub.

  4. Para receber as permissões necessárias para ver a topologia do aplicativo, peça ao administrador para conceder a você o papel do IAM de Leitor da topologia do app (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.

  5. Instrumente seu aplicativo para usar o OpenTelemetry e para enviar os dados de rastreamento ao endpoint OTLP.

Ver o mapa de topologia

  1. 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.

  2. No seletor de projetos do console Google Cloud , selecione o projeto host ou de gerenciamento do App Hub.

  3. Selecione um aplicativo na lista.

  4. Clique na guia Topologia. O mapa de topologia do aplicativo vai aparecer.

O mapa de topologia é totalmente interativo. É possível aumentar e diminuir o zoom e mover os nós para ajudar a visualizar a relação entre os serviços e as cargas de trabalho. Você também pode conferir detalhes sobre um nó ou uma aresta:

  • Para conferir alertas ou atributos abertos de um serviço ou carga de trabalho, selecione o nó.
  • Para conferir a latência e a taxa de erros entre dois nós, selecione a aresta.

Resolver problemas

Para informações que podem ajudar você a entender por que o mapa de topologia do aplicativo não mostra dados, consulte Solucionar problemas do Application Monitoring.