reverse_tunnels: Add in support for the reverse tunnel reporting by adding hook points and interface for the reporter (#42647)

## Commit Message
Add in support for the reverse tunnel reporting by adding hook points
and interface for the reporter

## Additional Description
Adds an interface for reporters to extend to report the reverse tunnels.
Also added in the hooks needed on the extension, socket manager and the
filter to report the tunnels with the context to report to the reporter
(configured using yaml).

We are reporting the tenant_id on connections because we have plans to
possibly use them for validation later on in the request lifecycle. This
data isnt available at the upstream_socket_manager hence we dont report
the tenant_id on disconnection

Also added tests for the exercised new code paths.

Signed-off-by: aakugan <[email protected]>

Mirrored from https://github.com/envoyproxy/envoy @ 3fc850ad47b56545fdb20b3b987c53050cdb8fd9

Author: update-envoy[bot]

envoy/extensions/bootstrap/reverse_tunnel/upstream_socket_interface/v3/BUILD

@@ -5,5 +5,8 @@ load("@envoy_api//bazel:api_build_system.bzl", "api_proto_package")
 licenses(["notice"])  # Apache 2
 
 api_proto_package(
-    deps = ["@com_github_cncf_xds//udpa/annotations:pkg"],
+    deps = [
+        "//envoy/config/core/v3:pkg",
+        "@com_github_cncf_xds//udpa/annotations:pkg",
+    ],
 )

envoy/extensions/bootstrap/reverse_tunnel/upstream_socket_interface/v3/upstream_reverse_connection_socket_interface.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package envoy.extensions.bootstrap.reverse_tunnel.upstream_socket_interface.v3;
 
+import "envoy/config/core/v3/extension.proto";
+
 import "google/protobuf/wrappers.proto";
 
 import "udpa/annotations/status.proto";
@@ -29,4 +31,9 @@ message UpstreamReverseConnectionSocketInterface {
   // When enabled, emits hidden statistics for individual nodes and clusters.
   // Defaults to false.
   bool enable_detailed_stats = 3;
+
+  // Optional configuration for a tunnel reporting extension. When provided,
+  // the socket interface instantiates a reporter via the configured factory.
+  // If unset, no reporting is done.
+  config.core.v3.TypedExtensionConfig reporter_config = 4;
 }