Resolver problemas no Data Studio

Às vezes, o Data Studio mostra erros durante a geração de relatórios. Esses erros podem ocorrer por vários motivos, incluindo fontes de dados corrompidas, configurações de gráfico inadequadas ou cotas de plataforma excedidas. Entender esses erros comuns ajuda a resolver problemas nos relatórios.

Siga as etapas deste guia para investigar e corrigir problemas em gráficos, relatórios e fontes de dados.

Etapas gerais básicas

Problemas temporários de rede ou falhas no servidor podem causar problemas inesperados no Data Studio. Faça estas verificações rápidas antes de gastar tempo solucionando problemas de configurações complexas. Depois de cada etapa, confira se o problema foi resolvido.

Possíveis sintomas e mensagens de erro

As mensagens de erro são mostradas em fonte de código:

  • Páginas que não respondem
  • System error
  • Data Studio is not available

Etapas de resolução

  • Atualize a janela do navegador.
  • Limpe o cache e os cookies do navegador.
  • Reinicie o navegador da Web.
  • Tente usar outro navegador da Web.
  • Reinicie o computador.
  • Tente usar outro dispositivo, se houver um disponível.

Se essas etapas não resolverem o problema, aguarde alguns minutos e tente de novo. Se o problema persistir, verifique se outros usuários estão enfrentando problemas semelhantes no fórum da comunidade do Data Studio.

Problemas de acesso

Se você usa o Google Workspace ou o Cloud Identity, o administrador da sua organização precisa ativar o Data Studio antes de você acessá-lo. Da mesma forma, quando você compartilha relatórios com usuários de outra organização, o administrador dela precisa ativar o Data Studio para as contas deles.

Serviço desativado para sua conta

We are sorry, but you do not have access to this service. Please contact your Organization Administrator for access.

Etapas de resolução

Peça ao administrador da sua organização para ativar o Data Studio (saiba mais sobre os recursos corporativos).

Ao fazer login ou usar os recursos do Data Studio pela primeira vez, talvez você veja uma caixa de diálogo de consentimento do OAuth solicitando acesso à sua Conta do Google. Ao conceder esse consentimento, você autoriza o Data Studio a se comunicar de forma segura com as APIs Data subjacentes em seu nome.

Etapas de resolução

Clique em Continuar (ou Permitir) na caixa de diálogo para conceder as permissões necessárias. Você só precisa dar consentimento uma vez, a menos que revogue o acesso explicitamente.

Serviço desativado para um destinatário do relatório

Ao tentar compartilhar um relatório do Data Studio com outro usuário, talvez você receba a seguinte mensagem de erro:

You do not have access to Data Studio. To enable this service, please log in to the Admin console.

Causa: essa mensagem de erro indica que o destinatário não tem o serviço do Data Studio ativado na conta do Google Workspace ou do Cloud Identity. O administrador da organização desativou ou restringiu o Data Studio para o grupo.

Etapas de resolução

O destinatário precisa entrar em contato com o administrador da organização para solicitar acesso. Como remetente, você não pode corrigir esse problema porque o acesso depende das políticas de domínio do destinatário.

Problemas de conexão e fonte de dados

Os erros de conexão de dados ocorrem por vários motivos, incluindo falta de credenciais de dados, configurações corrompidas, fontes de dados excluídas ou permissões de acesso revogadas. Siga estas etapas para resolver problemas de conexão com seus dados.

Solução de problemas e erros específicos do conector

Se você encontrar erros em um conector de dados específico (como tempos limite de consulta, campos de mesclagem ambíguos ou limites de conjunto de dados), consulte o guia de solução de problemas desse conector:

  • Conector do BigQuery: consulte Resolver erros e limitações do conector do BigQuery para corrigir mesclagens de Field is ambiguous, erros de HTTP 504 Gateway timeout, limites de tabelas de conjuntos de dados (>5,000 tables), erros de criptografia (CMEK) de CONDITION_NOT_MET, conversões de TIME e erros de VPC Service Controls (VPC-SC) fora da VPN.
  • Conector do Looker: consulte Resolver problemas do conector do Looker para corrigir falhas de conexão e de Análise específicas do Looker.

Possíveis mensagens de erro

As mensagens de erro são mostradas em fonte de código:

  • Missing data source
  • Data set configuration error
  • No data set access
  • Data source not attached
  • Data source needs to be added
  • The underlying data has changed
  • Database connection error

Etapas de resolução

Falhas de e-mail programado ou alerta por trás do VPC Service Controls

