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á.
Usar a fonte de dados Amazon Redshift
Políticas do IAM
O Grafana precisa de permissões concedidas por meio do IAM para poder ler as métricas do Redshift. Você pode anexar essas permissões aos perfis do IAM e usar o suporte integrado do Grafana para assumir perfis. A política de acesso integrada do Amazon Grafana Redshift é definida na seção AWS política gerenciada: AmazonGrafanaRedshiftAccess .
Consultar dados no Amazon Redshift
A fonte de dados Amazon Redshift fornece um editor de consultas SQL padrão. O Amazon Managed Grafana inclui alguns macros para ajudar a escrever consultas de séries temporais mais complexas.
Macros
| Macro | Descrição | Exemplo de saída | 
|---|---|---|
| $__timeEpoch(column) | $__timeEpochserá substituído por uma expressão para converter em um carimbo de data e hora do Unix e renomear a coluna para tempo | 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() | $__timeToexibe a hora de término atual do intervalo do painel com aspas | '2017-07-18T11:15:52Z' | 
| $__timeGroup(column, '1m') | $__timeGroupagrupa carimbos de data e hora para que haja apenas um ponto para cada período no grafo | floor(extract(epoch from time)/60)*60 AS
                                "time" | 
| $__schema | $__schema usa o esquema selecionado | public | 
| $__table |  $__tableexibe uma tabela do$__schemafornecido (ele usa o esquema público por padrão) | sales | 
| $__column | $__columnexibe uma coluna da$__tableatual | date | 
| $__unixEpochFilter(column) | $__unixEpochFilterserá substituído por um filtro de intervalo de tempo usando o nome da coluna especificada com os tempos representados como carimbo de data e hora do Unix |  column >= 1624406400 AND column <= 1624410000
                                 | 
| $__unixEpochGroup(column) | $__unixEpochGroupé o mesmo que$__timeGroup, mas para tempos armazenados como carimbo de data e hora do 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 pode ser consultado, então pode 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 grafos
Para visualizações de séries temporais e grafos, existem alguns requisitos:
- 
                    Uma coluna com uma dateou um tipo dedatetimedeve ser selecionada.
- 
                    A coluna datedeve estar em ordem crescente (usandoORDER BY column ASC).
- 
                    Você deve selecionar uma coluna numérica. 
Para criar um grafo mais razoável, certifique-se de usar os macros $__timeFilter e $__timeGroup.
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
O 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.
Inspecionar a consulta
Como o Grafana é compatível com macros que o Redshift não é, a consulta totalmente renderizada, que pode ser copiada e colada diretamente no Redshift, fica visível no Inspetor de consultas. Para visualizar a consulta interpolada completa, escolha o menu Inspetor de consultas 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 Adicionar uma variável de consulta.. Use a fonte de dados 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 performance.
Depois de criar uma variável, você poderá usá-la em suas consultas do Redshift usando Sintaxe da variável. Para obter mais informações sobre variáveis, consulte Modelos e variáveis.
Anotações
As Anotações permitem que você sobreponha informações importantes de eventos nos grafos. Você pode adicionar anotações selecionando o painel ou adicionando consultas de anotações usando a visualização Anotações, aberta no menu Dashboard.
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 | 
|---|---|
|  | O nome do campo de data e hora. Pode ser uma coluna com uma data SQL nativa, um tipo de dados de hora ou um valor epoch. | 
|  | Nome opcional do campo de data ou hora de término. Pode ser uma coluna com uma data SQL nativa, um tipo de dados de hora ou um valor epoch. | 
|  | Campo de descrição do evento. | 
|  | Nome de campo opcional a ser usado para tags de eventos como uma string separada por vírgula. |