Adicionar e gerenciar variáveis do painel

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 9.x do Grafana.

Para espaços de trabalho do Grafana compatíveis com a versão 8.x do Grafana, consulteTrabalhando na versão 8 do 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 serão alteradas 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 métricas, você pode usar variáveis em seu lugar. As variáveis são exibidas como listas suspensas na parte superior do painel. Esses menus suspensos facilitam a alteração dos dados exibidos em seu painel.

Eles podem ser especialmente úteis para administradores que desejam permitir que os visualizadores do Grafana ajustem rapidamente as visualizações, mas 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ê use 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 manutenção.

recurso

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"}

Os valores das variáveis são sempre sincronizados com o URL usando a sintaxe var- =value<varname>.

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).