用途:对 SigNoz 可观测性数据(metrics、logs、traces)生成、编写或运行临时查询,不包装成仪表盘面板或告警。
主要能力:按用户意图选择信号类型(错误率/延迟/吞吐量优先用 metrics,日志文本检索用 logs,单请求细节用 traces,资源利用率用 metrics,摄取量/成本用 source=meter 的 Cost Meter 指标);发现可用数据(signoz_list_metrics、signoz_get_field_keys、signoz_get_field_values、signoz_list_services、signoz_get_service_top_operations);执行查询(signoz_query_metrics、signoz_search_logs、signoz_search_traces、signoz_aggregate_logs、signoz_aggregate_traces、signoz_execute_builder_query);处理结果并区分失败读取、部分结果与完整结果。
使用方式:先确认 signoz_* MCP 工具可用,否则运行 signoz-mcp-setup 初始化或修复 MCP 连接,不要回退到原始 HTTP 调用或编造结果。查询前先发现字段与指标,使用工具返回的名称而非猜测。日志搜索用 filter 与 searchText,searchScope 默认 body;聚合的 aggregation 为单个裸词(count、avg、p50、p99、rate 等),列放在 aggregateOn。signoz_execute_builder_query 需绝对 Unix 毫秒 start/end,并为每个 builder_query 与 builder_formula 设置正 limit 和非空 order。
适用场景:查询/搜索可观测性数据、计算聚合(错误率、p99 延迟、请求数、吞吐量)、查找特定日志或追踪、调查尖峰/下降/趋势、按维度分组计数、Cost Meter 摄取量与成本归因。
限制:不适用于仪表盘面板的原始 ClickHouse SQL;当前 MCP 契约无异常查询工具,无法使用 Exceptions Explorer;traces 无未限定全文搜索,需对已发现的结构化字段用 CONTAINS;字段键按信号区分,不可跨信号复用;Cost Meter 仅保留有限属性集,美元成本需由用量乘以单价推导;部分结果不得当作全量总数或断言“无/全部”。