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á.
Adicionar e gerenciar variáveis
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
A tabela a seguir lista os tipos de variáveis no Grafana.
Tipo de variável | Descrição |
---|---|
Consulta |
Lista de valores gerada por consulta, como nomes de métricas, nomes de servidores, sensores IDs, data centers e assim por diante. |
Personalizado |
Defina as opções de variáveis manualmente usando uma lista separada por vírgulas. |
Text box (Caixa de texto) |
Exiba um campo de entrada de texto livre com um valor padrão opcional. |
Constante |
Defina uma constante oculta. |
Fonte de dados |
Altere rapidamente a fonte de dados de todo um dashboard. |
Intervalo |
As variáveis de intervalo representam intervalos de tempo. |
Filtros ad hoc |
Filtros de chave/valor que são adicionados automaticamente a todas as consultas de métricas de uma fonte de dados (somente Prometheus, Loki, InfluxDB e Elasticsearch). |
Variáveis globais |
Variáveis internas que podem ser usadas em expressões no editor de consultas. |
Variáveis encadeadas |
As consultas de variáveis podem conter outras variáveis. |
Tópicos
Inserir opções gerais
Você deve inserir opções gerais para qualquer tipo de variável que você criar.
Para inserir opções gerais
-
Navegue até o dashboard para o qual você deseja criar uma variável e selecione o ícone de Configurações do dashboard (engrenagem) na parte superior da página.
-
Na guia Variáveis, selecione Nova variável.
-
Insira um Nome para a variável.
-
Na lista Tipo, selecione Consulta.
-
(Opcional) Em Rótulo, insira o nome de exibição do menu suspenso de variáveis.
Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.
-
Escolha uma opção Ocultar:
-
Nenhuma seleção (em branco): o menu suspenso de variáveis exibe o valor do Nome ou Rótulo da variável.
-
Rótulo: o menu suspenso de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.
-
Variável: nenhum menu suspenso de variáveis é exibido no dashboard.
-
Adicionar uma variável de consulta.
As variáveis de consulta permitem que você escreva uma consulta de fonte de dados que pode retornar 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, sensores ou data centers. Os valores das variáveis mudam à medida que elas buscam opções dinamicamente com uma consulta à fonte de dados.
Geralmente, as variáveis de consulta são compatíveis apenas com strings. Se sua consulta retornar números ou qualquer outro tipo de dados, talvez seja necessário convertê-los em strings para usá-los como variáveis. Para a fonte de dados Azure, por exemplo, você pode usar a função tostring
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.
nota
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.
Para adicionar uma variável de consulta
-
Insira as opções gerais, conforme descrito acima.
-
Na lista Fonte de dados, selecione a fonte de dados de destino para a consulta.
-
Na lista Atualizar, selecione quando a variável deve atualizar as opções.
-
No carregamento do dashboard: consultas a fontes de dados sempre que o dashboard é carregado. Isso retarda o carregamento do dashboard, porque 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 a consulta de opções variáveis contiver um filtro de intervalo de tempo ou depender do intervalo de tempo do dashboard.
-
-
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.
-
A consulta deve retornar valores denominados
__text
e__value
. Por exemplo, em SQL, você pode usar uma consulta comoSELECT hostname AS __text, id AS __value from MyTable
. As consultas para outras linguagens variam de acordo com a sintaxe. -
Se você precisar de mais espaço em um único editor de consulta de campo de entrada, passe o cursor sobre as linhas no canto inferior direito do campo e arraste para baixo para expandir.
-
-
(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 Filtrar variáveis com regex.
-
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.
-
(Opcional) Insira as Opções de seleção.
-
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.
-
Selecione Adicionar para adicionar a variável ao dashboard.
Adicionar uma variável personalizada
Use uma variável personalizada para um valor que não muda, como um número ou uma string.
Por exemplo, se você tiver nomes de servidores ou nomes de regiões que nunca mudam, talvez queira 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 o Grafana deve enviar quando as variáveis encadeadas são atualizadas.
Para adicionar uma variável personalizada
-
Insira as opções gerais, conforme descrito acima.
-
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 ou pares de chave/valor separados por um espaço e dois pontos. Por exemplo,
key1 : value1,key2 : value2
. -
(Opcional) Insira as Opções de seleção.
-
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.
-
Selecione 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 livre 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.
Para adicionar uma variável de caixa de texto
-
Insira as opções gerais, conforme descrito acima.
-
(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 para os usuários digitarem texto.
-
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.
-
Selecione Adicionar para adicionar a variável ao dashboard.
Adicionar uma variável constante
Variáveis constantes permitem que você defina uma constante oculta. Isso é útil 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 apenas um valor e não pode ser atualizada a menos que você atualize as configurações da variável.
Variáveis constantes são úteis quando você tem valores complexos que precisa incluir nas consultas, mas não quer digitar novamente em todas as consultas. Por exemplo, se você tivesse um caminho de servidor chamado i-0b6a61efe2ab843gg
, você poderia substituí-lo por uma variável chamada $path_gg
.
Para adicionar uma variável constante
-
Insira as opções gerais, conforme descrito acima.
-
Insira o valor da variável no campo Valor. É possível inserir letras, números e símbolos. Você pode até usar curingas se usar o formato bruto.
-
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.
-
Selecione Adicionar para adicionar a variável ao dashboard.
Adicionar uma variável de fonte de dados
As variáveis da fonte de dados permitem que você altere rapidamente a fonte de dados de todo um dashboard. Elas serão úteis se você tiver várias instâncias de uma fonte de dados, talvez em ambientes diferentes.
Para adicionar uma variável de fonte de dados.
-
Insira as opções gerais, conforme descrito acima.
-
Na lista Tipo, selecione a fonte de dados de destino para a variável.
Você também pode escolher Abrir seletor de fonte de dados avançado para ver mais opções, incluindo adicionar uma fonte de dados (somente administradores). Para obter mais informações, consulte Conectar-se à fonte de dados.
-
(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. Deixe esse campo vazio para exibir todas as instâncias.
-
(Opcional) Insira as Opções de seleção.
-
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.
-
Selecione 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
ou 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 datas (para Elasticsearch) ou como um parâmetro de função de resumo (para Graphite).
Para adicionar uma variável de intervalo
-
Insira as opções gerais, conforme descrito acima.
-
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)
ey (years)
. Você também pode aceitar ou editar os valores padrão:1m,10m,30m,1h,6h,12h,1d,7d,14d,30d
. -
(Opcional) Ative a Opção automática se quiser adicionar a opção
auto
à lista. Essa opção permite especificar quantas vezes o intervalo de tempo atual deve ser dividido para calcular o período de tempoauto
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 2 minutos, o Grafana agrupará os dados em 15 incrementos de dois minutos.
-
-
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.
-
Selecione Adicionar para adicionar a variável ao dashboard.
Exemplos de variáveis de intervalo
O exemplo a seguir mostra uma variável de modelo myinterval
em uma função do Graphite:
summarize($myinterval, sum, false)
Adicionar filtros ad hoc
Os filtros ad hoc permitem que você adicione filtros de valor/chave 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 ad hoc nas consultas. Em vez disso, você usa filtros ad hoc para gravar filtros para consultas existentes.
nota
Variáveis de filtro ad hoc só funcionam com fontes de dados Prometheus, Loki, InfluxDB e Elasticsearch.
-
Insira as opções gerais, conforme descrito acima.
-
Na lista Fonte de dados, selecione a fonte de dados de destino.
Você também pode escolher Abrir seletor de fonte de dados avançado para ver mais opções, incluindo adicionar uma fonte de dados (somente administradores). Para obter mais informações, consulte Conectar-se à fonte de dados.
-
Selecione Adicionar para adicionar a variável ao dashboard.
Criar 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 criar 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.
Configurar opções de seleção de variáveis
As opções de seleção são um recurso que você pode usar para gerenciar seleções de opções variáveis. Todas as opções de seleção são opcionais e estão desativadas por padrão.
Variáveis de vários valores
Interpolar uma variável com vários valores selecionados é complicado, pois não é simples formatar os vários valores em uma string válida no contexto em que a variável é usada. O Grafana tenta resolver isso permitindo que cada plug-in de fonte de dados informe ao mecanismo de interpolação de modelos qual formato usar para vários valores.
nota
A opção Personalizar todos os valores na variável deve estar em branco para que o Grafana formate todos os valores em uma única string. Se for deixado em branco, o Grafana concatenará (somará) todos os valores na consulta. Por exemplo, value1,value2,value3
. Se, em vez disso, um valor all
personalizado for usado, o valor será *
ou all
.
Variáveis de vários valores com uma fonte de dados Graphite
O Graphite usa expressões globais. Uma variável com vários valores deve, nesse caso, ser interpolada como {host1,host2,host3}
se o valor da variável atual fosse host1, host2 e host3.
Variáveis de vários valores com uma fonte de dados Prometheus ou InfluxDB
O InfluxDB e o Prometheus usam expressões regex, então a mesma variável é interpolada como (host1|host2|host3)
. Todo valor também tem escape regex. Do contrário, um valor com um caractere de controle regex dividiria a expressão regex.
Variáveis de vários valores com uma fonte de dados elástica
O Elasticsearch usa a sintaxe de consulta do Lucene, então a mesma variável é formatada como ("host1" OR "host2" OR "host3")
. Nesse caso, todo valor deve ser de escape para que o valor contenha apenas palavras de controle e aspas do Lucene.
Solucionar problemas de variáveis de vários valores
O escape e a formatação automáticos podem causar problemas e pode ser difícil entender a lógica por trás disso. Especialmente para InfluxDB e Prometheus, em que o uso da sintaxe regex requer que a variável seja usada no contexto do operador regex.
Se você não quiser que o Grafana faça esse escape e formatação automáticos de regex, faça o seguinte:
-
Desative as opções Multivalor ou Incluir todas as opções.
-
Use o formato bruto.
Incluir todas as opções
O Grafana adiciona uma opção All
à lista suspensa de variáveis. Se um usuário selecionar essa opção, então todas as opções de variáveis serão selecionadas.
Personalizar todos os valores
Essa opção só estará visível se Incluir todas as opções estiver selecionado.
Insira a sintaxe regex, globs ou lucene no campo Personalizar todos os valores para definir o valor da opção All
.
Por padrão, o valor All
inclui todas as opções em uma expressão combinada. Isso pode se tornar muito longo e causar problemas de performance. Às vezes, pode ser melhor especificar um valor personalizado para todos, como um regex curinga.
Para ter uma sintaxe personalizada de regex, globs ou lucene na opção Personalizar todos os valores, ela nunca é de escape, então você terá que pensar sobre qual será um valor válido para a fonte de dados.
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 | Descrição |
---|---|---|
|
1594671549254 |
Unix milissegundos epoch |
|
2020-07-13T20:19:09.254Z |
Nenhum argumento, o padrão é ISO 8601/RFC 3339 |
|
2020-07-13T20:19:09.254Z |
ISO 8601/RFC 3339 |
|
1594671549 |
Unix segundos epoch |
|
2020-07 |
Qualquer formato de data personalizado que não inclua o caractere : |
A sintaxe acima também funciona com ${__to}
.
$__interval
Você pode usar a variável $__interval
como um parâmetro para agrupar por hora (para InfluxDB, MySQL, Postgres, MSSQL), intervalo do histograma de datas (para Elasticsearch) ou como um parâmetro de função de resumo (para Graphite).
O Grafana calcula automaticamente um intervalo que pode ser usado para agrupar por hora 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, se você estiver vendo um grafo de três meses de dados, talvez não consiga ver os detalhes no nível de minutos. O agrupamento por hora ou dia torna a consulta mais eficiente sem afetar o que o grafo mostra. O $__interval
é calculado usando o intervalo de tempo e a largura do grafo (o número de pixels).
Cálculo aproximado: (to - from) / resolution
Por exemplo, quando o intervalo de tempo é de uma hora e o grafo está em tela cheia, então o intervalo pode ser calculado em 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
(1 dia). Os pontos são agrupados por dia.
Na fonte de dados InfluxDB, a variável legada $interval
é a mesma variável. $__interval
deve ser usado em vez disso.
As fontes de dados InfluxDB e Elasticsearch têm os campos Group by time
interval
que são usados para codificar de forma rígida o intervalo ou definir o limite mínimo para a variável $__interval
(usando a sintaxe >
, por exemplo >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
.
$__org
Essa variável é o ID da organização atual. ${__org.name}
é o nome da organização atual.
$__user
${__user.id}
é o ID do usuário atual. ${__user.login}
é o identificador de login do usuário atual. ${__user.email}
é o e-mail do usuário atual.
$__range
Compatível apenas com as fontes de dados Prometheus e Loki. Essa variável representa o intervalo do dashboard atual. É calculado por to -
from
. Tem um milissegundo e uma segunda representação chamada $__range_ms
e $__range_s
.
$__rate_interval
Compatível somente com as fontes de dados Prometheus. A variável $__rate_interval
deve ser usada na função de taxa.
$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
.
Isso é usado 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.
$__timezone
A variável $__timezone
retorna o fuso horário atualmente selecionado, ou utc
ou uma entrada do banco de dados de fuso horário do IANA (por exemplo, America/New_York
).
Se o fuso horário atualmente selecionado for Hora do navegador, o Grafana tentará determinar o fuso horário do seu navegador.
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.
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 variáveis encadeadas em qualquer fonte de dados que as permita.
Dashboards com modelos vinculados extremamente complexos são possíveis, 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 vinculadas
-
Variáveis de encadeamento criam dependências de principal e secundária. Você pode imaginá-las como uma escada ou uma árvore.
-
A maneira mais fácil de criar uma variável encadeada é copiar a variável na qual você deseja basear a nova. Na lista de variáveis, clique no í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 variáveis criadas dessa forma aparecerão na parte inferior da lista. Talvez seja necessário arrastá-las para uma posição diferente na lista para colocá-las em uma ordem lógica.
Ordem das variáveis
Você pode alterar a ordem das variáveis na lista de variáveis do dashboard clicando nas setas para cima e para baixo no lado direito de cada entrada. O Grafana lista os menus suspensos de variáveis da esquerda para a direita de acordo com essa lista, com a variável na parte superior, 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.
-
Lembre-se de que não há indicação na interface de usuário de quais variáveis têm relações de dependência. Liste as variáveis em uma ordem lógica para tornar mais fácil para os outros usuários (e para você).
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 Grafana então deverá executar consultas para todas as variáveis dependentes antes de atualizar as visualizações no dashboard.
Gerenciar variáveis
A página de variáveis permite adicionar variáveis e gerenciar as variáveis existentes. Também permite inspecionar variáveis e identificar se uma variável está sendo referenciada (ou usada) em outras variáveis ou no dashboard.
Mover: você pode mover uma variável para cima ou para baixo na lista usando arrastar e soltar.
Clonar: para clonar uma variável, clique no ícone de clonar no conjunto de ícones à direita. Isso cria uma cópia da variável com o nome da variável original prefixada com copy_of_
.
Excluir: para excluir uma variável, clique no ícone da lixeira no conjunto de ícones à direita.
Filtrar variáveis com regex
Usando a opção de consulta regex, você filtra a lista de opções retornadas pela consulta da variável ou modifica as opções retornadas.
Esta página mostra como usar regex para filtrar e modificar valores no menu suspenso de variáveis.
Usando a opção de consulta regex, você filtra a lista de opções retornadas pela consulta da variável ou modifica as opções retornadas. Para obter mais informações, consulte o guia do Mozilla sobre expressões regulares
Os exemplos a seguir mostram a filtragem na seguinte lista de opções
backend_01 backend_02 backend_03 backend_04
Filtrar para que somente as opções que terminam com 01
ou 02
sejam retornadas
Regex:
/ ( 01|02 ) $/
Resultado:
backend_01 backend_02
Filtrar e modificar as opções usando um grupo de captura regex para retornar parte do texto
Regex:
/.* ( 01|02 ) /
Resultado:
01 02
Filtrar e modificar: exemplo do Prometheus
Para esta lista de opções:
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000 up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000 up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
Este regex:
/. *instance=" ( [^"]* ) .*/
Retorna estes resultados:
demo.robustperception.io:9090 demo.robustperception.io:9093 demo.robustperception.io:9100
Filtrar e modificar usando grupos nomeados de captura de texto e valor
Usando grupos de captura nomeados, você pode capturar partes separadas de “texto” e “valor” das opções retornadas pela consulta da variável. Isso permite que a lista suspensa de variáveis contenha um nome amigável para cada valor que possa ser selecionado.
Por exemplo, ao consultar a métrica node_hwmon_chip_names
do Prometheus, o chip_name
é muito mais amigável do que o valor chip
. Portanto, o seguinte resultado da consulta de variável:
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
Passou pelo seguinte regex:
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/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.