用途:为系统行为提供可观测性,采集并导出 Prometheus 兼容指标,用于构建仪表盘、配置告警和排查性能问题。适用于需要了解请求速率与延迟、跟踪业务指标(注册、转化)、调试性能问题的场景。
主要能力:提供三种指标类型——Counter(只增,如请求数、错误数)、Gauge(当前值,如活跃连接数、队列长度)、Histogram(数值分布,如请求延迟、响应大小)。MetricsRegistry 支持注册指标、递增计数器、设置/增减仪表、观测直方图、计时器辅助,并可将指标导出为 Prometheus 文本格式或 JSON。资料提供 TypeScript 与 Python 两种实现,并预注册了 http_requests_total、errors_total、http_request_duration_seconds、active_connections、queue_size 等常用指标。
使用方式:注册指标后,在业务代码中调用对应方法记录数据;通过 /metrics 端点返回 metrics.toPrometheus() 输出,Content-Type 设为 text/plain; charset=utf-8。示例包括 HTTP 请求跟踪、队列监控、业务指标记录。
最佳实践:命名一致(snake_case,名称含单位如 _seconds、_bytes);保持标签基数低;启动时预注册指标;延迟用直方图而非仪表。常见错误:使用高基数标签(如 user_id)、用仪表记录延迟、未预注册、名称缺单位、直方图桶过多。
限制:资料未提供安装命令、依赖要求、性能上限、收费或平台支持信息,暂未提供。相关模式包括 health-checks、anomaly-detection、logging-observability。