Resolva problemas de monitorização de aplicações

Este documento contém informações que podem ajudar a compreender os dados apresentados na página Monitorização de aplicações. Também contém informações que podem ajudar a configurar o seu projeto do Google Cloud para que possa ver os dados da sua aplicação.

Problemas conhecidos

Esta secção apresenta problemas conhecidos relacionados com a monitorização de aplicações:

  • A latência de rastreio não está disponível na monitorização de aplicações. Para ver dados de latência da sua aplicação, use a página Explorador de rastreios e aplique filtros de aplicação, serviço ou carga de trabalho. Para mais informações, consulte o artigo Encontre e explore rastreios: veja informações da aplicação.

Resolver problemas

Esta secção descreve como resolver problemas relacionados com a monitorização de aplicações.

É-lhe pedido que crie uma aplicação

Abre a página Monitorização de aplicações na Google Cloud consola e vê a mensagem "Crie uma aplicação para começar". Não espera ver esta mensagem porque registou uma aplicação do App Hub.

Para resolver esta falha, certifique-se de que o selecionador de recursos está definido para o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps.

A sua aplicação não mostra dados para alguns sinais de ouro

Existem vários motivos pelos quais não vê um valor para um sinal de ouro:

  • A infraestrutura não suporta o tipo de métrica. Por exemplo, os equilibradores de carga de rede não suportam métricas do sistema. Para mais informações, consulte o artigo Serviços e cargas de trabalho suportados pela monitorização de aplicações.

  • O tipo de métrica é suportado, mas não existem dados disponíveis. Por exemplo, se o intervalo de tempo estiver definido para um intervalo em que não foram recolhidos dados de métricas, não existem dados a apresentar para os sinais de ouro.

Para ver uma lista de recursos que geram etiquetas do App Hub, consulte o artigo Serviços e cargas de trabalho suportados pela monitorização de aplicações.

Os dados de métricas da sua aplicação estão em falta ou incompletos

Vê um gráfico para um serviço ou uma carga de trabalho, e este gráfico não apresenta dados de métricas ou faltam alguns dados.

Pode não ter de fazer nada. Os gráficos adicionados ao painel de controlo predefinido para um serviço ou uma 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 etiquetas do App Hub, consulte o artigo Serviços e cargas de trabalho suportados pela monitorização de aplicações.

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

  1. Certifique-se de que o seletor de projetos está definido para o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

  2. Certifique-se de que o administrador da organização configurou o âmbito das métricas para o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas para listar os projetos que armazenam os dados das métricas da sua aplicação. Para mais informações, consulte o artigo Configure a monitorização de aplicações.

Os dados de registo da sua aplicação estão em falta ou incompletos

O painel de registos num painel de controlo não mostra entradas de registo ou não mostra todas as entradas de registo geradas pela sua aplicação.

Para resolver esta falha, faça o seguinte:

  1. Para receber as autorizações necessárias para ver os dados de registo, peça ao seu administrador que lhe conceda as seguintes funções de IAM:

    • Logs Viewer (roles/logging.viewer) no projeto anfitrião do App Hub ou no projeto de gestão da pasta ativada para apps e em quaisquer outros projetos listados no respetivo âmbito de registo predefinido. Esta função concede acesso à maioria das entradas de registo no contentor de registos _Default. Para mais informações, consulte o artigo Funções de registo.
    • Logs View Accessor (roles/logging.viewAccessor) nas visualizações de registos apresentadas no âmbito do registo predefinido do projeto anfitrião do App Hub ou do projeto de gestão da pasta com apps ativadas. Para saber como conceder acesso a uma vista de registo, consulte o artigo Controle o acesso a uma vista de registo.

  2. Certifique-se de que o administrador da organização configurou o âmbito de registo predefinido do projeto anfitrião do App Hub ou do projeto de gestão da pasta com apps ativadas para listar os recursos que armazenam os dados de registo da sua aplicação. Para mais informações, consulte o artigo Configure a monitorização de aplicações.

As suas políticas de alerta estão em falta

