Usando a fonte de dados do Amazon Redshift

Políticas do IAM

O Grafana precisa de permissões concedidas usando o IAM para poder ler as métricas do Redshift. Você pode anexar essas permissões às funções do IAM e utilizar o suporte integrado do Grafana para assumir funções. A política de acesso integrada do Amazon Grafana Redshift é definida na seção. AWSpolítica gerenciada: AmazonGrafanaRedshiftAccess

Consulte dados do Amazon Redshift

A fonte de dados do Amazon Redshift fornece um editor de consultas SQL padrão. O Amazon Managed Grafana inclui algumas macros para ajudar a escrever consultas de séries temporais mais complexas.

Macros

Macro	Descrição	Exemplo de saída
$__timeEpoch(column)	$__timeEpochserá substituída por uma expressão para converter em um timestamp UNIX e renomear a coluna para time	UNIX_TIMESTAMP(dateColumn) as "time"
$__timeFilter(column)	$__timeFiltercria uma condicional que filtra os dados (usandocolumn) com base no intervalo de tempo do painel	time BETWEEN '2017-07-18T11:15:52Z' AND '2017-07-18T11:15:52Z'
$__timeFrom()	$__timeFromexibe a hora de início atual do intervalo do painel com aspas	'2017-07-18T11:15:52Z'
$__timeTo()	$__timeTogera a hora de término atual do intervalo do painel com aspas	'2017-07-18T11:15:52Z'
$__timeGroup(column, '1m')	$__timeGroupagrupa carimbos de data/hora para que haja apenas 1 ponto para cada período no gráfico	floor(extract(epoch from time)/60)*60 AS "time"
$__schema	$__schema usa o esquema selecionado	public
$__table	$__tablegera uma tabela a partir do dado $__schema (ele usa o esquema público por padrão)	sales
$__column	$__columnproduz uma coluna a partir da corrente $__table	date
$__unixEpochFilter(column)	$__unixEpochFilterser substituído por um filtro de intervalo de tempo usando o nome da coluna especificada com horários representados como timestamp Unix	column >= 1624406400 AND column <= 1624410000
$__unixEpochGroup(column)	$__unixEpochGroupé o mesmo que, $__timeGroup mas para horários armazenados como timestamp Unix	floor(time/60)*60 AS "time"

Visualização

A maioria das consultas no Redshift é melhor representada por uma visualização de tabela. Qualquer consulta exibirá dados em uma tabela. Se puder ser consultado, ele poderá ser colocado em uma tabela.

Este exemplo retorna os resultados de uma visualização de tabela:

SELECT {column_1}, {column_2} FROM {table};

Visualizações de séries temporais e gráficos

Para visualizações de séries temporais e gráficos, existem alguns requisitos:

• Uma coluna com um date ou um datetime tipo deve ser selecionada.

• A date coluna deve estar em ordem crescente (usandoORDER BY column ASC).

• Você deve selecionar uma coluna numérica.

Para criar um gráfico mais razoável, certifique-se de usar as $__timeFilter $__timeGroup macros e.

Exemplo de consulta de série temporal:

SELECT
  avg(execution_time) AS average_execution_time,
  $__timeGroup(start_time, 'hour'),
  query_type
FROM
  account_usage.query_history
WHERE
  $__timeFilter(start_time)
group by
  query_type,start_time
order by
  start_time,query_type ASC;

Modo de preenchimento

Grafana também preenche automaticamente quadros sem um valor com algum padrão. Para configurar esse valor, altere o Valor de preenchimento no editor de consultas.

Inspecionando a consulta

Como o Grafana suporta macros que o Redshift não suporta, a consulta totalmente renderizada, que pode ser copiada e colada diretamente no Redshift, fica visível no Inspector de Consultas. Para ver a consulta interpolada completa, escolha o menu Inspector de Consulta e a consulta completa estará visível na guia Consulta.

Modelos e variáveis

Para obter mais informações sobre como adicionar uma nova variável de consulta do Redshift, consulte. Adicionando uma variável de consulta Use sua fonte de dados do Redshift como fonte de dados para as consultas disponíveis.

Qualquer valor consultado em uma tabela do Amazon Redshift pode ser usado como uma variável. Evite selecionar muitos valores, pois isso pode causar problemas de desempenho.

Depois de criar uma variável, você pode usá-la em suas consultas do Redshift usando. Sintaxe variável Para obter mais informações sobre variáveis, consulteModelos e variáveis.

Anotações

Anotaçõespermite que você sobreponha informações ricas sobre eventos em cima de gráficos. Você pode adicionar anotações selecionando o painel ou adicionando consultas de anotações usando a visualização Anotações, aberta no menu Painel.

Exemplo de consulta para adicionar anotações automaticamente:

SELECT
  time as time,
  environment as tags,
  humidity as text
FROM
  $__table
WHERE
  $__timeFilter(time) and humidity > 95

A tabela a seguir representa os valores das colunas consideradas para renderizar anotações:

Nome	Descrição
Time	O nome do campo de data ou hora. Pode ser uma coluna com um tipo de dados SQL nativo de data ou hora ou valor de época.
Timeend	Nome opcional do campo de data ou hora de término. Pode ser uma coluna com um tipo de dados SQL nativo de data ou hora ou valor de época.
Text	Campo de descrição do evento.
Tags	Nome de campo opcional a ser usado para tags de eventos como uma string separada por vírgula.