otelcol.processor.deltatocumulative

实验性：这是一个实验性组件。实验性组件可能会频繁更改，也可能被删除而没有可用的替代品。要使用该组件，必须将stability.level标志设置为experimental。

otelcol.processor.deltatocumulative接受其他otelcol组件的指标并将具有delta时间性的指标转换为累积。

注意
otelcol.processor.deltatocumulative是openTelemetry Collector deltatocumulative处理器的包装器。如果需要，错误报告或功能请求将被重定向到上游仓库。

您可以通过提供不同的标签来指定多个otelcol.processor.deltatocumulative组件。

用法

otelcol.processor.deltatocumulative "LABEL" {
  output {
    metrics = [...]
  }
}

参数

otelcol.processor.deltatocumulative支持以下参数

名称	类型	描述	默认值	必填
`max_stale`	`持续时间`	在将流标记为过时之前等待新样本的时间。	`"5m"`	否
`max_streams`	`数字`	跟踪流的上限。设置为`0`以禁用。	`0`	否

otelcol.processor.deltatocumulative跟踪传入的指标流。具有delta时间性的总和和指数直方图指标会被跟踪并转换为累积时间性。

如果自指定的max_stale持续时间以来没有接收到新样本，则跟踪的流被视为过时并丢弃。max_stale必须设置为大于"0s "的持续时间。

max_streams属性配置跟踪流的上线。当跟踪流的限制达到时，新的传入流将被丢弃。您可以通过将max_streams设置为0来禁用此行为。

块

在otelcol.processor.deltatocumulative的定义内支持以下块

层次结构	块	描述	必填
输出	输出	配置发送接收遥测数据的位置。	是
debug_metrics	debug_metrics	配置本组件生成的监控其状态的性能指标。	否

输出块

output块配置了一组组件，将结果遥测数据转发到其中。

支持以下参数

名称	类型	描述	默认值	必填
`logs`	`列表(otelcol.Consumer)`	发送日志的消费者列表。	`[]`	否
`metrics`	`列表(otelcol.Consumer)`	发送指标到消费者的列表。	`[]`	否
`traces`	`列表(otelcol.Consumer)`	要发送跟踪信息的消费者列表。	`[]`	否

必须指定 output 块，但它的所有参数都是可选的。默认情况下，遥测数据会被丢弃。根据需要配置 metrics、logs 和 traces 参数，以将遥测数据发送到其他组件。

debug_metrics 块

debug_metrics 块配置该组件生成的监控其状态的指标。

支持以下参数

名称	类型	描述	默认值	必填
`disable_high_cardinality_metrics`	`布尔值`	是否禁用某些高基数指标。	`true`	否
`level`	`字符串`	控制包装收集器发出的指标的详细程度。	`"detailed"`	否

disable_high_cardinality_metrics 是 Grafana Alloy 与 OpenTelemetry Collector 中的 telemetry.disableHighCardinalityMetrics 功能网关的等效功能。它移除了可能导致高基数指标的属性。例如，将从关于 HTTP 和 gRPC 连接的指标中删除具有 IP 地址和端口号的属性。

注意
如果已配置，则 disable_high_cardinality_metrics 只适用于 otelcol.exporter.* 和 otelcol.receiver.* 组件。

level 是 OpenTelemetry Collector 中的 telemetry.metrics.level 功能网关的 Alloy 等效功能。可能的值有 "none"、"basic"、"normal" 和 "detailed"。

导出的字段

以下字段将被导出，并可由其他组件引用

名称	类型	描述
`input`	`otelcol.Consumer`	一个其他组件可以用来发送遥测数据的值。

input 接受 otelcol.Consumer 数据以供指标使用。

组件健康

otelcol.processor.deltatocumulative 只有在给定无效配置的情况下才会报告为不健康。

调试信息

otelcol.processor.deltatocumulative 不公开任何特定组件的调试信息。

调试指标

processor_deltatocumulative_streams_tracked (仪表)：当前由聚合状态跟踪的流数量。
processor_deltatocumulative_streams_limit (仪表)：跟踪流的上限。
processor_deltatocumulative_streams_evicted (计数器)：要从跟踪中删除以便摄取新流而从跟踪中移除的流总数。
processor_deltatocumulative_streams_max_stale (仪表)：在流被丢弃之前没有新样本的时间长度。
processor_deltatocumulative_datapoints_processed (计数器)：已处理的点数总数（成功或失败）。
processor_deltatocumulative_datapoints_dropped (计数器)：由于在 reason 标签中给出的原因而被丢弃的错误点数。
processor_deltatocumulative_gaps_length (计数器)：所有间隙的总长度，如由于在传输中丢失导致的间隙。

示例

基本用法

此示例在将其发送到 otelcol.exporter.otlp 进行进一步处理之前，将 delta 时间性指标转换为累积指标。

otelcol.processor.deltatocumulative "default" {
  output {
    metrics = [otelcol.exporter.otlp.production.input]
  }
}

otelcol.exporter.otlp "production" {
  client {
    endpoint = env("OTLP_SERVER_ENDPOINT")
  }
}

导出 Prometheus 数据

此示例在将其转换为需要累积时间性的 Prometheus 数据之前，将 delta 时间性指标转换为累积指标。

otelcol.processor.deltatocumulative "default" {
  output {
    metrics = [otelcol.exporter.prometheus.default.input]
  }
}

otelcol.exporter.prometheus "default" {
  forward_to = [prometheus.remote_write.default.receiver]
}

prometheus.remote_write "default" {
  endpoint {
    url = env("PROMETHEUS_SERVER_URL")
  }
}