Tipos de variáveis - Amazon Managed Grafana

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

Tipos de variáveis

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 8.x do Grafana.

Para espaços de trabalho do Grafana compatíveis com a versão 9.x do Grafana, consulteTrabalhando na versão 9 do Grafana.

O Grafana usa vários tipos de variáveis.

Tipo de variável Descrição
Query Lista de valores gerada por consultas, como nomes de métricas, nomes de servidores, IDs de sensores, data centers e assim por diante. Para obter mais informações, consulte Adicionar uma variável de consulta.
Personalizar Defina as opções de variáveis manualmente usando uma lista separada por víulas. Para obter mais informações, consulte Como adicionar uma variável personalizada.
Text box (Caixa de texto) Exiba um campo de entrada de texto com um valor padrão opcional. Para obter mais informações, consulte Adicionar uma variável de caixa de texto.
Constante Defina uma constante oculta. Para obter mais informações, consulte Adicionar uma variável constante.
Fonte de dados Altere rapidamente a fonte de dados de um painel inteiro. Para obter mais informações, consulte Como adicionar uma variável de fonte de dados.
Intervalo As variáveis de intervalo representam períodos de tempo. Para obter mais informações, consulte Adicionar uma variável de intervalo.
Filtros ad hoc Filtros de chave/valor que são adicionados automaticamente a todas as consultas métricas de uma fonte de dados (InfluxDB, Prometheus e OpenSearch somente). Para obter mais informações, consulte Adicionar filtros ad hoc.
Variáveis globais Variáveis integradas que podem ser usadas em expressões no editor de consultas. Para obter mais informações, consulte Variáveis globais.
Variáveis em cadeia As consultas de variáveis podem conter outras variáveis. Para obter mais informações, consulte Variáveis em cadeia.

Adicionar uma variável de consulta

Usando variáveis de consulta, você pode escrever uma consulta de fonte de dados que retorna uma lista de nomes de métricas, valores de tags ou chaves. Por exemplo, uma variável de consulta pode retornar uma lista de nomes de servidores, IDs de sensores ou data centers. Os valores das variáveis mudam à medida que elas buscam opções dinamicamente com uma consulta à fonte de dados.

As expressões de consulta podem conter referências a outras variáveis e, na verdade, criar variáveis vinculadas. O Grafana detecta isso e atualiza automaticamente uma variável quando uma de suas variáveis vinculadas é alterada.

Expressões de consulta

As expressões de consulta são diferentes para cada fonte de dados. Para obter mais informações, consulte a documentação de sua fonte de dados emFontes de dados.

Inserindo opções gerais

Para inserir opções gerais para uma variável de consulta
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Consulta.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Inserindo opções de consulta

Para inserir opções de consulta para uma variável de consulta
  1. Na lista Fonte de dados, selecione a fonte de dados de destino para a consulta. Para obter mais informações sobre fontes de dados, consulteFontes de dados.

  2. Na lista Atualizar, selecione quando a variável deve atualizar as opções.

    • Nunca - armazena em cache consultas de variáveis e os valores não são atualizados. Isso é bom se os valores nunca mudarem, mas problemático se eles forem dinâmicos e mudarem muito.

    • No carregamento do painel - consulta a fonte de dados toda vez que o painel é carregado. Isso retarda o carregamento do painel, porque a consulta da variável deve ser concluída antes que o painel possa ser inicializado.

    • Sobre alteração do intervalo de tempo - consulta a fonte de dados quando o intervalo de tempo do painel muda. Use essa opção somente se sua consulta de opções variáveis contiver um filtro de intervalo de tempo ou depender do intervalo de tempo do painel.

  3. No campo Consulta, insira uma consulta.

    • O campo de consulta varia de acordo com a sua origem dos dados. Algumas fontes de dados têm editores de consulta personalizados.

    • Se você precisar de mais espaço em um único editor de consulta de campo de entrada, pause nas linhas no canto inferior direito do campo e arraste para baixo para expandir.

  4. (Opcional) No campo Regex, digite uma expressão regex para filtrar ou capturar partes específicas dos nomes retornados pela consulta da fonte de dados. Para ver exemplos, consulte Filtrando variáveis com regex.

  5. Na lista de classificação, selecione a ordem de classificação dos valores a serem exibidos na lista suspensa. A opção padrão, Desativado, significa que a ordem das opções retornadas pela consulta da fonte de dados será usada.

  6. (Opcional) Insira Opções de seleção. Para obter mais informações, consulte Inserindo opções de seleção de variáveis.

  7. Em Visualização de valores, o espaço de trabalho Grafana exibe uma lista dos valores das variáveis atuais. Os revise para garantir que eles correspondam ao que você espera.

  8. Escolha Adicionar para adicionar a variável ao painel.

