12. 正则表达式[杨青]

概述

Perl Compatible Regular Expressions (PCRE) are supported in Zabbix.

Zabbix支持 Perl Compatible Regular Expressions (PCRE)。

There are two ways of using regular expressions in Zabbix:

在Zabbix中有两种使用正则表达式的方法：

• manually entering a regular expression
• using a global regular expression created in Zabbix
• 手动输入正则表达式
• 使用在Zabbix中创建的全局正则表达式

Regular expressions

正则表达式

You may manually enter a regular expression in supported places. Note that the expression may not start with @ because that symbol is used in Zabbix for referencing global regular expressions.

可以在支持的位置手动输入正则表达式。请注意，表达式可能不以@开头，因为该符号在Zabbix中用于引用全局正则表达式。

Global regular expressions

全局正则表达式

There is an advanced editor for creating and testing complex regular expressions in Zabbix frontend.

在Zabbix前端，有一个高级的编辑器用于创建和测试复杂的正则表达式。

Once a regular expression has been created this way, it can be used in several places in the frontend by referring to its name, prefixed with @, for example, @mycustomregexp.

一旦以这种方式创建了正则表达式，它就可以在前端的几个地方使用，方法是加个@前缀来引用它的名称，例如，@mycustomregexp。

To create a global regular expression:

要创建全局正则表达式：

• Go to: Administration → General
• Select Regular expressions from the dropdown
• Click on New regular expression
• 切换到： 管理（Administration） → 一般（General）
• 从右上角的下拉列表中选择 正则表达式（Regular expressions）
• 单击 新的正则表达式（New regular expression）

The Regular expressions tab allows to set the regular expression name and add subexpressions.

正则表达式（Regular expressions）选项卡允许设置正则表达式名称并添加子表达式。

All mandatory input fields are marked with a red asterisk.

所有必填输入字段都标有红色星号。

Since Zabbix 2.4.0, a forward slash (/) in the expression is treated literally, rather than a delimiter. This way it is possible to save expressions containing a slash, whereas previously it would produce an error.

从Zabbix 2.4.0开始，表达式中的正斜杠（/）按字面意思处理，而不是分隔符。这样就可以保存包含斜杠的表达式，而以前会产生错误。

<note important>Zabbix里自定义的表达式名称可以包含逗号，空格等。在引用时可能导致误解的情况下（例如，监控项键的参数中的逗号），整个引用可以放在引号中，如下所示：// " @My custom regexp for purpose1, purpose2"//。
不能在其他位置引用正则表达式名称（例如，在LLD规则属性中）。 :::

Example

举例

Use of the following regular expression in LLD to discover databases not taking into consideration a database with a specific name:

在LLD中使用以下正则表达式来发现不考虑具有特定名称的数据库的数据库：

^TESTDATABASE$

Chosen Expression type: "Result is FALSE". Doesn't match name, containing string "TESTDATABASE".

选择 表达式类型（Expression type）： "结果为假（Result is FALSE）"。不匹配名称，包含字符串“TESTDATABASE”。

Example with an inline regex modifier

内联正则表达式修饰符的示例

Use of the following regular expression including an inline modifier (?i) to match the characters "error":

使用如下带有内联修饰符（?i）的正则表达式匹配“error”字符：

(?i)error

Chosen Expression type: "Result is TRUE". Characters "error" are matched.

选择 表达式类型（Expression type）： "结果为真（Result is TRUE）"。“error”字符被匹配到。

Another example with an inline regex modifier

内联正则表达式修饰符的另一个示例

Use of the following regular expression including multiple inline modifiers to match the characters after a specific line:

使用以下正则表达式（包括多个内联修饰符）来匹配特定行之后的字符：

(?<=match (?i)everything(?-i) after this line\n)(?sx).*    #我们增加了一个修饰符(?s)来使点号（.）具备匹配换行符的能力。

Chosen Expression type: "Result is TRUE". Characters after a specific line are matched.

选择表达式类型： "结果为真（Result is TRUE）"。匹配特定行后的字符。

More complex example

更复杂的例子

A custom regular expression may consist of multiple subexpressions, and it can be tested in the Test tab by providing a test string.

自定义正则表达式可能包含多个子表达式，可以通过提供测试字符串在Test选项卡中进行测试。

Results show the status of each subexpression and total custom expression status.

结果显示每个子表达式的状态和整个自定义表达式的状态。

Total custom expression status is defined as Combined result. If several sub expressions are defined Zabbix uses AND logical operator to calculate Combined result. It means that if at least one Result is False Combined result has also False status.

总自定义表达式状态定义为 合并的结果（Combined result）。如果定义了几个子表达式，Zabbix使用AND逻辑运算符来计算 合并的结果（Combined result）。这意味着如果只要有一个结果为False，合并的结果（Combined result） 也为False状态。

Explanation of global regular expressions

全局正则表达式的说明

Regular expression support by location

支持正则表达式的位置