Investigar aplicativos, serviços e cargas de trabalho

É possível conferir os painéis e o mapa de topologia que o Application Monitoring cria para seus aplicativos, serviços e cargas de trabalho do App Hub para monitorar o desempenho dos recursos, inspecionar indicadores de ouro e alertas, registrar serviços e cargas de trabalho e diagnosticar problemas.

O que o Monitoramento de Aplicativos mostra

Os painéis de monitoramento de aplicativos mostram o seguinte:

• Detalhes sobre os aplicativos registrados, incluindo localização, criticidade e serviços () e cargas de trabalho () registrados.

• Detalhes sobre os serviços e as cargas de trabalho descobertos e registrados, incluindo o tipo funcional, que permite identificar agentes (robot_2) e servidores MCP ().

• Dados de telemetria para seus aplicativos, serviços e cargas de trabalho:

  • Dados de registro e métricas gerados pela infraestrutura compatível.
  • Períodos de trace gerados por aplicativos instrumentados.
  • Sinais de ouro definidos pelo OpenTelemetry para tráfego, latência e taxa de erros quando uma carga de trabalho é executada no Google Kubernetes Engine. Para saber mais, consulte Instrumento para monitoramento de aplicativos.

• Abra alertas para seus aplicativos, serviços e cargas de trabalho. Para aplicativos e para serviços e cargas de trabalho registrados, esses alertas são de políticas de alertas associadas a um aplicativo do App Hub. Para serviços e cargas de trabalho descobertos, o Google Cloud Observability usa o nome do Inventário de recursos do Cloud para identificar políticas de alertas relevantes.

• Um gráfico de topologia que fornece uma visualização dinâmica das relações entre serviços e cargas de trabalho. Esse gráfico também mostra alertas e trânsito.

Google Cloud Navegação no console ao usar uma pasta habilitada para apps

O App Hub é compatível com duas configurações: pasta habilitada para apps e projetos host do App Hub. Esta seção se aplica somente quando você usa uma pasta habilitada para apps.

Quando você usa uma pasta habilitada para apps, o console do Google Cloud redefine automaticamente o seletor de recursos de uma pasta habilitada para apps para o projeto de gerenciamento da pasta quando você navega para uma página do Google Cloud Observability. Se você navegar para outra página no console do Google Cloud , o seletor de recursos será redefinido para a pasta habilitada para apps.

O Cloud Logging aceita pastas como um recurso. Por exemplo, as pastas armazenam coletores de registros e buckets de registros criados pelo sistema chamados _Default e _Required. Para acessar o recurso de pasta, use o seletor de recursos e selecione manualmente a pasta habilitada para apps.

Antes de começar

Antes de usar o Application Monitoring, configure seu projeto host ou de gerenciamento do App Hub. Esse é o projeto que você usa para visualizar os dados de telemetria do aplicativo:

• Para ter as permissões necessárias para visualizar dados de registros e métricas, criar políticas de alertas e personalizar painéis, peça ao administrador para conceder a você os seguintes papéis do IAM:

  • Visualizador de registros (roles/logging.viewer) no projeto host ou de gerenciamento do App Hub e em qualquer outro projeto listado no escopo do registro padrão. Esse papel concede acesso à maioria das entradas de registro no bucket de registros _Default. Saiba mais em Papéis do Logging.
  • Acessador de visualização de registros (roles/logging.viewAccessor) nas visualizações de registros listadas no escopo de registro padrão do projeto host ou de gerenciamento do App Hub. Para saber mais sobre como conceder acesso a uma visualização de registro, consulte Controlar o acesso a uma visualização de registro.
  • Editor do Monitoring (roles/monitoring.editor) no projeto host ou de gerenciamento do App Hub. Para principais que não precisam criar ou modificar políticas de alertas ou painéis, considere conceder o papel de Leitor do Monitoring (roles/monitoring.viewer).
  • Usuário do Cloud Trace (roles/cloudtrace.user) no projeto host ou de gerenciamento do App Hub e nos projetos no escopo de trace padrão.
  • Leitor do App Hub (roles/apphub.viewer) no projeto host ou de gerenciamento do App Hub. Para mais informações, consulte Papéis e permissões do App Hub.

  Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

