【免费下载链接】community-templates
Zabbix Community Templates repository
本指南围绕 community-templates 仓库中的「App Skype for business Mediation Role」Zabbix 模板(6.0 版 README)展开,系统讲解如何用 Zabbix 监控 Microsoft Skype for Business Server 2015(前身 Lync 2013)中继服务器角色的运行状态与呼叫性能。读完本文,你将掌握该模板 12 个监控项的完整语义、内置触发器与值映射的工作原理、性能计数器的预处理方式,以及导入部署与阈值基线化的实战方法。
模板定位:它监控什么
根据模板自述(6.0/README.md 的 Description 段落),该模板用于评估 Microsoft Skype for Business Server 2015 中 Mediation Server(中继服务器)角色的服务状态、整体健康状况与性能表现,其监控设计参考了 Microsoft TechNet 文档(文档编号 gg398616,原文中已注明出处)。
在 Skype for Business / Lync 拓扑中,中继服务器是企业语音基础设施与 PSTN(公共交换电话网)网关之间的桥接组件,负责 SIP 信令的中转与媒体流的转发,直接决定了呼入呼出电话的可用性与质量。模板作者将其定位于"Lync 2013 Mediation role template",因此该模板既适用于 Lync Server 2013 环境,也适用于延续自 Lync 的 Skype for Business Server 2015 环境。
模板通过三类采集手段覆盖"状态 + 性能"两个维度:
- Windows 性能计数器(perf_counter):采集呼入/呼出呼叫量、Media Bypass 呼叫、健康指数、媒体中继连通性、PSM 质量通道等性能指标;
- Windows 服务状态(service.info):监测
Lync Server Mediation与Lync Server Replica Replicator Agent两个关键服务是否在运行; - Windows 事件日志(eventlog,主动采集):监测
Lync Server日志中与 CDR 适配器故障相关的事件。
需要特别说明:模板 README 中明确提醒,各计数器的告警阈值需要根据自身环境设定,建议先持续观察一段时间,摸清指标的正常波动范围后再确定阈值。这与模板内置触发器的"从简从宽"设计是一致的(详见下文触发器章节)。
仓库中的模板文件与版本支持
该模板在仓库中按 Zabbix 大版本分目录存放,同一模板存在三种导出格式:
| 目录 | 导出格式 | 适用 Zabbix 版本 |
|---|---|---|
| 5.0 | XML | Zabbix 5.0 |
| 5.4 | YAML | Zabbix 5.4 |
| 6.0 | YAML | Zabbix 6.0 |
三个版本的模板实体内容完全一致(模板名均为App Skype for business Mediation Role),只是序列化格式与 Zabbix 版本适配不同。本文以关联文档所在的 6.0 版本 为主线,其 YAML 导出文件中保留了最完整的机器可读细节(触发器、预处理、值映射、图形、标签),可作为 README 的重要补充。
模板总体结构:无宏、无模板链接、无发现规则
原文档明确列出了模板结构的几个"空"部分,这在 Zabbix 模板中属于正常且常见的简化设计:
- 宏(Macros):无 —— 模板不依赖任何用户宏或模板宏,所有阈值直接固化在触发器表达式中;
- 模板链接(Template links):无 —— 模板独立完成全部采集,不继承其他模板;
- 发现规则(Discovery rules):无 —— 模板使用静态监控项,监控对象固定为本地中继服务器的性能计数器与服务,无需 LLD 自动发现。
因此,该模板的完整构成就是:12 个监控项 + 6 条触发器 + 1 个值映射 + 1 个图形 + 3 组标签。
监控项全景:12 个监控项完整清单
下表完整收录了原 README 的监控项清单,并补充了从 6.0 YAML 导出文件 中可确认的采集间隔(Update)、预处理与标签信息:
| 监控项名称 | 说明 | 类型 | 键值与附加信息 |
|---|---|---|---|
| Outbound Calls: Current | 返回正在通过中继服务器的活动呼叫总数 | Zabbix agent | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- current"],Update: 60 |
| Health Indices: Load Call Failure Index | 返回与"因负载过高导致呼叫失败"相关的 Global Health Index,取值缩放为 0~100 的指数 | Zabbix agent | perf_counter["\LS:MediationServer - Health Indices\- Load Call Failure Index"],Update: 60 |
| Outbound Calls: Active media bypass calls | 返回以 Media Bypass 模式通过中继服务器的活动呼叫总数。Media Bypass 呼叫不经过中继服务器转发媒体,消耗的中继服务器资源显著更少 | Zabbix agent | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- Active media bypass calls"],Update: 60 |
| CDR adapter problem | 监测 Lync Server 事件日志中与 CDR(通话详细信息记录)适配器问题相关的事件 | Zabbix agent (active) | eventlog["Lync Server",,,,56207],Update: 180,历史保留 7 天,不保存趋势,值类型为 LOG |
| Inbound Calls: Current | 返回正在进行中的呼入呼叫数 | Zabbix agent | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- current"],Update: 60 |
| Inbound Calls: Active media bypass calls | 返回正在进行中的 Media Bypass 呼入呼叫数 | Zabbix agent | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- Active media bypass calls"],Update: 60 |
| Global Counters: Current audio channels with PSM quality reporting | 返回启用了 PSM(Phase Shift Modulation,相移键控)质量上报的活动音频通道总数。计算 PSM 质量存在处理开销,评估性能时需考虑该因素 | Zabbix agent | perf_counter["\LS:MediationServer - Global Counters\- Current audio channels with PSM quality reporting"],Update: 60 |
| Total failed calls caused by unexpected interaction from a gateway | 返回因网关对端返回意外响应而失败的呼叫数,该值应尽可能低 | Zabbix agent | perf_counter["\LS:MediationServer - Global Per Gateway Counters(_Total)\- Total failed calls caused by unexpected interaction from a gateway"],Update: 60,预处理 CHANGE_PER_SECOND |
| Service: Lync Server Mediation | 中继服务器核心服务的运行状态 | Zabbix agent | service.info["Lync Server Mediation", state],Update: 300,值映射 Windows service state |
| Service: Lync Server Replica Replicator Agent | Lync Server 副本复制代理服务的运行状态 | Zabbix agent | service.info["Lync Server Replica Replicator Agent", state],Update: 300,值映射 Windows service state |
| Total failed calls caused by unexpected interaction from the Proxy | 返回因前端服务器(Front End Server)返回意外响应而失败的呼叫数,该值应尽可能低 | Zabbix agent | perf_counter["\LS:MediationServer - Global Counters\- Total failed calls caused by unexpected interaction from the Proxy"],Update: 60,预处理 CHANGE_PER_SECOND |
| Media Relay: Media Connectivity Check Failure | 返回中继服务器与远端端点之间无法建立媒体连通性的呼叫数,该值应尽可能低 | Zabbix agent | perf_counter["\LS:MediationServer - Media Relay\- Media Connectivity Check Failure"],Update: 60 |
实用提示:上表中的性能计数器键包含反斜杠与连字符组合(如
\-),转写时请直接从仓库的 README 或 YAML 文件复制键值,不要手工重新输入,避免因计数器路径不匹配导致采集无数据。键中的\LS:MediationServer - ...是 Lync 性能对象(Perfmon 中对应 "LS:MediationServer" 计数器集)的完整路径。
性能计数器类监控项解读
性能计数器的采集间隔统一为60 秒,覆盖中继服务器的三条核心观测线:
呼叫流量线:
Inbound Calls: Current、Outbound Calls: Current直接反映当前并发呼叫规模,是最直观的容量与负载观测指标;Inbound Calls: Active media bypass calls、Outbound Calls: Active media bypass calls则反映走 Media Bypass 的呼叫比例。由于 Bypass 呼叫的媒体流不经过中继服务器,其占比越高,中继服务器单位呼叫的资源消耗越低——这也是模板说明中特别强调"Bypass 呼叫消耗资源显著更少"的原因。失败与健康线:
Total failed calls caused by unexpected interaction from a gateway(网关对端异常响应导致的失败)、Total failed calls caused by unexpected interaction from the Proxy(前端服务器异常响应导致的失败)、Media Relay: Media Connectivity Check Failure(媒体连通性检查失败)三个指标在模板中均被注明"返回的值应尽可能低",是发现网关/前端协作异常与媒体路径故障的关键信号;Health Indices: Load Call Failure Index则将负载相关的失败情况归一化为 0~100 的健康指数。质量开销线:
Current audio channels with PSM quality reporting反映启用 PSM 质量上报的通道数。模板说明明确指出,计算 PSM 质量存在额外处理开销,因此在评估中继服务器性能时,应把这个通道数纳入资源预算考量。
事件日志类监控项
CDR adapter problem是模板中唯一的事件日志监控项(YAML 导出 中type: ZABBIX_ACTIVE、value_type: LOG),键值eventlog["Lync Server",,,,56207]的含义是:在 "Lync Server" 事件日志源中,匹配事件 ID 为 56207 的日志条目(事件 ID 位于键的第 5 个参数位)。CDR(Call Detail Recording)负责记录通话详细信息,其适配器异常会影响计费与报表数据的完整性,因此模板将其作为独立监控项采集。
需要留意的是:该监控项类型为ZABBIX_ACTIVE(主动式),要求被监控主机上的 Zabbix agent 启用主动检查(配置ServerActive指向 Zabbix server 或 proxy)。该监控项采集间隔 180 秒,历史数据保留 7 天,不保存趋势(trends: '0'),符合日志类监控项的存储惯例。
服务状态类监控项
两个服务监控项均使用service.info["<服务名>", state]键(采集间隔 300 秒),返回的是Windows 服务状态码,并通过模板内置的值映射Windows service state转换为可读文本:
Lync Server Mediation:中继服务器核心服务,对应触发器"Lync Server Mediation service stopped";Lync Server Replica Replicator Agent:副本复制代理服务,对应触发器"Lync Server Replica Replicator Agent service stopped"。
预处理:将累计计数器转换为每秒速率
在 6.0 YAML 导出 中,两个"Total failed calls"监控项(网关异常、代理异常)均配置了预处理步骤:
preprocessing: - type: CHANGE_PER_SECOND parameters: - ''CHANGE_PER_SECOND是 Zabbix 内置预处理类型,其作用是把"两次采集之间的增量除以时间差",从而将累计型计数器(counter)转换为每秒变化率。Windows 性能计数器中带Total的失败计数通常是单调递增的累计值,直接展示绝对值没有参考意义(只会一路变大);经过本预处理后,指标变成"每秒新增失败呼叫数",既便于横向对比,也使得触发器阈值(如 >10)具有明确的物理含义。
同理,模板其余计数器(如current系列)本身是瞬时值(gauge),无需此类预处理。
触发器:内置告警规则一览
原 README 的 Triggers 一节标注为"无触发器",但对照 6.0 模板导出文件 可以发现,模板实际内置了 6 条触发器(README 未同步更新,应以机器可读的模板导出为准)。完整清单如下:
| 触发器名称 | 表达式(简化) | 优先级 | 监控项 |
|---|---|---|---|
| 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 | WARNING | Total failed calls caused by unexpected interaction from the Proxy |
| 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 | WARNING | Total failed calls caused by unexpected interaction from a gateway |
| 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 | WARNING | Health Indices: Load Call Failure Index |
| 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 | WARNING | Media Relay: Media Connectivity Check Failure |
| Lync Server Mediation service stopped | last(/App Skype for business Mediation Role/service.info["Lync Server Mediation", state])<>0 | AVERAGE | Service: Lync Server Mediation |
| Lync Server Replica Replicator Agent service stopped | last(/App Skype for business Mediation Role/service.info["Lync Server Replica Replicator Agent", state])<>0 | AVERAGE | Service: Lync Server Replica Replicator Agent |
(注:触发器名称中的 "connectiviti" 为模板原始命名,本文保留原样。)
从表达式设计可以看出两条规律:
- 两个失败率触发器的阈值同为
>10,由于监控项已经过CHANGE_PER_SECOND预处理,其含义是"每秒新增失败呼叫数超过 10"即告警; - 健康指数与媒体连通性触发器采用
>0的"零容忍"策略——只要出现任何负载相关呼叫失败或媒体连通性检查失败就告警(WARNING); - 两个服务触发器采用
<>0判定,即状态码不为 0(Running)即触发 AVERAGE 级告警,与服务状态值映射的 0=Running 语义严格对应。
需要再次强调的是模板 README 的告诫:这些阈值是作者环境下的经验值,并不保证适用于你的生产环境。建议部署后先以"仅记录、不告警"的方式观察指标基线(例如 1~2 周),再结合业务容忍度调整阈值与优先级。
值映射:Windows service state
模板为服务状态监控项定义了一个值映射Windows service state,将service.info[..., state]返回的 Windows 服务状态码翻译为可读文本(来源:6.0 YAML 导出 的 valuemaps 段落):
| 原始值 | 映射文本 |
|---|---|
| 0 | Running |
| 1 | Paused |
| 2 | Start pending |
| 3 | Pause pending |
| 4 | Continue pending |
| 5 | Stop pending |
| 6 | Stopped |
| 7 | Unknown |
| 255 | No such service |
该值映射覆盖了 Windows 服务控制管理器(SCM)的全部标准状态码,包括 255(服务不存在)这一在主机角色变更后常见的情形,使得告警消息与监控图表直接显示人类可读的服务状态,而非裸数字。
内置图形:Lync mediation server call statistics
模板附带一个名为Lync mediation server call statistics的图形,将 4 个呼叫统计指标聚合到同一张图中,便于直观对比呼入/呼出流量与 Media Bypass 占比:
| 图项 | 键值 | 颜色 |
|---|---|---|
| Inbound Calls: Active media bypass calls | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- Active media bypass calls"] | 1A7C11(绿) |
| Inbound Calls: Current | perf_counter["\LS:MediationServer - Inbound Calls(_total)\- current"] | F63100(红) |
| Outbound Calls: Active media bypass calls | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- Active media bypass calls"] | 2774A4(蓝) |
| Outbound Calls: Current | perf_counter["\LS:MediationServer - Outbound Calls(_total)\- current"] | A54F10(橙) |
从颜色与排序设计可以推断作者意图:红/橙代表总体呼叫量,绿/蓝代表 Media Bypass 子集,两两成组,一眼即可看出 Bypass 占比及双向流量的对称性。
标签体系
6.0 导出文件为全部监控项配置了三组Application标签,便于在 Zabbix 前端按应用维度筛选:
- Logs:仅用于
CDR adapter problem(事件日志类); - Lync performance:全部 9 个性能计数器监控项;
- Services:两个服务状态监控项。
部署与使用步骤
按 community-templates 仓库根 README 的通用使用方式,结合本模板特性,推荐部署流程如下:
下载对应版本的模板文件:根据 Zabbix 版本选择 5.0 XML、5.4 YAML 或 6.0 YAML。
导入模板:在 Zabbix 前端进入「数据采集 → 模板」,点击导入并上传模板文件。模板名为
App Skype for business Mediation Role,会一并导入其所属模板组Templates。关联主机:为中继服务器创建(或选择)主机,在「模板」选项卡中链接该模板。主机应为运行 Skype for Business / Lync 2013 中继服务器角色的Windows 服务器。
确认 Zabbix agent 配置:
- 性能计数器(
perf_counter)与服务状态(service.info)监控项走被动检查,Windows agent 需正常运行; CDR adapter problem是主动检查(ZABBIX_ACTIVE),需要在 agent 配置中正确设置ServerActive=<Zabbix server/proxy 地址>,否则该监控项将无数据。
- 性能计数器(
观察与调优:按模板说明,先持续观察各计数器一段时间,确认正常波动范围后,再按需调整 6 条内置触发器的阈值与优先级。
常见问题与排查提示
结合模板结构与采集机制,以下几点可作为排障线索:
- 某个 perf_counter 监控项无数据:优先检查键值是否因手工转写而变形(务必原样复制),其次确认 Windows 端性能对象
LS:MediationServer是否存在——若主机并非中继服务器角色或 Lync 组件未安装,计数器对象不存在,采集自然失败; - CDR adapter problem 长期无数据:该监控项匹配的是事件 ID 56207 的日志条目,属于"事件驱动"型监控——没有该事件发生即没有数据属于正常现象;同时确认 agent 主动检查链路(ServerActive、被动/主动端口、TLS 配置)可用;
- 服务状态显示为 No such service(255):说明 Windows 端不存在该服务名,常见于服务名变更或主机上未安装对应角色组件,此时服务触发器会被触发,需核实主机角色配置;
- 告警过于频繁/完全不告警:模板内置阈值(失败率 >10、健康指数 >0)为作者环境经验值,应依据自身基线数据调整,这与模板 README 的明确建议一致。
相关文件索引
- 本文关联文档:6.0 版 README
- 6.0 模板导出(含触发器/预处理/值映射/图形完整定义):template_lync_2013_mediation_role.yaml
- 5.4 版本:README 与 YAML 导出
- 5.0 版本:README 与 XML 导出
如需查阅本模板在整个仓库中的组织方式,可参见仓库根 README.md 的模板索引部分。
【免费下载链接】community-templates
Zabbix Community Templates repository
相关推荐
AI 在你开口前偷偷读了什么?system_prompts_leaks 系统提示词合集怎么读
AI 在你开口前偷偷读了什么?system_prompts_leaks 系统提示词合集怎么读 system_prompts_leaks 是一个持续更新的仓库,专
HPE ProLiant DL380 服务器监控:Zabbix SNMP 模板全解析与部署指南
HPE ProLiant DL380 服务器监控:Zabbix SNMP 模板全解析与部署指南 本文以 Zabbix 官方仓库中 templates/serve
指标监控可观测性告警运维Zabbix 监控 Unbound 递归 DNS 服务器:模板指标详解、部署流程与采集原理(community-templates)
Zabbix 监控 Unbound 递归 DNS 服务器:模板指标详解、部署流程与采集原理(community templates) 导读 本文围绕 commu
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考