Como adicionar uma variável personalizada

Use uma variável personalizada para valores que não mudam. Isso pode ser números, sequências de caracteres ou até mesmo outras variáveis.

Por exemplo, se você tiver nomes de servidor ou nomes de regiões que não mudam, você pode criá-los como variáveis personalizadas em vez de variáveis de consulta. Como elas não mudam, você pode usá-las em variáveis em cadeia em vez de outras variáveis de consulta. Isso reduziria o número de consultas que o Grafana deve enviar quando as variáveis em cadeia são atualizadas. Para obter mais informações sobre variáveis em cadeia, consulteVariáveis em cadeia.

Inserindo opções gerais

Para inserir opções de consulta para uma variável personalizada
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, escolha Personalizado.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo ‐ O menu suspenso da lista de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Como inserir opções personalizadas

Para inserir opções personalizadas para uma variável personalizada
  1. Na lista Valores separados por vírgula, insira os valores dessa variável em uma lista separada por vírgula. Você pode incluir números, cadeias de caracteres, outras variáveis ou pares de valores-chave separados por dois pontos.

  2. (Opcional) Insira Opções de seleção. Para obter mais informações, consulte Inserindo opções de seleção de variáveis.

  3. Em Visualização de valores, o espaço de trabalho Grafana exibe uma lista dos valores das variáveis atuais. Os revise para garantir que eles correspondam ao que você espera.

  4. Escolha Adicionar para adicionar a variável ao painel.

Adicionar uma variável de caixa de texto

As variáveis da caixa de texto exibem um campo de entrada de texto com um valor padrão opcional. Essa é a variável mais flexível, pois você pode inserir qualquer valor. Use esse tipo de variável se você tiver métricas com alta cardinalidade ou se quiser atualizar vários painéis em um painel ao mesmo tempo.

Inserindo opções gerais

Para inserir opções gerais para uma variável de caixa de texto
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Caixa de texto.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Inserindo opções de texto

Para inserir opções de texto para uma variável de caixa de texto
  1. (Opcional) No campo Valor padrão, selecione o valor padrão para a variável. Se você não inserir nada nesse campo, o Grafana exibirá uma caixa de texto vazia na qual você pode digitar texto.

  2. Em Pré-visualização de valores, o Grafana exibe uma lista dos valores das variáveis atuais. Os revise para garantir que eles correspondam ao que você espera.

  3. Escolha Adicionar para adicionar a variável ao painel.

Adicionar uma variável constante

Para definir uma constante oculta, use variáveis constantes. Variáveis constantes são úteis para prefixos de caminhos métricos para painéis que você deseja compartilhar. Quando você exporta um painel, as variáveis constantes são convertidas em opções de importação.

Variáveis constantes não são flexíveis. Cada variável constante contém apenas um valor. Para atualizá-lo, você deve atualizar as configurações das variáveis.

Variáveis constantes são úteis quando você tem valores complexos que devem ser incluídos nas consultas, mas não querem redigitar em cada consulta. Por exemplo, se você tivesse um caminho de servidor chamadoi-0b6a61efe2ab843gg, você poderia substituí-lo por uma variável chamada$path_gg.

Inserindo opções gerais

Para inserir opções gerais para uma variável constante
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Constante.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel. Esse é o padrão.

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

Inserindo opções constantes

Para inserir opções constantes para uma variável constante
  1. No campo Valor, insira o valor da variável. Você pode inserir letras, números e símbolos. Se você usar opções avançadas de formato variável, você pode até mesmo usar curingas. Para obter mais informações, consulte Opções de formato de variáveis avançadas.

  2. Em Pré-visualização de valores, o espaço de trabalho Grafana exibe o valor da variável atual. Revise-o para garantir que corresponda ao que você espera.

  3. Escolha Adicionar para adicionar a variável ao painel.