• Verifique se você configurou o escopo de observabilidade do projeto host ou de gerenciamento do App Hub. Para mais informações, consulte Configurar o monitoramento de aplicativos.

  O escopo de observabilidade controla quais dados estão disponíveis para seu projeto host ou de gerenciamento do App Hub. As configurações padrão desses escopos podem não permitir que você veja todos os dados de registro ou métrica.

• Atualize as políticas de alertas que monitoram os dados do aplicativo para incluir rótulos específicos do aplicativo. Para mais informações, consulte Associar uma política de alertas a um serviço ou carga de trabalho.

Listar aplicativos

Para listar os aplicativos que você registrou no App Hub, além de informações como o número de alertas e o local, a criticidade e o ambiente do aplicativo, faça o seguinte:

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto host ou de gerenciamento do App Hub.

3. Selecione a guia Aplicativos.

   A captura de tela a seguir ilustra o painel de resumo:

   

Na guia Aplicativos, você tem várias opções:

• Para abrir um aplicativo no App Hub, clique em Mais e selecione Gerenciar no App Hub.

• Para investigar um aplicativo, selecione o nome dele. No painel que é aberto, é possível analisar os dados de registro, trace e métrica do aplicativo e a topologia dele. Também é possível abrir painéis específicos para cada serviço ou carga de trabalho que faz parte do aplicativo.

  Para saber mais, consulte a seção Investigar um aplicativo deste documento.

Listar serviços e cargas de trabalho registrados e descobertos

Com o App Hub, é possível registrar recursos de infraestrutura como serviços ou cargas de trabalho. Ele também pode descobrir recursos de infraestrutura que são candidatos ao registro. Os serviços e as cargas de trabalho podem ter um dos seguintes status de registro:

• Registrados: serviços e cargas de trabalho registrados em um aplicativo e gerenciados pelo App Hub.

• Descobertos: serviços e cargas de trabalho que podem ser registrados em um aplicativo porque fazem parte do limite de gerenciamento de aplicativos e que não estão registrados em nenhum outro aplicativo ou podem ser registrados em vários aplicativos. O status descoberto também inclui serviços e cargas de trabalho que você exclui ou cancela o registro de um aplicativo, mas que podem ser registrados novamente.

• Desvinculado: serviços ou cargas de trabalho que foram registrados em um aplicativo, mas que o App Hub não pode gerenciar ou monitorar porque os recursos Google Cloud subjacentes não fazem mais parte do limite de gerenciamento de aplicativos que você definiu.

Para listar os serviços e as cargas de trabalho registrados e descobertos, faça o seguinte:

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

2. Na barra de ferramentas do console do Google Cloud , selecione o projeto host ou de gerenciamento do App Hub.

3. Selecione a guia Serviços e cargas de trabalho.

   

   A página Serviços e cargas de trabalho lista todos os serviços e cargas de trabalho registrados. Para cada região do App Hub compatível, ele também lista no máximo 100 serviços descobertos e 100 cargas de trabalho descobertas.

   Para ajudar a identificar o tipo de cada recurso, a tabela inclui as seguintes colunas:

   • Tipo do App Hub: exibe o tipo de registro do App Hub, que é Serviço () ou Carga de trabalho ().
   • Tipo funcional: mostra o tipo funcional do App Hub, como Agente (robot_2) ou Servidor MCP ().

Na guia Serviços e cargas de trabalho, é possível fazer o seguinte:

• Modifique os dados exibidos na tabela usando o botão Colunas. Por exemplo, é possível exibir a coluna Tipo funcional.
• Aplique filtros para modificar a lista de serviços e cargas de trabalho. Por exemplo, é possível filtrar por tipo funcional para encontrar serviços e cargas de trabalho para agentes ou servidores MCP. Da mesma forma, os filtros podem ajudar você a encontrar um serviço ou uma carga de trabalho específica.

