【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本篇技术指南围绕 community-templates 仓库中Applications/NTP/template_chrony_accuracy_1目录下的 chrony_Monitoring 模板展开完整讲解如何基于 Zabbix agent 主动采集模式将chronyc命令输出的全部同步精度信息offset、stratum、reach、root delay、Leap status 等转化为可监控、可告警的 Zabbix 监控项与触发器。读完本文你将掌握该模板的导入前置条件、13 个监控项的采集原理、宏变量与触发器的工作方式以及将其落地到生产环境时的注意事项。模板概述与定位chrony_Monitoring 是一套以「chrony 时间同步精度信息」为监控对象的 Zabbix 模板README 原文描述为chrony accuracy Information Template德语注释Sammeln Sie alle Informationen, die in der chronyc Befehl angezeigt wird意为「收集 chronyc 命令中显示的所有信息」。它面向安装了 Zabbix agent 且运行 chrony 的 Linux 主机通过远程执行chronyc tracking、chronyc sources、chronyc -v等命令将 chrony 内部的时间偏差、同步层级、网络延迟、轮询周期等状态持续上报到 Zabbix。该模板在仓库中的位置与对应版本文件如下5.0/README.md本文主体文档5.0/template_chrony_accuracy_1.xmlZabbix 5.0 导入文件5.4/template_chrony_accuracy_1.yamlZabbix 5.4 导入文件6.0/template_chrony_accuracy_1.yamlZabbix 6.0 导入文件模板内部名称为chrony_Monitoring显示名称chrony归属模板组HomeRackUserGroupTemplates所有监控项均挂载到名为chrony的应用application下。三个版本文件内容一致仅导出格式与语法随 Zabbix 版本不同5.0 为 XML5.4/6.0 为 YAML。部署前置条件启用 agent 远程命令该模板的所有监控项都依赖 Zabbix agent 的system.run[...]键在目标主机上执行命令因此在被监控主机的 agent 配置文件中必须显式开启两个开关README 明确要求修改zabbix_agentd.confEnableRemoteCommands1 UnsafeUserParameters1EnableRemoteCommands1允许 Zabbix server 通过 agent 远程执行命令即system.run键生效的前提。UnsafeUserParameters1允许在用户自定义参数与远程命令中使用特殊字符。模板的监控项 key 内包含管道符|、引号与空格如system.run[chronyc tracking |grep Last offset|awk {print$4}]没有该开关这些 key 会被 agent 拒绝执行。配置完成后需重启 agent 服务使配置生效。需要特别注意的是system.run会以 agent 进程通常为zabbix用户的权限在主机上执行任意命令开启远程命令会放大攻击面生产环境应结合防火墙、agent 访问控制如Server/ServerActive白名单与严格的宏覆写来收敛风险。部署流程可归纳为三步从上述对应版本目录下载模板文件在 Zabbix Web 界面通过Configuration → Templates → Import导入将模板链接Link到目标主机——主机上需安装 Zabbix agent本文场景为 agent 主动模式并运行 chrony 服务按环境覆写模板宏见下文「宏变量」一节等待数据采集。模板结构总览README 明确声明该模板不含模板链接Template links、不含发现规则Discovery rules即它是一套完全独立的、基于固定监控项的模板不依赖其他模板也不使用低级别发现LLD动态生成监控项。其完整结构由以下三部分构成组成部分内容宏变量{$NTP_OFFSET}、{$NTP_OFFSET_LARGE}监控项13 个全部为Zabbix agent (active)类型ZABBIX_ACTIVE触发器3 个见下文「触发器详解」一个值得注意的细节README 的 Triggers 一节标注为There are no triggers in this template但从 5.0/template_chrony_accuracy_1.xml 的导出内容看模板实际内置了 3 个触发器。README 与模板实体存在出入实际生效的告警以 XML/YAML 导入后的实体为准。宏变量时间偏差告警阈值模板定义了两个文本型Text macro宏变量用于控制「时间偏差过大」告警的阈值单位毫秒NameDescriptionDefaultType{$NTP_OFFSET}-50Text macro{$NTP_OFFSET_LARGE}-5000Text macro{$NTP_OFFSET}默认 50面向较敏感的小偏差场景对应 INFO 级提示{$NTP_OFFSET_LARGE}默认 5000面向偏差明显恶化的大偏差场景对应 WARNING 级告警。引用关系上WARNING 触发器使用{$NTP_OFFSET_LARGE}INFO 触发器在 XML 表达式中引用的是{$NTP_OFFSET_SMALL}而模板宏列表中并未定义该宏仅定义了{$NTP_OFFSET}与{$NTP_OFFSET_LARGE}。从源码结构看这应当是模板作者命名不一致所致实际使用时建议将{$NTP_OFFSET_SMALL}定义为主机/模板级宏或直接复用{$NTP_OFFSET}默认 50ms作为 INFO 阈值否则该触发器会因宏缺失而无法正常求值。监控项详解13 个指标全解析模板共采集 13 个监控项全部为主动模式ZABBIX_ACTIVE数据由 agent 主动推送server 无需对每个被监控主机单独轮询。下表汇总了各监控项的名称、采集 key、更新间隔、值类型与预处理方式依据 XML 导出整理监控项名称采集 key更新间隔值类型单位预处理chrony Versionsystem.run[chronyc -v]3600sCHAR--chronyc sourcessystem.run[chronyc sources]600sTEXT--NTP synchronized serversystem.run[chronyc sources\|grep \* \|awk {print$2}]600sCHAR--NTP stratumsystem.run[chronyc sources\|grep \* \|awk {print$3}]1800s---chronyReachsystem.run[chronyc sources\|grep \* \|awk {print$5}]600s--OCTAL_TO_DECIMALchronyc trackingsystem.run[chronyc tracking]600sTEXT--NTP offsetsystem.run[chronyc tracking \|grep Last offset\|awk {print$4}]600sFLOATmsMULTIPLIER1000Leap statussystem.run[chronyc tracking \|grep Leap status\|awk {print$4}]600sCHAR--NTP offset (long term average)system.run[chronyc tracking \|grep RMS offset\|awk {print$4}]600sFLOATmsMULTIPLIER1000Network total delaysystem.run[chronyc tracking \|grep Root delay\|awk {print$4}]10sFLOATmsMULTIPLIER1000NTP time difference (ms)system.run[chronyc tracking \|grep System time\|awk {print$4}]10sFLOATmsMULTIPLIER1000NTP time difference (direction)system.run[chronyc tracking \|grep System time\|awk {print$6}]10sCHAR--NTP pollingsystem.run[chronyc tracking \|grep Update interval\|awk {print$4}]600sFLOATs-两类原始全量文本监控项chronyc tracking与chronyc sources的历史保留期为 60 天history: 60d且不存储趋势trends: 0用于保留命令原始输出便于排障其余派生监控项则直接解析出结构化数值。chronyc tracking 数据源及其字段解析chronyc tracking输出 chrony 当前的同步状态模板用grep定位到具体行、再用awk {print$N}取出第 N 列。以常见输出格式为例行首字段编号从 1 开始$1为单词、$2为字段名、$3为冒号、$4起为数值/状态各派生监控项的取值逻辑如下监控项提取来源解析说明NTP offsetLast offset行第 4 列最近一次时钟更新时估算的本地偏差时间偏差MULTIPLIER 1000将秒换算为毫秒NTP offset (long term average)RMS offset行第 4 列偏差值的长期均方根平均用于观察趋势而非瞬时值Network total delayRoot delay行第 4 列到 stratum-1 时间源的网络总往返延迟更新间隔 10s敏感度最高NTP time difference (ms)System time行第 4 列NTP 时间与系统时间之间的差值数值NTP time difference (direction)System time行第 6 列差值的方向即系统时间相对 NTP 时间是fast快还是slow慢CHAR 型NTP pollingUpdate interval行第 4 列与 NTP 服务器的同步间隔秒FLOAT 型单位sLeap statusLeap status行第 4 列闰秒状态取值包括Normal正常、Insert second插入闰秒、Delete second删除闰秒、Not synchronized未同步其中四个 ms 单位监控项NTP offset、long-term average、Network total delay、NTP time difference (ms)在 XML/YAML 中均配置了MULTIPLIER预处理步骤、参数1000。由于chronyc tracking中这些数值以「秒」为单位输出可以推断该预处理的作用是把秒换算成毫秒使监控项单位ms与数值语义一致也便于直接与宏阈值ms比较。chronyc sources 数据源及其字段解析chronyc sources列出所有已配置时间源及其状态。模板通过grep \*过滤出当前被选中的同步源行chrony 用*标记当前参考同步源表示通过时钟错误检查的候选源-表示不可用源等再按列提取监控项提取来源解析说明NTP synchronized server同步源行第 2 列当前同步源的主机名/IPReference 标识NTP stratum同步源行第 3 列同步源的 stratum 层级数值越小越接近权威时钟chronyReach同步源行第 5 列最近 8 次轮询的成功情况以 8 位二进制/八进制数表达README 日文注释原文为「過去8回の問合せ成功回数を8ビットで表現します」chronyReach的预处理值得单独说明chrony 输出的是八进制形式如377表示最近 8 次轮询全部成功模板为其配置了OCTAL_TO_DECIMAL预处理步骤将八进制字符串转换为十进制数值便于后续数值型阈值判断——例如377八进制→ 255十进制而0表示 8 次轮询全部失败可用作同步链路健康度的量化指标。版本信息监控chrony Version通过system.run[chronyc -v]采集值类型 CHAR更新间隔 3600 秒每小时一次。该监控项用于记录 chrony 客户端版本便于在升级或排障时对照版本行为差异。触发器详解XML 中实际内置的 3 个告警尽管 README 标注无触发器但导入文件中实际定义了 3 个触发器全部挂在监控项之上1. NTP 大偏差告警WARNING表达式5.4/6.0 YAML 语法last(/chrony_Monitoring/system.run[chronyc tracking |grep Last offset|awk {print$4}]){$NTP_OFFSET_LARGE} or last(/chrony_Monitoring/system.run[chronyc tracking |grep Last offset|awk {print$4}])-{$NTP_OFFSET_LARGE}名称Misalignment of the upper NTP has exceeded the {$NTP_OFFSET_LARGE}ms优先级 WARNING。当最近一次偏差绝对值超过{$NTP_OFFSET_LARGE}默认 5000ms时触发。2. NTP 小偏差提示INFO依赖上述 WARNING表达式结构与上一条相同只是阈值换为{$NTP_OFFSET_SMALL}优先级 INFO名称为Misalignment of the upper NTP has exceeded the {$NTP_OFFSET_SMALL}ms。该触发器声明了对 WARNING 触发器的依赖关系dependencies当大偏差 WARNING 已触发时INFO 触发器不会重复告警避免告警风暴。3. 未同步告警WARNINGMULTIPLE 类型表达式5.4/6.0 YAML 语法((find(/chrony_Monitoring/system.run[chronyc tracking |grep Leap status|awk {print$4}],,regexp,Not synchronized))0)名称Not synchronized with the NTP server.优先级 WARNING类型为MULTIPLE。当Leap status文本中匹配到Not synchronized时触发直接表达「主机已与 NTP 服务器失去同步」这一关键故障状态。使用提醒触发器 2 引用的{$NTP_OFFSET_SMALL}未在模板宏中定义导入后请务必在模板或主机级补全该宏或改为复用{$NTP_OFFSET} 50否则 INFO 触发器无法正确评估。数据采集原理与命令解读模板的核心技术手段是 Zabbix agent 的system.run键在目标主机上执行 shell 命令管道。其通用模式为system.run[命令 | grep 关键字 | awk {print$N}]执行链路可概括为三层命令层chronyc tracking/chronyc sources/chronyc -v输出原始文本过滤层grep按关键字如Last offset、System time或同步标记\*定位目标行——注意模板中grep \*对星号做了转义避免被当作正则通配符提取层awk {print$N}取出行内第 N 个空白分隔字段得到纯数值或状态字符串。更新间隔的设计体现了指标敏感度差异Network total delay与NTP time difference系列为10 秒高频采集网络延迟与实时偏差波动快、告警响应需及时NTP stratum为1800 秒低频采集层级变化极少chrony Version为3600 秒版本基本不变。在 agent 主动模式下这些间隔由 agent 端依据 server 下发配置执行能够将大量细粒度采样集中到少量主机上减轻 server 轮询压力。运维实践与注意事项数据不更新时的排查顺序确认zabbix_agentd.conf中EnableRemoteCommands1与UnsafeUserParameters1已生效配置后需重启 agent在 agent 主机上手工执行chronyc tracking、chronyc sources确认 chrony 服务运行且命令有输出——注意 chrony 客户端与chronyd守护进程的 socket 权限agent 运行用户需有访问权限检查 agent 是否为主动模式并正确配置ServerActive确认 server 端主机界面模板已链接查看监控项最新数据与错误信息system.run在命令执行失败时通常返回不可用Not supported状态可从 Zabbix 日志定位。安全与权限由于所有监控项都依赖system.run远程命令执行建议将 agent 的Server/ServerActive限定为可信 Zabbix server 地址在无需动态调整时保持最小化配置若对命令注入敏感可考虑改用 UserParameter 白名单化改造仓库内 template_chrony_accuracy_english 的 5.4/6.0 版本采用「主监控项 依赖项」结构是降低远程命令面的一种变体思路可作为改造参考。阈值与告警调优{$NTP_OFFSET}50ms与{$NTP_OFFSET_LARGE}5000ms为通用默认值。对时延敏感的业务如数据库集群、分布式事务建议收紧小阈值对仅需粗粒度健康检查的环境可适当放宽。同时记得为 INFO 触发器补全{$NTP_OFFSET_SMALL}宏否则该告警长期失效。仓库内的相关模板community-templates 仓库的 Applications/NTP 目录下还提供了多套可对比选用的兄弟模板template_chrony_accuracyApp Chrony Service同样基于chronyc tracking但额外采集proc.num[,chrony]进程数与chronyd --versiontemplate_chrony_accuracy_english本文模板的英文版5.4/6.0 采用依赖项Dependent item结构template_chrony_accuracy_japanese日文版template_ntp_accuracy面向传统ntpd/ntpq的同类精度监控模板。结语chrony_Monitoring 是一套轻量、无需外部脚本的 chrony 精度监控方案通过 13 个system.run监控项完整覆盖chronyc输出中的偏差、层级、延迟、轮询与同步状态配合内置的偏差阈值告警与「未同步」检测能够在时间漂移演变为业务故障前给出预警。部署时只需两步关键配置EnableRemoteCommands1、UnsafeUserParameters1、一次模板导入与宏覆写即可投入使用若需更深度的告警策略或更小的远程命令面可参考仓库内 5.4/6.0 YAML 实体定义进行二次改造。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐用 Zabbix 监控 NTP 精度community-templates 中 template_ntp_accuracy_japanese 模板实战与 ntpq 字段解析用 Zabbix 监控 NTP 精度community templates 中 template_ntp_accuracy_japanese 模板实战与 ntZabbix 监控 chrony NTP 精度template_chrony_accuracy_japanese 模板完整实战指南Zabbix 监控 chrony NTP 精度template_chrony_accuracy_japanese 模板完整实战指南 本文基于 Zabbix C使用 Zabbix 社区模板 chrony_Monitoring 监控 chrony NTP 精度chronyc 指标采集、预处理与告警实战使用 Zabbix 社区模板 chrony_Monitoring 监控 chrony NTP 精度chronyc 指标采集、预处理与告警实战 本文以 Zabb上一篇Zephyr 支持 Intel Integrated Sensor Hub (ISH)从固件构建到 ADL RVP 板卡调试实战下一篇Security-101 基础设施安全关键概念安全卫生、态势管理、补丁与容器安全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考