用途:回答 ServiceNow 中两类常见问题——“实例变慢”和“夜间定时任务从未运行”,通过读取平台自身遥测数据(事务日志、syslog、sys_trigger、进度 worker 等)来定位原因,而不是再写 GlideRecord 扫描加重实例负担。
主要能力:
- 性能排查:先用 snow_get_inbound_http_logs 读取 syslog_transaction 并按响应时间排序;再用 snow_query_table 查询 syslog_transaction 的 response_time、sql_time、sql_count、business_rule_time、network_time、output_length 等字段,对照模式判断是慢 SQL、N+1、业务规则开销、网络问题还是返回负载过大。
- 单条慢查询分析:用 snow_analyze_query 查看 sys_db_index 索引列表;注意 estimated_performance 和反模式列表是本地根据字符串计算,并非实测。
- 定时任务排查:分两层看——sysauto(及 sysauto_script 等子表)保存任务定义,sys_trigger 保存队列条目。用 snow_scheduled_job_manage 查看定义,再用 snow_query_table 查 sys_trigger 的 state、next_action、claimed_by 等字段,识别卡住、被死节点认领、无线程等状态。
- 长任务排查:查询 sys_progress_worker 和 sys_execution_tracker 判断导入、修复脚本等是否停滞。
必要用法:查询前先用 snow_discover_table_fields 确认字段存在;对子表要查整条继承链,如 snow_query_table 查 sys_dictionary 时用 nameINsysauto,sysauto_script。state 数字编码不确定时,用 snow_query_table 查 sys_choice(name=sys_trigger^element=state)确认,或使用 display_value: true。
限制:Table API 对不存在的字段不会报错,会丢弃条件并返回未过滤结果,需警惕“结果集完整不代表过滤生效、结果为空不代表实例健康”。sys_trigger 的 state 数值映射仅为社区说法、未见于官方文档且仓库内互相矛盾;sys_progress_worker 与 sys_execution_tracker 的 state 编码也未文档化。snow_get_slow_queries 并不读取官方 Slow Queries 日志,其空结果会返回“未发现性能问题”的误导性建议。平台 Slow Queries 日志位于 All > System Diagnostics > Stats > Slow Queries,本 MCP 工具无法读取。