文档 Grafana Alloy 参考 组件 otelcol otelcol.receiver.vcenter

实验性

otelcol.receiver.vcenter

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

otelcol.receiver.vcenter 接收来自运行 VMware vSphere API 的 vCenter 或 ESXi 主机的指标，并将其转发到其他 otelcol.* 组件。

注意：otelcol.receiver.vcenter 是 OpenTelemetry Collector 上游 otelcol-contrib 分发版中 vcenter 接收器的包装器。如有必要，错误报告或功能请求将被重定向到上游仓库。

通过赋予不同的标签，可以指定多个 otelcol.receiver.vcenter 组件。

可收集的完整指标列表可在vcenter 接收器文档中找到。

先决条件

此接收器已构建为支持以下 ESXi 和 vCenter 版本：

• 8
• 7.0

必须指定一个分配有 vSphere “只读” 用户并具有对 vCenter 服务器、集群和所有后续被监控资源的权限，接收器才能检索有关它们的信息。

用法

alloy 复制

otelcol.receiver.vcenter "LABEL" {
  endpoint = "VCENTER_ENDPOINT"
  username = "VCENTER_USERNAME"
  password = "VCENTER_PASSWORD"

  output {
    metrics = [...]
  }
}

参数

otelcol.receiver.vcenter 支持以下参数：

endpoint 的格式为 <protocol>://<hostname>。例如，https://vcsa.hostname.localnet。

块

otelcol.receiver.vcenter 的定义中支持以下块：

tls 块

tls 块配置用于服务器的 TLS 设置。如果未提供 tls 块，则连接到服务器时不会使用 TLS。

支持以下参数：

如果服务器不支持 TLS，您必须将 insecure 参数设置为 true。

要禁用与服务器连接的 tls，请将 insecure 参数设置为 true。

如果 reload_interval 设置为 "0s"，则证书永远不会重新加载。

以下参数对互斥，不能同时设置：

• ca_pem 和 ca_file
• cert_pem 和 cert_file
• key_pem 和 key_file

如果 cipher_suites 留空，则使用安全的默认列表。有关支持的密码套件列表，请参阅Go TLS 文档。

curve_preferences 参数决定了握手期间优先使用的椭圆曲线集，按优先级顺序排列。如果未提供，则使用默认列表。可用的椭圆曲线集有 X25519、P521、P256 和 P384。

metrics 块

metric 块

resource_attributes 块

resource_attribute 块

debug_metrics 块

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

支持以下参数：

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

output 块

output 块配置一组组件，用于转发生成的遥测数据。

支持以下参数：

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

导出的字段

otelcol.receiver.vcenter 不导出任何字段。

组件健康状态

仅当给定无效配置时，otelcol.receiver.vcenter 才会被报告为不健康。

调试信息

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

示例

此示例通过批处理处理器转发接收到的遥测数据，最终将其发送到支持 OTLP 的端点：

alloy 复制

otelcol.receiver.vcenter "default" {
  endpoint = "https://:15672"
  username = "otelu"
  password = "password"

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

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

otelcol.exporter.otlp "default" {
  client {
    endpoint = sys.env("OTLP_ENDPOINT")
  }
}

兼容组件

otelcol.receiver.vcenter 可以接受来自以下组件的参数：

• 导出 OpenTelemetry otelcol.Consumer 的组件