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

Nesta seção, descrevemos os erros que podem ocorrer 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:

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 intervalo de tempo é modificado

Você adiciona um gráfico a um painel. Quando você altera o intervalo de tempo 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 vai ser listado como 1 minute interval. No entanto, se você mudar o intervalo de tempo de uma hora para um dia, o período de alinhamento vai ser listado como 5 minute interval.

Esse comportamento é esperado.

Os gráficos são limitados quanto ao número de pontos de dados que podem exibir. Portanto, quando o número de pontos de dados disponíveis para o intervalo de tempo selecionado é maior que o limite de exibição, o Monitoring modifica automaticamente as configurações de alinhamento para reduzir o número de pontos de dados a serem exibidos.

O gráfico não exibe dados

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

• Quando não houver dados disponíveis para o período especificado para o gráfico, a seguinte mensagem será 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 os que informam o uso de cota, fornecem apenas uma amostra por dia.

  • Mude o tipo de métrica selecionado para o 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 de recurso especificados na consulta estão definidos. Você pode usar a interface orientada por menu em gráficos para pesquisar 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 exibir 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 mapeados para o eixo Y esquerdo precisam ser as mesmas. Caso contrário, a mensagem de erro anterior será exibida. Da mesma forma, as unidades de todos os tipos de métrica mapeados ao 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):

Na captura de tela, há um título para cada tipo de métrica que é mostrado pelo gráfico.

Por exemplo, se você quiser que o gráfico mostre série temporal apenas para VMs que estão na zona us-central1-a, adicione o filtro zone = us-central1-a a cada consulta.

Não foi possível selecionar valores de filtro para gráficos definidos pelo MQL e pelo PromQL

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

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

Erros do painel

Nesta seção, descrevemos os erros que podem ocorrer ao criar painéis.

O painel não está exibindo todos os eventos

Você configura um painel para exibir eventos. No entanto, apenas eventos recentes são exibidos. Eventos mais antigos não são mostrados.

Para resolver esse problema, siga um destes procedimentos:

• Use um período mais curto. Por exemplo, mostre os 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 quanto ao número de eventos que podem ser exibidos. Quando esses limites são atingidos, os painéis exibem apenas os eventos mais recentes.

O gráfico de alertas não exibe dados

Um painel contém um gráfico de alertas, mas o gráfico de alertas não exibe dados.

Para resolver esse problema, tente o seguinte:

• Visualize a configuração do gráfico de alertas e selecione uma política de alerta. Se nenhuma política de alertas for exibida, associe o gráfico a uma política de alertas ou exclua esse gráfico do painel.

  Se um gráfico de alertas for adicionado a um painel e a política de alertas referenciada for excluída, o gráfico deixará de exibir dados. A exclusão de uma política de alertas não remove os gráficos que fazem referência a essa política.

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

  Se um gráfico de alertas for adicionado a um painel e a política de alertas referenciada for modificada para conter várias condições, o gráfico deixará de exibir dados. Para resolver essa condição, associe o gráfico de alertas a uma política de alertas de condição única ou exclua o gráfico de alertas do painel.

• Aumente o período. O seletor de intervalo de tempo 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 execute uma das seguintes ações para cada projeto do Google Cloud com registros que 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 apenas os registros de projetos do Google Cloud em que você tem permissão para visualizar as entradas de registro.

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 é mostrado:

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