flow: Add otelcol.receiver.vcenter component

CHANGELOG.md

@@ -62,6 +62,7 @@ Main (unreleased)
 
   - `otelcol.processor.filter` - filters OTLP telemetry data using OpenTelemetry
     Transformation Language (OTTL). (@hainenber)
+  - `otelcol.receiver.vcenter` - receives metrics telemetry data from vCenter. (@marctc)
 
 ### Enhancements
 

component/otelcol/config_scrape.go

@@ -0,0 +1,57 @@
+package otelcol
+
+import (
+	"errors"
+	"fmt"
+	"time"
+
+	scraperhelper "go.opentelemetry.io/collector/receiver/scraperhelper"
+)
+
+var (
+	errNonPositiveInterval = errors.New("requires positive value")
+)
+
+// ScraperControllerArguments defines common settings for a scraper controller
+// configuration.
+type ScraperControllerArguments struct {
+	CollectionInterval time.Duration `river:"collection_interval,attr,optional"`
+	InitialDelay       time.Duration `river:"initial_delay,attr,optional"`
+	Timeout            time.Duration `river:"timeout,attr,optional"`
+}
+
+// DefaultScraperControllerArguments holds default settings for ScraperControllerArguments.
+var DefaultScraperControllerArguments = ScraperControllerArguments{
+	CollectionInterval: time.Minute,
+	InitialDelay:       time.Second,
+	Timeout:            0 * time.Second,
+}
+
+// SetToDefault implements river.Defaulter.
+func (args *ScraperControllerArguments) SetToDefault() {
+	*args = DefaultScraperControllerArguments
+}
+
+// Convert converts args into the upstream type.
+func (args *ScraperControllerArguments) Convert() *scraperhelper.ScraperControllerSettings {
+	if args == nil {
+		return nil
+	}
+
+	return &scraperhelper.ScraperControllerSettings{
+		CollectionInterval: args.CollectionInterval,
+		InitialDelay:       args.InitialDelay,
+		Timeout:            args.Timeout,
+	}
+}
+
+// Validate returns an error if args is invalid.
+func (args *ScraperControllerArguments) Validate() error {
+	if args.CollectionInterval <= 0 {
+		return fmt.Errorf(`"collection_interval": %w`, errNonPositiveInterval)
+	}
+	if args.Timeout < 0 {
+		return fmt.Errorf(`"timeout": %w`, errNonPositiveInterval)
+	}
+	return nil
+}

component/otelcol/receiver/vcenter/vcenter.go

@@ -0,0 +1,104 @@
+// Package vcenter provides an otelcol.receiver.vcenter component.
+package vcenter
+
+import (
+	"fmt"
+	"net/url"
+
+	"github.com/grafana/agent/component"
+	"github.com/grafana/agent/component/otelcol"
+	"github.com/grafana/agent/component/otelcol/receiver"
+	otel_service "github.com/grafana/agent/service/otel"
+	"github.com/grafana/river/rivertypes"
+	"github.com/open-telemetry/opentelemetry-collector-contrib/receiver/vcenterreceiver"
+	otelcomponent "go.opentelemetry.io/collector/component"
+	"go.opentelemetry.io/collector/config/configopaque"
+	otelextension "go.opentelemetry.io/collector/extension"
+)
+
+func init() {
+	component.Register(component.Registration{
+		Name:          "otelcol.receiver.vcenter",
+		Args:          Arguments{},
+		NeedsServices: []string{otel_service.ServiceName},
+
+		Build: func(opts component.Options, args component.Arguments) (component.Component, error) {
+			fact := vcenterreceiver.NewFactory()
+			return receiver.New(opts, fact, args.(Arguments))
+		},
+	})
+}
+
+// Arguments configures the otelcol.receiver.vcenter component.
+type Arguments struct {
+	Endpoint string            `river:"endpoint,attr"`
+	Username string            `river:"username,attr"`
+	Password rivertypes.Secret `river:"password,attr"`
+
+	ScraperControllerArguments otelcol.ScraperControllerArguments `river:",squash"`
+	TLS                        otelcol.TLSClientArguments         `river:"tls,block,optional"`
+
+	// DebugMetrics configures component internal metrics. Optional.
+	DebugMetrics otelcol.DebugMetricsArguments `river:"debug_metrics,block,optional"`
+
+	// Output configures where to send received data. Required.
+	Output *otelcol.ConsumerArguments `river:"output,block"`
+}
+
+var _ receiver.Arguments = Arguments{}
+
+var (
+	// DefaultArguments holds default values for Arguments.
+	DefaultArguments = Arguments{
+		ScraperControllerArguments: otelcol.DefaultScraperControllerArguments,
+	}
+)
+
+// SetToDefault implements river.Defaulter.
+func (args *Arguments) SetToDefault() {
+	*args = DefaultArguments
+}
+
+// Convert implements receiver.Arguments.
+func (args Arguments) Convert() (otelcomponent.Config, error) {
+	return &vcenterreceiver.Config{
+		TLSClientSetting:          *args.TLS.Convert(),
+		ScraperControllerSettings: *args.ScraperControllerArguments.Convert(),
+		Endpoint:                  args.Endpoint,
+		Username:                  args.Username,
+		Password:                  configopaque.String(args.Password),
+	}, nil
+}
+
+// Validate checks to see if the supplied config will work for the receiver
+func (args Arguments) Validate() error {
+	res, err := url.Parse(args.Endpoint)
+	if err != nil {
+		return fmt.Errorf("unable to parse url %s: %w", args.Endpoint, err)
+	}
+
+	if res.Scheme != "http" && res.Scheme != "https" {
+		return fmt.Errorf("url scheme must be http or https")
+	}
+	return nil
+}
+
+// Extensions implements receiver.Arguments.
+func (args Arguments) Extensions() map[otelcomponent.ID]otelextension.Extension {
+	return nil
+}
+
+// Exporters implements receiver.Arguments.
+func (args Arguments) Exporters() map[otelcomponent.DataType]map[otelcomponent.ID]otelcomponent.Component {
+	return nil
+}
+
+// NextConsumers implements receiver.Arguments.
+func (args Arguments) NextConsumers() *otelcol.ConsumerArguments {
+	return args.Output
+}
+
+// DebugMetricsConfig implements receiver.Arguments.
+func (args Arguments) DebugMetricsConfig() otelcol.DebugMetricsArguments {
+	return args.DebugMetrics
+}

