指标

Java 代理会跟踪某些系统和应用程序指标。其中一些具有内置的可视化效果，而另一些只能使用自定义 Kibana 仪表板进行可视化。

这些指标将定期发送到 APM 服务器，然后从那里发送到 Elasticsearch。您可以使用设置 metrics_interval 调整间隔。

这些指标将存储在 apm-* 索引中，并将 processor.event 属性设置为 metric。

主机指标。从 6.6 版开始，这些指标将在 APM 应用中可视化。

如需更多系统指标，请考虑在主机上安装 metricbeat。

Linux 的 cgroup 指标。

特定于 JVM 的指标

Java Management Extensions (JMX) 在 JVM 上提供了一个通用的管理界面，通常用于通过此界面公开内部指标。

Elastic APM 代理能够直接连接到 JMX 界面，而无需其他凭据或更改 JVM 参数，这与其他外部工具（如 VisualVM 或 Jconsole）不同。此外，它仅捕获指标，不向最终用户公开整个 JMX 管理界面。

需要通过 capture_jmx_metrics 选项配置要捕获的 JMX 指标。

为了支持 按跨度类型花费的时间 图表，代理会收集有关跨度和事务时间（按跨度类型细分）的汇总指标。

在某些情况下，您可能只想使用代理来收集和传输指标，而无需跟踪任何 Java 代码。在这种情况下，您可以将 instrument 配置选项设置为 false。这样，代理将最大限度地减少对应用程序的影响，同时仍然收集指标并将其发送到 APM 服务器。

Elastic APM Java 代理支持收集通过 OpenTelemetry 定义的指标。有关详细信息，请参阅相应的文档部分。

Elastic APM Java 代理允许您使用流行的指标收集框架 Micrometer 来跟踪自定义应用程序指标。

从应用程序跟踪自定义指标的一些用例包括监视与性能相关的事项，例如缓存统计信息、线程池或页面点击量。但是，您还可以跟踪与业务相关的指标（例如收入），并将其与性能指标相关联。注册到 Micrometer MeterRegistry 的指标会在内存中聚合，并按照 metrics_interval 进行报告。基于有关服务和时间戳的元数据，您可以将指标与跟踪关联起来。优点是，指标不会受到 采样率 的影响，并且通常占用更少的空间。这是因为并非每个事件都单独存储。

跟踪指标的限制在于，您无法将值归因于特定事务。如果您想这样做，请将 标签添加到事务，而不是使用 Micrometer 跟踪指标。这里的权衡是您必须进行 100% 采样，或者考虑丢失的事件。原因是，例如，如果您将采样率设置为 10%，则只会存储 10 个请求中的一个。您在非采样事务上设置的标签将丢失。

附加代理，就完成了！代理会自动检测所有 MeterRegistry 实例，并将所有指标报告给 APM 服务器（除了它们最初报告的位置之外）。当在应用程序已经启动后附加代理时，代理会在调用其任何公共方法时检测到 MeterRegistry。如果您在 CompoundMeterRegistry 中使用多个注册表，则代理只会报告一次指标。

使用 Discover 验证指标是否已成功报告给 Kibana。

现在，您应该看到包含 APM 代理收集的指标和来自 Micrometer 的自定义指标的文档。使用已知的 Micrometer 指标字段缩小搜索范围。例如，如果您知道已在 Micrometer MeterRegistry 中注册了指标名称 cache.puts，请在搜索中添加 cache_puts: *（点替换为下划线），以仅返回 Micrometer 指标文档。

TSVB 是推荐用于 Micrometer 指标的可视化工具。首先，请确保选择正确的聚合。最常见的选项是：

通常按属性（包括 Micrometer 标签或 APM 代理已收集的属性）对指标进行分组。这可能是服务版本、运行时版本，甚至是云元数据。

声明对 Micrometer 的依赖

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-core</artifactId>
    <version>${micrometer.version}</version>
</dependency>

创建 Micrometer MeterRegistry。

MeterRegistry registry = new SimpleMeterRegistry(new SimpleConfig() {

        @Override
        public CountingMode mode() {
            // to report the delta since the last report
            // this makes building dashbaords a bit easier
            return CountingMode.STEP;
        }

        @Override
        public Duration step() {
            // the duration should match metrics_interval, which defaults to 30s
            return Duration.ofSeconds(30);
        }

        @Override
        public String get(String key) {
            return null;
        }
    }, Clock.SYSTEM);

开始使用 Spring Boot 的最简单方法是添加对 Spring Boot Actuator 的依赖。Spring Boot Actuator 为 Micrometer 提供依赖管理和自动配置。

使用 management.metrics.export.simple 前缀通过 application.properties 进行配置

management.metrics.export.simple.enabled=true
management.metrics.export.simple.step=30s
management.metrics.export.simple.mode=STEP

本节列出所有受支持的 Micrometer Meter，并描述它们如何映射到 Elasticsearch 文档。

Micrometer 标签嵌套在 labels 下。例如：

"labels": {
  "tagKey1": "tagLabel1",
  "tagKey2": "tagLabel2",
}

标签非常适合按不同维度分解指标。尽管没有上限，但请注意，每个标签的大量不同值（也称为高基数）可能会导致更高的内存使用率、更高的索引大小和更慢的查询。此外，请确保限制不同标签键的数量，以避免 映射爆炸。

根据指标类型，某些指标可能会作为多个指标导出到 Elasticsearch。以下显示每个指标类型的结果字段。请注意，disable_metrics 选项对指标的原始名称起作用，而不是对生成的字段起作用。因此，只能禁用给定指标的所有字段，而不能禁用单个字段。

代理在内部使用队列来缓冲各种事件（例如，事务、跨度、指标），然后再将它们发送到 APM 服务器。启用 agent_reporter_health_metrics 后，代理将公开有关此队列的运行状况以及与 APM 服务器的网络连接的多个指标。此外，如果启用 agent_background_overhead_metrics，则代理将持续测量其自身后台任务的资源消耗，并将结果作为指标提供。