Resolver problemas em gráficos

Nesta página, explicamos alguns comportamentos que podem ocorrer ao usar as métricas coletadas pelos projetos do Google Cloud.

Erros no gráfico

Esta seção descreve os erros que podem aparecer ao configurar um gráfico. É possível configurar gráficos usando o Metrics Explorer ou adicionando-os a um painel.

Lacunas nos dados do gráfico

Charts vezes, os gráficos apresentam lacunas nos dados. Por exemplo, veja na captura de tela a seguir esse comportamento para a métrica loadbalancing.googleapis.com/https/total_latencies:

Exemplo de gráfico com lacunas nos valores.

Pode ocorrer lacunas nos dados quando os dados são gravados com pouca frequência. O Cloud Monitoring coleta métricas por amostragem. Com dados muito esparsos, talvez não haja dados disponíveis quando uma amostra for coletada. Por exemplo, intervalos nas métricas do balanceador de carga podem ocorrer quando a contagem de solicitações é de 0,05 consulta por segundo (QPS, na sigla em inglês) ou menos. Quando a taxa de consulta aumenta, as lacunas desaparecem.

O período de alinhamento muda quando o período é modificado

Você adiciona um gráfico a um painel. Quando você muda o período do gráfico, às vezes o período de alinhamento muda. Por exemplo, se você mudar o intervalo de uma hora para duas horas, o período de alinhamento será listado como 1 minute interval. No entanto, se você mudar o período de uma hora para um dia, o período de alinhamento será listado como 5 minute interval.

Esse comportamento é esperado.

Os gráficos são limitados no número de pontos de dados que podem mostrar. Portanto, quando o número de pontos de dados disponíveis para o período selecionado é maior que o limite de exibição, o monitoramento modifica automaticamente as configurações de alinhamento para reduzir o número de pontos de dados exibidos.

O gráfico não mostra todas as séries temporais

Você configura um gráfico, mas ele não mostra todas as séries temporais.

Por motivos de desempenho, os gráficos são configurados para mostrar no máximo 50 séries temporais.

Quando você configura um gráfico e mais de 50 série temporal estão disponíveis, o gráfico limita o número de série temporal exibidas e adiciona um ícone com um ponto vermelho à barra de ferramentas. A dica do ícone mostra a seguinte mensagem:

To improve performance, we've limited the time series displayed in this chart.

Para mostrar todas série temporal, abra a dica e selecione o botão Mostrar todas as séries temporais.

O gráfico não mostra dados

Você configura um gráfico, mas ele mostra uma mensagem de erro em vez de dados:

  • Quando não há dados disponíveis para o período especificado no gráfico, esta mensagem é exibida:

    No data is available for the selected time frame.

    Para resolver o problema, tente o seguinte:

    • Aumente o período do gráfico. Alguns tipos de métricas, como as que informam o uso de cota, fornecem apenas uma amostra por dia.

    • Mude o tipo de métrica selecionado no gráfico. É possível que o tipo de métrica especificado pelo gráfico esteja inativo. Ou seja, não há dados para esse tipo de métrica.

  • Quando o tipo de métrica ou de recurso especificado pela consulta não é reconhecido, a seguinte mensagem é exibida:

    An error occurred requested data. One or more resources could not be found.

    Para resolver esse problema, tente o seguinte:

    • Verifique se o tipo de métrica e o tipo de recurso especificados na consulta estão definidos. Você pode usar a interface de menu para gráficos para procurar o tipo de métrica.

    • Verifique a ortografia do tipo de métrica e de recurso na consulta.

O gráfico com várias métricas exibe uma mensagem de erro

Você está configurando um gráfico para exibir várias métricas. O gráfico exibe a seguinte mensagem de erro:

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

Os gráficos podem mostrar vários tipos de métricas, e você pode mapear um tipo de métrica para o eixo Y à esquerda ou à direita. As unidades de todos os tipos de métrica mapeadas para o eixo Y esquerdo precisam ser as mesmas. Caso contrário, a mensagem de erro anterior será mostrada. Da mesma forma, as unidades de todos os tipos de métrica mapeadas para o eixo Y direito precisam ser as mesmas, ou a mensagem de erro anterior será mostrada.

Para resolver esse erro, faça o seguinte:

  1. Se o gráfico contiver métricas com mais de dois tipos de unidades, remova as métricas até ter apenas dois tipos de unidades.

  2. Atribua todas as métricas com um tipo de unidade ao eixo Y esquerdo e todas as métricas com o outro tipo de unidade ao eixo Y direito.