• Registre um ou mais serviços ou cargas de trabalho descobertos em um aplicativo novo ou atual:

  • Para registrar um único serviço ou carga de trabalho, na coluna Aplicativo, selecione Registrar.

  • Para registrar vários serviços ou cargas de trabalho, faça o seguinte:

    1. Para cada serviço ou carga de trabalho, marque a caixa de seleção.

       Você pode fazer até 100 seleções. Além disso, se uma caixa de seleção não estiver ativada, o serviço ou a carga de trabalho já estará registrado.

    2. No banner de seleção de tabela, selecione Registrar.

    3. Na caixa de diálogo de registro, escolha entre criar um novo aplicativo ou usar um aplicativo atual e, em seguida, conclua a caixa de diálogo.

       • Novo aplicativo: insira os detalhes do aplicativo e defina o local como global ou regional. Use global quando os serviços e as cargas de trabalho estiverem em vários locais.

       • Aplicativo atual: selecione um aplicativo. É possível registrar qualquer serviço ou carga de trabalho com um aplicativo cujo local seja global. Se um aplicativo tiver um local específico, só será possível registrar serviços e cargas de trabalho que tenham o mesmo local.

       Para informações sobre locais de aplicativos, consulte Aplicativos globais e regionais.

• Para serviços e cargas de trabalho registrados, é possível abrir o aplicativo associado no App Hub.

• Abra um painel que mostre dados de telemetria de um serviço ou carga de trabalho. Para saber mais, consulte a seção Investigar um serviço ou aplicativo deste documento.

Ver a topologia do limite de gerenciamento de aplicativos

O Google Cloud Observability cria um gráfico de topologia dinâmico dos serviços e cargas de trabalho registrados e descobertos usando dados de trace. Para determinar quais dados de trace analisar, o Google Cloud Observability consulta os recursos listados no escopo de trace padrão em busca de dados de trace e, em seguida, retém apenas os dados dos projetos dentro do limite de gerenciamento do aplicativo.

Para exibir um gráfico de topologia dinâmica dos seus aplicativos e dos serviços e cargas de trabalho descobertos, faça o seguinte:

1. Conclua as etapas em Ver topologia do aplicativo: antes de começar.

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

3. Na barra de ferramentas do console do Google Cloud , selecione seu projeto host ou de gerenciamento do App Hub.

4. Selecione a guia Topologia.

   

   A página Topologia exibe um círculo azul para cada aplicativo registrado:

   • Para dois aplicativos, o círculo azul mostra um botão 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 counter_4. O valor no botão é o número de serviços e cargas de trabalho registrados.

   Para serviços e cargas de trabalho registrados e descobertos, o gráfico de topologia exibe um nó com um ícone, que indica o tipo de recurso. Ele também exibe arestas que representam o tráfego entre dois nós.

   O gráfico de topologia mostra no máximo 1.000 nós. Para cada região do App Hub compatível, o gráfico pode exibir no máximo 100 serviços descobertos e 100 cargas de trabalho descobertas.

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 um círculo de aplicativo em um ponto.

• Para receber informações sobre atributos e alertas, selecione um aplicativo ou um nó.

• Selecione a borda para ver informações sobre o tráfego entre os nós. Um submenu exibe os nomes dos nós e as principais métricas, como a taxa de erros e o 95º percentil de latência.

Para saber mais sobre essa guia, consulte Ver a topologia do aplicativo.

Investigar um aplicativo

Para investigar a integridade de um aplicativo, faça o seguinte:

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto host ou de gerenciamento do App Hub.

3. Selecione a guia Visão geral e, na lista de aplicativos, selecione o aplicativo.

   Um painel para o aplicativo é aberto com a guia Visão geral selecionada. Essa guia mostra informações resumidas. As seções a seguir descrevem as informações que você pode encontrar nas guias Visão geral, Painéis e Topologia.

