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á.
Variáveis
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.
Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana
Uma variável é um espaço reservado para um valor. Você pode usar variáveis em consultas métricas e em títulos de painéis. Então, quando você altera o valor, usando a lista suspensa na parte superior do painel, as consultas métricas do seu painel mudam para refletir o novo valor.
As variáveis permitem que você crie painéis mais interativos e dinâmicos. Em vez de codificar coisas como nomes de servidores, aplicativos e sensores em suas consultas de métricas, você pode usar variáveis em seu lugar. As variáveis são exibidas como listas suspensas na parte superior do painel. Essas listas suspensas facilitam a alteração dos dados exibidos em seu painel.
Isso pode ser especialmente útil para administradores que desejam permitir que os visualizadores da Grafana ajustem rapidamente as visualizações, mas não desejam conceder a eles permissões completas de edição. Os Visualizadores da Grafana podem usar variáveis.
Variáveis e modelos também permitem que você crie painéis de fonte única. Se você tiver várias fontes de dados ou servidores idênticos, poderá criar um painel e usar variáveis para alterar o que está visualizando. Isso simplifica enormemente a manutenção e a conservação.
Modelos
Um modelo é qualquer consulta que contém uma variável. Por exemplo, se você estivesse administrando um painel para monitorar vários servidores, você poderia criar um painel para cada servidor ou criar um painel e usar painéis com consultas de modelo, como as seguintes.
wmi_system_threads{instance=~"$server"}
<varname>Os valores das variáveis são sempre sincronizados com o URL usando a sintaxe var- =value.
Exemplos
As variáveis são listadas em listas suspensas na parte superior da tela. Selecione variáveis diferentes para ver como as visualizações mudam.
Para ver as configurações das variáveis, navegue até Configurações do painel > Variáveis. Clique em uma variável na lista para ver suas configurações.
As variáveis podem ser usadas em títulos, descrições, painéis de texto e consultas. As consultas com texto que começa com $ são modelos. Nem todos os painéis terão consultas de modelo.
Práticas recomendadas variáveis
-
As listas suspensas de variáveis são exibidas na ordem em que estão listadas na lista de variáveis nas configurações do painel.
-
Coloque as variáveis que você alterará com frequência na parte superior, para que elas sejam mostradas primeiro (à esquerda no painel).
-
Por padrão, as variáveis pré-selecionam o valor mais alto na lista suspensa. Se você quiser escolher um valor vazio em vez disso, altere as configurações da variável, da seguinte forma:
-
Marque a caixa de seleção Incluir todas as opções.
-
No campo Personalizar todos os valores, insira o valor
+.
-
