Expressões regulares

Visão geral

Perl Compatible Regular Expressions (PCRE, PCRE2) são suportadas no Zabbix.

Há duas maneiras de usar expressões regulares no Zabbix:

• Inserir manualmente uma expressão regular
• Usar uma expressão regular global criada no Zabbix

Expressões regulares

Você pode inserir manualmente uma expressão regular em locais suportados.
Observe que a expressão não deve começar com @, pois esse símbolo é usado no Zabbix para referenciar expressões regulares globais.

Observe que, na correspondência em várias linhas, os âncoras ^ e $ correspondem ao início e ao fim de cada linha, respectivamente, em vez do início e do fim de toda a string.

Veja também exemplos de escape correto em vários contextos.

Expressões regulares globais

O Zabbix fornece um editor avançado no frontend para criar e testar expressões regulares complexas.
Para acessá-lo, vá para Administration > General > Regular expressions.
O Zabbix inclui várias expressões regulares globais predefinidas em seu conjunto de dados padrão.

Você pode filtrar a lista de expressões regulares por nome e descrição para encontrar as expressões de que precisa.

Configuração

Para criar uma expressão regular global, clique em Criar expressão regular e informe os parâmetros da expressão regular no formulário.

Todos os campos obrigatórios são marcados com um asterisco vermelho.

Uma barra / na expressão é tratada literalmente, e não como delimitador. Isso torna possível salvar expressões que contenham uma barra sem erros.

Depois que uma expressão regular é criada, ela pode ser usada em vários locais no frontend, referenciando seu nome com o prefixo @, por exemplo, @mycustomregexp.

Botões do formulário

Os botões na parte inferior do formulário permitem que você execute várias operações:

Button	Description
	Adicionar uma expressão regular. Este botão está disponível apenas para novas expressões regulares.
	Atualizar as propriedades de uma expressão regular.
	Criar outra expressão regular com base nas propriedades da expressão regular atual.
	Testar uma expressão regular e suas subexpressões em relação a um valor fornecido.
	Excluir a expressão regular.
	Cancelar a edição das propriedades da expressão regular.

Testando uma expressão regular

Você pode testar a expressão regular e suas subexpressões inserindo um valor no campo Test expression e clicando no botão Test.

Na coluna Test result, o status de cada subexpressão é exibido. O campo Combined result exibe o status geral da expressão regular. Se várias subexpressões estiverem definidas, o Zabbix usa o operador lógico AND para calcular o Combined result; isto é, se pelo menos um resultado for False, o Combined result também será False.

Expressões regulares globais padrão

O conjunto de dados padrão inclui as seguintes expressões regulares globais predefinidas:

Importando/exportando uma expressão regular

Você pode importar ou exportar expressões regulares globais conforme descrito na página de configuração de exportação/importação de Regular expressions.

Exemplos

Exemplo de exclusão de uma string exata

Use a seguinte expressão na descoberta de baixo nível para descobrir bancos de dados, exceto um banco de dados com um nome específico:

^TESTDATABASE$

Tanto Test result quanto Combined result exibem FALSE: o nome corresponde a "TESTDATABASE", portanto a condição Does not match regular expression não é satisfeita.

Exemplo com um modificador de regex inline para uma correspondência sem distinção entre maiúsculas e minúsculas

Use a seguinte expressão regular, que inclui o modificador inline (?i) para realizar uma correspondência sem distinção entre maiúsculas e minúsculas dos caracteres "error":

(?i)error

Tanto Test result quanto Combined result exibem TRUE: os caracteres "error" são correspondidos mesmo com Case sensitive selecionado, porque o modificador inline (?i) torna a correspondência sem distinção entre maiúsculas e minúsculas.

Exemplo com vários modificadores inline de regex

Use a seguinte expressão regular, que inclui vários modificadores inline, para corresponder aos caracteres após uma linha específica:

(?<=match (?i)eveRything(?-i) after this line\r\n)(?sx).*# comment

onde:

• (?i) - ativa a correspondência sem distinção entre maiúsculas e minúsculas;
• (?-i) - desativa a correspondência sem distinção entre maiúsculas e minúsculas;
• (?s) - ativa o modo dotall, permitindo que . corresponda a caracteres de nova linha;
• (?x) - ativa o modo estendido, permitindo que espaços em branco e comentários na expressão regular sejam ignorados.

Tanto Test result quanto Combined result exibem TRUE: os caracteres que seguem a linha específica são correspondidos.

Suporte a expressão regular por local