Ver informações resumidas

Para ver informações gerais sobre o aplicativo com uma lista de serviços e cargas de trabalho, selecione a guia Visão geral:

Como mostrado, essa guia fornece informações gerais sobre o aplicativo, além de uma lista de serviços e cargas de trabalho registrados no aplicativo. Para cada serviço ou carga de trabalho, essa guia também mostra o seguinte:

• O número de alertas abertos. Para ver os detalhes desses alertas, selecione o número.
• O tipo do App Hub.

• No exemplo, as colunas da tabela foram modificadas para exibir também o tipo funcional do App Hub. O tipo funcional ajuda a identificar cargas de trabalho e serviços de agentes:

  • Agente (robot_2)
  • Servidor MCP ()

• Valores para indicadores de ouro:

  • Tráfego: taxas de solicitação de entrada no serviço ou na carga de trabalho durante o período selecionado. Para algumas configurações, esse gráfico contém guias. A guia Solicitação mostra a métrica de rede L7, e a guia Bytes mostra a métrica de rede L4.
  • Taxa de erro do servidor: proporção de solicitações recebidas com um código de resposta equivalente a um código de resposta HTTP 5xx em relação a todas as solicitações recebidas no período selecionado.
  • Latência P95: 95º percentil de latência para uma solicitação exibida no período selecionado, em milissegundos.
  • Saturação: mede o nível de preenchimento do serviço ou da carga de trabalho. Por exemplo, para grupos gerenciados de instâncias (MIGs), Cloud Run e implantações do Google Kubernetes Engine, esse campo mostra a utilização da CPU.

As opções na guia Visão geral permitem que você faça o seguinte:

• Abra o aplicativo, um serviço ou uma carga de trabalho no App Hub.
• Abra o painel de um serviço ou carga de trabalho.
• Redefina o período. Quando você abre o painel, o período é definido como a hora mais recente.

Acessar a telemetria agregada

Para ver informações de registro, métrica, trace e alertas do seu aplicativo, selecione a guia Painéis.

Os gráficos nessa guia agregam automaticamente os dados de métricas dos serviços e das cargas de trabalho no aplicativo. Esses gráficos também mostram anotações de eventos, que podem ajudar você a correlacionar dados de diferentes fontes ao solucionar um problema. Para ver quais anotações estão ativadas, na barra de ferramentas, clique em Anotações.

A guia Painéis contém filtros que podem ser usados para restringir os dados exibidos. Para mais informações sobre como analisar os dados mostrados nessa guia, consulte a seção Usar as opções do painel para analisar a telemetria deste documento.

Ver recursos de IA

O Application Monitoring usa dados de trace para derivar métricas, como o uso de tokens e as taxas de erro, para os recursos de IA que seu aplicativo usa. Essas métricas podem ajudar você a entender a integridade, o comportamento e os custos do aplicativo.

Para ver informações sobre os recursos de IA associados ao seu aplicativo, faça o seguinte:

1. Selecione a guia Painéis.

2. No Sumário do painel, selecione Recursos de IA.

   Se você não encontrar uma entrada de recursos de IA, isso significa que não há recursos de IA associados ao seu aplicativo.

A seção Recursos de IA do painel permite visualizar e analisar as seguintes informações:

• Total de consultas por segundo e contagem de tokens.
• Taxa média de erros, latência e taxa de erros de chamada de ferramenta.
• Uso de tokens.
• Taxas de erro e latência para agentes.

Para saber como explorar esse painel, consulte Ver recursos de IA.

Veja a topologia

Para conferir uma visualização dinâmica dos serviços e cargas de trabalho, alertas e tráfego do aplicativo, selecione a guia Topologia.

Para saber mais sobre a guia Topologia, consulte Ver topologia.

Investigar um serviço ou uma carga de trabalho