Como adicionar uma variável de fonte de dados

Para alterar rapidamente a fonte de dados de um painel inteiro, você pode usar variáveis da fonte de dados. Eles são úteis se você tiver várias instâncias de uma fonte de dados, talvez em ambientes diferentes.

Inserindo opções gerais

Para inserir opções gerais para uma variável de fonte de dados
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Fonte de dados.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Como inserir opções de fonte de dados

Para inserir opções de fonte de dados para uma variável de fonte de dados
  1. Na lista Tipo, selecione a fonte de dados de destino para a variável. Para obter mais informações sobre fontes de dados, consulteFontes de dados.

  2. (Opcional) Em Filtro de nome de instância, insira um filtro regex para quais instâncias de fonte de dados escolher na lista suspensa de valores variáveis. Mantenha esse campo vazio para exibir todas as instâncias.

  3. (Opcional) Insira Opções de seleção. Para obter mais informações, consulte Inserindo opções de seleção de variáveis.

  4. Em Pré-visualização de valores, o Grafana exibe uma lista dos valores das variáveis atuais. Os revise para garantir que eles correspondam ao que você espera.

  5. Escolha Adicionar para adicionar a variável ao painel.

Adicionar uma variável de intervalo

Use uma variável de intervalo para representar períodos de tempo como1m,1h,1d. Você pode pensar neles como um group-by-time comando para todo o painel. As variáveis de intervalo alteram a forma como os dados são agrupados na visualização. Você também pode usar a opção Automático para retornar um número definido de pontos de dados por período de tempo.

Você pode usar uma variável de intervalo como um parâmetro para agrupar por hora (para InfluxDB), intervalo de histograma de data (para OpenSearch) ou como um parâmetro de função resumida (para Graphite).

Inserindo opções gerais

Para inserir opções gerais para uma variável de intervalo
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Intervalo.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa da variável. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Inserindo opções de intervalo

Para inserir opções de intervalo para uma variável de intervalo
  1. No campo Valores, insira os intervalos de tempo que você deseja que apareçam na lista suspensa de variáveis. As seguintes unidades de tempo são suportadas:s (seconds)m (minutes)h (hours),d (days),w (weeks),M (months),,y (years) e. Você também pode aceitar ou editar os valores padrão:1m,10m,30m,1h,6h,12h,1d,7d,14d,30d.

  2. (Opcional) Ative a opção automática se quiser adicionar aauto opção à lista. Use essa opção para especificar quantas vezes o intervalo de tempo atual deve ser dividido para calcular oauto período atual. Se você ativá-lo, mais duas opções aparecerão:

    • Contagem de etapas — Selecione o número de vezes que o intervalo de tempo atual será dividido para calcular o valor, semelhante à opção de consulta Máximo de pontos de dados. Por exemplo, se o intervalo de tempo visível atual for de 30 minutos, oauto intervalo agrupará os dados em 30 incrementos de um minuto. O valor padrão é de 30 etapas.

    • Intervalo mínimo — O limite mínimo abaixo do qual os intervalos de contagem de etapas não dividirão o tempo. Para continuar o exemplo de 30 minutos, se o intervalo mínimo for definido como2m, o Grafana agrupa os dados em 15 incrementos de 2 minutos.

  3. Em Pré-visualização de valores, o Grafana exibe uma lista dos valores das variáveis atuais. Os revise para garantir que eles correspondam ao que você espera.

  4. Escolha Adicionar para adicionar a variável ao painel.

Exemplos de variáveis de intervalo

Exemplo usando a variável de modelomyinterval em uma função Graphite:

summarize($myinterval, sum, false)

Um exemplo mais complexo de grafite:

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

Adicionar filtros ad hoc

Você pode usar filtros únicos ou ad hoc para adicionar filtros de chave/valor que são adicionados automaticamente a todas as consultas métricas que usam a fonte de dados especificada. Ao contrário de outras variáveis, você não usa filtros únicos em consultas. Em vez disso, você os usa para escrever filtros para consultas existentes.

nota

Nota: Variáveis de filtro únicas ou ad hoc funcionam somente com InfluxDB, Prometheus e fontes OpenSearch de dados.

Inserindo opções gerais

