/metrics 能返回文本,只能证明有一个输出端点。人脸服务中的 SimpleMetric 是占位实现,标签、计时与导出格式都需要独立审查。
标签没有分桶
labels(**kwargs) 直接返回 self,所有 endpoint 和 status 都增加同一个 value。一次成功的对比请求先增加 started,再增加 success,因此这个共享值会增加两次;计数请求也混在同一个对象里。
本次隔离执行原类确认:不同标签返回同一对象,两次调用得到 value=2。导出时却分别把共享值写成 compare 和 count 的 success,读者看到的标签隔离实际上并不存在。
计时器没有计时
time() 返回 self,进入和离开上下文没有记录时间,也没有增加时长统计。request_duration.value 不会因为包裹了请求就自动变成耗时。导出文本声明 histogram,却没有提供通常用于时延分析的 bucket 与 sum。
此外时长样本中,指标名和标签之间夹了空格,例如:
face_recognition_request_duration_seconds_count {endpoint="compare_faces"} 0这不应被当作可信的标准样本格式。实际接入前需要使用解析器验证文本,而不是仅检查 HTTP 200。本文没有运行 Prometheus 解析器,不能把格式疑点说成已完成抓取复现。
正确指标应该回答什么
建议计数器每个请求只在明确生命周期点计一次,结果标签区分成功、样本不可比和内部失败;时长使用真正的 Histogram,并定义是否包含排队。不能把未知结果全记为 different_person,也不能把总结果数仅导出成 same_person。
多进程部署还需要专门处理指标聚合,进程内 value 不会自然变成全服务计数。高基数字段如图片哈希、人脸身份与请求 ID 不应直接成为标签。
验收应同时检查文本可解析、已知请求的计数增量、标签隔离和直方图总数。可观测性的第一原则不是“图上有线”,而是指标能够忠实回答业务与运行问题。
源码与阅读导航
本文属于「人脸识别服务源码笔记」第 11 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。
全部专题与阅读顺序 · 上一篇:模型只加载一次,是每个进程一次而不是整台机器一次 · 下一篇:健康检查返回 200,为什么还不能证明模型服务可用
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。