文档

Grafana Alloy

参考

组件

otelcol

otelcol.processor.cumulativetodelta

公开预览

`otelcol.processor.cumulativetodelta`

公开预览: 这是一个公开预览组件。公开预览组件可能会发生重大更改，并可能被覆盖相同用例的等效功能替代。必须将 stability.level 标志设置为 public-preview 或更低才能使用此组件。

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

注意
otelcol.processor.cumulativetodelta 是上游 OpenTelemetry Collector cumulativetodelta 处理器的包装器。必要时，错误报告或功能请求将被重定向到上游存储库。

您可以通过为多个 otelcol.processor.cumulativetodelta 组件赋予不同的标签来指定它们。

用法

otelcol.processor.cumulativetodelta "<LABEL>" {
  output {
    metrics = [...]
  }
}

参数

您可以与 otelcol.processor.cumulativetodelta 一起使用以下参数

名称	类型	描述	默认值	必需
`initial_value`	`string`	处理给定指标身份的第一个观测点。	`"auto"`	否
`max_staleness`	`duration`	状态条目在上次看到后存活的总时间。	`"0"`	否

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

如果自 max_staleness 指定的持续时间以来未收到新样本，则跟踪的流被认为是陈旧并被丢弃。当设置为 "0" 时，状态将无限期保留。

initial_value 设置给定指标身份的第一个观测点的处理方式。当收集器（重新）启动时，没有记录给定的累积计数器有多少已经转换为增量值。

"auto"（默认）：如果设置了开始时间 AND 开始时间发生在组件启动之后 AND 开始时间与时间戳不同，则发送观测值。这适用于网关部署。此启发式方法类似于 drop，但它保留了新启动计数器的值，这些计数器之前可能没有观测值。
"keep"：将观测值作为增量值发送。这适用于之前未观测到传入指标的情况。例如，当您将收集器作为 Sidecar 运行时，收集器生命周期与指标源绑定。
"drop"：保留观测值但不发送。这适用于网关部署。它保证产生的所有增量计数之前都没有被观测到，但会丢弃前两个观测值之间的值。

块

您可以与 otelcol.processor.cumulativetodelta 一起使用以下块

块	描述	必需
`output`	配置接收到的遥测数据发送到哪里。	是
`debug_metrics`	配置此组件生成的指标，用于监控其状态。	否
`exclude`	配置哪些指标不转换为增量。	否
`include`	配置哪些指标转换为增量。	否

如果指标同时匹配 include 和 exclude，则 exclude 优先。如果未提供 include 或 exclude，则不应用过滤。

`output`

必需

output 块配置一组组件来转发产生的遥测数据。

支持以下参数

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

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

`include`

include 块配置哪些指标转换为增量。

支持以下属性

名称	类型	描述	必需
`metrics`	`list(string)`	要转换为增量的名称或模式。	否
`match_type`	`string`	要使用的匹配类型，`strict` 或 `regexp`。	否
`metric_types`	`list(string)`	要转换为增量的指标类型。	否

如果提供了 metrics 或 match_type 其中之一，则另一个也必须提供。

metric_types 的有效值为 sum 和 histogram。

`exclude`

exclude 块配置哪些指标不转换为增量。exclude 优先于 include。

支持以下属性

名称	类型	描述	必需
`metrics`	`list(string)`	在转换为增量时要排除的名称或模式。	否
`match_type`	`string`	要使用的匹配类型，`strict` 或 `regexp`。	否
`metric_types`	`list(string)`	在转换为增量时要排除的指标类型。	否

如果提供了 metrics 或 match_type 其中之一，则另一个也必须提供。

metric_types 的有效值为 sum 和 histogram。

`debug_metrics`

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

支持以下参数

名称	类型	描述	默认值	必需
`disable_high_cardinality_metrics`	`boolean`	是否禁用某些高基数指标。	`true`	否

disable_high_cardinality_metrics 是 Grafana Alloy 中相当于 OpenTelemetry Collector 中 telemetry.disableHighCardinalityMetrics 特性门控的参数。它会删除可能导致高基数指标的属性。例如，关于 HTTP 和 gRPC 连接的指标中包含 IP 地址和端口号的属性会被删除。

注意
如果配置了 disable_high_cardinality_metrics，它仅适用于 otelcol.exporter.* 和 otelcol.receiver.* 组件。

导出字段

导出以下字段，可供其他组件引用

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

input 接受用于指标的 otelcol.Consumer 数据。

组件健康状态

仅当配置无效时，才会报告 otelcol.processor.cumulativetodelta 为不健康。

调试信息

otelcol.processor.cumulativetodelta 不暴露任何组件特定的调试信息。

示例

此示例将累积时间属性的指标转换为增量，然后将其发送到 otelcol.exporter.otlp 进行进一步处理。

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

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