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

Grafana usa vários tipos de variáveis.

Adicionando uma variável de consulta

Usando 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 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 sua fonte de dados emConectar-se à fonte de dados.

Inserindo opções gerais

Inserindo opções de consulta

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 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 elas não mudam, você pode usá-las em variáveis encadeadas em vez de outras variáveis de consulta. Isso reduziria o número de consultas que a Grafana deve enviar quando as variáveis encadeadas são atualizadas. Para obter mais informações sobre variáveis encadeadas, consulteVariáveis encadeadas.

Inserindo opções gerais

Inserindo opções personalizadas

Adicionando 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

Inserindo opções de texto

Adicionando 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 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 chamadoi-0b6a61efe2ab843gg, você poderia substituí-lo por uma variável chamada$path_gg.

Inserindo opções gerais

Inserindo opções constantes

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

Inserindo opções de fonte de dados

Adicionando uma variável de intervalo

Use uma variável de intervalo para representar períodos de tempo1m, como,1h,1d. Você pode pensar neles como um comando em todo o painel group-by-time . 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 Auto 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).

Inserindo opções gerais

Inserindo opções de intervalo

Exemplos de variáveis de intervalo

Exemplo usando a variável de modelo myinterval 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 nas consultas. Em vez disso, você os usa para escrever filtros para consultas existentes.

Inserindo opções gerais

Inserindo opções

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 encadeadas

Variáveis encadeadas, 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 encadeadas funcionam e fornece links para exemplos de painéis 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 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 de consultas.

Melhores práticas e dicas

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

Criação de novas variáveis encadeadas

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 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ção da complexidade

Quanto mais camadas de dependência você tiver nas variáveis, mais tempo será necessário para atualizar os painéis 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 painel.

Variáveis globais

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.

$__from e $__to

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

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 e orgid = 1? de=agora-6h¶=agora

intervalo $__

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 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 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 segundos 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á ser 1d (1 dia); os pontos serão agrupados por dia.

Na fonte de dados do 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

$__intervalo_ms

Essa variável é a $__interval variável em milissegundos, não uma string formatada com intervalo de tempo. Por exemplo, se $__interval for20m, entã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.

Intervalo $__

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

$timeFilter ou $__timeFilter

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

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