Para inserir opções gerais para um filtro ad hoc
  1. Navegue até o painel para o qual você deseja criar uma variável e escolha o ícone de configurações do painel (engrenagem) na parte superior da página.

  2. Na guia Variáveis, escolha Novo.

  3. Insira um nome para sua variável.

  4. Na lista Tipo, selecione Filtros ad hoc.

  5. (Opcional) Em Etiqueta, insira o nome de exibição da lista suspensa de variáveis. Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

  6. Escolha uma opção Ocultar:

    • Sem seleção (em branco) — A lista suspensa de variáveis exibe o valor do nome ou do rótulo da variável. Esse é o padrão.

    • Rótulo — A lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.

    • Variável — Nenhuma lista suspensa de variáveis é exibida no painel.

Opções de inserção

Para inserir opções para um filtro ad hoc
  1. Na lista de fontes de dados, selecione a fonte de dados de destino. Para obter mais informações sobre fontes de dados, consulteFontes de dados.

  2. Escolha Adicionar para adicionar a variável ao painel.

Criação de filtros ad hoc

Os filtros ad hoc são uma das opções variáveis mais complexas e flexíveis disponíveis. Em vez de uma lista regular de opções de variáveis, essa variável permite a construção de uma consulta ad hoc em todo o painel. Os filtros que você aplica dessa maneira são aplicados a todos os painéis no painel.

Variáveis em cadeia

Variáveis em cadeia, também chamadas de variáveis vinculadas ou variáveis aninhadas, são variáveis de consulta com uma ou mais outras variáveis em sua consulta variável. Esta seção explica como as variáveis em cadeia funcionam e fornece links para exemplos de painéis que usam variáveis em cadeia.

As consultas de variáveis em cadeia são diferentes para cada fonte de dados, mas a premissa é a mesma para todas. Você pode usar consultas de variáveis em cadeia em qualquer fonte de dados que as suporte.

Você pode criar painéis complexos vinculados e modelados, com 5 ou 10 níveis de profundidade. Tecnicamente, não há limite para o quão profundo ou complexo você pode ir, mas quanto mais links você tiver, maior será a carga da consulta.

Práticas recomendadas e dicas

As práticas a seguir facilitarão o uso de seus painéis e variáveis.

Criação de novas variáveis em cadeia

  • O encadeamento de variáveis cria dependências entre pais e filhos. Você pode imaginá-los como uma escada ou uma árvore.

  • A maneira mais rápida de criar uma nova variável em cadeia é copiar a variável na qual você deseja basear a nova. Na lista de variáveis, escolha o ícone Duplicar variável à direita da entrada da variável para criar uma cópia. Em seguida, você pode adicionar à consulta para a variável principal.

  • As novas variáveis em cadeia que você criar dessa forma aparecem na parte inferior da lista. Para dar à lista uma ordem lógica, arraste a variável para uma posição diferente na lista.

Ordem variável

Para alterar a ordem das variáveis na lista de variáveis do painel, escolha as setas para cima e para baixo no lado direito de cada entrada. O espaço de trabalho Grafana lista listas suspensas de variáveis da esquerda para a direita, de acordo com essa lista, exibindo a variável no topo da lista, na extrema esquerda.

  • Liste as variáveis que não têm dependências na parte superior, antes de suas variáveis secundárias.

  • Cada variável deve seguir aquela da qual é dependente.

  • A interface do usuário não indica quais variáveis têm relações de dependência. Liste as variáveis em uma ordem lógica para torná-las mais claras para os usuários finais (e para você mesmo).

Consideração da complexidade

Quanto mais camadas de dependência você tiver nas variáveis, mais tempo será necessário para atualizar os painéis depois de alterar as variáveis.

Por exemplo, se você tiver uma série de quatro variáveis vinculadas (país, região, servidor, métrica) e alterar o valor da variável raiz (país), o espaço de trabalho Grafana deverá executar consultas para todas as variáveis dependentes antes de atualizar as visualizações no painel.

Variáveis globais

O Grafana tem variáveis globais integradas que podem ser usadas em expressões no editor de consultas. Este tópico os lista em ordem alfabética e os define. Essas variáveis são úteis em consultas, links de painéis, links de painéis e links de dados.

$__painel

Essa variável é o nome do painel atual.

$__de e $__para

