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 compatíveis com o **Grafana versão 8.x**. Para espaços de trabalho do Grafana que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md) 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 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md). O Grafana usa vários tipos de variáveis. | Tipo de variável | Description | | --- | --- | | Consulta | Query-generated lista de valores 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.](#add-a-query-variable). | | Personalizada | Defina as opções de variáveis manualmente usando uma lista separada por vírgulas. Para obter mais informações, consulte [Adicionar uma variável personalizada](#add-a-custom-variable). | | Text box (Caixa de texto) | Exibir 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](#add-a-text-box-variable). | | Constante | Defina uma constante oculta. Para obter mais informações, consulte [Adicionar uma variável constante](#add-a-constant-variable). | | Fonte de dados | Altere rapidamente a fonte de dados de todo um dashboard. Para obter mais informações, consulte [Adicionar uma variável de fonte de dados](#add-a-data-source-variable). | | Intervalo | As variáveis de intervalo representam intervalos de tempo. Para obter mais informações, consulte [Adicionar uma variável de intervalo](#add-an-interval-variable). | | Filtros ad hoc | Key/value filtros que são adicionados automaticamente a todas as consultas métricas de uma fonte de dados (InfluxDB, Prometheus e somente). OpenSearch Para obter mais informações, consulte [Adicionar filtros ad hoc](#add-ad-hoc-filters). | | Variáveis globais | Built-in variáveis que podem ser usadas em expressões no editor de consultas. Para obter mais informações, consulte [Variáveis globais](#global-variables). | | Variáveis encadeadas | As consultas de variáveis podem conter outras variáveis. Para obter mais informações, consulte [Variáveis encadeadas](#chained-variables). | ## Adicionar uma variável de consulta. Ao usar variáveis de consulta, você pode escrever uma consulta de fonte de dados que retorne uma lista de nomes de métricas, valores de tag 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 da fonte de dados em [Conectar-se à fonte de dados](AMG-data-sources.md). ### Inserir opções gerais **Para inserir opções gerais para uma variável de consulta** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Consulta**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### Inserir 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, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 1. Na lista **Atualizar**, selecione quando a variável deve atualizar as opções. + **Nunca**: armazena em cache as consultas de variáveis, e os valores não são atualizados. Isso será bom se os valores nunca mudarem, mas problemático se forem dinâmicos e mudarem muito. + **No carregamento do dashboard**: consultas a fontes de dados sempre que o dashboard é carregado. Isso retarda o carregamento do dashboard, pois a consulta da variável precisa ser concluída antes que o dashboard possa ser inicializado. + **Na alteração de intervalo de tempo**: consultas a fonte de dados quando o intervalo de tempo do dashboard é alterado. Use esta 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 dashboard. 1. No campo **Consulta**, insira uma consulta. + O campo de consulta varia de acordo com a fonte 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. 1. (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 obter exemplos, consulte [Filtrar variáveis com regex](templates-and-variables.md#filter-variables-with-regex). 1. Na lista **Classificar**, selecione a ordem de classificação dos valores a serem exibidos na lista suspensa. A opção padrão, **Desabilitado**, significa que a ordem das opções retornadas pela consulta da fonte de dados será usada. 1. (Opcional) Insira as **Opções de seleção**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 1. Na **Pré-visualização de valores**, o espaço de trabalho do Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ## Adicionar uma variável personalizada Use uma variável *personalizada* para valores que não mudam. Pode ser números, strings ou até mesmo outras variáveis. Por exemplo, se você tiver nomes de servidores 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 eles não mudam, você pode usá-los em variáveis encadeadas em vez de outras variáveis de consulta. Isso reduziria o número de consultas que o Grafana deve enviar quando as variáveis encadeadas são atualizadas. Para obter mais informações sobre variáveis encadeadas, consulte [Variáveis encadeadas](#chained-variables). ### Inserir opções gerais **Para inserir opções de consulta para uma variável personalizada** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, escolha **Personalizada**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### 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, strings, outras variáveis ou pares de chave/valor separados por dois pontos. 1. (Opcional) Insira as **Opções de seleção**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 1. Na **Pré-visualização de valores**, o espaço de trabalho do Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ## 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. Esta é 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 dashboard ao mesmo tempo. ### Inserir opções gerais **Para inserir opções gerais para uma variável de caixa de texto** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Caixa de texto**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### Inserir 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 em que você pode digitar texto. 1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ## Adicionar uma variável constante Para definir uma constante oculta, use variáveis *constantes*. Variáveis constantes são úteis para prefixos de caminhos de métricas para dashboards que você deseja compartilhar. Quando você exporta um dashboard, 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 somente um valor. Para atualizá-lo, você deve atualizar as configurações da variável. Variáveis constantes são úteis quando você tem valores complexos que devem ser incluídos nas consultas, mas não quer digitar novamente em cada consulta. Por exemplo, se você tivesse um caminho de servidor denominado `i-0b6a61efe2ab843gg`, você poderia substituí-lo por uma variável denominada `$path_gg`. ### Inserir opções gerais **Para inserir opções gerais para uma variável constante** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Constante**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. Esse é o padrão. + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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. ### Inserir opções constantes **Para inserir opções constantes para uma variável constante** 1. Insira o valor da variável no campo **Valor**. É possível inserir letras, números e símbolos. Caso use opções avançadas de formato de variáveis, você poderá até usar curingas. Para obter mais informações, consulte [Opções avançadas de formato de variáveis](templates-and-variables.md#advanced-variable-format-options). 1. Na **Pré-visualização de valores**, o espaço de trabalho do Grafana exibe o valor da variável atual. Revise-o para garantir que corresponda ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ## Adicionar uma variável de fonte de dados Para alterar rapidamente a fonte de dados de um dashboard inteiro, você pode usar variáveis da *fonte de dados*. Elas serão úteis se você tiver várias instâncias de uma fonte de dados, talvez em ambientes diferentes. ### Inserir opções gerais **Para inserir opções gerais para uma variável de fonte de dados** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Fonte de dados**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### 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, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 1. (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 de variáveis. Mantenha este campo vazio para exibir todas as instâncias. 1. (Opcional) Insira as **Opções de seleção**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ## Adicionar uma variável de intervalo Use uma variável de *intervalo* para representar períodos de tempo como `1m`, `1h`, `1d`. Você pode pensar neles como um comando abrangente do dashboard de agrupar por hora. As variáveis de intervalo mudam 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 parâmetro para agrupar por hora (para InfluxDB), intervalo do histograma de data (para OpenSearch) ou como um parâmetro de função de resumo (para Graphite). ### Inserir opções gerais **Para inserir opções gerais para uma variável de intervalo** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Intervalo**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### Inserir 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 compatíveis: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)` e `y (years)`. Você também pode aceitar ou editar os valores padrão: `1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`. 1. (Opcional) Ative a **Opção automática** se quiser adicionar a opção `auto` à lista. Use essa opção para especificar quantas vezes o intervalo de tempo atual deve ser dividido para calcular o intervalo de tempo `auto` 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, então o intervalo `auto` agrupará os dados em 30 incrementos de um minuto. O valor padrão é 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 como `2m`, o Grafana agrupará os dados em 15 incrementos de dois minutos. 1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera. 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ### Exemplos de variáveis de intervalo Exemplo de uso da variável `myinterval` de modelo em uma função do Graphite: ``` summarize($myinterval, sum, false) ``` Um exemplo mais complexo do Graphite: ``` 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 key/value filtros 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 nas consultas. Em vez disso, você os usa para escrever filtros para consultas existentes. **nota** **Nota:** ou ad hoc One-time, as variáveis de filtro funcionam apenas com InfluxDB, Prometheus e fontes de dados. OpenSearch ### Inserir opções gerais **Para inserir opções gerais para um filtro ad hoc** 1. Navegue até o dashboard para o qual deseja criar uma variável e escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página. 1. Na guia **Variáveis**, escolha **Nova**. 1. Insira um **Nome** para a variável. 1. Na lista **Tipo**, selecione **Filtros ad hoc**. 1. (Opcional) Em **Rótulo**, 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. 1. Escolha uma opção **Ocultar**: + **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **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 dashboard. ### Inserir opções **Para inserir opções para um filtro ad hoc** 1. Na lista **Fonte de dados**, selecione a fonte de dados de destino. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 1. Escolha **Adicionar** para adicionar a variável ao dashboard. ### Criar de filtros ad hoc Os filtros ad hoc são uma das opções de 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 criação de uma consulta ad hoc em todo o dashboard. Os filtros que você aplica dessa maneira são aplicados a todos os painéis no dashboard. ## Variáveis encadeadas *Variáveis encadeadas*, também chamadas de *variáveis vinculadas* ou *variáveis aninhadas*, são variáveis de consulta outras variáveis na consulta de variável. Esta seção explica como as variáveis encadeadas funcionam e fornece links para exemplos de dashboards que usam variáveis encadeadas. As consultas de variáveis encadeadas são diferentes para cada fonte de dados, mas a premissa é a mesma para todas. Você pode usar consultas de variáveis encadeadas em qualquer fonte de dados que as suporte. Você pode criar dashboards complexos vinculados e modelados, com cinco ou dez 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 de consultas. ### Dicas e práticas recomendadas As práticas a seguir facilitarão o uso dos dashboards e variáveis. #### Criar novas variáveis encadeadas + O encadeamento de variáveis cria dependências entre primárias e secundárias. Você pode imaginá-las como uma escada ou uma árvore. + A maneira mais rápida de criar uma nova variável encadeada é copiar a variável em que você deseja basear a nova. Na lista de variáveis, escolha o ícone de **Duplicar variável** à direita da entrada da variável para criar uma cópia. Você pode então adicionar à consulta a variável principal. + As novas variáveis encadeadas que você cria 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 das variáveis Para alterar a ordem das variáveis na lista de variáveis do dashboard, escolha as setas para cima e para baixo no lado direito de cada entrada. O espaço de trabalho do Grafana lista as 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 das variáveis secundárias. + Cada variável deve seguir aquela da qual depende. + A interface de 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ções sobre complexidade Quanto mais camadas de dependência você tiver nas variáveis, mais tempo será necessário para atualizar os dashboards após a alteração das 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 do Grafana deverá executar consultas para todas as variáveis dependentes antes de atualizar as visualizações no dashboard. ## Variáveis globais O Grafana tem variáveis globais integradas que podem ser usadas em expressões no editor de consultas. Este tópico as lista em ordem alfabética e as define. Essas variáveis são úteis em consultas, links de dashboards, links de painéis e links de dados. ### $\_\_dashboard Esta variável é o nome do dashboard atual. ### $\_\_from e $\_\_to O Grafana tem duas variáveis de intervalo de tempo integradas: `$__from` e `$__to`. Atualmente, elas são sempre interpoladas como milissegundos epoch por padrão, mas você pode controlar a formatação da data. | Sintaxe | Exemplo de resultado | Description | | --- | --- | --- | | ${\_\_from} | 1594671549254 | Unix milissegundos epoch | | ${\_\_from:date} | 2020-07-13 T20:19:09.254Z | Sem argumentos, o padrão é ISO 3339 8601/RFC | | ${\_\_from:date:iso} | 2020-07-13 T20:19:09.254Z | ISO 8601/RFC 3339 | | ${\_\_from:date:seconds} | 1594671549 | Unix segundos epoch | | ${\_\_from:date:YYYY-MM} | 2020-07 | Qualquer formato de dados personalizado. Para obter mais informações, consulte [Exibir](https://momentjs.com/docs/#/displaying/). | A sintaxe acima também funciona com `${__to}`. 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 e orgid = 1? de=agora-6h¶=agora ### $\_\_interval *Você pode usar a `$__interval` variável como um parâmetro para agrupar por hora (para InfluxDB, Myself, Postgres, MSSQL), intervalo do histograma de data (para) ou como um parâmetro de função de resumo (para Graphite OpenSearch).* O espaço de trabalho do Grafana calcula automaticamente um intervalo que pode ser usado para agrupar por tempo nas consultas. Quando há mais pontos de dados do que os mostrados em um grafo, as consultas podem ser mais eficientes agrupando por um intervalo maior. Por exemplo, é mais eficiente agrupar por um dia do que por dez segundos ao analisar três meses de dados. O grafo terá a mesma aparência e a consulta será mais rápida. O `$__interval` é calculado usando o intervalo de tempo e a largura do grafo (o número de pixels). Cálculo aproximado: `(from - to) / resolution` Por exemplo, quando o intervalo de tempo é de uma hora e o grafo está em tela cheia, o intervalo pode ser calculado para `2m`; os pontos são agrupados em intervalos de dois minutos. Se o intervalo de tempo for de seis meses e o grafo estiver em tela cheia, o intervalo poderá ser `1d` (um dia); os pontos serão agrupados por dia. Na fonte de dados InfluxDB, a variável legada `$interval` é a mesma variável. Use `$__interval` em vez disso. O InfluxDB e as fontes de OpenSearch dados têm `Group 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 variável `$__interval` em milissegundos, não uma string formatada com intervalo de tempo. Por exemplo, se `$__interval` for `20m` então `$__interval_ms` será `1200000`. ### $\_\_name Esta 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 Esta variável é o ID da organização atual. A variável `${__org.name}` é o nome da organização atual. ### $\_\_user 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 No momento, esta variável é compatível somente com fontes de dados Prometheus. Essa variável representa o intervalo do dashboard atual. É calculado por `to - from`. Tem representações de milissegundos e segundos denominadas `$__range_ms` e `$__range_s`. ### $timeFilter ou $\_\_timeFilter A variável `$timeFilter` retorna o intervalo de tempo atualmente selecionado como uma expressão. Por exemplo, a expressão `Last 7 days` do intervalo de tempo é `time > now() - 7d`. Esta variável é usada em vários lugares, incluindo: + A cláusula WHERE para a fonte de dados InfluxDB. O Grafana a adiciona automaticamente às consultas do InfluxDB quando está no modo **Editor de consultas**. Você pode adicioná-la manualmente no modo **Editor de texto**: `WHERE $timeFilter`. + Consultas de analytics de logs na fonte de dados Azure Monitor. + Consultas SQL em MySQL, Postgres e MSSQL. + A variável `$__timeFilter` é usada na fonte de dados MySQL.