Google BigQuery - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Google BigQuery

Fornece suporte para o Google BigQuery como banco de dados de back-end.

nota

O Amazon Managed Grafana inclui duas fontes de dados diferentes para BigQuery. A fonte de dados atual é do Grafana Labs. Uma fonte de dados mais antiga, que não tem mais suporte ativo, é da DoIT International. Novas fontes de dados devem usar a fonte de dados fornecida pelo Grafana Labs. Para saber mais sobre como migrar suas consultas existentes, consulteImportando consultas criadas com o BigQuery DataSource plug-in DoIT International.

Recursos:

  • Configuração da consulta

  • Editor SQL Raw

  • Criador de consultas

  • Suporte a macros

  • Funções adicionais

  • Visualização da tabela

  • Anotações

  • Consultas BQ em variáveis

  • Tabelas fragmentadas

  • Tabelas particionadas

  • Alocação granular de slots (execução de consultas em um projeto com preço fixo)

Adicionar a fonte de dados

  1. Abra o console do Grafana no espaço de trabalho Amazon Managed Grafana e verifique se você está logado.

  2. No menu lateral em Configuração (o ícone de engrenagem), escolha Fontes de dados.

  3. Escolha Adicionar fonte de dados.

    nota

    Se você não vê o link Fontes de dados no menu lateral, isso significa que seu usuário atual não tem aAdmin função.

  4. Selecione Google BigQueryby Grafana Labs na lista de fontes de dados.

  5. Insira as seguintes informações:

    • Em Nome, insira o nome da fonte de dados.

    • O padrão significa que ele será pré-selecionado para novos painéis.

    • Em Chave da conta de serviço, insira o arquivo de chave da conta de serviço para um projeto do GCP. As instruções sobre como criar isso estão mais adiante neste documento.

Você pode definir a prioridade da consultaINTERACTIVE ouBATCH por fonte de dados.

Autenticação

Para autenticar o BigQuery plug-in, faça o upload de um arquivo JWT do Google. Você precisa criar uma conta de serviço do Google Cloud Platform (GCP) para o projeto do qual deseja mostrar dados. Uma fonte de dados Amazon Managed Grafana se integra a um projeto do GCP. Se quiser visualizar dados de vários projetos do GCP, você pode conceder permissões à conta de serviço em cada projeto ou criar uma fonte de dados por projeto do GCP.

Habilitar APIs

Vá para BigQuery API e habilite a API.

Criar uma conta de serviço do GCP para um projeto

Para criar uma conta de serviço do GCP para um projeto
  1. Navegue até a página de credenciais de API e serviço.

  2. Escolha Criar credenciais e escolha Chave da conta de serviço.

  3. Na página Criar chave da conta de serviço, escolha o tipo de chave JSON. Em seguida, no menu suspenso Conta de serviço, escolha a opção Nova conta de serviço.

  4. Insira um nome para a conta de serviço no campo Nome da conta de serviço e escolha as funções Visualizador deBigQuery dados e Usuário deBigQuery Job no menu suspenso Função.

  5. Escolha Create (Criar). Um arquivo de chave JSON é criado e baixado para o seu computador. Armazene esse arquivo em um local seguro, pois ele permite o acesso aos seus BigQuery dados.

  6. Faça o upload para o Amazon Managed Grafana na página de configuração da fonte de dados. Você pode fazer o upload do arquivo ou colar em seu conteúdo.

  7. O conteúdo do arquivo é criptografado e salvo no banco de dados Grafana. Não se esqueça de salvar depois de fazer o upload do arquivo.

Usando o construtor de consultas

O criador de consultas fornece uma interface simples, mas fácil de usar, para ajudá-lo a redigir rapidamente uma consulta. O construtor permite que você defina as partes básicas da sua consulta. As mais comuns são:

  • A tabela da qual você deseja consultar

  • O campo de tempo e o campo métrico

  • Cláusula WHERE: use uma das macros predefinidas para acelerar seu tempo de escrita ou configure sua própria expressão. As macros compatíveis existentes são as seguintes:

    • Exemplo de macro $__timeFiler com os últimos 7 dias

      WHERE `createDate` BETWEEN TIMESTAMP_MILLIS (1592147699012) AND TIMESTAMP_MILLIS (1592752499012) AND _PARTITIONTIME >= '2020-06-14 18:14:59' AND _PARTITIONTIME < '2020-06-21 18:14:59'
    • Exemplo de macro $__timeFrom com os últimos 7 dias

      WHERE `createDate` > TIMESTAMP_MILLIS (1592223758609) AND _PARTITIONTIME >= '2020-06-15 15:22:38' AND _PARTITIONTIME < '2020-06-22 15:22:38'
    • Macro $__timeTo com os últimos 7 dias

      WHERE `createDate` < TIMESTAMP_MILLIS (1592828659681) AND _PARTITIONTIME >= '2020-06-15 15:24:19' AND _PARTITIONTIME < '2020-06-22 15:24:19'
  • Opção GROUPBY: você pode usar uma macro predefinida ou usar um dos campos da sua consulta a. time ($_interval, none)

  • Opção ORDER BY

nota

Nota: Se seu local de processamento não for o padrão dos EUA, defina-o no menu suspenso Local de processamento na parte superior direita e inferior do criador de consultas

Solução de problemas

Para solucionar problemas de uma consulta, use o Inspector de consultas na parte superior do criador de consultas. Isso ajuda você a ver a consulta limpa e a solucionar erros de SQL.

Importando consultas criadas com o BigQuery DataSource plug-in DoIT International

Se você tiver consultas existentes que usam o BigQuery plug-in DoIT International, você pode importá-las alterando a fonte de dados para Grafana BigQuery. Suas consultas serão importadas como consultas SQL brutas.