O Monitoramento de Aplicativos cria um painel para cada serviço e carga de trabalho. Esses painéis mostram dados de telemetria e informações de alerta, além de ajudar a entender a integridade de um serviço ou carga de trabalho específica. É possível analisar os dados nesses painéis de maneira semelhante à análise dos dados mostrados na guia Painel de um aplicativo.

A captura de tela a seguir ilustra o painel de uma carga de trabalho:

O status de registro de um serviço ou carga de trabalho afeta os dados que o Monitoramento de Aplicativos mostra no painel:

• Registrado: o Application Monitoring usa os rótulos e atributos específicos do aplicativo que a infraestrutura compatível e os aplicativos instrumentados anexam à telemetria que geram. Esses painéis mostram dados de registros, métricas e traces.

• Descoberto: o Application Monitoring deriva o tipo de recurso usando o nome do recurso, conforme definido pelo Inventário de recursos do Cloud. Em seguida, ele usa o tipo de recurso para identificar e filtrar dados de registros e métricas para infraestrutura compatível. Por exemplo, se o tipo de recurso for determinado como cloud_run-revision, os gráficos poderão filtrar os dados pelos valores dos rótulos location e service_name.

Para abrir o painel de monitoramento de aplicativos de um serviço ou carga de trabalho, faça o seguinte:

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto host ou de gerenciamento do App Hub.

3. Selecione a guia Serviços e cargas de trabalho e, em seguida, selecione o serviço ou a carga de trabalho.

   Observação: para serviços e cargas de trabalho registrados em um aplicativo, também é possível abrir os painéis na página de resumo do aplicativo.

   Um painel é aberto para o serviço ou a carga de trabalho que você selecionou.

Ver informações resumidas

Para ver informações gerais sobre o serviço ou a carga de trabalho, no Sumário do painel, selecione a opção Visão geral.

Esta seção mostra o seguinte:

• Informações sobre o aplicativo, como o tipo de infraestrutura e a importância. Quando o tipo de infraestrutura não pode ser identificado, esse campo mostra Serviço do App Hub. Para mais informações, consulte Infraestrutura compatível com o Application Monitoring.

• Uma tabela de alertas.

• Indicadores de ouro.

Se um serviço ou carga de trabalho não estiver registrado, esta seção também vai exibir um banner como este:

This service is not registered. Register it to gain a unified view of your application's performance and stability.

Você não precisa fazer nada. No entanto, recomendamos que você registre seus serviços e cargas de trabalho.

Ver telemetria

Para ver os dados de telemetria, use o Sumário do painel para navegar até o conteúdo relevante:

• Para ver os indicadores dourados e outras informações de métricas, selecione Infraestrutura.
• Para analisar os dados de trace, selecione Traces.
• Para analisar os dados de registro, selecione Registros.

Os gráficos de telemetria mostram anotações de eventos que podem ajudar a correlacionar dados de diferentes fontes ao solucionar um problema. Para ver quais anotações estão ativadas, na barra de ferramentas, clique em Anotações.

Para saber como analisar os dados nesses gráficos, consulte a seção Usar as opções do painel para analisar a telemetria deste documento.

Ver recursos de IA

Para ver informações sobre os recursos de IA, use o Sumário do painel:

• Agente: disponível para agentes. Esta seção mostra informações sobre sessões, invocações de agentes e uso de tokens.

• Ferramentas: disponíveis para agentes. Esta seção mostra informações sobre chamadas de ferramentas, incluindo taxa de erro, contagem de chamadas e latência P95.

• Modelos: disponíveis para alguns agentes. Esta seção mostra informações sobre o número de chamadas de modelo feitas pelo agente, a taxa de erro e o uso de tokens.

Para saber como analisar os dados nessas seções, consulte Ver recursos de IA.

Usar as opções do painel para analisar a telemetria

Os painéis do Application Monitoring exibem informações de registro, métrica, trace e alerta. Nesta seção, descrevemos como usar as opções em um painel ou em um widget, como um gráfico, para receber mais informações sobre os dados mostrados. Você também pode usar essas opções para modificar os dados mostrados.

