12 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 nos locais suportados. Observe que a expressão não pode começar com @, porque esse símbolo é usado no Zabbix para referenciar expressões regulares globais.
É possível ocorrer estouro de pilha ao usar expressões regulares. Consulte a página de manual do pcrestack para obter mais informações.
Observe que, na correspondência em várias linhas, os âncoras ^ e $ correspondem ao início/fim de cada linha, respectivamente, em vez do início/fim de toda a string.
Veja também exemplos de escape correto em vários contextos.
Expressões regulares globais
Há um editor avançado para criar e testar expressões regulares complexas no frontend do Zabbix.
Depois que uma expressão regular é criada dessa forma, ela pode ser usada em vários locais no frontend, referenciando seu nome, com o prefixo @, por exemplo, \@mycustomregexp.
Para criar uma expressão regular global:
- Vá para: Administration > General
- Selecione Regular expressions no menu suspenso
- Clique em New regular expression
A aba Expressions permite definir o nome da expressão regular e adicionar subexpressões.
Todos os campos obrigatórios são marcados com um asterisco vermelho.
| Parameter | Description | |
|---|---|---|
| Name | Defina o nome da expressão regular. Quaisquer caracteres Unicode são permitidos. | |
| Expressions | Clique em Add no bloco Expressions para adicionar uma nova subexpressão. | |
| Expression type | Selecione o tipo de expressão: Character string included - corresponde à substring Any character string included - corresponde a qualquer substring de uma lista delimitada. A lista delimitada inclui uma vírgula (,), um ponto (.) ou uma barra (/) . Character string not included - corresponde a qualquer string, exceto a substring Result is TRUE - corresponde à expressão regular Result is FALSE - não corresponde à expressão regular |
|
| Expression | Digite a substring/expressão regular. | |
| Delimiter | Uma vírgula (,), um ponto (.) ou uma barra (/) para separar strings de texto em uma expressão regular. Este parâmetro fica ativo somente quando o tipo de expressão "Any character string included" estiver selecionado. | |
| Case sensitive | Uma caixa de seleção para especificar se uma expressão regular diferencia maiúsculas de minúsculas. | |
Uma barra (/) na expressão é tratada literalmente, e não como delimitador. Dessa forma, é possível salvar expressões contendo uma barra, sem erros.
Um nome de expressão regular personalizada no Zabbix pode conter vírgulas, espaços etc.
Nos casos em que isso possa levar a uma interpretação incorreta ao referenciar (por exemplo, uma vírgula no parâmetro de uma chave de item), a referência inteira pode ser colocada entre aspas assim: "\@My custom regexp for purpose1, purpose2".
Os nomes das expressões regulares não devem ser colocados entre aspas em outros locais (por exemplo, nas propriedades de uma regra de LLD).
Na aba Test, a expressão regular e suas subexpressões podem ser testadas fornecendo uma string de teste.
Os resultados mostram o status de cada subexpressão e o status total da expressão personalizada.
O status total da expressão personalizada é definido como Combined result. Se várias subexpressões forem definidas, o Zabbix usa o operador lógico AND para calcular Combined result. Isso significa que, se pelo menos um Result for False, Combined result também terá status False.
Expressões regulares globais padrão
O Zabbix vem com várias expressões regulares globais em seu conjunto de dados padrão.
| Name | Expression | Matches |
|---|---|---|
| File systems for discovery | ^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$ |
"btrfs" ou "ext2" ou "ext3" ou "ext4" ou "jfs" ou "reiser" ou "xfs" ou "ffs" ou "ufs" ou "jfs" ou "jfs2" ou "vxfs" ou "hfs" ou "refs" ou "apfs" ou "ntfs" ou "fat32" ou "zfs" |
| Network interfaces for discovery | ^Software Loopback Interface |
Strings que começam com "Software Loopback Interface". |
^lo$ |
"lo" | |
^(In)?[Ll]oop[Bb]ack[0-9._]*$ |
Strings que opcionalmente começam com "In", depois têm "L" ou "l", depois "oop", depois "B" ou "b", depois "ack", que pode ser opcionalmente seguido por qualquer número de dígitos, pontos ou sublinhados. | |
^NULL[0-9.]*$ |
Strings que começam com "NULL" e são opcionalmente seguidas por qualquer número de dígitos ou pontos. | |
^[Ll]o[0-9.]*$ |
Strings que começam com "Lo" ou "lo" e são opcionalmente seguidas por qualquer número de dígitos ou pontos. | |
^[Ss]ystem$ |
"System" ou "system" | |
^Nu[0-9.]*$ |
Strings que começam com "Nu" e são opcionalmente seguidas por qualquer número de dígitos ou pontos. | |
| Storage devices for SNMP discovery | ^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$ |
"Physical memory" ou "Virtual memory" ou "Memory buffers" ou "Cached memory" ou "Swap space" |
| Windows service names for discovery | ^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$ |
"MMCSS" ou "gupdate" ou "SysmonLog" ou strings como "clr_optimization_v2.0.50727_32" e "clr_optimization_v4.0.30319_32", em que, no lugar dos pontos, você pode colocar qualquer caractere exceto nova linha. |
| Windows service startup states for discovery | ^(automatic|automatic delayed)$ |
"automatic" ou "automatic delayed" |
Exemplos
Exemplo 1
Uso da 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$
Tipo de expressão escolhido: "Result is FALSE". Não corresponde ao nome, contendo a string "TESTDATABASE".
Exemplo com um modificador de regex inline
Uso da seguinte expressão regular, incluindo um modificador inline (?i), para corresponder aos caracteres "error":
(?i)error
Tipo de expressão escolhido: "Result is TRUE". Os caracteres "error" são correspondidos.
Outro exemplo com um modificador regex inline
Uso da seguinte expressão regular, incluindo vários modificadores inline, para corresponder aos caracteres após uma linha específica:
(?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters
Tipo de expressão escolhido: "Result is TRUE". Os caracteres após uma linha específica são correspondidos.
O modificador g não pode ser especificado na linha. A lista de modificadores disponíveis pode ser encontrada na página de manual pcresyntax. Para mais informações sobre a sintaxe PCRE, consulte a documentação HTML do PCRE.
Suporte a expressões regulares por local
| Location | Regular expression | Global regular expression | Multiline matching | Comments | |
|---|---|---|---|---|---|
| Agent items | |||||
| eventlog[] | Yes | Yes | Yes | regexp, severity, source, eventid parameters |
|
| eventlog.count[] | regexp, severity, source, eventid parameters |
||||
| log[] | regexp parameter |
||||
| log.count[] | |||||
| logrt[] | Yes/No | regexp parameter supports both, file_regexp parameter supports non-global expressions only |
|||
| logrt.count[] | |||||
| proc.cpu.util[] | No | No | cmdline parameter |
||
| proc.get[] | |||||
| proc.mem[] | |||||
| proc.num[] | |||||
| sensor[] | device and sensor parameters on Linux 2.4 |
||||
| system.hw.macaddr[] | interface parameter |
||||
| system.sw.packages[] | regexp parameter |
||||
| system.sw.packages.get[] | regexp parameter |
||||
| vfs.dir.count[] | regex_incl, regex_excl, regex_excl_dir parameters |
||||
| vfs.dir.get[] | regex_incl, regex_excl, regex_excl_dir parameters |
||||
| vfs.dir.size[] | regex_incl, regex_excl, regex_excl_dir parameters |
||||
| vfs.file.regexp[] | Yes | regexp parameter |
|||
| vfs.file.regmatch[] | |||||
| web.page.regexp[] | |||||
| SNMP traps | |||||
| snmptrap[] | Yes | Yes | No | regexp parameter |
|
| Item value preprocessing | Yes | No | No | pattern parameter |
|
| Functions for triggers/calculated items | |||||
| count() | Yes | Yes | Yes | pattern parameter if operator parameter is regexp or iregexp |
|
| countunique() | Yes | Yes | |||
| find() | Yes | Yes | |||
| logeventid() | Yes | Yes | No | pattern parameter |
|
| logsource() | |||||
| Low-level discovery | |||||
| Filters | Yes | Yes | No | Regular expression field | |
| Overrides | Yes | No | In matches, does not match options for Operation conditions | ||
| Action conditions | Yes | No | No | In matches, does not match options for Host name and Host metadata autoregistration conditions | |
| Scripts | Yes | Yes | No | Input validation rule field | |
| Web monitoring | Yes | No | Yes | Variables with a regex: prefix Required string field |
|
| User macro context | Yes | No | No | In macro context with a regex: prefix | |
| Macro functions | |||||
| regsub() | Yes | No | No | pattern parameter |
|
| iregsub() | |||||
| Link indicators in maps | Yes | No | No | Pattern field (for text items) | |
| Icon mapping | Yes | Yes | No | Expression field | |
| Value mapping | Yes | No | No | Value field if mapping type is regexp |
|