菜单
文档breadcrumb arrow Grafana Alloybreadcrumb arrow 参考breadcrumb arrow 组件breadcrumb arrow otelcolbreadcrumb arrow otelcol.connector.host_info
开源

otelcol.connector.host_info

otel.connector.host_info 接收来自其他 otelcol 组件的 span 数据并生成使用指标。

用法

alloy
otelcol.connector.host_info "LABEL" {
  output {
    metrics = [...]
  }
}

参数

otelcol.connector.host_info 支持以下参数

名称类型描述默认值必需
host_identifiers列表(string)用于识别唯一主机的资源属性的有序列表。["host.id"]
metrics_flush_interval持续时间多久刷新一次生成的指标。"60s"

otelcol.connector.host_info 的定义内支持以下块

层次结构描述必需
输出输出配置接收到的遥测数据的发送位置。
debug_metricsdebug_metrics配置此组件生成的指标,以监控其状态。

输出块

output 块配置了一组组件,以将结果遥测数据转发到。

支持以下参数

名称类型描述默认值必需
metricslist(otelcol.Consumer)要发送指标的消费者列表。[]

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

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"

导出字段

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

名称类型描述
inputotelcol.Consumer其他组件可以使用它发送遥测数据的一个值。

input 接受 otelcol.Consumer 跟踪遥测数据。它不接受指标和日志。

示例

以下示例接受跟踪,通过 otelcol.processor.resourcedetection 组件添加 host.id 资源属性,从这些跟踪创建使用指标,并将指标写入 Mimir。

alloy
otelcol.receiver.otlp "otlp" {
  http {}
  grpc {}

  output {
    traces = [otelcol.processor.resourcedetection.otlp_resources.input]
  }
}

otelcol.processor.resourcedetection "otlp_resources" {
  detectors = ["system"]
  system {
    hostname_sources = [ "os" ]
    resource_attributes {
      host.id {
        enabled = true
      }
    }
  }
  output {
    traces = [otelcol.connector.host_info.default.input]
  }
}

otelcol.connector.host_info "default" {
  output {
    metrics = [otelcol.exporter.prometheus.otlp_metrics.input]
  }
}

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

prometheus.remote_write "default" {
  endpoint {
    url = "https://prometheus-xxx.grafana.net/api/prom/push"
    basic_auth {
      username = sys.env("PROMETHEUS_USERNAME")
      password = sys.env("GRAFANA_CLOUD_API_KEY")
    }
  }
}

兼容组件

otelcol.connector.host_info 可以接受以下组件的参数

otelcol.connector.host_info 的导出可以被以下组件消费

注意

连接某些组件可能不合理,或者组件可能需要进一步配置才能正确连接。请参阅链接的文档以获取更多详细信息。