Conecte-se a uma fonte de dados do Snowflake

Com a fonte de dados do Snowflake Enterprise, você pode visualizar seus dados do Snowflake junto com todas as outras fontes de dados no Grafana, bem como dados de log e métricas no contexto. Essa fonte de dados inclui um poderoso editor de consultas de digitação antecipada, suporta anotações complexas, define limites de alerta, controla o acesso e as permissões e muito mais.

nota

Essa fonte de dados é somente para Grafana Enterprise. Para ter mais informações, consulte Gerencie o acesso aos plug-ins corporativos.

Além disso, em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode exigir a instalação do plug-in apropriado. Para ter mais informações, consulte Amplie seu espaço de trabalho com plug-ins.

Visão geral

O que é Snowflake?

A Snowflake oferece um serviço de análise e armazenamento de dados baseado em nuvem, geralmente denominado “dados warehouse-as-a-service”, que oferece uma solução para armazenamento de dados, lagos de dados, engenharia de dados, ciência de dados, desenvolvimento de aplicativos de dados e compartilhamento de dados. Nos últimos anos, o Snowflake ganhou enorme popularidade devido à sua capacidade de armazenar e analisar dados de forma econômica usando hardware e software baseados em nuvem; recentemente culminou no maior IPO de software de todos os tempos. Atualmente, muitas empresas usam o Snowflake como seu banco de dados principal para armazenar dados de aplicativos e negócios, como contagens de transações, sessões ativas de usuários e até mesmo dados métricos e de séries temporais.

Aproveitando ao máximo o Snowflake e o Amazon Managed Grafana

Visualize os dados do Snowflake sem movê-los: a arquitetura exclusiva do Grafana consulta os dados diretamente onde eles estão, em vez de movê-los e pagar por armazenamento e ingestão redundantes.

Componha painéis de várias fontes: com painéis pré-criados e personalizados, reúna dados de várias fontes de dados diferentes em um único painel.

Transforme e compute no nível do usuário: os usuários podem transformar dados e executar vários cálculos nos dados que veem, exigindo menos preparação de dados.

Combine, calcule e visualize em painéis: crie painéis de fontes de dados mistas que exibam dados relacionados do Snowflake e de outras fontes.

Atributos

Editor de consultas: o editor de consultas é um editor de preenchimento automático do Smart SQL que permite visualizar séries temporais ou dados de tabelas, lidar com erros de sintaxe SQL e preencher automaticamente palavras-chave SQL básicas.

Permissões da fonte de dados: controle quem pode visualizar ou consultar dados do Snowflake na Grafana

Anotações: sobreponha eventos do Snowflake em qualquer gráfico da Grafana para correlacionar eventos com outros dados gráficos

Alertas: defina lojas de métricas com base em alertas no Snowflake

Variáveis para consultas: Crie variáveis de modelo no Grafana com base nos dados do Snowflake e inclua variáveis nas consultas do Snowflake para criar painéis interativos.

Consultas multimétricas: escreva uma única consulta que retorne várias métricas, cada uma em sua própria coluna

Comece a usar o plug-in Snowflake

Aqui estão cinco etapas rápidas para começar a usar o plug-in Snowflake na Grafana:

Etapa 1: configurar a fonte de dados do Snowflake

Para configurar a fonte de dados, escolha Configuração, Fontes de dados, Adicionar fonte de dados, Snowflake.

Adicione seus detalhes de autenticação e a fonte de dados estará pronta para consulta!

Os seguintes campos de configuração estão disponíveis.

Nome	Descrição
Conta	Conta para Snowflake.
Nome de usuário	Nome de usuário da conta de serviço.
Senha	Senha da conta de serviço.
Esquema (opcional)	Define um esquema padrão para consultas.
Armazém (opcional)	Define um depósito padrão para consultas.
Banco de dados (opcional)	Define um banco de dados padrão para consultas.
Função (opcional)	Assume uma função para consultas.

Etapa 2: escrever consultas para seus dados do Snowflake

Crie um painel em um painel e selecione uma fonte de dados do Snowflake para começar a usar o editor de consultas.

