Metrics Exporter - OTLP

状态: 稳定

通用

OTLP Metrics Exporter 是一个 Push Metric Exporter，它通过 OpenTelemetry Protocol 发送指标。

OTLP Metrics Exporter 必须提供配置，以影响 MetricReader 输出的 temporality，该输出是仪器种类的函数。此选项可以命名为 temporality，默认情况下必须为所有仪器种类将 temporality 首选项设置为 Cumulative。

OTLP Metrics Exporter 必须提供配置，以影响 MetricReader 的默认 aggregation，该默认值是仪器种类的函数。此选项可以命名为 default_aggregation，默认情况下必须为所有仪器种类设置 默认聚合。

导出器必须根据 OpenTelemetry Protocol Exporter 规范提供配置。

如果某个语言提供了自动配置 MetricReader 以与关联的导出器配对的机制（例如，使用 OTEL_METRICS_EXPORTER 环境变量），则默认情况下：

• 导出器必须与 periodic exporting MetricReader 配对。
• 导出器必须使用 OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE 变量，根据仪器种类配置默认聚合的 temporality，如下所述。
• 如果实现了 OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION 变量，导出器必须使用该变量，根据仪器种类配置默认聚合，如下所述。

其他环境变量配置

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE 的可识别值（不区分大小写）是：

• Cumulative：为所有仪器种类选择 Cumulative 聚合 temporality。
• Delta：为 Counter、Asynchronous Counter 和 Histogram 仪器种类选择 Delta 聚合 temporality，为 UpDownCounter 和 Asynchronous UpDownCounter 仪器种类选择 Cumulative 聚合。
• LowMemory：此配置对 Synchronous Counter 和 Histogram 使用 Delta 聚合 temporality，对 Synchronous UpDownCounter、Asynchronous Counter 和 Asynchronous UpDownCounter 仪器种类使用 Cumulative 聚合 temporality。

“LowMemory”之所以命名如此，是因为 SDK 在某些条件下可以使用比其他配置更少的内存。相比之下，“cumulative”选项强制 SDK 为 Synchronous Counter 和 Histogram 仪器维护 delta 到 cumulative 的转换，而“delta”选项则强制 SDK 为 Asynchronous Counter 仪器维护 cumulative 到 delta 的转换。

OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION 的可识别值（不区分大小写）是：

• explicit_bucket_histogram：使用 Explicit Bucket Histogram Aggregation。
• base2_exponential_bucket_histogram：使用 Base2 Exponential Bucket Histogram Aggregation。

参考

• OTEP0131 OTLP Exporters 可配置导出行为