O Grafana tem duas variáveis de intervalo de tempo integradas:$__from$__to e. Atualmente, eles são sempre interpolados como milissegundos de época por padrão, mas você pode controlar a formatação da data.

Sintaxe Exemplo de resultado Descrição
${__from} 1594671549254 Época de milissegundos do Unix
${__from:date} 2020-07-13T 20:19:09 .254Z Sem argumentos, o padrão é ISO 8601/RFC 3339
${__from:date:iso} 2020-07-13T 20:19:09 .254Z ISO 8601/RFC 3339
${__from:date:seconds} 1594671549 Época dos segundos do Unix
${__from:date:YYYY-MM} 2020-7 Qualquer formato de dados personalizado. Para obter mais informações, consulte Exibição.

A sintaxe acima${__to} também funciona com.

Você também pode usar essa variável em URLs. Por exemplo, para enviar um usuário final para um painel que mostra um intervalo de tempo de seis horas atrás até agora, use o seguinte URL: https://play.grafana.org/d/000000012/grafana-play-home? Painel de visualização = 2&orgid=1? de=agora-6h&a=agora

intervalo $__

Você pode usar a$__interval variável como um parâmetro para agrupar por tempo (para InfluxDB, Myself, Postgres, MSSQL), intervalo do histograma de data (para OpenSearch) ou como um parâmetro de função resumida (para Graphite).

O espaço de trabalho Grafana calcula automaticamente um intervalo que pode ser usado para agrupar por tempo em consultas. Quando há mais pontos de dados do que os mostrados em um gráfico, as consultas podem ser mais eficientes agrupando por um intervalo maior. Por exemplo, é mais eficiente agrupar por 1 dia do que por 10 ao analisar 3 meses de dados. O gráfico terá a mesma aparência e a consulta será mais rápida. O$__interval é calculado usando o intervalo de tempo e a largura do gráfico (o número de pixels).

Cálculo aproximado:(from - to) / resolution

Por exemplo, quando o intervalo de tempo é de 1 hora e o gráfico está em tela cheia, o intervalo pode ser calculado para2m; os pontos são agrupados em intervalos de 2 minutos. Se o intervalo de tempo for de 6 meses e o gráfico estiver em tela cheia, o intervalo poderá ser1d (1 dia); os pontos são agrupados por dia.

Na fonte de dados do InfluxDB, a variável$interval legada é a mesma variável. Use $__interval em vez disso.

O InfluxDB e as fontes de OpenSearch dados têmGroup by time interval campos que são usados para codificar o intervalo ou definir o limite mínimo para a$__interval variável usando a> sintaxe ->>10m.

$__interval_ms

Essa variável é a$__interval variável em milissegundos, não uma string formatada com intervalo de tempo. Por exemplo, se o$__interval é20m, então o$__interval_ms é1200000.

$__nome

Essa variável só está disponível no painel Singlestat e pode ser usada nos campos de prefixo ou sufixo na guia Opções. A variável será substituída pelo nome ou alias da série.

$__org

Essa variável é a ID da organização atual. A variável${__org.name} é o nome da organização atual.

$__usuário

A variável${__user.id} é o ID do usuário atual. A variável${__user.login} é o identificador de login do usuário atual. A variável${__user.email} é o e-mail do usuário atual.

$__range

Atualmente, essa variável é compatível apenas com fontes de dados do Prometheus. Essa variável representa o intervalo do painel atual. É calculado porto - from. Tem representações de milissegundos$__range_ms e segundos chamadas$__range_s e.

$timeFilter ou $__timeFilter

A$timeFilter variável retorna o intervalo de tempo atualmente selecionado como uma expressão. Por exemplo, aLast 7 days expressão do intervalo de tempo étime > now() - 7d.

Essa variável é usada em vários lugares, incluindo:

  • A cláusula WHERE para a fonte de dados do InfluxDB. O Grafana o adiciona automaticamente às consultas do InfluxDB quando está no modo Editor de Consultas. Você pode adicioná-lo manualmente no modo Editor de Texto:WHERE $timeFilter.

  • Consultas do Log Analytics na fonte de dados do Azure Monitor.

  • Consultas SQL em MySQL, Postgres e MSSQL.

  • A$__timeFilter variável é usada na fonte de dados MySQL.