Para que uma política de alerta seja apresentada num painel de controlo de monitorização de aplicações, tem de associar a política de alerta a um serviço ou uma carga de trabalho adicionando etiquetas específicas à política.

Para associar uma política de alertas a uma carga de trabalho ou um serviço através da consola Google Cloud , faça o seguinte:

  1. Na Google Cloud consola, aceda à página  Alertas:

    Aceder a Alertas

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Na barra de ferramentas da Google Cloud consola, selecione o seu projeto anfitrião do App Hub ou o projeto de gestão para a pasta com apps ativadas.
  3. Encontre a política de alertas, clique em Ver mais, selecione Editar e, de seguida, aceda à secção Notificações e nome.
  4. Na secção Etiquetas de aplicações, selecione a sua aplicação e, em seguida, selecione a sua carga de trabalho ou serviço.
  5. Clique em Guardar política.

Depois de concluir estes passos, as etiquetas com as seguintes chaves são anexadas à sua política de alertas. Estas etiquetas identificam a sua aplicação e o seu serviço ou carga de trabalho:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Também pode adicionar etiquetas de utilizador a uma política de alerta através da CLI Google Cloud, do Terraform ou da API Cloud Monitoring. No entanto, tem de usar as chaves de etiquetas apresentadas no exemplo anterior. Para mais informações, consulte o seguinte:

Adicionou etiquetas de aplicações à sua política de alertas, mas a política não é apresentada

Para resolver esta falha, verifique se a política inclui as seguintes etiquetas:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

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

Não é necessária nenhuma ação.

Os recursos usados por um serviço ou uma carga de trabalho determinam os dados apresentados para esse serviço ou carga de trabalho.

Não é possível guardar as alterações ao painel de controlo que está a ver

Está a explorar os dados apresentados num painel de controlo de serviços ou cargas de trabalho e quer guardar as alterações. A barra de ferramentas apresenta um botão Guardar no painel de controlo. No entanto, quando seleciona esse botão, não pode guardar as alterações no painel de controlo atual.

O botão Guardar no painel de controlo só é apresentado quando o painel de controlo que está a ver é só de leitura. No entanto, pode usar este botão para guardar as alterações num painel de controlo personalizado. Para mais informações, consulte o artigo Vista geral dos painéis de controlo.

Não é possível guardar o seu gráfico

Quando está a explorar dados de telemetria, o botão Guardar no painel de controlo na barra de ferramentas está desativado.

Para resolver esta falha, certifique-se de que tem autorizações suficientes.

Para receber as autorizações de que precisa para guardar alterações num painel de controlo personalizado, peça ao seu administrador para lhe conceder a função de IAM de editor de monitorização (roles/monitoring.editor) no projeto anfitrião do App Hub ou no projeto de gestão da sua pasta ativada para apps.

Estão a ser abertos incidentes inesperados

Com o lançamento da monitorização de aplicações, a etiqueta metadata.system_labels.apphub_host_project_id foi mudada para metadata.system_labels.apphub_application_container. Esta alteração pode resultar na geração de novos incidentes e no não encerramento de alguns incidentes abertos. Por exemplo, para políticas de ausência de métricas, pode receber uma notificação porque a alteração nas etiquetas pode fazer com que uma série cronológica monitorizada deixe de comunicar amostras.

Não é necessária nenhuma ação. Os incidentes são encerrados automaticamente quando os dados deixam de chegar, após o fim da duração do encerramento automático. Para mais informações, consulte o artigo Dados de métricas parciais.

Não pode aceder aos registos na pasta com a app ativada

Selecionou uma pasta com apps ativadas com o selecionador de recursos na consola Google Cloud . Em seguida, abre uma página do Google Cloud Observability, como a página Explorador de registos, e o selecionador de recursos é reposto para um projeto.

O comportamento é intencional. Quando seleciona uma pasta com apps ativadas e, em seguida, acede a uma página do Google Cloud Observability, o recurso selecionado é reposto para o projeto de gestão da pasta. Normalmente, quer que o projeto esteja selecionado quando quer ver os dados de telemetria de uma aplicação.

Para aceder aos registos na pasta ativada para apps, use o selecionador de recursos para selecionar manualmente a pasta.