本手册仍在编写中,目前尚未完善。
如果您想帮助改进它,我们希望您这样做,请查看 README

22 Dropwizard 指标

ratpack-dropwizard-metrics jar 提供了与 Dropwizard Metrics 库 的集成。

Dropwizard Metrics 是 JVM 上最优秀的指标库之一。它提供了一套指标类型和指标报告工具,可以深入了解您的应用程序的性能,无论是在开发阶段还是在生产环境中的实时状态。它可以让您轻松地捕获统计信息,例如已处理的请求数或响应时间,以及更通用的信息,例如内部集合的状态、队列或代码的某些部分被执行的次数。通过对代码进行度量,您可以准确地了解代码在运行时执行的操作,并能够做出明智的优化决策。

Ratpack 与 Dropwizard Metrics 的集成意味着,您只需注册 Guice 模块,即可自动捕获许多关键指标。如果您需要更深入的了解,Ratpack 还可以让您使用库的众多指标类型轻松地捕获其他指标,然后使用库的指标报告程序将所有这些指标报告到您的所需输出。

请参阅 DropwizardMetricsModule 以获取详细的使用信息。

1.22 内置指标

Ratpack 为关键指标提供了内置的指标收集器。当您使用 DropwizardMetricsModule 在应用程序中启用指标时,内置的指标收集器也会自动启用。

Ratpack 为以下内容提供了内置的指标收集器

Ratpack 还支持 Dropwizard Metric 的 JVM 检测。请参阅 DropwizardMetricsConfig.jvmMetrics(boolean) 以获取使用信息。

2.22 自定义指标

Ratpack 通过两种方式让您能够捕获您自己的应用程序指标

  1. 通过依赖注入或上下文注册查找获取 MetricRegistry,并向其注册您自己的指标。
  2. 将指标注释添加到您的 Guice 注入类。

请参阅 DropwizardMetricsModule 以获取更多详细信息。

3.22 指标报告

Ratpack 支持以下输出的指标报告程序

有关如何使用 WebSockets 使用实时指标的示例,请参阅 example-books 项目。