Filtrar um painel

É possível adicionar filtros a um painel que se aplicam a todos os widgets dele.

Por exemplo, a barra de ferramentas da guia Painel de um aplicativo contém um filtro como apphub_service_id: *. Para ver dados de serviços específicos, clique em Menu e selecione esses serviços na lista.

Analisar dados de registro

Observação :se os painéis não estiverem mostrando os dados de registro esperados, talvez seja necessário configurar o escopo do registro padrão ou ter mais permissões do Identity and Access Management. Para mais informações, consulte Configurar e definir o escopo do registro padrão e Os dados de registro do aplicativo estão ausentes ou incompletos.

Se você estiver visualizando a guia Painel de um painel de aplicativo, os dados de registro serão mostrados na seção Registros do aplicativo. Caso contrário, os dados serão mostrados na seção Registros.

As seções Registros de aplicativos e Registros de um painel mostram entradas de registro que correspondem a um filtro e são armazenadas pelos recursos listados no escopo de registro padrão do projeto host ou de gerenciamento do App Hub. Para aplicativos, o filtro é semelhante ao seguinte:

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

Para serviços e cargas de trabalho, o filtro contém outras cláusulas. Para ver o filtro aplicado aos dados de registro, clique em Mostrar consulta.

Se você quiser escrever consultas, abra um submenu ou a página Análise de registros. As duas opções permitem escrever e executar consultas e mudar o escopo. No entanto, o submenu mantém o contexto atual e permite salvar os resultados da análise em um painel personalizado:

• Para abrir um menu flutuante, clique em Analisar dados.

  Quando terminar, clique em Cancelar para fechar o menu suspenso e descartar as mudanças. Se quiser salvar as alterações em um painel personalizado, clique em Salvar no painel e preencha a caixa de diálogo. Não é possível salvar as mudanças no painel que você estava visualizando quando abriu o submenu.

  O menu suspenso não lista os filtros mostrados pelo botão Mostrar consulta. Esses filtros são aplicados no nível do painel e não podem ser removidos.

• Para abrir a página Análise de registros em uma nova guia do navegador, clique em Ver na Análise de registros.

  A consulta é pré-configurada para mostrar entradas de registro que correspondem a rótulos de aplicativos específicos e que estão no período especificado pelo painel. Quando você fecha a guia do navegador, as mudanças são descartadas.

Para mais informações sobre como analisar seus registros, consulte os seguintes documentos:

• Criar e salvar consultas usando a linguagem de consulta do Logging.
• Ver registros usando a Análise de registros.

Acessar dados de métricas

Os gráficos e as tabelas no painel mostram indicadores de ouro e outros dados de métricas relevantes para os recursos usados pelo aplicativo, serviço ou carga de trabalho. Os dados exibidos podem ser armazenados em qualquer projeto listado pelo escopo de métricas do seu projeto host ou de gerenciamento do App Hub.

Ver configuração do gráfico

Para conferir detalhes como o tipo de métrica e as opções de agregação de um gráfico que mostra dados de métricas, acesse a barra de ferramentas de um gráfico ou tabela e clique em Informações.

Explorar dados

Para analisar um gráfico ou uma tabela em mais detalhes, abra um submenu ou a página do Metrics Explorer. As duas opções permitem testar diferentes configurações de gráfico e salvar os resultados em um painel personalizado. No entanto, o submenu mantém o contexto atual:

• Para abrir um menu flutuante, clique em Analisar dados.

  Quando terminar, clique em Cancelar para fechar o menu suspenso e descartar as mudanças. Se quiser salvar as alterações em um painel personalizado, clique em Salvar no painel e preencha a caixa de diálogo. Não é possível salvar as mudanças no painel que você estava visualizando quando abriu o submenu.

