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 de gráfico

Esta seção descreve erros que podem ocorrer durante a configuração de 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 é alterado quando o intervalo de tempo é modificado

Você adiciona um gráfico a um painel. Quando você altera o período do gráfico, às vezes, o período de alinhamento muda. Por exemplo, se você alterar de uma hora a duas horas, o período de alinhamento é listado como 1 minute interval: No entanto, se você alterar 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 nas e o número de pontos de dados que podem ser mostrados. Portanto, quando o número de pontos de dados disponíveis para o período selecionado é maior do que o o limite de exibição, o Monitoring modifica automaticamente o 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 é exibida:

    No data is available for the selected time frame.

    Para resolver o problema, tente o seguinte:

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

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

  • Quando o tipo de métrica ou de recurso especificado pela consulta reconhecido, verá a seguinte mensagem:

    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 são definidas. Você pode usar a interface orientada por menus para gráficos procure o tipo de métrica.

    • Verifique se o tipo de métrica e o tipo de recurso estão corretos no 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étrica, e é possível mapear um tipo de métrica para à esquerda ou à direita. As unidades de todos os tipos de métricas mapeado para o eixo Y à esquerda deve ser o mesmo; caso contrário, o erro anterior é exibida. Da mesma forma, as unidades de todas os tipos de métrica mapeados para o eixo Y à direita precisam ser iguais ou o erro anterior é exibida.

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 de Metrics Explorer com dois tipos de métricas.

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

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

Não foi 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 linguagem de consulta do Monitoring (MQL, na sigla em inglês) ou com PromQL. Em seguida, você cria filtros permanentes do painel. Quando você visualiza o painel, tenta alterar o valor padrão de o filtro, mas o menu de valores de rótulo não é exibido ou o menu de valores de rótulo não está correto:

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

Para resolver esse problema, digite 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 você pode encontrar ao criar painéis.

O painel não está exibindo todos os eventos

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

Para resolver esse problema, siga um destes procedimentos:

  • Use um período mais curto. Por exemplo, exibir os dados do período mais recente hora 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 que eles podem exibir. Quando esses limites são atingidos, os painéis exibir apenas os eventos mais recentes.

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 exibir quaisquer dados.

Para resolver esse problema, tente o seguinte:

  • Visualize a configuração do gráfico e garanta que um alerta é selecionada. Se nenhuma política de alertas for mostrado, associe o gráfico a uma política de alertas ou excluir o gráfico do painel.

    gráficos em painéis que mostram dados de uma parada da política de alertas. exibir dados quando a política de alertas referenciada for excluída. A exclusão de uma política de alertas não remove os gráficos que se referem a ela.

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

    Os gráficos em painéis que mostram dados de uma política de alertas deixam de ser exibidos se a política de alertas for modificada para conter várias condições. Para resolver essa condição, associar o gráfico a uma política de alertas de condição única ou excluir o gráfico do painel.

  • Aumente o período. O seletor de intervalo de tempo deve ser definido como maior do 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 realize uma das seguintes ações Para cada projeto do Google Cloud cujos registros você quer ver:

    • 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

  • Alterar a configuração do painel de registros para exibir registros apenas para Projetos do Google Cloud em que você tem permissão para visualizar as entradas de registro.

O painel de registros exibe a mensagem de permissão negada

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

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

Para resolver esse problema, faça o seguinte:

  1. Editar o widget do painel de registros.

  2. Siga uma das seguintes ações:

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

    • Remova do menu Visualizações de armazenamento as que não estão incluídas. permissão para visualizar. Para informações sobre papéis do IAM necessárias para acessar as visualizações de registros, consulte Conceda acesso a uma visualização de registros.

      Quando o widget do painel de registros pesquisa visualizações de registros, você precisa ter permissão para ler entradas de registro em todas as visualizações de registro listadas. Caso contrário, uma mensagem de erro vai aparecer.

  3. Clique em Aplicar.

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 exceder 2.000 caracteres, o seguinte é 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 painéis, 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.