component/otelcol/receiver/vcenter/vcenter_test.go

@@ -0,0 +1,39 @@
+package vcenter
+
+import (
+	"testing"
+	"time"
+
+	"github.com/grafana/river"
+	"github.com/open-telemetry/opentelemetry-collector-contrib/receiver/vcenterreceiver"
+	"github.com/stretchr/testify/require"
+)
+
+func TestArguments_UnmarshalRiver(t *testing.T) {
+	in := `
+		endpoint = "http://localhost:1234"
+		username = "user"
+		password = "pass"
+		collection_interval = "2m"
+
+		output { /* no-op */ }
+	`
+
+	var args Arguments
+	require.NoError(t, river.Unmarshal([]byte(in), &args))
+	args.Convert()
+	ext, err := args.Convert()
+	require.NoError(t, err)
+	otelArgs, ok := (ext).(*vcenterreceiver.Config)
+
+	require.True(t, ok)
+
+	require.Equal(t, "user", otelArgs.Username)
+	require.Equal(t, "pass", string(otelArgs.Password))
+	require.Equal(t, "http://localhost:1234", otelArgs.Endpoint)
+
+	require.Equal(t, 2*time.Minute, otelArgs.ScraperControllerSettings.CollectionInterval)
+	require.Equal(t, time.Second, otelArgs.ScraperControllerSettings.InitialDelay)
+	require.Equal(t, 0*time.Second, otelArgs.ScraperControllerSettings.Timeout)
+
+}

docs/sources/flow/reference/components/otelcol.receiver.vcenter.md