• Para ver o gráfico ou a tabela no Metrics Explorer, acesse a barra de ferramentas, clique em Mais e selecione Ver no Metrics Explorer.

  Agora você tem um gráfico temporário que pode ser modificado e analisado. Por exemplo, é possível mudar as opções de agregação ou o estilo de exibição. Para salvar o gráfico em um painel personalizado, clique em Salvar no painel e preencha a caixa de diálogo.

Correlacionar dados de métricas e registros

Ao visualizar um gráfico, talvez você queira analisar os dados de registro que foram gravados no mesmo recurso que os dados de métricas do gráfico. Por exemplo, se você notar um pico ou uma queda em um gráfico, talvez queira analisar as entradas de registro para receber mais informações sobre o sistema.

Uma maneira de correlacionar os dados de métricas e registros é usar as opções de gráfico para abrir um submenu que exibe o gráfico e as entradas de registro selecionadas. Em seguida, use as barras de ferramentas e os menus no submenu para analisar os dados de métricas e registros. Por exemplo, é possível adicionar filtros à consulta de métrica, modificar a consulta de geração de registros ou expandir e explorar entradas de registro.

A captura de tela a seguir ilustra o submenu:

O submenu não exibe todas as entradas de registro que correspondem ao seletor de período do painel. Em vez disso, o sistema cria uma consulta de geração de registros com base na consulta de métrica. A consulta de geração de registros inclui todas as variáveis aplicáveis, mas não inclui filtros no nível do painel.

Ver dados de métricas e registros

É possível correlacionar dados de métricas e registros quando um gráfico exibe qualquer tipo de métrica, exceto uma métrica com base em registros ou do Prometheus. Quando um gráfico exibe uma métrica com base em registros, uma métrica do Prometheus ou quando não exibe dados de métricas, não é possível correlacionar dados de métricas e registros.

Para abrir o menu que mostra os dados de métricas e de registros, siga um destes procedimentos:

• Para filtrar os dados de registro apenas pelo tipo de recurso e pelas variáveis aplicáveis, na barra de ferramentas do gráfico, clique em Mais opções de gráfico e selecione Inspecionar registros relacionados.

• Para mostrar entradas de registro que se correlacionam com uma série temporal específica, no gráfico, use o ponteiro para selecionar um ponto na série temporal, acesse a dica e selecione segment Inspecionar registros relacionados.

  Nesse modo, o submenu modifica o seletor de período para cinco minutos antes e depois do carimbo de data/hora do ponto selecionado.

Se o gráfico não exibir uma opção Inspecionar registros relacionados, ele não será compatível com a correlação de métricas e registros.

Salvar alterações

É possível salvar o gráfico ou o painel de registros mostrado no submenu, incluindo as alterações feitas, em um painel personalizado. Se você salvar o gráfico no mesmo painel em que abriu o submenu, um novo gráfico será criado no painel.

Para salvar o gráfico ou o painel de registros em um painel personalizado, abra o menu Ações do widget, selecione Salvar no painel e preencha a caixa de diálogo. É possível selecionar um painel personalizado atual ou criar um painel e salvar o widget.

Fechar o submenu

Para fechar o menu, clique em Cancelar na barra de ferramentas.

Explorar alertas

A seção Alertas de um painel lista os alertas abertos para políticas de alertas associadas ao seu aplicativo. Se você estiver visualizando um painel de um serviço ou carga de trabalho, esta seção exibirá alertas para esse serviço ou carga de trabalho.

Para mais informações sobre os alertas e as políticas de alertas, faça o seguinte:

• Para encontrar detalhes sobre a política de alertas que causou o alerta, clique no nome da política. O painel que é aberto exibe informações detalhadas sobre a política de alertas, incluindo um gráfico que mostra os dados monitorados e os rótulos.

• Para ver todas as políticas de alertas associadas ao aplicativo, acesse a barra de ferramentas e clique em Analisar dados. Um submenu é aberto com todas as políticas. Para voltar ao painel, clique em Cancelar.