• A data/hora pode aparecer em qualquer lugar na consulta, desde que esteja incluída.

• Uma coluna numérica deve ser incluída. Isso pode ser uma agregação ou uma coluna int/float.

• Opcionalmente, você pode incluir colunas de sequência de caracteres para criar séries de dados separadas, se os dados da série temporal estiverem formatados para métricas diferentes.

Layout de uma consulta do Snowflake

select
  <time_column>,
  <any_numerical_column>
  <other_column_1>,
  <other_column_2>,
  <...>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign

Formato de consulta SQL para grupo de séries temporais por intervalo

select
  $__timeGroup(created_ts, '1h'), // group time by interval of 1h
  <time_column>, 
  <any_numerical_column>,
  <metric_column>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
group by <time_column>

Formato de consulta SQL para tabelas

select
  <time_column>, // optional if result format option is table
  <any_column_1>
  <any_column_2>
  <any_column_3>
from
  <any_table>
where
  $__timeFilter(time_column) // macro for time range, optional if format as option is table
  and $<custom_variable> = 1 // custom variables start with dollar sign

Etapa 3: criar e usar variáveis de modelo

Usando variáveis de modelo

Você pode incluir variáveis de modelo nas consultas, conforme mostrado no exemplo a seguir.

 select
   <column>
 from 
   <table>
 WHERE column >= '$variable'

O exemplo a seguir mostra o uso de variáveis de vários valores em uma consulta.

select
  <column>
from 
  <table>
WHERE <column> regexp '${variable:regex}'

Usando a fonte de dados Snowflake para criar variáveis

Nas configurações do painel, escolha Variáveis e escolha Novo.

Usando o tipo de variável “Consulta”, selecione a fonte de dados do Snowflake como a “Fonte de dados”.

Importante

Certifique-se de selecionar somente uma coluna em sua consulta variável.

Exemplo:

SELECT DISTINCT query_type from account_usage.query_history;

fornecerá essas variáveis:

All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW

Etapa 4: configurar um alerta

Você pode definir alertas sobre métricas específicas do Snowflake ou sobre consultas que você criou.

Escolha o botão da guia de alerta no editor de consultas e escolha Criar alerta.

Etapa 5. Crie uma anotação

As anotações permitem que você sobreponha eventos em um gráfico.

Para criar uma anotação, nas configurações do painel, escolha Anotações e Novo e selecione Snowflake como fonte de dados.

Como as anotações são eventos, elas exigem pelo menos uma coluna de tempo e uma coluna para descrever o evento.

O código de exemplo a seguir mostra uma consulta para anotar todos os logins com falha no Snowflake.

SELECT
  EVENT_TIMESTAMP as time,
  EVENT_TYPE,
  CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;

E

• hora: TIME

• título: EVENT_TYPE

• texto: CLIENT_IP

Isso sobreporá as anotações de todos os logins com falha no Snowflake nos painéis do seu painel.

Funcionalidade adicional

Usando o campo Nome de exibição

Esse plug-in usa o campo Nome de exibição na guia Campo do painel Opções para encurtar ou alterar uma chave de legenda com base em seu nome, rótulos ou valores. Outras fontes de dados usam a alias funcionalidade personalizada para modificar as teclas de legenda, mas a função Nome de exibição é uma forma mais consistente de fazer isso.

Permissões da fonte de dados

Limite o acesso ao Snowflake escolhendo a guia Permissões na página de configuração da fonte de dados para ativar as permissões da fonte de dados. Na página de permissões, os administradores podem ativar permissões e restringir as permissões de consulta a usuários e equipes específicos.

Entenda seus dados de faturamento e uso do Snowflake

Na fonte de dados do Snowflake, você pode importar um painel de faturamento e uso que mostra informações úteis de faturamento e uso.

Adicione o painel na página de configuração da fonte de dados do Snowflake:

Esse painel usa o banco de dados ACCOUNT_USAGE e exige que o consultor tenha a função ACCOUNTADMIN. Para fazer isso com segurança, crie uma nova fonte de dados Grafana que tenha um usuário com a função ACCOUNTADMIN. Em seguida, selecione essa fonte de dados nas variáveis.