【免费下载链接】community-templates
Zabbix Community Templates repository
本指南以 community-templates 仓库中的「App Skype for business Mediation Role」模板(5.0 README)为核心,系统讲解如何用 Zabbix 监控 Microsoft Lync 2013 / Skype for Business Server 2015 的 Mediation Server 角色:涵盖 12 个采集项(性能计数器、Windows 服务状态、事件日志)、6 个内置触发器、数据预处理、值映射与内置图形。读完本文,你将能理解该模板的完整内部结构,并掌握其在 Zabbix 5.0 / 5.4 / 6.0 中的导入方式与阈值调优思路。
模板背景:Mediation Server 在 Lync / Skype for Business 中的角色
根据模板描述(README 的 Description 部分),该模板用于评估 Mediation Server 上服务的运行状态与整体健康度,以及该服务器的性能表现,文档依据为微软 TechNet 上关于 Lync 2013 Mediation Role 的官方性能监控指南(https://technet.microsoft.com/en-us/library/gg398616.aspx,README 中已注明出处)。
Mediation Server 是企业语音(Enterprise Voice)架构中的核心组件,负责:
- 信令与媒体的中继:在 Lync/Skype for Business 客户端与 PSTN 网关、IP-PBX 等对端之间转发 SIP 信令并中转媒体流;
- 媒体绕过(Media Bypass):当客户端与网关之间网络路径满足条件时,媒体流可以直接在两端之间传输而不再经过 Mediation Server,从而显著降低其资源消耗(模板中
Active media bypass calls系列计数器正是对这一状态的度量); - 与 Front End Server(前端服务器)及网关对端交互:交互异常会直接导致呼叫失败,模板中专门采集了这两类失败计数。
该模板在仓库中的定位是Lync 2013 Mediation Role 监控模板(README Overview 原文为 "Lync 2013 Mediation role template"),同时其描述明确面向Microsoft Skype for Business Server 2015,因此可视为覆盖 Lync 2013 与早期 Skype for Business 部署场景。
模板文件与版本
模板目录Applications/Misc/template_lync_2013_mediation_role/下按 Zabbix 主版本提供了三份导出文件:
| 版本 | 文件 | 导出格式 |
|---|---|---|
| Zabbix 5.0 | template_lync_2013_mediation_role.xml | XML(<zabbix_export><version>5.0</version>,导出时间 2021-11-21) |
| Zabbix 5.4 | template_lync_2013_mediation_role.yaml | YAML(zabbix_export,version 5.4) |
| Zabbix 6.0 | template_lync_2013_mediation_role.yaml | YAML(zabbix_export,version 6.0) |
从仓库内容看,5.4 与 6.0 的 YAML 导出结构完全一致(各对象 UUID 相同,如模板 UUID 均为5792540b3c9d4e0f92069dc0751a87d7),仅version字段不同;5.0 的 XML 导出则使用了旧式<applications>分组(Logs / Lync performance / Services),而 5.4/6.0 的 YAML 改为tags标签形式(Application: Logs、Application: Lync performance、Application: Services),这符合 Zabbix 从旧版应用到新式标签的演进方式。
⚠️值得注意的文档差异:README 的 "Triggers" 一节声明 "There are no triggers in this template",但实际的 XML 与 YAML 导出文件中已包含6 个触发器(详见下文)。这说明 README 滞后于模板文件的真实内容,导入与使用时务必以模板导出文件为准。README 中关于无宏(Macros)、无模板链接(Template links)、无发现规则(Discovery rules)的声明则与实际导出文件一致。
采集项总览:模板监控的三类数据
模板共采集 12 个监控项(Items),分别通过Zabbix agent(被动检查)与Zabbix agent (active)(主动检查)获取,可归纳为三个维度:
- Windows 服务状态(
service.info,被动检查,更新间隔 300 秒); - Mediation Server 性能计数器(
perf_counter,被动检查,更新间隔 60 秒); - Lync Server 事件日志(
eventlog,主动检查,更新间隔 180 秒,LOG 数据类型,历史保留 7 天且不保存趋势)。
服务健康状态(service.info)
模板通过 Zabbix agent 的service.info键监控 Mediation Server 上两个关键 Windows 服务的运行状态,并使用内置值映射Windows service state将数值状态翻译为可读文本:
| 监控项名称 | 键 | 更新间隔 |
|---|---|---|
| Service: Lync Server Mediation | service.info["Lync Server Mediation", state] | 300 |
| Service: Lync Server Replica Replicator Agent | service.info["Lync Server Replica Replicator Agent", state] | 300 |
其中Lync Server Mediation是 Mediation Server 角色本身的核心服务;Lync Server Replica Replicator Agent负责 Lync Server 配置复制的复制代理服务,其异常同样会破坏服务器功能。
两个服务项均绑定了值映射Windows service state,该值映射在导出文件中明确定义(见 5.4 YAML):
| 原始值 | 文本含义 | 原始值 | 文本含义 |
|---|---|---|---|
| 0 | Running | 5 | Stop pending |
| 1 | Paused | 6 | Stopped |
| 2 | Start pending | 7 | Unknown |
| 3 | Pause pending | 255 | No such service |
| 4 | Continue pending |
对应地,两个服务项各配置了一个AVERAGE(平均)级别触发器,当状态值不等于 0(即非 Running)时告警:
last(/App Skype for business Mediation Role/service.info["Lync Server Mediation", state])<>0 → 触发器 "Lync Server Mediation service stopped" last(/App Skype for business Mediation Role/service.info["Lync Server Replica Replicator Agent", state])<>0 → 触发器 "Lync Server Replica Replicator Agent service stopped"呼叫性能计数器(perf_counter)
模板的绝大部分采集项通过 Zabbix agent 的perf_counter键读取 Windows 性能计数器对象LS:MediationServer下的计数器,更新间隔统一为 60 秒。perf_counter键语法为perf_counter["\对象名称(实例)\计数器名称"],模板中多处使用\-转义连字符,避免键名中的特殊字符被解析歧义。全部性能计数器如下:
| 监控项名称 | 键(计数器路径) | 度量含义 |
|---|---|---|
| Inbound Calls: Current | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- current"] | 进行中的入站呼叫数量 |
| Inbound Calls: Active media bypass calls | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- Active media bypass calls"] | 进行中的、处于媒体绕过模式的入站呼叫数量 |
| Outbound Calls: Current | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- current"] | 经 Mediation Server 的进行中出站呼叫总数 |
| Outbound Calls: Active media bypass calls | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- Active media bypass calls"] | 处于媒体绕过模式的进行中出站呼叫总数 |
| Media Relay: Media Connectivity Check Failure | perf_counter["\LS:MediationServer - Media Relay\- Media Connectivity Check Failure"] | 因 Mediation Server 与远端端点之间无法建立媒体连通性而失败的呼叫数,该值应尽可能低 |
| Health Indices: Load Call Failure Index | perf_counter["\LS:MediationServer - Health Indices\- Load Call Failure Index"] | 0~100 之间的缩放指数,反映因 Global Health Index 判定为高负载而导致的呼叫失败 |
| Global Counters: Current audio channels with PSM quality reporting | perf_counter["\LS:MediationServer - Global Counters\- Current audio channels with PSM quality reporting"] | 正在上报 PSM(Phase Shift Modulation,相移调制)质量的活跃通道总数;计算 PSM 质量存在处理开销,评估性能时需计入 |
| Total failed calls caused by unexpected interaction from the Proxy | perf_counter["\LS:MediationServer - Global Counters\- Total failed calls caused by unexpected interaction from the Proxy"] | 因 Front End Server 意外响应而失败的呼叫数,该值应尽可能低 |
| Total failed calls caused by unexpected interaction from a gateway | perf_counter["\LS:MediationServer - Global Per Gateway Counters(_Total)\- Total failed calls caused by unexpected interaction from a gateway"] | 因网关对端意外响应而失败的呼叫数,该值应尽可能低 |
这些计数器覆盖了 Mediation Server 健康度的三个关键面:呼叫容量与并发(Current 系列)、媒体绕过效果(bypass 系列,值越高说明越多的媒体流绕过了服务器、资源占用越低)、故障面(连通性检查失败与两类交互失败,均要求越低越好)。
事件日志监控(eventlog)
模板还通过Zabbix agent (active)主动监控 Windows 事件日志中的 CDR(Call Detail Records,呼叫详细记录)适配器问题:
| 监控项名称 | 键 | 类型 | 更新间隔 |
|---|---|---|---|
| CDR adapter problem | eventlog["Lync Server",,,,56207] | Zabbix agent (active) | 180 |
Zabbix 的eventlog键完整语法为eventlog[logname, regexp, severity, source, eventid, maxlines],此处仅使用了两个参数:日志名为Lync Server,事件 ID 为56207——即监控 Lync Server 事件日志中与CDR 适配器问题相关的 56207 号事件。该采集项在导出文件中被标记为value_type: LOG、历史保留7d且trends: 0(不保存趋势数据),并归入 Logs 应用/标签分组。由于它是主动检查(active),需要确保被监控主机上的 Zabbix agent 已启用主动模式并正确配置ServerActive指向 Zabbix server/proxy。
触发器详解:模板内置的 6 个告警
尽管 README 声称模板没有触发器,但实际导出文件(5.0 XML 与 5.4 YAML)中共定义了6 个触发器,可按监控对象分为两类:
呼叫故障类(WARNING 警告级):
| 触发器名称 | 表达式(以 5.4/6.0 全路径形式给出) | 触发条件解读 |
|---|---|---|
| Call failed caused by unexpected interaction from a proxy | last(/App Skype for business Mediation Role/perf_counter["\LS:MediationServer - Global Counters\- Total failed calls caused by unexpected interaction from the Proxy"])>10 | 因前端服务器意外交互导致的呼叫失败速率超过 10/秒 |
| Call failed caused by unexpected interaction from a gateway | last(/App Skype for business Mediation Role/perf_counter["\LS:MediationServer - Global Per Gateway Counters(_Total)\- Total failed calls caused by unexpected interaction from a gateway"])>10 | 因网关意外交互导致的呼叫失败速率超过 10/秒 |
| Lync load call failure index too high | last(/App Skype for business Mediation Role/perf_counter["\LS:MediationServer - Health Indices\- Load Call Failure Index"])>0 | 负载呼叫失败指数大于 0,说明出现高负载导致的呼叫失败 |
| Lync media connectiviti check failures too high | last(/App Skype for business Mediation Role/perf_counter["\LS:MediationServer - Media Relay\- Media Connectivity Check Failure"])>0 | 媒体连通性检查失败计数大于 0(注意:该监控项未做速率换算,>0 即告警) |
服务状态类(AVERAGE 平均级):即上文两个service.info触发器(<>0表示服务状态不是 Running 即告警),用于第一时间发现 Mediation Server 核心服务停摆。
需要说明:5.0 的 XML 导出使用无主机路径的短表达式(如{last(0)}>10、{last()}>0),而 5.4/6.0 的 YAML 使用带完整主机路径的表达式(如上表所示),两种格式分别对应各自版本的触发器表达式规范。
数据预处理:CHANGE_PER_SECOND 速率换算
两个「Total failed calls」计数器(Proxy 与 gateway 两类)在导出文件中均配置了数据预处理步骤:
preprocessing: - type: CHANGE_PER_SECOND parameters: - ''这意味着原始采集值(Windows 性能计数器的累计计数,单调递增)会在入库前被换算为每秒变化量(速率),从而让「>10」的阈值具有明确的物理含义——每秒超过 10 次呼叫失败即触发 WARNING 告警。这也是该类计数器触发条件可读性高的原因:若不经过该预处理,直接用累计值比较阈值将毫无意义。其余计数器(如 Inbound/Outbound Current、bypass 计数、Load Call Failure Index 等)未配置预处理,直接以原始瞬时值入库,适合直接观测并发量与即时健康指数。
内置图形:Lync mediation server call statistics
模板自带一个名为Lync mediation server call statistics的图形(Graph),将四条呼叫统计曲线叠加展示,便于直观对比入站/出站流量与媒体绕过比例:
| 曲线 | 颜色 | 数据来源 |
|---|---|---|
| Inbound Calls: Active media bypass calls | 1A7C11(绿) | Inbound Calls(_total)- Active media bypass calls |
| Inbound Calls: Current | F63100(红) | Inbound Calls(_total)- current |
| Outbound Calls: Active media bypass calls | 2774A4(蓝) | Outbound Calls(_total)- Active media bypass calls |
| Outbound Calls: Current | A54F10(橙) | Outbound Calls(_total)- current |
通过该图形可以快速判断:Current 与 bypass 两条线越接近,说明媒体绕过比例越高,Mediation Server 的媒体转发负载越低——这正是该模板设计上希望运维人员长期观察的核心指标。
在 Zabbix 中导入与使用
导入模板
- 在 Zabbix Web 前端进入Configuration(配置)→ Templates(模板)→ Import(导入);
- 根据你的 Zabbix 主版本选择对应文件:
- Zabbix 5.0:导入 5.0 的 XML 文件;
- Zabbix 5.4 / 6.0:分别导入 5.4 或 6.0 的 YAML 文件;
- 导入后模板名为App Skype for business Mediation Role,位于 Templates 模板组。
链接主机与运行前提
- 该模板必须链接到运行 Windows 的 Lync/Skype for Business Mediation Server 主机,且主机上需安装Zabbix agent——
perf_counter、service.info与eventlog均为 Windows 平台 agent 提供的键; eventlog采集项属于主动检查,需确认 agent 的主动模式配置正确(ServerActive、Hostname与 Zabbix 前端主机名一致);- 模板本身不定义宏、不链接其他模板、不使用发现规则,因此开箱即用,无需额外配置依赖。
仓库中其他 Windows 模板(如 template_ad_ds_health_and_performance/5.0/README.md)同样采用perf_counter、service.info、eventlog这套键组合,可作为理解此类 Windows 监控模板的统一参考。
阈值调优:先观察、后设限
模板 README 反复强调一个关键原则:这些计数器的阈值必须根据你的实际环境来设定。官方建议先对相关计数器持续监控一段时间,摸清正常波动范围,再据此设置阈值。具体落地建议:
- 对
Total failed calls...两个计数器(已做 CHANGE_PER_SECOND 换算),先用 Zabbix 图形观察正常运行期的速率基线,再把触发器的>10调整为「基线 + 合理余量」; - 对
Media Connectivity Check Failure(>0 即告警)与Load Call Failure Index(>0 即告警),如果环境中存在偶发的瞬时抖动导致误报,可结合触发器恢复表达式(如连续 N 次)或调整告警级别来抑制; - 长期追踪
Active media bypass calls与Current的比值,可作为判断媒体绕过策略配置是否生效的参考依据。
注意事项与局限
- 命名与版本覆盖:模板名为 "App Skype for business Mediation Role",README 概述为 "Lync 2013 Mediation role template",描述针对 Skype for Business Server 2015,适用于 Lync 2013 至早期 Skype for Business 部署;
- README 与导出文件不一致:README 声称无触发器,但导出文件实际包含 6 个触发器,请以导出文件内容为准;
- 无阈值参数化:模板未使用任何宏(Macros),触发器阈值均为硬编码数值,环境差异较大时需手动编辑触发器表达式;
- 无发现规则:模板采用静态采集项设计,适用于固定角色的 Mediation Server 主机,不涉及 LLD 自动发现;
- 日志类采集项不保存趋势:CDR adapter problem 采集项
trends: 0,长周期容量规划请以其他性能计数器为主。
总体而言,该模板以 12 个采集项 + 6 个触发器 + 1 个内置图形,覆盖了 Mediation Server 从服务可用性(service.info)、呼叫健康度(失败计数与健康指数)到性能容量(并发呼叫与媒体绕过)的完整监控闭环,是 Zabbix 生态中监控 Lync 2013 / Skype for Business 2015 语音角色的开箱即用方案。
【免费下载链接】community-templates
Zabbix Community Templates repository
相关推荐
AI 在你开口前偷偷读了什么?system_prompts_leaks 系统提示词合集怎么读
AI 在你开口前偷偷读了什么?system_prompts_leaks 系统提示词合集怎么读 system_prompts_leaks 是一个持续更新的仓库,专
Zabbix 监控 Skype for Business 2015 中继服务器(Mediation Role):Lync 2013 模板指标详解与部署指南
Zabbix 监控 Skype for Business 2015 中继服务器(Mediation Role):Lync 2013 模板指标详解与部署指南 本指
Zabbix 8.0 模板实战:使用 Zabbix agent 2 的 Systemd 监控模板监控服务与 Socket 单元
Zabbix 8.0 模板实战:使用 Zabbix agent 2 的 Systemd 监控模板监控服务与 Socket 单元 本篇技术指南围绕 Zabbix
指标监控可观测性告警运维
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考