文档 Grafana Alloy 参考 组件 otelcol otelcol.exporter.prometheus

otelcol exporter prometheus

otelcol.exporter.prometheus接受来自其他otelcol组件的OTLP格式指标，将指标转换为Prometheus格式指标，并将生成的指标转发到prometheus组件。

可以通过指定不同的标签来指定多个otelcol.exporter.prometheus组件。

用法

alloy 复制

otelcol.exporter.prometheus "LABEL" {
  forward_to = [...]
}

参数

otelcol.exporter.prometheus支持以下参数

默认情况下，OpenTelemetry资源转换为target_info指标。OpenTelemetry仪器作用域转换为otel_scope_info指标。分别将include_scope_info和include_target_info参数设置为false，以禁用自定义指标。

当include_scope_labels为true时，将otel_scope_name和otel_scope_version标签添加到每个转换后的指标样本中。

当include_target_info为true时，OpenTelemetry Collector资源转换为target_info指标。

块

以下块在otelcol.exporter.prometheus的定义中被支持

debug_metrics 块

debug_metrics块配置本组件生成的度量以监控其状态。

以下参数被支持

disable_high_cardinality_metrics是Grafana Alloy与OpenTelemetry Collector中的'telemetry.disableHighCardinalityMetrics'特性配对的等价功能。它移除了可能导致高基数度量的属性。例如，移除了有关HTTP和gRPC连接的度量中的IP地址和端口号属性。

level是Alloy与OpenTelemetry Collector中的'telemetry.metrics.level'特性配对的等价功能。可能的值有"none"，"basic"，"normal"和"detailed"。

导出字段

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

input接受用于度量的otelcol.Consumer数据。其他遥测信号被忽略。

发送到input的度量被转换为与Prometheus兼容的度量，并转发到forward_to参数。

以下是在转换过程中被丢弃的

• 使用delta聚合时间性的度量。

  注意

  Prometheus原生不支持delta度量。如果你的Alloy实例消费delta OTLP度量，你可以在使用otelcol.exporter.prometheus之前使用otelcol.processor.deltatocumulative将它们转换为cumulative OTLP度量。

组件健康

otelcol.exporter.prometheus仅在有无效配置的情况下报告为不健康。

调试信息

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

示例

基本用法

此示例接受通过OTLP发送的度量，并使用prometheus.remote_write转发。

alloy 复制

otelcol.receiver.otlp "default" {
  grpc {}

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

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

prometheus.remote_write "mimir" {
  endpoint {
    url = "http://mimir:9009/api/v1/push"
  }
}

从OTLP资源属性创建Prometheus标签

此示例使用otelcol.processor.transform从key1和key2 OTLP资源属性中添加额外的key1和key2 OTLP度量数据点属性。

otelcol.exporter.prometheus然后将key1和key2转换为Prometheus标签，以及其他任何OTLP度量数据点属性。

这避免了将resource_to_telemetry_conversion设置为true的需要，这可能会创建过多的不必要的度量标签。

alloy 复制

otelcol.receiver.otlp "default" {
  grpc {}

  output {
    metrics = [otelcol.processor.transform.default.input]
  }
}

otelcol.processor.transform "default" {
  error_mode = "ignore"

  metric_statements {
    context = "datapoint"

    statements = [
      `set(attributes["key1"], resource.attributes["key1"])`,
      `set(attributes["key2"], resource.attributes["key2"])`,
    ]
  }

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

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

prometheus.remote_write "mimir" {
  endpoint {
    url = "http://mimir:9009/api/v1/push"
  }
}

兼容组件

otelcol.exporter.prometheus可以接受以下组件的参数

• 导出Prometheus MetricsReceiver的组件

otelcol.exporter.prometheus的导出可以被以下组件消费

• 消费OpenTelemetry otelcol.Consumer的组件