3 上下文用户宏
概述
可选上下文可用于 [user宏]（/manual/config/macros/user_macros），允许覆盖具有特定于上下文的默认值。
上下文附加到宏名称；语法取决于是否上下文是一个静态文本值：
或正则表达式：
请注意，具有正则表达式上下文的宏只能在用户宏配置。如果 regex: 前缀在其他地方被用作用户宏上下文，就像在触发器表达式中一样，它将被视为静态上下文。
上下文引用是可选的（另见 [重要注释]（#important_notes））。
宏上下文示例：
| 示例 | 说明 |
|---|---|
{$LOW_SPACE_LIMIT} |
没有上下文的用户宏。 |
{$LOW_SPACE_LIMIT:/tmp} |
带有上下文的用户宏（静态字符串）。 |
{$LOW_SPACE_LIMIT:regex:"^/tmp$"} |
带有上下文的用户宏（正则表达式）。与{$LOW_SPACE_LIMIT:/tmp}相同。 |
{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"} |
带有上下文的用户宏（正则表达式）。匹配所有以 /var/log/ 为前缀的字符串。 |
使用场景
具有上下文的用户宏可以定义，以实现触发器表达式中更灵活的阈值（基于低级别发现获取的值）。例如，您可以定义以下宏：
- {$LOW_SPACE_LIMIT} = 10
- {$LOW_SPACE_LIMIT:/home} = 20
- {$LOW_SPACE_LIMIT:regex:"^/[a-z]+$"} = 30
然后，可以在用于挂载文件系统发现的触发器原型中，将低级别发现宏用作宏上下文：
发现后，不同的低磁盘空间阈值将根据发现的挂载点或文件系统类型在触发器中应用。如果出现以下情况，将生成问题事件：
- /home 文件夹的空闲磁盘空间少于 20%
- 匹配正则表达式模式的文件夹（如 /etc、/tmp 或 /var）的空闲磁盘空间少于 30%
- 不匹配正则表达式模式且不是 /home 的文件夹的空闲磁盘空间少于 10%
重要笔记
- 如果存在多个具有上下文的用户宏，Zabbix 将尝试首先匹配简单的上下文宏，然后匹配上下文宏未定义顺序的正则表达式。
不要创建不同的上下文宏匹配相同的字符串以避免未定义的行为。
- 如果在主机上找不到带有上下文的宏，则链接模板或全局，然后搜索没有上下文的宏。
- 上下文中仅支持低级发现宏。任何其他宏被忽略并被视为纯文本。
从技术上讲，宏上下文是使用类似于 item key 参数，除了宏上下文是如果有 , 字符，则不被解析为多个参数：
- 如果上下文包含
}，则必须用"引用宏上下文字符或以"字符开头。引号内的引号context 必须用\字符转义。 \字符本身没有被转义，这意味着它是不可能的有一个以\字符结尾的引用上下文 - 宏 {$MACRO:"a:\b\c\"} 无效。- 上下文中的前导空格被忽略，尾随空格是不是：
- 例如 {$MACRO:A} 与 {$MACRO:A} 相同，但不同{$宏：A}。
- 前导引号和尾随引号后的所有空格都是忽略，但引号内的所有空格都不是：
- 宏 {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } 和 {$MACRO:"A" }相同，但宏{$MACRO:"A"} 和 {$MACRO:" A "}不是。
以下宏都是等价的，因为它们具有相同的上下文：{$MACRO:A}, {$MACRO: A} 和 {$MACRO:"A"}。这是相反的带有监控项键，其中'key[a]', 'key[ a]' 和 'key["a"]' 是语义上相同，但出于唯一性目的而不同。