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

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

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.

Inserir opções gerais

Inserir opções de consulta

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.

Inserir opções gerais

Inserir opções personalizadas

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

Inserir opções de texto

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

Inserir opções constantes

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

Inserir opções de fonte de dados

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 tempo (para InfluxDB), de intervalo do histograma de datas (para OpenSearch) ou como parâmetro de função de resumo (para Graphite).

Inserir opções gerais

Inserir opções de intervalo

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 filtros de chave/valor que são adicionados automaticamente a todas as consultas de 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.

Inserir opções gerais

Inserir opções

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

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.

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.

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 dashboard 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?viewPanel=2&orgId=1?from=now-6h&to=now

$__interval

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

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.

As fontes de dados InfluxDB e do OpenSearch têm campos Group by time interval que são usados para codificar de forma rígida o intervalo ou definir o limite mínimo da variável $__interval 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: