指标

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

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

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

系统指标编辑

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

有关更多系统指标，请考虑在您的主机上安装 metricbeat。

cgroup 指标（在 1.18.0 中添加）编辑

Linux 的 cgroup 指标。

JVM 指标编辑

JVM 特定指标

JMX 指标编辑

Java 管理扩展 (JMX) 为 JVM 提供了一个通用的管理接口，通常用于通过此接口公开内部指标。

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

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

内置应用程序指标编辑

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

仅使用代理进行指标收集编辑

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

OpenTelemetry 指标编辑

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

Micrometer 指标编辑

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

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

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

说明编辑

使用现有的 Micrometer 设置开始编辑

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

验证 Micrometer 数据编辑

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

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

可视化 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 的最简单方法是添加对 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 启用，代理将持续测量其自身后台任务的资源消耗，并将结果作为指标提供。

代理报告和事件指标编辑

代理后台资源消耗指标编辑