[exporter/exporterhelper] Migrate TimeoutConfig to schema-based configuration generated by mdatagen.

.chloggen/migrate_timeout_config.yaml

@@ -0,0 +1,25 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/otlp)
+component: pkg/exporterhelper
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Migrate `TimeoutConfig` to schema-based configuration generated by mdatagen.
+
+# One or more tracking issues or pull requests related to the change
+issues: [15505]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:
+
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: [api]

exporter/exporterhelper/config.schema.json

@@ -0,0 +1,20 @@
+{
+  "$id": "go.opentelemetry.io/collector/exporter/exporterhelper",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$defs": {
+    "timeout_config": {
+      "type": "object",
+      "properties": {
+        "timeout": {
+          "type": "string",
+          "description": "Defines the timeout for every attempt to send data to the backend. A zero timeout means no timeout.",
+          "default": "5s",
+          "minimum": 0,
+          "pattern": "^([0-9]+(\\.[0-9]+)?(ns|us|µs|ms|s|m|h))+$"
+        }
+      },
+      "description": "A timeout configuration. The timeout applies to individual attempts to send data to the backend."
+    }
+  },
+  "title": "pkg/exporterhelper"
+}

exporter/exporterhelper/internal/config.schema.json

@@ -0,0 +1,20 @@
+{
+  "$id": "go.opentelemetry.io/collector/exporter/exporterhelper/internal",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$defs": {
+    "timeout_config": {
+      "type": "object",
+      "properties": {
+        "timeout": {
+          "type": "string",
+          "description": "Defines the timeout for every attempt to send data to the backend. A zero timeout means no timeout.",
+          "default": "5s",
+          "minimum": 0,
+          "pattern": "^([0-9]+(\\.[0-9]+)?(ns|us|µs|ms|s|m|h))+$"
+        }
+      },
+      "description": "A timeout configuration. The timeout applies to individual attempts to send data to the backend."
+    }
+  },
+  "title": "exporterhelper/timeout"
+}

exporter/exporterhelper/internal/doc.go

@@ -0,0 +1,6 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+//go:generate mdatagen metadata.yaml
+
+package internal // import "go.opentelemetry.io/collector/exporter/exporterhelper/internal"

exporter/exporterhelper/internal/metadata.yaml

@@ -0,0 +1,13 @@
+type: exporterhelper/timeout
+parent: pkg/exporterhelper
+
+exported_configs:
+  timeout_config:
+    description: A timeout configuration. The timeout applies to individual attempts to send data to the backend.
+    type: object
+    properties:
+      timeout:
+        description: Defines the timeout for every attempt to send data to the backend. A zero timeout means no timeout.
+        type: duration
+        default: 5s
+        minimum: 0

exporter/exporterhelper/internal/timeout_sender.go

@@ -5,35 +5,11 @@ package internal // import "go.opentelemetry.io/collector/exporter/exporterhelpe
 
 import (
 	"context"
-	"errors"
-	"time"
 
 	"go.opentelemetry.io/collector/component"
 	"go.opentelemetry.io/collector/exporter/exporterhelper/internal/sender"
 )
 
-// TimeoutConfig for timeout. The timeout applies to individual attempts to send data to the backend.
-type TimeoutConfig struct {
-	// Timeout is the timeout for every attempt to send data to the backend.
-	// A zero timeout means no timeout.
-	Timeout time.Duration `mapstructure:"timeout"`
-}
-
-func (ts *TimeoutConfig) Validate() error {
-	// Negative timeouts are not acceptable, since all sends will fail.
-	if ts.Timeout < 0 {
-		return errors.New("'timeout' must be non-negative")
-	}
-	return nil
-}
-
-// NewDefaultTimeoutConfig returns the default config for TimeoutConfig.
-func NewDefaultTimeoutConfig() TimeoutConfig {
-	return TimeoutConfig{
-		Timeout: 5 * time.Second,
-	}
-}
-
 // timeoutSender is a requestSender that adds a `timeout` to every request that passes this sender.
 type timeoutSender[T any] struct {
 	component.StartFunc

exporter/exporterhelper/metadata.yaml

@@ -18,6 +18,10 @@ feature_gates:
     from_version: 'v0.158.0'
     reference_url: 'https://github.com/open-telemetry/opentelemetry-collector/issues/15047'
 
+exported_configs:
+  timeout_config:
+    $ref: ./internal.timeout_config
+
 telemetry:
   metrics:
     exporter_enqueue_failed_log_records:

exporter/otlpexporter/config_test.go

@@ -141,7 +141,7 @@ func TestUnmarshalInvalidConfig(t *testing.T) {
 		},
 		{
 			name:     "invalid_timeout",
-			errorMsg: `'timeout' must be non-negative`,
+			errorMsg: `timeout value must be greater than or equal to 0`,
 		},
 		{
 			name:     "invalid_retry",