Quando sua fonte de dados é protegida por um perímetro do VPC Service Controls (VPC-SC) usando níveis de acesso baseados em IP, os recursos automatizados em segundo plano podem falhar.

Possíveis sintomas e mensagens de erro incluem:

  • Os envios de e-mail programados contêm apenas um link para o relatório e não incluem o conteúdo do relatório ou anexos em PDF.
  • Os alertas de gráfico não são acionados ou param de enviar notificações.
  • Organization VPC Service Controls prohibit access to data set used by this component
  • Service Control Failure

Etapas de resolução

Como as tarefas em segundo plano automatizadas não são executadas em um endereço IP de usuário final, o VPC Service Controls bloqueia a solicitação. Para resolver esses erros, configure sua fonte de dados para usar credenciais de conta de serviço ou crie um nível de acesso que permita solicitações em segundo plano (saiba mais).

Problemas de configuração e no nível do gráfico

Os gráficos com configurações incompletas ou campos incompatíveis mostram erros. Você também pode encontrar erros de sintaxe de fórmula, como parênteses ausentes, nomes de função incorretos ou operadores inadequados. O Data Studio destaca a seção corrompida da fórmula.

Possíveis mensagens de erro

As mensagens de erro são mostradas em fonte de código:

  • System error
  • Chart configuration incomplete
  • Invalid combination of metrics and dimensions
  • Get report failed

Etapas de resolução

Sobre o erro Invalid combination of metrics and dimensions

Causa: esse erro ocorre quando o gráfico combina campos de uma maneira que não é compatível com a fonte de dados. Sistemas de back-end como o Google Analytics e o Google Ads armazenam dados em esquemas fixos que permitem que apenas dimensões e métricas específicas sejam consultadas juntas.

Dica: no caso do Google Analytics, use o Dimensions and Metrics Explorer para verificar as combinações compatíveis antes de adicionar campos ao gráfico.

Problemas de interface do usuário / funcionalidade

Se o Data Studio parar de funcionar corretamente ou de responder, as extensões ou os complementos do navegador podem estar causando o conflito.

Possíveis sintomas e mensagens de erro

As mensagens de erro são mostradas em fonte de código:

  • Recursos que não funcionam
  • Elementos da interface ausentes
  • O produto para de responder
  • Sorry! We can't save this report right now.

Etapas de resolução

  • Siga as etapas básicas descritas no início desta página.
  • Tente usar outro navegador da Web.
  • Desative as extensões e os complementos de terceiros do navegador.

Se isso resolver o problema, ative as extensões uma por uma para identificar qual delas está causando o conflito. Compartilhe sua descoberta nos fóruns do Looker.

Problemas de combinação

A maioria dos erros de combinação se enquadra em três categorias: mesclagens configuradas incorretamente, fontes de dados ausentes e resultados de combinação inesperados.

Erros de agrupamento configurado incorretamente

As mensagens de erro são mostradas em fonte de código:

  • One or more join configurations is incomplete.
  • One or more join configurations is missing a join condition.
  • Join key incomplete. Each selected data source must specify a join key field for every join key.
  • Um campo rosa Missing aparece dentro da condição de mesclagem.

Etapas de resolução

  • Edite a configuração de junção.
  • Verifique se todas as mesclagens na sua combinação têm uma condição e um operador válidos. As correlações (`CROSS JOIN`) não usam condições de mesclagem.
  • Para campos ausentes, remova o campo corrompido ou verifique se as duas tabelas mescladas compartilham as colunas de chave correspondentes.

Conexão ausente ou incorreta da fonte de dados

One or more tables is missing its data source.

Etapas de resolução

Reconecte todas as tabelas que estejam sem a fonte de dados na configuração da combinação.

Cota do Google Analytics 4 esgotada

Os relatórios que se conectam aos dados do Google Analytics 4 (GA4) estão sujeitos às cotas da API Data do GA4. Para monitorar o uso de tokens de cota no seu relatório, abra a caixa de diálogo Uso do token no Google Analytics.

Conferir o uso do token

  1. Edite seu relatório do Data Studio.
  2. Para saber o uso geral do token, clique com o botão direito do mouse na tela do relatório e selecione Uso do token no Google Analytics.
  3. Para verificar o uso de tokens em um gráfico específico, clique com o botão direito do mouse nele e selecione Uso do token no Google Analytics.

O resumo geral de uso mostra:

A caixa de diálogo "Uso do token no Google Analytics", que mostra o número de tokens de cota usados por todo o relatório

  • Os tokens de cota consumidos em todo o relatório ou na página atual durante sua sessão.
  • Os tokens de cota restantes antes de atingir o limite da API.
  • Os tokens de cota consumidos por cada gráfico, listados do maior para o menor.