Se não houver entradas na seção Alertas, uma das seguintes condições será verdadeira:

• Não há alertas abertos.

  Para ver os alertas fechados e aqueles que foram abertos fora da configuração de período do painel, na barra de ferramentas da seção Alertas, desative Agrupados por política e ative Mostrar alertas fechados.

  Se a tabela permanecer vazia, isso significa que você não tem políticas de alertas associadas ou nenhuma das políticas associadas relatou um alerta.

• Nenhuma das políticas de alerta armazenadas no projeto host ou de gerenciamento do App Hub está associada a um serviço ou carga de trabalho. Para fazer essa associação, adicione rótulos à política de alertas. Para mais informações, consulte Associar uma política de alertas a um serviço ou carga de trabalho.

Confira dados de trace

Observação :se os painéis não estiverem mostrando os dados de trace esperados, talvez seja necessário configurar o escopo de trace padrão ou talvez você precise de outras permissões do Identity and Access Management. Para mais informações, consulte Configurar e definir o escopo de trace padrão. Os dados de trace não estão disponíveis para serviços ou cargas de trabalho descobertos.

A seção Traces de um painel lista informações sobre períodos gerados pelos serviços e cargas de trabalho registrados quando esses períodos contêm atributos de recursos específicos do aplicativo. Os atributos de recurso necessários estão disponíveis quando você instrumenta o aplicativo. Somente os períodos que atendem aos filtros do painel são mostrados.

Para dados de trace, o painel no nível do aplicativo agrupa os períodos pelo nome e pelo nome do serviço ou da carga de trabalho e, em seguida, exibe as seguintes informações em um formato tabular:

• Nome do período.
• Nome do serviço ou da carga de trabalho.
• O número de períodos no agrupamento.
• Os percentis de latência 50, 90 e 95 dos períodos no agrupamento.
• A taxa de erros.

Para mais informações sobre um agrupamento, selecione-o. Um menu interativo é aberto:

O painel interativo mostra o seguinte:

• Períodos individuais no grupo. A primeira entrada é selecionada automaticamente.

• Informações sobre o trace pai do período selecionado. Essas informações incluem o seguinte:

  • Informações estatísticas, como a duração total.

  • A hierarquia de chamadas que mostra o período no contexto do trace. Se o ícone de GenAI, , aparecer com um nome, o período terá eventos ou atributos de IA generativa.

    Por padrão, a hierarquia de chamadas aparece como uma linha do tempo. Se quiser ver a hierarquia como um gráfico acíclico dirigido (DAG), selecione Gráfico na barra de ferramentas.

    

  • O serviço ou a carga de trabalho associada a cada chamada. O ícone de serviço, , identifica os serviços registrados no App Hub. Da mesma forma, o ícone de carga de trabalho, , identifica as cargas de trabalho.

  • Latência de cada chamada.

  • Status de sucesso de cada chamada, indicado em azul ou vermelho.

  • Uma coleção de guias que permitem explorar atributos, entradas de registro ou outras informações.

Como o painel é interativo, para ver um período diferente, selecione-o na linha do tempo ou na visualização do DAG.

Também é possível ver os períodos de trace usando a página Explorador de traces. Para fazer isso, na barra de ferramentas da seção Traces, clique em Ver no Explorador de traces:

• Os filtros específicos do aplicativo são aplicados automaticamente.
• É possível adicionar, remover ou modificar qualquer filtro. No entanto, as alterações feitas são descartadas quando você fecha a página do Trace Explorer.

Para saber mais sobre como analisar os dados de trace, consulte Encontrar e analisar traces.

Resolver problemas

Para informações que podem ajudar você a entender quais dados está visualizando ou por que um painel não exibe dados, consulte Resolver problemas do Application Monitoring.

A seguir

• Confira os recursos de IA.

• Ver topologia.

• Instrumentar um aplicativo para o Monitoramento de Aplicativos.

• Infraestrutura compatível com o Application Monitoring.