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á.
# Trabalhar no Grafana versão 9
` ao final. Para visualizar períodos fiscais, use `fQ (fiscal quarter)` e unidades de tempo `fy (fiscal year)`.
O operador de mais permite que você avance no tempo, em relação ao agora. Por exemplo, você pode usar esse recurso para analisar dados previstos no futuro.
A tabela a seguir fornece exemplos de intervalos relativos.
| Exemplo de intervalo relativo | De | Para |
| --- | --- | --- |
| Últimos 5 minutos | `now-5m` | `now` |
| O dia até o momento | `now/d` | `now` |
| Esta semana | `now/w` | `now/w` |
| Esta semana até o momento | `now/w` | `now` |
| Este mês | `now/M` | `now/M` |
| Este mês até o momento | `now/M` | `now` |
| Mês anterior | `now-1M/M` | `now-1M/M` |
| Este ano até o momento | `now/Y` | `now` |
| Este ano | `now/Y` | `now/Y` |
| Ano fiscal anterior | `now-1y/fy` | `now-1y/fy` |
**nota**
O Grafana Alerting não é compatível com `now+n` para os carimbos de data e hora futuros e `now-1n/n` para os carimbos de data e hora do *início de n até o final de n.*
**Controles de intervalo de tempo comuns**
Os controles de tempo do painel e do dashboard têm uma interface de usuário comum. A seguir, descrevemos os controles comuns de intervalo de tempo.
+ O intervalo de tempo atual, também chamado de *seletor de tempo*, mostra o intervalo de tempo atualmente exibido no dashboard ou painel que você está visualizando. Passe o cursor sobre o campo para ver os carimbos de data e hora exatos no intervalo e sua origem (como o navegador local). Clique no *intervalo de tempo atual* para alterá-lo. Você pode alterar a hora atual usando um *intervalo de tempo relativo*, como os últimos 15 minutos ou um intervalo de tempo absoluto, como `2020-05-14 00:00:00` a `2020-05-15 23:59:59`.
+ O **intervalo de tempo relativo** pode ser selecionado na lista **Intervalos de tempo relativos**. Você pode filtrar a lista usando o campo de entrada na parte superior. Alguns exemplos de intervalos de tempo incluem: *Últimos 30 minutos*, *Últimas 12 horas*, *Últimos 7 dias*, *Últimos 2 anos*, *Ontem**, Anteontem*, *Este mesmo dia na semana passada*, *Hoje até o momento*, *Esta semana até o momento* e *Este mês até o momento*.
+ O **intervalo de tempo absoluto** pode ser definido de duas maneiras: digitando valores de tempo exatos ou valores de tempo relativo nos campos **De** e **Para** e clicando em **Aplicar intervalo de tempo**, ou clicando em uma data ou intervalo de datas no calendário exibido quando você clicar no campo **De** ou **Para**. Para aplicar suas seleções, clique em **Aplicar intervalo de tempo**.
*Outros recursos de intervalo de tempo*
1. Para reduzir, clique em **Cmd\$1Z** ou **Ctrl\$1Z**. Clique no ícone para ver um intervalo de tempo maior na visualização do painel ou dashboard.
1. Para usar o recurso de aumentar, clique e arraste para selecionar o intervalo de tempo na visualização que você deseja visualizar.
**nota**
O aumento é aplicável somente para visualizações de grafos.
*Atualizar dashboards*
Clique no ícone de **Atualizar dashboard** para executar imediatamente todas as consultas no dashboard e atualizar as visualizações. O Grafana cancela todas as solicitações pendentes quando você aciona uma atualização.
Por padrão, o Grafana não atualiza automaticamente o dashboard. As consultas são executadas em sua própria programação, de acordo com as configurações do painel. No entanto, se você quiser atualizar regularmente o dashboard, clique na seta para baixo ao lado do ícone **Atualizar dashboard** e selecione um intervalo de atualização.
**Controlar o intervalo de tempo usando um URL**
Você pode controlar o intervalo de tempo de um dashboard fornecendo os parâmetros de consulta a seguir no URL do dashboard.
+ `from` define o limite mínimo do intervalo de tempo, especificado em ms epoch, ou o [tempo relativo](#v9-dash-setting-dashboard-time-range).
+ `to` define o limite máximo do intervalo de tempo, especificado em ms epoch, ou o tempo relativo.
+ `time` e `time.window` definem um intervalo de tempo de `time-time.window/2` a `time+time.window/2`. Ambos os parâmetros devem ser especificados em ms. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de 10s de 1499999995000 a 1500000005000.
# Criar dashboards
** no canto superior direito.
**Restaurar para uma versão do dashboard salva anteriormente**
Caso precise restaurar para uma versão do dashboard salva anteriormente, você pode clicar no botão **Restaurar** à direita de uma linha na lista de versões do dashboard ou clicar no botão **Restaurar para versão ** que aparece na visualização de diferenças. Clicar no botão abrirá o pop-up a seguir solicitando que você confirme a restauração.
Depois de restaurar para uma versão anterior, uma nova versão será criada contendo exatamente os mesmos dados da versão anterior, somente com um número de versão diferente. Essa informação encontra-se na **coluna Notas** da linha na nova versão do dashboard. Isso é feito apenas para garantir que as versões anteriores do dashboard não sejam afetadas pela alteração.
# Gerenciar links do dashboard
=value.
**Exemplos**
As variáveis são listadas em listas suspensas na parte superior da tela. Selecione variáveis diferentes para ver como as visualizações mudam.
Para ver as configurações das variáveis, navegue até **Configurações do dashboard > Variáveis**. Clique em uma variável na lista para ver as configurações.
As variáveis podem ser usadas em títulos, descrições, painéis de texto e consultas. As consultas com texto que começam com `$` são modelos. Nem todos os painéis terão consultas de modelo.
**Práticas recomendadas de variáveis**
+ As listas suspensas de variáveis são exibidas na ordem em que estão listadas na lista de variáveis em **Configurações do dashboard**.
+ Coloque as variáveis que você alterará com frequência na parte superior, para que elas sejam mostradas primeiro (à esquerda no dashboard).
# Adicionar e gerenciar variáveis
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Produziria a seguinte lista suspensa:
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
Somente nomes de grupos de captura `text` e `value` são compatíveis.
##
}`: este formato lhe dá mais controle de como o Grafana interpreta valores. Para obter mais informações, consulte *Opções avançadas de formato de variáveis*.
+ `[[varname]]`: não use. Esta sintaxe é antiga e foi descontinuada. Ela será removida em uma versão futura.
Antes de as consultas serem enviadas à fonte de dados, a consulta é *interpolada*, o que significa que a variável é substituída por seu valor atual. Durante a interpolação, o valor da variável pode ser de *escape* para se adequar à sintaxe da linguagem de consulta e onde ela é usada. Por exemplo, uma variável usada em uma expressão regex em uma consulta do InfluxDB ou Prometheus terá escape regex.
**Opções avançadas de formato de variáveis**
A formatação da interpolação de variável depende da fonte de dados, mas há algumas situações em que talvez você queira alterar a formatação padrão.
Por exemplo, o padrão para a fonte de dados MySQL é unir vários valores separados por vírgula com aspas: `'server01','server02'`. Em alguns casos, você pode desejar ter uma string separada por vírgulas sem aspas: `server01,server02`. Você pode fazer isso acontecer com as opções avançadas de formatação de variáveis listadas abaixo.
**Sintaxe geral**
Sintaxe: `${var_name:option}`
Se alguma opção de formatação inválida for especificada, então será `glob` a default/fallback opção.
**CSV**
Formata variáveis com vários valores como uma string separada por vírgulas.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
**Distribuído - OpenTSDB**
Formata variáveis com vários valores em formato personalizado para OpenTSDB.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
**Doublequote**
Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `"` em cada valor por `\"` e cita cada valor com `"`.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
**Glob - Graphite**
Formata variáveis com vários valores em um glob (para consultas do Graphite).
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
**JSON**
Formata variáveis com vários valores como uma string separada por vírgulas.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene - Elasticsearch**
Formata variáveis com vários valores no formato Lucene para Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Percentencode**
Formata variáveis de valor único e de vários valores para uso em parâmetros de URL.
```
servers = [ 'foo()bar BAZ', 'test2' ]
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
**Barra vertical**
Formata variáveis com vários valores como uma string separada por barras verticais.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
**Bruto**
Desativa a formatação específica da fonte de dados, como aspas simples em uma consulta SQL.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
Formata variáveis com vários valores como uma string regex.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
**Singlequote**
Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `'` em cada valor por `\'` e cita cada valor com `'`.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
**Sqlstring**
Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `'` em cada valor por `''` e cita cada valor com `'`.
```
servers = [ "test'1", "test2" ]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
**Texto**
Formata variáveis de valor único e de vários valores em sua representação de texto. Para uma única variável, ele retornará apenas a representação do texto. Para variáveis de vários valores, ele retornará a representação de texto combinada com `+`.
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
**Parâmetros de consulta**
Formata variáveis de valor único e de vários valores como a representação de parâmetro de consulta. Exemplo: `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Avaliar uso do dashboard
** para a unidade personalizada que deve vir depois do valor.
+ **prefixo:** para a unidade personalizada que deve vir antes do valor.
+ **hora:** para formatos de data e hora personalizados, digite, por exemplo, **hora:DD-MM-AAA**. Consulte [formatos](https://momentjs.com/docs/#/displaying/) para ver a sintaxe e as opções de formato.
+ **si:** para unidades SI personalizadas. Por exemplo: **si: mF**. Este é um pouco mais avançado, pois você pode especificar uma unidade e a escala de dados de origem. Portanto, se seus dados de origem forem representados como mili (milhares de) de alguma coisa, prefixe a unidade com o caractere de escala SI.
+ **contagem:** para uma unidade de contagem personalizada.
+ **moeda:** para personalizar uma unidade monetária.
Você também pode colar um emoji nativo no seletor de unidades e selecioná-lo como uma unidade personalizada.
#### Unidades de string
[${__range_s}s]) != )
```
**Fontes de dados especiais**
O Grafana também inclui três fontes de dados especiais: **Grafana**, **Mista** e **Dashboard.** Para obter mais detalhes, consulte Fontes de dados
## Navegue pela guia de consulta
**: valor do rótulo para o URL. Se seu rótulo contiver pontos, use a sintaxe **\$1\$1field.labels[""]**.
## Variáveis de valor
/public/emails/ng_alert_notification.html`. Você pode editar esse arquivo para alterar o aspecto visual de todos os e-mails de alerta.
# Alertas sobre dados numéricos
auth =
}
```
## Provisionar pontos de contato e modelos
*Substitua pelo URL do webhook do Slack (ou outro contato)
Este exemplo cria um ponto de contato que envia notificações de alerta para o Slack.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
As políticas de notificação dizem ao Grafana como rotear instâncias de alerta, e não para onde. Elas conectam alertas disparados aos seus pontos de contato previamente definidos usando um sistema de rótulos e matchers.
**Para provisionar políticas de notificação e roteamento**
1. Copie esse bloco de código em um arquivo .tf na máquina local.
Neste exemplo, os alertas são agrupados por `alertname`, o que significa que todas as notificações provenientes de alertas que compartilham o mesmo nome são agrupadas na mesma mensagem do Slack.
Se quiser rotear notificações específicas de forma diferente, você pode adicionar subpolíticas. As subpolíticas permitem que você aplique o roteamento a diferentes alertas com base na correspondência de rótulos. Neste exemplo, aplicamos um tempo de desativação de áudio a todos os alertas com o rótulo a=b.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. No campo mute\$1timings, vincule um tempo de desativação de áudio à política de notificação.
1. Execute o comando `terraform apply`.
1. Acesse a interface de usuário do Grafana e verifique os detalhes da política de notificação.
**nota**
Você não pode editar recursos provisionados do Terraform na interface de usuário. Isso garante que a pilha de alertas esteja sempre sincronizada com o código.
1. Clique em **Testar** para verificar se o ponto de notificação está funcionando corretamente.
## Estipular tempos de desativação de áudio
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Você pode verificar se os recursos de alerta foram criados no Grafana.
**Para visualizar os recursos provisionados no Grafana**
1. Abra a instância do Grafana.
1. Navegue até Alertas.
1. Clique em uma pasta de recursos de alerta, por exemplo, Regras de alerta.
Os recursos provisionados são rotulados como **Provisionados**, para que fique claro que eles não foram criados manualmente.
**nota**
Você não pode editar recursos provisionados do Grafana. Você só pode alterar as propriedades do recurso alterando o arquivo de provisionamento e reiniciando o Grafana ou realizando uma recarga dinâmica. Isso evita que sejam feitas alterações no recurso que seriam substituídas se um arquivo fosse provisionado novamente ou se uma recarga dinâmica fosse realizada.
# Migrar alertas clássicos do dashboard para o Grafana Alerting