Resolver problemas no monitoramento de aplicativos

Este documento contém informações que podem ajudar você a entender quais dados são mostrados na página Monitoramento de aplicativos. Ele também contém informações que podem ajudar você a configurar seu projeto do Google Cloud para visualizar os dados do aplicativo.

Problemas conhecidos

Esta seção lista problemas conhecidos relacionados ao Application Monitoring:

  • A latência de rastreamento não está disponível no Application Monitoring. Use a página Buscador de trace para conferir seus dados de trace. Para mais informações, consulte Encontrar e explorar traces.

Resolver problemas

Nesta seção, descrevemos como resolver problemas relacionados ao Application Monitoring.

Você recebe a instrução de criar um aplicativo

Você abre a página Monitoramento de aplicativos no console Google Cloud e vê a mensagem "Crie um aplicativo para começar". Você não espera ver esta mensagem porque registrou um aplicativo do App Hub.

Para resolver essa falha, verifique se o seletor de recursos está definido como o projeto host do App Hub ou o projeto de gerenciamento da pasta habilitada para apps.

Seu aplicativo não mostra dados para alguns indicadores de ouro

Há vários motivos para você não ver um valor para um indicador de ouro:

  • A infraestrutura não é compatível com o tipo de métrica. Por exemplo, os balanceadores de carga de rede não são compatíveis com métricas do sistema. Para mais informações, consulte Serviços e cargas de trabalho compatíveis com o Application Monitoring.

  • O tipo de métrica é compatível, mas não há dados disponíveis. Por exemplo, se o período for definido para um intervalo em que nenhum dado de métrica foi coletado, não haverá dados para mostrar nos indicadores de ouro.

Para ver uma lista de recursos que geram rótulos do App Hub, consulte Serviços e cargas de trabalho compatíveis com o monitoramento de aplicativos.

Os dados de métricas do seu aplicativo estão ausentes ou incompletos

Você visualiza um gráfico de um serviço ou carga de trabalho, mas ele não mostra dados de métricas ou alguns dados estão faltando.

Talvez você não precise fazer nada. Os gráficos adicionados ao painel predefinido de um serviço ou carga de trabalho são selecionados com base nos recursos usados por esse serviço ou carga de trabalho. No entanto, alguns recursos podem não gerar dados para um tipo de métrica específico. Para ver uma lista de recursos que geram rótulos do App Hub, consulte Serviços e cargas de trabalho compatíveis com o monitoramento de aplicativos.

Se os dados de métricas estiverem incompletos, faça o seguinte:

  1. Verifique se o seletor de projetos está definido como o projeto host do App Hub ou o projeto de gerenciamento da pasta habilitada para apps.

  2. Verifique se o administrador da organização configurou o escopo de métricas para o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por app para listar os projetos que armazenam os dados de métricas do aplicativo. Para mais informações, consulte Configurar o Application Monitoring.

Os dados de registro do seu aplicativo estão ausentes ou incompletos

O painel de registros em um painel não mostra nenhuma entrada de registro ou não mostra todas as entradas de registro geradas pelo seu aplicativo.

Para resolver essa falha, faça o seguinte:

  1. Para ter as permissões necessárias para ver dados de registros, peça ao administrador para conceder a você os seguintes papéis do IAM:

    • Visualizador de registros (roles/logging.viewer) no projeto host do App Hub ou no projeto de gerenciamento da pasta ativada para apps e em qualquer outro projeto listado no escopo de registros padrão. Essa função concede acesso à maioria das entradas de registro no bucket de registros _Default. Para mais informações, consulte Papéis do Logging.
    • Acessador de visualização de registros (roles/logging.viewAccessor) nas visualizações de registros listadas no escopo de registros padrão do projeto host do Hub do seu app ou no projeto de gerenciamento da pasta ativada para apps. Para saber mais sobre como conceder acesso a uma visualização de registro, consulte Controlar o acesso a uma visualização de registro.

  2. Verifique se o administrador da organização configurou o escopo de registros padrão do projeto host do App Hub ou o projeto de gerenciamento da pasta ativada para apps para listar os recursos que armazenam os dados de registros do aplicativo. Para mais informações, consulte Configurar o Application Monitoring.

