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á.
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
Uma variável é um espaço reservado para um valor. Você pode usar variáveis em consultas de métricas e em títulos de painéis. Então, quando você altera o valor, usando o menu suspenso na parte superior do dashboard, as consultas de métricas do painel mudam para refletir o novo valor.
As variáveis permitem que você crie dashboards mais interativos e dinâmicos. Em vez da codificação rígida do servidor, da aplicação ou de outros nomes de sensor 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 dashboard. Essas listas suspensas facilitam a alteração dos dados exibidos no dashboard.
Isso pode ser especialmente útil para administradores que desejam permitir que os visualizadores do Grafana ajustem rapidamente as visualizações, mas que não desejam conceder a eles permissões completas de edição. Os visualizadores do Grafana podem usar variáveis.
Variáveis e modelos também permitem que você crie dashboards de fonte única. Se você tiver várias fontes de dados ou servidores idênticos, poderá criar um dashboard e usar variáveis para alterar o que está visualizando. Isso simplifica consideravelmente 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 dashboard para monitorar vários servidores, você poderia criar um dashboard para cada servidor ou poderia criar um dashboard e usar painéis com consultas de modelo, como as a seguir.
wmi_system_threads{instance=~"$server"}Os valores das variáveis são sempre sincronizados com o URL usando a sintaxe var-<varname>=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 dashboard > Variáveis. Clique em uma variável na lista para ver as 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çam com $ são modelos. Nem todos os painéis terão consultas de modelo.
Práticas recomendadas de variáveis
-
As listas suspensas de variáveis são exibidas na ordem em que estão listadas na lista de variáveis em Configurações do dashboard.
-
Coloque as variáveis que você alterará com frequência na parte superior, para que elas sejam mostradas primeiro (à esquerda no dashboard).