O resumo de uso no nível do gráfico mostra:

A caixa de diálogo "Detalhes do uso do token no Google Analytics", que mostra o número de tokens de cota usados por cada gráfico

  • Os tokens de cota consumidos por cada solicitação de consulta.
  • O carimbo de data/hora exato de conclusão da consulta.
  • Se o gráfico foi carregado diretamente do GA4 ou do cache em memória. Uma marca de seleção verde indica que o gráfico foi carregado da memória sem consumir tokens. Um X vermelho indica que o gráfico consultou o GA4 diretamente (saiba mais sobre a atualização de dados).

Mensagens de erro de cota excedida

Os relatórios que excedem as cotas do GA4 mostram um dos seguintes erros:

  • Exhausted concurrent requests quota. Please send fewer requests concurrently.
  • This property has issued too many requests in the last day.
  • Too many requests using this Google Analytics property have encountered errors in the last hour.
  • This property has issued too many requests in the last hour.
  • This property is denied access to Google Analytics.
  • This property has issued too many potentially thresholded requests in the last hour.
  • This project/property has issued too many requests in the last hour.

Etapas de resolução

Se você exceder os limites de cota do GA4, use as seguintes técnicas para consultar menos dados do GA4 e confiar mais no cache do Data Studio:

  • Mude sua fonte de dados para as credenciais do proprietário. As credenciais do proprietário permitem que vários leitores de relatórios compartilhem os mesmos dados em cache sem consumir novos tokens de cota.
  • Consolide as fontes de dados duplicadas do GA4 em uma única fonte reutilizável. O compartilhamento de uma fonte de dados aumenta o armazenamento em cache em memória nos gráficos.
  • Reduza o tráfego de visitantes compartilhando o relatório com menos pessoas ou removendo relatórios incorporados de páginas da Web com alto tráfego.
  • Reduza o número de gráficos nas páginas do relatório.
  • Extraia seus dados do GA4 em um resumo dos relatórios estático. Aguarde até 24 horas para que as cotas excedidas sejam redefinidas antes de executar a extração.
  • Exporte seus dados do GA4 para o BigQuery e use o conector do BigQuery para se conectar ao conjunto de dados exportado.
  • Faça upgrade para o Analytics 360 para limites da API maiores.
  • Considere usar um conector de parceiro.

Estratégias para resolver problemas complexos

Para diagnosticar problemas complexos no Data Studio, primeiro identifique onde o problema ocorre. Reflita:

  • O problema está acontecendo em todos os seus relatórios ou apenas em um?
  • Isso afeta todos os tipos de gráfico ou apenas um componente específico?
  • Isso acontece em todos os navegadores da Web ou apenas em uma versão específica?

Confira também: O que você precisa para usar o Data Studio

Em seguida, reduza as variáveis. Isole o problema ao menor número possível de fatores simplificando o relatório ou os dados:

  • Isole problemas de dados: se você suspeitar de dados inválidos, aplique um filtro para ocultar metade das linhas. Se o erro desaparecer, os dados corrompidos estão na metade oculta. Se o erro persistir, os dados corrompidos estão na metade visível. Continue dividindo as linhas até localizar o registro incorreto.
  • Isolar problemas do gráfico: crie uma versão do gráfico com erro que tenha apenas uma dimensão e uma métrica. Adicione gradualmente os campos e as opções de estilo um por um até que o erro reapareça.

Informar um problema ao Google

Se não for possível resolver o problema depois de seguir essas etapas, informe isso ao Google. Esteja preparado para fornecer:

  • Uma descrição completa do problema
  • Etapas para reproduzir a falha
  • As mensagens de erro ou os IDs de erro que aparecem
  • Um link para um relatório de teste que demonstra o problema

Sobre os IDs de erro

Se você encontrar um ID de erro alfanumérico de 8 caracteres (Error ID: a1b2c3d4), inclua-o no relatório do bug. Os IDs de erro ajudam os engenheiros do Google a localizar o trace exato da falha nos registros do sistema. Os IDs de erro são gerados dinamicamente para cada evento de falha. Portanto, um novo ID é criado sempre que o erro ocorre.

Sobre os relatórios de teste

Ao compartilhar um relatório de teste com o Suporte do Google, mantenha-o o mais simples possível. Faça uma cópia do relatório original e exclua todas as páginas, gráficos e filtros não relacionados que não são necessários para reproduzir o bug.