Resolver problemas no monitoramento de aplicativos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 a configurar seu projeto do Google Cloud para que você possa conferir os dados do aplicativo.

Problemas conhecidos

Esta seção lista problemas conhecidos relacionados ao monitoramento de aplicativos:

• A latência do rastreamento não está disponível no monitoramento de aplicativos. Use a página Trace Explorer para conferir seus dados de trace. Para mais informações, consulte Encontrar e analisar traces.

Resolver problemas

Esta seção descreve como resolver problemas relacionados ao monitoramento de aplicativos.

Você precisa criar um aplicativo

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

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

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

Há vários motivos para não aparecer um valor para um indicador dourado:

• A infraestrutura não é compatível com o tipo de métrica. Por exemplo, os balanceadores de carga de rede não oferecem suporte a métricas do sistema. Para mais informações, consulte Recursos compatíveis com o App Hub.

• O tipo de métrica é aceito, 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 as golden signals.

Para conferir uma lista de recursos que geram rótulos do App Hub, consulte Recursos compatíveis com o App Hub.

Os dados de métrica do seu app estão ausentes ou incompletos

Você visualiza um gráfico de um serviço ou de uma carga de trabalho, e ele não mostra nenhum dado de métrica ou alguns dados estão ausentes.

Talvez não seja necessário fazer nada. Os gráficos adicionados ao painel predefinido para 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 conferir uma lista de recursos que geram rótulos do App Hub, consulte Recursos com suporte do App Hub.

Se os dados da métrica estiverem incompletos, faça o seguinte:

1. Verifique se o seletor de projetos está definido como seu projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

2. O administrador da organização precisa ter configurado o escopo de métricas do projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps para listar os projetos que armazenam os dados de métricas do aplicativo. Para mais informações, consulte Configurar o monitoramento de aplicativos.

Os dados de registro do seu app 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 aplicativo.

Para resolver esse problema, faça o seguinte:

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

   • Visualizador de registros (roles/logging.viewer) no projeto do host do App Hub ou no projeto de gerenciamento da pasta ativada para o app e em todos os outros projetos listados no escopo de registro padrão. Esse papel concede acesso à maioria das entradas de registro no bucket de registro _Default. Para mais informações, consulte Papéis de registro.
   • Logs View Accessor (roles/logging.viewAccessor) nas visualizações de registro listadas no escopo de registro padrão do projeto de host do app Hub ou do projeto de gerenciamento da pasta com o app. 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 registro padrão do projeto host do App Hub ou do projeto de gerenciamento para a pasta ativada pelo app para listar os recursos que armazenam os dados de registro do aplicativo. Para mais informações, consulte Configurar o monitoramento de aplicativos.

Suas políticas de alertas estão ausentes

Para que uma política de alertas seja mostrada em um painel de monitoramento de aplicativos, é necessário associar a política de alertas a um serviço ou carga de trabalho adicionando rótulos específicos a ela.

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

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

   Acessar Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto host do App Hub ou o projeto de gerenciamento da pasta ativada para o app.
3. Encontre a política de alertas, clique em more_vert Ver mais, selecione Editar e acesse a seção Notificações e nome.
4. Na seção Marcadores do aplicativo, selecione seu aplicativo e depois a carga de trabalho ou o serviço.
5. Clique em Salvar política.

Depois de concluir essas etapas, 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 rótulos de usuário a uma política de alertas usando a CLI do Google Cloud, 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:

• Gerenciar políticas de alertas pela API.
• Gerencie políticas de alertas com o Terraform.

Você adicionou rótulos de aplicativo à sua política de alertas, mas ela não está listada

Para resolver esse erro, verifique se a política inclui os seguintes identificadores:

• 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 é preciso 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 alterações 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 as alterações. 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 Save to dashboard é mostrado apenas quando o painel que você está visualizando é somente leitura. No entanto, você pode usar esse botão para salvar suas 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

Quando você está analisando dados de telemetria, o botão Save to dashboard fica desativado na barra de ferramentas.

Para resolver esse problema, verifique se você tem permissões suficientes.

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

Incidentes inesperados estão sendo abertos

Com o lançamento do monitoramento de aplicativos, o rótulo metadata.system_labels.apphub_host_project_id foi renomeado como metadata.system_labels.apphub_application_container. Essa mudança pode resultar em alguns incidentes novos sendo gerados e alguns incidentes abertos não sendo fechados. Por exemplo, em 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 é preciso fazer nada. Os incidentes são fechados automaticamente quando os dados param de chegar, após o término do período de fechamento automático. Para mais informações, consulte Dados de métricas parciais.

Não é possível acessar os registros na pasta ativada pelo app.

Você selecionou uma pasta ativada por app com o seletor de recursos no console do Google Cloud. Em seguida, você abre uma página da Observabilidade do Google Cloud, como a página Logs Explorer, e o seletor de recursos é redefinido para um projeto.

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

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