文档 Grafana Alloy 参考 组件 otelcol otelcol处理器.deltatocumulative

实验性

otelcol.processor.deltatocumulative

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

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

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

用法

合金 复制

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

参数

otelcol.processor.deltatocumulative 支持以下参数

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

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

max_streams 属性配置要跟踪的流的上限。如果达到跟踪流的限制，则丢弃新的传入流。

块

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

输出块

输出块配置一组组件，以将结果遥测数据转发到。

支持以下参数

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

debug_metrics 块

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

支持以下参数

disable_high_cardinality_metrics 是 Grafana Alloy 中与 OpenTelemetry Collector 的 telemetry.disableHighCardinalityMetrics 功能门相对应的。它删除可能导致高基数指标的属性。例如，从 HTTP 和 gRPC 连接的指标中删除具有 IP 地址和端口号的属性。

level 是 OpenTelemetry Collector 中与 telemetry.metrics.level 功能门相对应的 Alloy。可能的值是 "none"、"basic"、"normal" 和 "detailed"。

导出字段

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

input 接受 metrics 的 otelcol.Consumer 数据。

组件健康状态

只有在提供无效配置的情况下，otelcol.processor.deltatocumulative 才被视为不健康。

调试信息

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

调试指标

• otelcol_deltatocumulative_streams_tracked (仪表): 当前由聚合状态跟踪的流数量。
• otelcol_deltatocumulative_streams_limit (仪表): 跟踪流的最高限制。
• otelcol_deltatocumulative_streams_evicted (计数器): 从跟踪中移除以摄取新流的流总数。
• otelcol_deltatocumulative_streams_max_stale_seconds (仪表): 在流被丢弃之前，没有新样本的持续时间。
• otelcol_deltatocumulative_datapoints_processed (计数器): 处理的（成功或失败）数据点的总数。
• otelcol_deltatocumulative_datapoints_dropped (计数器): 由于在 reason 标签中给出的原因而被丢弃的故障数据点。
• otelcol_deltatocumulative_gaps_length (计数器): 流中所有间隔的总长度，例如由于传输中丢失。

示例

基本用法

此示例在发送到 otelcol.exporter.otlp 进行进一步处理之前将增量时间序列指标转换为累积指标

合金 复制

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

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

导出 Prometheus 数据

此示例在将其转换为需要累积时间序列的 Prometheus 数据之前，将增量时间序列指标转换为累积指标

合金 复制

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 = sys.env("PROMETHEUS_SERVER_URL")
  }
}

兼容组件

otelcol.processor.deltatocumulative 可以接受以下组件的参数

• 导出 OpenTelemetry otelcol.Consumer 的组件

otelcol.processor.deltatocumulative 有导出，可以由以下组件消费

• 消费 OpenTelemetry otelcol.Consumer 的组件