Gráfico com várias métricas exibe dados inesperados

Um gráfico é configurado para exibir várias métricas, e filtros foram adicionados para mostrar apenas séries temporais específicas. No entanto, o gráfico mostra as séries temporais que não satisfazem os filtros.

Para resolver essa situação, aplique filtros a cada métrica no gráfico.

Por exemplo, a captura de tela a seguir mostra o painel de configuração do Metrics Explorer referente a um gráfico que exibe o número de bytes lidos e gravados por instâncias de máquina virtual (VM, na sigla em inglês):

Exemplo do Metrics Explorer com dois tipos de métricas.

Na captura de tela, há um cabeçalho para cada tipo de métrica exibido pelo gráfico.

Por exemplo, se você quiser que o gráfico exiba séries temporais somente para VMs que estejam na zona us-central1-a, adicione o filtro zone = us-central1-a a cada consulta.

Não é possível selecionar valores de filtro para gráficos definidos por MQL e PromQL.

Você cria gráficos em um painel personalizado e os configura com a linguagem de consulta do Monitoring (MQL) ou com o PromQL. Em seguida, crie filtros permanentes do painel. Ao acessar o painel, você tenta mudar o valor padrão do filtro, mas o menu de valores de rótulo não aparece ou não está correto:

Os valores de um filtro do painel não são carregados.

Para resolver esse problema, insira o valor do filtro e selecione Aplicar. Por exemplo, se a chave de filtro for zone, digite us-central1-a.

Erros no painel

Esta seção descreve os erros que podem ocorrer ao criar ou editar painéis.

O painel não mostra todos os eventos

Você configura um painel para mostrar eventos, mas apenas os eventos recentes são exibidos. Os eventos mais antigos não são mostrados.

Para resolver esse problema, faça uma das seguintes ações:

  • Use um período mais curto. Por exemplo, mostre dados da hora mais recente em vez do dia mais recente ou selecione um período personalizado.

  • Adicione filtros.

Por motivos de desempenho, os painéis são limitados no número de eventos que podem ser mostrados. Quando esses limites são atingidos, os painéis mostram apenas os eventos mais recentes.

O painel criado pelo Terraform é redimensionado

Você criou um painel usando o Terraform e editou o painel usando o console do Google Cloud. Você esperava que o painel não fosse alterado, exceto pelas suas edições. Em vez disso, o painel é redimensionado. Por exemplo, seu painel tinha 12 colunas e agora tem 48.

Não edite painéis criados usando o Terraform com o console do Google Cloud. Quando o painel é editado, o tamanho é dimensionado por um fator de quatro.

O widget da política de alertas não exibe dados

Um painel contém um gráfico de uma política de alertas, mas o gráfico não mostra dados.

Para resolver esse problema, tente o seguinte:

  • Confira a configuração do gráfico e verifique se uma política de alertas está selecionada. Se nenhuma política de alertas for exibida, associe o gráfico a uma política de alertas ou exclua o gráfico do painel.

    Os gráficos nos painéis que mostram dados de uma política de alertas param de mostrar dados quando a política de alertas referenciada é excluída. A exclusão de uma política de alertas não remove os gráficos que fazem referência a ela.

  • Visualize os detalhes da política de alertas e verifique se ela contém uma única condição.

    Os gráficos nos painéis que mostram dados de uma política de alertas param de mostrar dados se a política de alertas for modificada para conter várias condições. Para resolver essa condição, associe o gráfico a uma política de alertas de condição única ou exclua o gráfico do painel.

  • Aumente o período. O seletor de período precisa ser definido como um valor maior que o período de amostragem dos dados. Embora a maioria das métricas seja amostrada a cada 60 segundos, algumas métricas não são amostradas com frequência. Por exemplo, a amostragem da métrica serviceruntime.googleapis.com/quota/limit é feita a cada 86.400 segundos (um dia).

O painel de registros informa uma consulta inválida

Você verá a mensagem de erro "Erro: consulta inválida" e o painel de registros não mostra nenhuma entrada de registro.

Para resolver esse problema, reduza o número de projetos cujos registros o painel de registros está configurado para exibir.

Para mais informações sobre essa condição de falha, consulte A consulta retorna um erro.

Nenhuma entrada foi encontrada no painel de registros

