#metrics #process #façade #generic #time #prometheus-style

metrics-process-promstyle

针对通用度量门面的 Prometheus 风格 '进程度量'

1 个不稳定版本

0.18.0 2022年4月1日

#339#metrics

Download history 16/week @ 2024-03-10 1/week @ 2024-03-17 28/week @ 2024-03-31 1/week @ 2024-04-07

188 每月下载量

MIT/Apache

14KB
50

metrics-process-promstyle: 通用度量门面的 Prometheus 风格进程度量

此软件包为后端无关的 metrics 门面提供 Prometheus 风格的 '进程度量'

尽管这些度量使用传统的 Prometheus 名称,但它们可以与任何 metrics-兼容的导出器一起使用!

进程度量包括以下有用的统计数据

  • CPU 时间
  • 内存使用量
  • 进程启动时间
  • 线程数量

未实现的进程度量

  • process_open_fds
  • process_max_fds
  • process_virtual_memory_max_bytes
  • process_heap_bytes

使用方法

设置好度量导出器后,您可以使用 describe() 描述进程度量。

metrics 软件包只提供 'push'-风格的度量;目前没有办法按需发出统计数据。因此,此软件包公开了一个名为 emit_now() 的函数,正如其名,当调用时发出统计数据。您可能需要偶尔调用此函数(从后台线程或 Tokio 任务等,如果需要)以更新度量。

(有朝一日,只需启用此软件包中的一个功能并调用必要的函数来为您设置计时器即可。)

请参阅 examples 目录中的示例。

版本控制

出于简单起见,此软件包将遵循 metrics 的大版本号,因此很容易知道正在使用兼容版本。这意味着此软件包的 0.18.x 版本将与 metrics0.18.x 版本兼容,而此软件包的假设性 1.x.x 版本将与 metrics1.x.x 版本兼容。

贡献

如果您想做出贡献,我将非常高兴接受。

许可证

许可协议为以下之一

任选其一。

贡献

除非您明确声明,否则根据Apache-2.0许可定义的,您有意提交以包含在作品中的任何贡献,都将双许可如上,没有任何额外的条款或条件。

依赖项

~4MB
~74K SLoC