Usar 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 está definida naAWSpolítica gerenciada: AmazonGrafanaRedshiftAccess seção.

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 carimbo de data/hora UNIX e renomear a coluna para hora	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()	$__timeFromgera 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 registros de data e 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 fornecido$__schema (ela usa o esquema público por padrão)	sales
$__column	$__columngera uma coluna da corrente$__table	date
$__unixEpochFilter(column)	$__unixEpochFilterser substituído por um filtro de intervalo de tempo usando o nome da coluna especificado 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 carimbo de data/hora 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 do. Se puder ser consultado, ele poderá ser colocado em uma tabela.

Este exemplo retorna resultados para 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, há alguns requisitos:

• Uma coluna com umdatetime tipodate ou deve ser selecionada.

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

• Você deve selecionar uma coluna numérica do.

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

Exemplo de consulta de séries temporais:

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

O Grafana também preenche automaticamente os 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 visualizar a consulta interpolada completa, escolha o menu Inspector de consulta e a consulta completa ficará 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, consulteAdicionar 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. Certifique-se de evitar 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 usandoSintaxe de variáveis. 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 dos 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 as anotações:

Name (Nome)	Descrição
Time	O nome do campo de data ou hora. Pode ser uma coluna com um tipo de dados nativo de data ou hora do SQL 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 nativo de data ou hora do SQL 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.