Suas políticas de alertas estão faltando

Para que uma política de alertas seja mostrada em um painel do Application Monitoring, é preciso associar a política a um serviço ou carga de trabalho adicionando rótulos específicos a ela.

Para associar uma política de alertas a uma carga de trabalho ou serviço usando o console Google Cloud , faça o seguinte:

  1. No console Google Cloud , acesse a página  Alertas:

    Acessar Alertas

    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 do App Hub ou o projeto de gerenciamento da pasta ativada para apps.
  3. Encontre a política de alertas, clique em Ver mais, selecione Editar e acesse a seção Notificações e nome.
  4. Na seção Marcadores de aplicativo, selecione seu aplicativo e depois selecione sua carga de trabalho ou serviço.
  5. Clique em Salvar política.

Depois de concluir essas etapas, os rótulos com as seguintes chaves serão anexados à sua política de alertas. Esses rótulos identificam seu aplicativo e seu serviço ou carga de trabalho:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Também é possível adicionar identificadores definidos pelo usuário a uma política de alertas usando a Google Cloud CLI, o Terraform ou a API Cloud Monitoring. No entanto, você precisa usar as chaves de rótulo mostradas no exemplo anterior. Para ver mais informações, consulte os seguintes tópicos:

Você adicionou rótulos de aplicativo à sua política de alertas, mas ela não aparece na lista

Para resolver essa falha, verifique se a política inclui os seguintes rótulos:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Os painéis dos seus serviços e cargas de trabalho são diferentes

Não é necessário fazer nada.

Os recursos usados por um serviço ou carga de trabalho determinam quais dados são mostrados para esse serviço ou carga de trabalho.

Não é possível salvar as mudanças no painel que você está visualizando

Você está analisando os dados mostrados em um painel de serviço ou de carga de trabalho e quer salvar suas mudanças. A barra de ferramentas mostra um botão Salvar no painel. No entanto, ao selecionar esse botão, não é possível salvar as mudanças no painel atual.

O botão Salvar no painel só aparece quando o painel que você está visualizando é somente leitura. No entanto, é possível usar esse botão para salvar as mudanças em um painel personalizado. Para mais informações, consulte Visão geral dos painéis.

Não é possível salvar o gráfico

Ao analisar dados de telemetria, o botão Salvar no painel na barra de ferramentas fica desativado.

Para resolver essa falha, verifique se você tem permissões suficientes.

Para receber as permissões necessárias para salvar mudanças em um painel personalizado, peça ao administrador para conceder a você o papel do IAM de Editor do Monitoring (roles/monitoring.editor) no projeto host do App Hub ou no projeto de gerenciamento da pasta ativada para apps.

Incidentes inesperados estão sendo abertos

Com o lançamento do Application Monitoring, o rótulo metadata.system_labels.apphub_host_project_id foi renomeado como metadata.system_labels.apphub_application_container. Essa mudança pode resultar na geração de novos incidentes e na não resolução de alguns incidentes em aberto. Por exemplo, nas políticas de ausência de métricas, você pode receber uma notificação porque a mudança nos rótulos pode fazer com que uma série temporal monitorada pare de informar amostras.

Não é necessário fazer nada. Os incidentes são fechados automaticamente quando os dados param de chegar, após o término da duração do fechamento automático. Para mais informações, consulte Dados de métricas parciais.

Não é possível acessar os registros na pasta habilitada para apps

Você selecionou uma pasta habilitada para apps com o seletor de recursos no console Google Cloud . Em seguida, abra uma página do Google Cloud Observability, como o Explorador de registros, e o seletor de recursos será redefinido para um projeto.

Esse é o comportamento esperado. Quando você seleciona uma pasta habilitada para apps e acessa uma página do Google Cloud Observability, o recurso selecionado é redefinido para o projeto de gerenciamento da pasta. Normalmente, você quer que o projeto seja selecionado quando quiser ver os dados de telemetria de um aplicativo.

Para acessar os registros na pasta com app ativado, use o seletor de recursos para selecionar manualmente a pasta.