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á.
# Dashboards 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