@@ -0,0 +1,133 @@
+---
+aliases:
+- /docs/grafana-cloud/agent/flow/reference/components/otelcol.receiver.vcenter/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/reference/components/otelcol.receiver.vcenter/
+- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/reference/components/otelcol.receiver.vcenter/
+canonical: https://grafana.com/docs/agent/latest/flow/reference/components/otelcol.receiver.vcenter/
+title: otelcol.receiver.vcenter
+description: Learn about otelcol.receiver.vcenter
+---
+
+# otelcol.receiver.vcenter
+
+`otelcol.receiver.vcenter` accepts metrics from a 
+vCenter or ESXi host running VMware vSphere APIs and
+forwards it to other `otelcol.*` components.
+
+> **NOTE**: `otelcol.receiver.vcenter` is a wrapper over the upstream
+> OpenTelemetry Collector `vcenter` receiver from the `otelcol-contrib`
+> distribution. Bug reports or feature requests will be redirected to the
+> upstream repository, if necessary.
+
+Multiple `otelcol.receiver.vcenter` components can be specified by giving them
+different labels.
+
+Make sure that you fulfill the [prerequisites](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/vcenterreceiver/README.md#prerequisites) before using this component.
+
+The full list of metrics that can be collected can be found [here](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/vcenterreceiver/documentation.md)
+
+## Usage
+
+```river
+otelcol.receiver.vcenter "LABEL" {
+  endpoint = "VCENTER_ENDPOINT"
+  username = "VCENTER_USERNAME"
+  password = "VCENTER_PASSWORD"
+
+  output {
+    metrics = [...]
+  }
+}
+```
+
+## Arguments
+
+`otelcol.receiver.vcenter` supports the following arguments:
+
+
+Name | Type | Description | Default | Required
+---- | ---- | ----------- | ------- | --------
+`endpoint` | `string` | Endpoint to a vCenter Server or ESXi host which has the SDK path enabled. | | yes
+`username` | `string` | Username to use for authentication. | | yes
+`password` | `string` | Password to use for authentication. | | yes
+`collection_interval` | `duration` | Defines how often to collect metrics. | `"1m"` | no
+`initial_delay` | `duration` | Defines how long this receiver waits before starting. | `"1s"` | no
+`timeout` | `duration` | Defines the timeout for the underlying HTTP client. | `"0s"` | no
+
+`endpoint` has the format `<protocol>://<hostname>`. For example, `https://vcsa.hostname.localnet`.
+
+## Blocks
+
+The following blocks are supported inside the definition of
+`otelcol.receiver.vcenter`:
+
+Hierarchy | Block | Description | Required
+--------- | ----- | ----------- | --------
+tls | [tls][] | Configures TLS for the HTTP client. | no
+debug_metrics | [debug_metrics][] | Configures the metrics that this component generates to monitor its state. | no
+output | [output][] | Configures where to send received telemetry data. | yes
+
+[tls]: #tls-block
+[debug_metrics]: #debug_metrics-block
+[output]: #output-block
+
+### tls block
+
+The `tls` block configures TLS settings used for a server. If the `tls` block
+isn't provided, TLS won't be used for connections to the server.
+
+{{< docs/shared lookup="flow/reference/components/otelcol-tls-config-block.md" source="agent" version="<AGENT VERSION>" >}}
+
+### debug_metrics block
+
+{{< docs/shared lookup="flow/reference/components/otelcol-debug-metrics-block.md" source="agent" version="<AGENT VERSION>" >}}
+
+### output block
+
+{{< docs/shared lookup="flow/reference/components/output-block.md" source="agent" version="<AGENT VERSION>" >}}
+
+## Exported fields
+
+`otelcol.receiver.vcenter` does not export any fields.
+
+## Component health
+
+`otelcol.receiver.vcenter` is only reported as unhealthy if given an invalid
+configuration.
+
+## Debug information
+
+`otelcol.receiver.vcenter` does not expose any component-specific debug
+information.
+
+## Example
+
+This example forwards received telemetry data through a batch processor before
+finally sending it to an OTLP-capable endpoint:
+
+```river
+otelcol.receiver.vcenter "default" {
+  endpoint = "http://localhost:15672"
+  username = "otelu"
+  password = "password"
+
+  output {
+    metrics = [otelcol.processor.batch.default.input]
+    logs    = [otelcol.processor.batch.default.input]
+    traces  = [otelcol.processor.batch.default.input]
+  }
+}
+
+otelcol.processor.batch "default" {
+  output {
+    metrics = [otelcol.exporter.otlp.default.input]
+    logs    = [otelcol.exporter.otlp.default.input]
+    traces  = [otelcol.exporter.otlp.default.input]
+  }
+}
+
+otelcol.exporter.otlp "default" {
+  client {
+    endpoint = env("OTLP_ENDPOINT")
+  }
+}

docs/sources/flow/reference/components/prometheus.exporter.vsphere.md

@@ -5,14 +5,24 @@ aliases:
 - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/reference/components/prometheus.exporter.vsphere/
 - /docs/grafana-cloud/send-data/agent/flow/reference/components/prometheus.exporter.vsphere/
 canonical: https://grafana.com/docs/agent/latest/flow/reference/components/prometheus.exporter.vsphere/
-description: Learn about prometheus.exporter.vsphere
 title: prometheus.exporter.vsphere
+labels:
+  stage: beta
+description: Learn about prometheus.exporter.vsphere
 ---
 
 # prometheus.exporter.vsphere
 
 The `prometheus.exporter.vsphere` component embeds [`vmware_exporter`](https://github.com/grafana/vmware_exporter) to collect vSphere metrics
 
+> **BETA**: This is a [beta][] component. Beta components are subject to breaking
+> changes, and may be replaced with equivalent functionality that cover the
+> same use case. We recommend to use [otelcol.receiver.vcenter][] instead.
+
+[beta]: {{< relref "../../../stability.md#beta" >}}
+[otelcol.receiver.vcenter]: {{< relref "./otelcol.receiver.vcenter.md" >}}
+
+
 ## Usage
 
 ```river

go.mod

@@ -560,7 +560,7 @@ require (
 	github.com/vertica/vertica-sql-go v1.3.0 // indirect
 	github.com/vishvananda/netlink v1.2.1-beta.2 // indirect
 	github.com/vishvananda/netns v0.0.0-20210104183010-2eb08e3e575f // indirect
-	github.com/vmware/govmomi v0.27.2 // indirect
+	github.com/vmware/govmomi v0.32.0 // indirect
 	github.com/vultr/govultr/v2 v2.17.2 // indirect
 	github.com/willf/bitset v1.1.11 // indirect
 	github.com/willf/bloom v2.0.3+incompatible // indirect
@@ -616,6 +616,7 @@ require (
 	github.com/githubexporter/github-exporter v0.0.0-20231025122338-656e7dc33fe7
 	github.com/natefinch/atomic v1.0.1
 	github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor v0.87.0
+	github.com/open-telemetry/opentelemetry-collector-contrib/receiver/vcenterreceiver v0.87.0
 	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc v0.42.0
 	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.19.0
 )