Você verá a mensagem de erro "Nenhuma entrada encontrada correspondente ao filtro atual" em um painel de registros. Essa mensagem pode ser exibida por vários motivos. Verifique se:

  • Para cada projeto com as entradas de registro que você quer ver, verifique se uma das seguintes condições é verdadeira:

    • Você tem o papel Visualizador de registros (roles/logging.viewer).

    • Para papéis personalizados, você tem as permissões a seguir:

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • Verifique se as cláusulas no editor de consultas não entram em conflito com as configurações mostradas no painel de registros.

    Por exemplo, quando o campo Editor de consultas contém severity=NOTICE, o painel de registros recupera todos os registros que têm um nível de gravidade exatamente NOTICE. Se o menu Gravidade do painel de registros estiver definido como "Aviso", o painel exibirá a mensagem "Nenhuma entrada encontrada que corresponda ao filtro atual". A mensagem é mostrada porque nenhuma das entradas de registro recuperadas tem um nível de gravidade de pelo menos "Aviso".

    Por outro lado, quando o campo Editor de consultas contém severity=WARNING e o menu Gravidade do painel de registros está definido como "Aviso", talvez você veja o registro entradas. Com essa configuração, o painel recupera registros com o nível de gravidade WARNING. Em seguida, essa lista de registros é filtrada para exibir apenas aqueles com gravidade de pelo menos "Aviso". Todos os registros recuperados têm pelo menos esse nível de gravidade.

O painel de registros indica que ele exibe dados parciais

Você verá um indicador de aviso e a mensagem "Mostrando resultados parciais" em um painel de registros.

Quando você não tem permissão para visualizar registros de um projeto do Google Cloud cujos registros você selecionou para exibir, este indicador é exibido. Para remover o indicador de alerta, siga um destes procedimentos:

  • Entre em contato com o administrador do sistema e peça que ele faça uma das seguintes ações para cada projeto do Google Cloud cujos registros você quer visualizar:

    • Conceda a você o papel de Visualizador de registros (roles/logging.viewer).

    • Para papéis personalizados, conceda a você as seguintes permissões:

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • Altere a configuração do painel de registros para mostrar os registros apenas de projetos do Google Cloud em que você tem permissão para visualizar as entradas de registro.

O painel de registros mostra a mensagem "Permissão negada"

O widget do painel de registros em um painel está mostrando a seguinte mensagem de negação de permissão:

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

Para resolver esse problema, faça o seguinte:

  1. Edite o widget do painel de registros.

  2. Escolha uma destas opções:

    • Defina o menu Escopo por como Projeto e use o menu Projetos para selecionar Projeto atual.

    • Remova do menu Visualizações de armazenamento as visualizações de registro que você não tem permissão para acessar. Para informações sobre os papéis do IAM necessários para acessar as visualizações de registro, consulte Conceder acesso a uma visualização de registro.

      Quando o widget do painel de registros pesquisa visualizações de registro, é necessário ter permissão para ler as entradas de registro em todas as visualizações de registro listadas. Caso contrário, uma mensagem de erro será exibida.

  3. Clique em Aplicar.

A tabela não mostra todas as séries temporais

Você configura uma tabela, mas ela não mostra todas as séries temporais.

Por motivos de desempenho, as tabelas são configuradas para mostrar no máximo 300 linhas.

Falha na chamada de API para criar um painel com um painel de registros

Há vários motivos para uma mensagem de erro ser exibida quando você cria um painel com um painel de registros:

  • Quando o painel de registros não atende aos requisitos mínimos de altura ou largura, o seguinte erro é exibido:

    Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.

    Para resolver essa condição, na representação JSON do painel, verifique se os campos height e width do widget de painel de registros atendem aos requisitos mínimos.

  • Quando o campo logsPanel.filter excede 2.000 caracteres, o seguinte erro é exibido:

    Unable to save dashboard: filter cannot be greater than 2000 characters.

    Para resolver essa condição, reduza o filtro.

  • Quando o campo resourceNames estiver ausente, você verá a seguinte mensagem de erro:

    Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.

    Para resolver essa condição, adicione um campo resourceNames ao JSON do painel.

  • Quando a sintaxe da resourceNames está incorreta, o seguinte erro é semelhante a este:

    Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`."

    Para resolver essa condição, substitua a-project por projects/a-project no JSON do painel.

  • Para informações sobre como resolver erros de sintaxe no campo filter, consulte Solução de problemas: problemas de sintaxe.

Para ver um exemplo de um arquivo JSON formatado corretamente, consulte Painel com um widget LogsPanel.

Como importar painéis do Grafana

Para informações sobre como usar e resolver problemas do importador de painel, consulte Importar painéis do Grafana para o Cloud Monitoring.

Para informações sobre problemas com a conversão do conteúdo do painel, consulte o arquivo README do importador.