Quando coletamos métricas no Grafana a partir de ferramentas como o Zabbix, é comum nos depararmos com legendas de nomes muito extensos, que acabam poluindo o dashboard e dificultando a leitura.
Antes de tudo, existem “N” formas de ajustar a legenda, como por exemplo override > display name. Porém essa dashboard é dinâmica/automática, ou seja caso seja adicionado um novo host no zabbix, o gráfico é criado automaticamente. Dessa forma existem muitas variáveis de host para host, como por exemplo a descrição/identificação de uma interface, até a forma como o item foi configurado no template.
Aqui um exemplo prático, que me deparei ao criar uma dashboard coletando as interfaces Download e Upload, porém com uma legenda bastante poluída.
Abaixo um modelo de exemplo do que o grafana nos motra:
SC-BNG-VII-GGNET: Tráfego de saída Eth-Trunk10.3028 - {to:cng-1,bng:sc-vii-bng,cmt:cgn-1-lan,tags:[cgnat]}
#
SC-BNG-VII-GGNET: Tráfego de entrada Eth-Trunk10.3028 - {to:cng-1,bng:sc-vii-bng,cmt:cgn-1-lan,tags:[cgnat]}A legenda contém muitas informações, mas nesse caso preciso apenas do sentido do tráfego (entrada ou saída) e do identificador do CGNAT (cgn-1-lan).
Para resolver isso, podemos usar a transformação “Rename fields by regex” no Grafana.
Construindo a Regex
A expressão usada foi:
.*Tráfego de (entrada|sa[ií]da).*cmt:(cgn-[^,}]+).*E o replace definido foi:
Tráfego de $1 $2Quebrando a expressão:
- .* Captura qualquer coisa antes da parte que interessa.
- Tráfego de (entrada|sa[ií]da)
- .*cmt:(cgn-[^,}]+).*
Resultado da Substituição
- O replace Tráfego de $1 $2 usa os grupos de captura:
Resultado final:
Tráfego de saída cgn-1-lan
Tráfego de entrada cgn-1-lan
Explicação Técnica dos Principais Pontos da Regex
- Capturing Group ( ) → Permite extrair partes específicas do texto.
- Alternation ( | ) → Funciona como um “OU”. No caso (entrada|sa[ií]da), cobre as duas formas possíveis.
- Character Set [ ] → Define um conjunto de caracteres aceitos. [ií] cobre tanto “saida” quanto “saída”.
- Negated Set [^ ] → Captura tudo, exceto o que está listado. Em [ ^,} ], exclui vírgula e chaves, delimitando bem o valor do campo.
Para facilitar a criação da expressão regular, o site https://regex101.com/ server para sua visualização:
Por fim
Usar regex no Grafana é uma das formas de manipular um campo, deixando dashboards mais claras e objetivos.
Neste exemplo, conseguimos transformar legendas longas em curtas e funcionais, mantendo apenas o essencial:
- O sentido do tráfego (entrada ou saída).
- O identificador do CGNAT (ex: cgn-1-lan).
Este e outros materiais dos mais diversos relacionados a redes e tecnologia, estão também disponíveis em meu blog https://arquivodeti.com.br/