async-grpc-xds 0.0.1 → 0.2.0

data/proto/envoy/extensions/load_balancing_policies/common/v3/common.proto

@@ -0,0 +1,188 @@
+syntax = "proto3";
+
+package envoy.extensions.load_balancing_policies.common.v3;
+
+import "envoy/config/core/v3/base.proto";
+import "envoy/config/route/v3/route_components.proto";
+import "envoy/type/v3/percent.proto";
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/wrappers.proto";
+
+import "envoy/annotations/deprecation.proto";
+import "udpa/annotations/status.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3";
+option java_outer_classname = "CommonProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/extensions/load_balancing_policies/common/v3;commonv3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Common configuration for two or more load balancing policy extensions]
+
+message LocalityLbConfig {
+  // Configuration for :ref:`zone aware routing
+  // <arch_overview_load_balancing_zone_aware_routing>`.
+  // [#next-free-field: 7]
+  message ZoneAwareLbConfig {
+    // Basis for computing per-locality percentages in zone-aware routing.
+    enum LocalityBasis {
+      // Use the number of healthy hosts in each locality.
+      HEALTHY_HOSTS_NUM = 0;
+
+      // Use the weights of healthy hosts in each locality.
+      HEALTHY_HOSTS_WEIGHT = 1;
+    }
+
+    // Configures Envoy to always route requests to the local zone regardless of the
+    // upstream zone structure. In Envoy's default configuration, traffic is distributed proportionally
+    // across all upstream hosts while trying to maximize local routing when possible. The approach
+    // with force_local_zone aims to be more predictable and if there are upstream hosts in the local
+    // zone, they will receive all traffic.
+    // * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
+    // * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
+    message ForceLocalZone {
+      // Configures the minimum number of upstream hosts in the local zone required when force_local_zone
+      // is enabled. If the number of upstream hosts in the local zone is less than the specified value,
+      // Envoy will fall back to the default proportional-based distribution across localities.
+      // If not specified, the default is 1.
+      // * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
+      // * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
+      google.protobuf.UInt32Value min_size = 1;
+    }
+
+    // Configures percentage of requests that will be considered for zone aware routing
+    // if zone aware routing is configured. If not specified, the default is 100%.
+    // * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
+    // * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
+    type.v3.Percent routing_enabled = 1;
+
+    // Configures minimum upstream cluster size required for zone aware routing
+    // If upstream cluster size is less than specified, zone aware routing is not performed
+    // even if zone aware routing is configured. If not specified, the default is 6.
+    // * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
+    // * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
+    google.protobuf.UInt64Value min_cluster_size = 2;
+
+    // If set to true, Envoy will not consider any hosts when the cluster is in :ref:`panic
+    // mode<arch_overview_load_balancing_panic_threshold>`. Instead, the cluster will fail all
+    // requests as if all hosts are unhealthy. This can help avoid potentially overwhelming a
+    // failing service.
+    bool fail_traffic_on_panic = 3;
+
+    // If set to true, Envoy will force LocalityDirect routing if a local locality exists.
+    bool force_locality_direct_routing = 4
+        [deprecated = true, (envoy.annotations.deprecated_at_minor_version) = "3.0"];
+
+    ForceLocalZone force_local_zone = 5;
+
+    // Determines how locality percentages are computed:
+    // - HEALTHY_HOSTS_NUM: proportional to the count of healthy hosts.
+    // - HEALTHY_HOSTS_WEIGHT: proportional to the weights of healthy hosts.
+    // Default value is HEALTHY_HOSTS_NUM if unset.
+    LocalityBasis locality_basis = 6;
+  }
+
+  // Configuration for :ref:`locality weighted load balancing
+  // <arch_overview_load_balancing_locality_weighted_lb>`
+  message LocalityWeightedLbConfig {
+  }
+
+  oneof locality_config_specifier {
+    option (validate.required) = true;
+
+    // Configuration for local zone aware load balancing.
+    ZoneAwareLbConfig zone_aware_lb_config = 1;
+
+    // Enable locality weighted load balancing.
+    LocalityWeightedLbConfig locality_weighted_lb_config = 2;
+  }
+}
+
+// Configuration for :ref:`slow start mode <arch_overview_load_balancing_slow_start>`.
+message SlowStartConfig {
+  // Represents the size of slow start window.
+  // If set, the newly created host remains in slow start mode starting from its creation time
+  // for the duration of slow start window.
+  google.protobuf.Duration slow_start_window = 1;
+
+  // This parameter controls the speed of traffic increase over the slow start window. Defaults to 1.0,
+  // so that endpoint would get linearly increasing amount of traffic.
+  // When increasing the value for this parameter, the speed of traffic ramp-up increases non-linearly.
+  // The value of aggression parameter should be greater than 0.0.
+  // By tuning the parameter, is possible to achieve polynomial or exponential shape of ramp-up curve.
+  //
+  // During slow start window, effective weight of an endpoint would be scaled with time factor and aggression:
+  // ``new_weight = weight * max(min_weight_percent, time_factor ^ (1 / aggression))``,
+  // where ``time_factor=(time_since_start_seconds / slow_start_time_seconds)``.
+  //
+  // As time progresses, more and more traffic would be sent to endpoint, which is in slow start window.
+  // Once host exits slow start, time_factor and aggression no longer affect its weight.
+  config.core.v3.RuntimeDouble aggression = 2;
+
+  // Configures the minimum percentage of origin weight that avoids too small new weight,
+  // which may cause endpoints in slow start mode receive no traffic in slow start window.
+  // If not specified, the default is 10%.
+  type.v3.Percent min_weight_percent = 3;
+}
+
+// Common Configuration for all consistent hashing load balancers (MaglevLb, RingHashLb, etc.)
+message ConsistentHashingLbConfig {
+  // If set to ``true``, the cluster will use hostname instead of the resolved
+  // address as the key to consistently hash to an upstream host. Only valid for StrictDNS clusters with hostnames which resolve to a single IP address.
+  bool use_hostname_for_hashing = 1;
+
+  // Configures percentage of average cluster load to bound per upstream host. For example, with a value of 150
+  // no upstream host will get a load more than 1.5 times the average load of all the hosts in the cluster.
+  // If not specified, the load is not bounded for any upstream host. Typical value for this parameter is between 120 and 200.
+  // Minimum is 100.
+  //
+  // Applies to both Ring Hash and Maglev load balancers.
+  //
+  // This is implemented based on the method described in the paper https://arxiv.org/abs/1608.01350. For the specified
+  // ``hash_balance_factor``, requests to any upstream host are capped at ``hash_balance_factor/100`` times the average number of requests
+  // across the cluster. When a request arrives for an upstream host that is currently serving at its max capacity, linear probing
+  // is used to identify an eligible host. Further, the linear probe is implemented using a random jump in hosts ring/table to identify
+  // the eligible host (this technique is as described in the paper https://arxiv.org/abs/1908.08762 - the random jump avoids the
+  // cascading overflow effect when choosing the next host in the ring/table).
+  //
+  // If weights are specified on the hosts, they are respected.
+  //
+  // This is an O(N) algorithm, unlike other load balancers. Using a lower ``hash_balance_factor`` results in more hosts
+  // being probed, so use a higher value if you require better performance.
+  google.protobuf.UInt32Value hash_balance_factor = 2 [(validate.rules).uint32 = {gte: 100}];
+
+  //  Specifies a list of hash policies to use for ring hash load balancing. If ``hash_policy`` is
+  // set, then
+  // :ref:`route level hash policy <envoy_v3_api_field_config.route.v3.RouteAction.hash_policy>`
+  // will be ignored.
+  repeated config.route.v3.RouteAction.HashPolicy hash_policy = 3;
+}
+
+// Connection overrides for the ORCA out-of-band (OOB) reporting stream, used by
+// load balancing policies that consume ORCA load reports (e.g.
+// :ref:`client_side_weighted_round_robin
+// <envoy_v3_api_msg_extensions.load_balancing_policies.client_side_weighted_round_robin.v3.ClientSideWeightedRoundRobin>`).
+// Whether and when OOB reporting runs is controlled by the embedding policy.
+message OrcaOobReportingConfig {
+  // Optional alternative port for the OOB reporting connection, for example an
+  // ORCA reporting sidecar listening on a dedicated port. If 0 or unset, the
+  // port of the host's ORCA reporting address is used. Ignored for non-IP
+  // (pipe/UDS) host addresses.
+  uint32 port_value = 1 [(validate.rules).uint32 = {lte: 65535}];
+
+  // Value of the ``:authority`` header on the OOB gRPC stream. If empty, the
+  // endpoint hostname is used, then the dialed address, then the cluster name.
+  string authority = 2
+      [(validate.rules).string = {well_known_regex: HTTP_HEADER_VALUE strict: false}];
+
+  // Optional key/value pairs used to select a transport socket from the
+  // cluster's :ref:`transport_socket_matches
+  // <envoy_v3_api_field_config.cluster.v3.Cluster.transport_socket_matches>`
+  // for the OOB connection. If unset, or if no match is found, the cluster's
+  // default transport socket is used. ALPN ``h2`` is always forced on the OOB
+  // connection regardless of this setting.
+  google.protobuf.Struct transport_socket_match_criteria = 3;
+}

data/proto/envoy/type/tracing/v3/custom_tag.proto

@@ -0,0 +1,109 @@
+syntax = "proto3";
+
+package envoy.type.tracing.v3;
+
+import "envoy/type/metadata/v3/metadata.proto";
+
+import "udpa/annotations/status.proto";
+import "udpa/annotations/versioning.proto";
+import "validate/validate.proto";
+
+option java_package = "io.envoyproxy.envoy.type.tracing.v3";
+option java_outer_classname = "CustomTagProto";
+option java_multiple_files = true;
+option go_package = "github.com/envoyproxy/go-control-plane/envoy/type/tracing/v3;tracingv3";
+option (udpa.annotations.file_status).package_version_status = ACTIVE;
+
+// [#protodoc-title: Custom Tag]
+
+// Describes custom tags for the active span.
+// [#next-free-field: 7]
+message CustomTag {
+  option (udpa.annotations.versioning).previous_message_type = "envoy.type.tracing.v2.CustomTag";
+
+  // Literal type custom tag with static value for the tag value.
+  message Literal {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.tracing.v2.CustomTag.Literal";
+
+    // Static literal value to populate the tag value.
+    string value = 1 [(validate.rules).string = {min_len: 1}];
+  }
+
+  // Environment type custom tag with environment name and default value.
+  message Environment {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.tracing.v2.CustomTag.Environment";
+
+    // Environment variable name to obtain the value to populate the tag value.
+    string name = 1 [(validate.rules).string = {min_len: 1}];
+
+    // When the environment variable is not found,
+    // the tag value will be populated with this default value if specified,
+    // otherwise no tag will be populated.
+    string default_value = 2;
+  }
+
+  // Header type custom tag with header name and default value.
+  message Header {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.tracing.v2.CustomTag.Header";
+
+    // Header name to obtain the value to populate the tag value.
+    string name = 1
+        [(validate.rules).string = {min_len: 1 well_known_regex: HTTP_HEADER_NAME strict: false}];
+
+    // When the header does not exist,
+    // the tag value will be populated with this default value if specified,
+    // otherwise no tag will be populated.
+    string default_value = 2;
+  }
+
+  // Metadata type custom tag using
+  // :ref:`MetadataKey <envoy_v3_api_msg_type.metadata.v3.MetadataKey>` to retrieve the protobuf value
+  // from :ref:`Metadata <envoy_v3_api_msg_config.core.v3.Metadata>`, and populate the tag value with
+  // `the canonical JSON <https://developers.google.com/protocol-buffers/docs/proto3#json>`_
+  // representation of it.
+  message Metadata {
+    option (udpa.annotations.versioning).previous_message_type =
+        "envoy.type.tracing.v2.CustomTag.Metadata";
+
+    // Specify what kind of metadata to obtain tag value from.
+    metadata.v3.MetadataKind kind = 1;
+
+    // Metadata key to define the path to retrieve the tag value.
+    metadata.v3.MetadataKey metadata_key = 2;
+
+    // When no valid metadata is found,
+    // the tag value would be populated with this default value if specified,
+    // otherwise no tag would be populated.
+    string default_value = 3;
+  }
+
+  // Used to populate the tag name.
+  string tag = 1 [(validate.rules).string = {min_len: 1}];
+
+  // Used to specify what kind of custom tag.
+  oneof type {
+    option (validate.required) = true;
+
+    // A literal custom tag.
+    Literal literal = 2;
+
+    // An environment custom tag.
+    Environment environment = 3;
+
+    // A request header custom tag.
+    Header request_header = 4;
+
+    // A custom tag to obtain tag value from the metadata.
+    Metadata metadata = 5;
+
+    // Custom tag value.
+    //
+    // The same :ref:`format specifier <config_access_log_format>` as used for
+    // :ref:`HTTP access logging <config_access_log>` applies here, however
+    // unknown specifier values are replaced with the empty string instead of ``-``.
+    string value = 6;
+  }
+}

data/proto/readme.md

@@ -15,6 +15,9 @@ These files come from [envoyproxy/data-plane-api](https://github.com/envoyproxy/
 - `envoy/config/route/v3/` - Route definitions (RDS)
 - `envoy/config/core/v3/` - Core types (Node, Address, etc.)
 - `envoy/extensions/transport_sockets/tls/v3/` - TLS/Secret definitions (SDS)
+- `envoy/extensions/load_balancing_policies/` - Typed load-balancing policy definitions
+- `xds/data/orca/v3/` - ORCA load reports
+- `xds/service/orca/v3/` - Out-of-band ORCA reporting service
 - `google/protobuf/` - Google protobuf well-known types
 
 ## Updating

data/proto/xds/data/orca/v3/orca_load_report.proto

@@ -0,0 +1,58 @@
+syntax = "proto3";
+
+package xds.data.orca.v3;
+
+option java_outer_classname = "OrcaLoadReportProto";
+option java_multiple_files = true;
+option java_package = "com.github.xds.data.orca.v3";
+option go_package = "github.com/cncf/xds/go/xds/data/orca/v3";
+
+import "validate/validate.proto";
+
+// See section `ORCA load report format` of the design document in
+// https://github.com/envoyproxy/envoy/issues/6614.
+
+message OrcaLoadReport {
+  // CPU utilization expressed as a fraction of available CPU resources. This
+  // should be derived from the latest sample or measurement. The value may be
+  // larger than 1.0 when the usage exceeds the reporter dependent notion of
+  // soft limits.
+  double cpu_utilization = 1 [(validate.rules).double.gte = 0];
+
+  // Memory utilization expressed as a fraction of available memory
+  // resources. This should be derived from the latest sample or measurement.
+  double mem_utilization = 2 [(validate.rules).double.gte = 0, (validate.rules).double.lte = 1];
+
+  // Total RPS being served by an endpoint. This should cover all services that an endpoint is
+  // responsible for.
+  // Deprecated -- use ``rps_fractional`` field instead.
+  uint64 rps = 3 [deprecated = true];
+
+  // Application specific requests costs. Each value is an absolute cost (e.g. 3487 bytes of
+  // storage) associated with the request.
+  map<string, double> request_cost = 4;
+
+  // Resource utilization values. Each value is expressed as a fraction of total resources
+  // available, derived from the latest sample or measurement.
+  map<string, double> utilization = 5
+      [(validate.rules).map.values.double.gte = 0, (validate.rules).map.values.double.lte = 1];
+
+  // Total RPS being served by an endpoint. This should cover all services that an endpoint is
+  // responsible for.
+  double rps_fractional = 6 [(validate.rules).double.gte = 0];
+
+  // Total EPS (errors/second) being served by an endpoint. This should cover
+  // all services that an endpoint is responsible for.
+  double eps = 7 [(validate.rules).double.gte = 0];
+
+  // Application specific opaque metrics.
+  map<string, double> named_metrics = 8;
+
+  // Application specific utilization expressed as a fraction of available
+  // resources. For example, an application may report the max of CPU and memory
+  // utilization for better load balancing if it is both CPU and memory bound.
+  // This should be derived from the latest sample or measurement.
+  // The value may be larger than 1.0 when the usage exceeds the reporter
+  // dependent notion of soft limits.
+  double application_utilization = 9 [(validate.rules).double.gte = 0];
+}

data/proto/xds/service/orca/v3/orca.proto

@@ -0,0 +1,36 @@
+syntax = "proto3";
+
+package xds.service.orca.v3;
+
+option java_outer_classname = "OrcaProto";
+option java_multiple_files = true;
+option java_package = "com.github.xds.service.orca.v3";
+option go_package = "github.com/cncf/xds/go/xds/service/orca/v3";
+
+import "xds/data/orca/v3/orca_load_report.proto";
+
+import "google/protobuf/duration.proto";
+
+// See section `Out-of-band (OOB) reporting` of the design document in
+// :ref:`https://github.com/envoyproxy/envoy/issues/6614`.
+
+// Out-of-band (OOB) load reporting service for the additional load reporting
+// agent that does not sit in the request path. Reports are periodically sampled
+// with sufficient frequency to provide temporal association with requests.
+// OOB reporting compensates the limitation of in-band reporting in revealing
+// costs for backends that do not provide a steady stream of telemetry such as
+// long running stream operations and zero QPS services. This is a server
+// streaming service, client needs to terminate current RPC and initiate
+// a new call to change backend reporting frequency.
+service OpenRcaService {
+  rpc StreamCoreMetrics(OrcaLoadReportRequest) returns (stream xds.data.orca.v3.OrcaLoadReport);
+}
+
+message OrcaLoadReportRequest {
+  // Interval for generating Open RCA core metric responses.
+  google.protobuf.Duration report_interval = 1;
+  // Request costs to collect. If this is empty, all known requests costs tracked by
+  // the load reporting agent will be returned. This provides an opportunity for
+  // the client to selectively obtain a subset of tracked costs.
+  repeated string request_cost_names = 2;
+}

data/readme.md

@@ -19,16 +19,30 @@ This is an early implementation focused on ADS with CDS and EDS. LDS/RDS, full r
 The `xds/` directory contains a Docker Compose integration environment with a Go xDS control plane and Ruby gRPC backends.
 
 ``` bash
-docker-compose -f xds/docker-compose.yaml up --exit-code-from tests
+docker compose -f xds/docker-compose.yaml up --build --exit-code-from tests
 ```
 
 ## Releases
 
 Please see the [project releases](https://socketry.github.io/async-grpc-xds/releases/index) for all releases.
 
+### v0.2.0
+
+  - Add ORCA load reporting messages, service interface, and client-side weighted-round-robin resources.
+  - Support endpoint hostnames in generated EDS resources.
+  - Replace the general resource builder with focused cluster and endpoint builders.
+
+### v0.1.0
+
+  - Add complete documentation coverage for the public xDS API.
+  - Support grouped IP and Unix-domain-socket addresses in EDS endpoints.
+  - Support selecting HTTP/1 or HTTP/2 for generated clusters.
+
 ### v0.1.0
 
-  - Initial extraction from `async-grpc`.
+  - Add complete documentation coverage for the public xDS API.
+  - Support grouped IP and Unix-domain-socket addresses in EDS endpoints.
+  - Support selecting HTTP/1 or HTTP/2 for generated clusters.
 
 ## See Also
 

data/releases.md

@@ -1,5 +1,17 @@
 # Releases
 
+## v0.2.0
+
+  - Add ORCA load reporting messages, service interface, and client-side weighted-round-robin resources.
+  - Support endpoint hostnames in generated EDS resources.
+  - Replace the general resource builder with focused cluster and endpoint builders.
+
+## v0.1.0
+
+  - Add complete documentation coverage for the public xDS API.
+  - Support grouped IP and Unix-domain-socket addresses in EDS endpoints.
+  - Support selecting HTTP/1 or HTTP/2 for generated clusters.
+
 ## v0.1.0
 
   - Initial extraction from `async-grpc`.

data/xds/readme.md

@@ -11,38 +11,11 @@ The Docker Compose setup includes:
 
 ## Running Tests
 
-### Start the environment
+From this directory:
 
 ```bash
 cd xds
-bundle install  # generates gems.locked for Docker build
-docker compose up -d
-```
-
-### Wait for services to be ready
-
-```bash
-docker compose ps
-```
-
-All services should show as "healthy" or "running".
-
-### Run tests
-
-```bash
-# Run tests in docker compose
-docker compose run --rm tests
-
-# Or run tests locally (if services are accessible)
-# Set XDS_SERVER_URI environment variable
-export XDS_SERVER_URI=xds-control-plane:18000
-bundle exec sus xds/test
-```
-
-### Cleanup
-
-```bash
-docker compose down
+docker compose up --build --exit-code-from tests
 ```
 
 ## Test Structure

data/xds/test/async/grpc/xds/control_plane.rb

@@ -5,7 +5,6 @@
 
 require "async/grpc/xds/control_plane"
 require "async/grpc/xds/client"
-require "async/grpc/xds/resource_builder"
 require "async/grpc/xds/server"
 require "async/http/endpoint"
 require "sus/fixtures/async"
@@ -33,8 +32,8 @@ describe Async::GRPC::XDS::ControlPlane do
 		control_plane.update_endpoints(
 			"myservice",
 			[
-				{address: "127.0.0.1", port: 50051},
-				{address: "127.0.0.2", port: 50052, healthy: false}
+				{addresses: [{address: "127.0.0.1", port: 50051}], healthy: true},
+				{addresses: [{address: "127.0.0.2", port: 50052}], healthy: false}
 			]
 		)
 		
@@ -49,15 +48,15 @@ describe Async::GRPC::XDS::ControlPlane do
 	end
 	
 	it "increments resource versions" do
-		control_plane.update_endpoints("myservice", [{address: "127.0.0.1", port: 50051}])
-		control_plane.update_endpoints("myservice", [{address: "127.0.0.2", port: 50052}])
+		control_plane.update_endpoints("myservice", [{addresses: [{address: "127.0.0.1", port: 50051}], healthy: true}])
+		control_plane.update_endpoints("myservice", [{addresses: [{address: "127.0.0.2", port: 50052}], healthy: true}])
 		
 		expect(control_plane.version(Async::GRPC::XDS::ControlPlane::ENDPOINT_TYPE)).to be == "2"
 	end
 	
 	it "serves resources over ADS" do
 		control_plane.update_cluster("myservice")
-		control_plane.update_endpoints("myservice", [{address: "127.0.0.1", port: 50051}])
+		control_plane.update_endpoints("myservice", [{addresses: [{address: "127.0.0.1", port: 50051}], healthy: true}])
 		
 		port = available_port
 		endpoint = Async::HTTP::Endpoint.parse(

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-grpc-xds
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -131,12 +131,14 @@ files:
 - lib/async/grpc/xds.rb
 - lib/async/grpc/xds/ads_stream.rb
 - lib/async/grpc/xds/client.rb
+- lib/async/grpc/xds/client_side_weighted_round_robin.rb
+- lib/async/grpc/xds/cluster.rb
 - lib/async/grpc/xds/context.rb
 - lib/async/grpc/xds/control_plane.rb
 - lib/async/grpc/xds/discovery_client.rb
+- lib/async/grpc/xds/endpoint.rb
 - lib/async/grpc/xds/health_checker.rb
 - lib/async/grpc/xds/load_balancer.rb
-- lib/async/grpc/xds/resource_builder.rb
 - lib/async/grpc/xds/resource_cache.rb
 - lib/async/grpc/xds/resources.rb
 - lib/async/grpc/xds/server.rb
@@ -148,6 +150,7 @@ files:
 - lib/envoy/config/cluster/v3/cluster_pb.rb
 - lib/envoy/config/cluster/v3/filter_pb.rb
 - lib/envoy/config/cluster/v3/outlier_detection_pb.rb
+- lib/envoy/config/common/mutation_rules/v3/mutation_rules_pb.rb
 - lib/envoy/config/core/v3/address_pb.rb
 - lib/envoy/config/core/v3/backoff_pb.rb
 - lib/envoy/config/core/v3/base_pb.rb
@@ -170,6 +173,9 @@ files:
 - lib/envoy/config/endpoint/v3/endpoint_components_pb.rb
 - lib/envoy/config/endpoint/v3/endpoint_pb.rb
 - lib/envoy/config/endpoint/v3/load_report_pb.rb
+- lib/envoy/config/route/v3/route_components_pb.rb
+- lib/envoy/extensions/load_balancing_policies/client_side_weighted_round_robin/v3/client_side_weighted_round_robin_pb.rb
+- lib/envoy/extensions/load_balancing_policies/common/v3/common_pb.rb
 - lib/envoy/service/discovery/v3/ads_pb.rb
 - lib/envoy/service/discovery/v3/aggregated_discovery_service.rb
 - lib/envoy/service/discovery/v3/discovery_pb.rb
@@ -186,6 +192,7 @@ files:
 - lib/envoy/type/matcher/v3/struct_pb.rb
 - lib/envoy/type/matcher/v3/value_pb.rb
 - lib/envoy/type/metadata/v3/metadata_pb.rb
+- lib/envoy/type/tracing/v3/custom_tag_pb.rb
 - lib/envoy/type/v3/hash_policy_pb.rb
 - lib/envoy/type/v3/http_pb.rb
 - lib/envoy/type/v3/http_status_pb.rb
@@ -217,6 +224,9 @@ files:
 - lib/xds/core/v3/resource_locator_pb.rb
 - lib/xds/core/v3/resource_name_pb.rb
 - lib/xds/core/v3/resource_pb.rb
+- lib/xds/data/orca/v3/orca_load_report_pb.rb
+- lib/xds/service/orca/v3/open_rca_service.rb
+- lib/xds/service/orca/v3/orca_pb.rb
 - lib/xds/type/matcher/v3/domain_pb.rb
 - lib/xds/type/matcher/v3/http_inputs_pb.rb
 - lib/xds/type/matcher/v3/ip_pb.rb
@@ -234,6 +244,7 @@ files:
 - proto/envoy/config/cluster/v3/cluster.proto
 - proto/envoy/config/cluster/v3/filter.proto
 - proto/envoy/config/cluster/v3/outlier_detection.proto
+- proto/envoy/config/common/mutation_rules/v3/mutation_rules.proto
 - proto/envoy/config/core/v3/BUILD
 - proto/envoy/config/core/v3/address.proto
 - proto/envoy/config/core/v3/backoff.proto
@@ -268,6 +279,8 @@ files:
 - proto/envoy/config/route/v3/route.proto
 - proto/envoy/config/route/v3/route_components.proto
 - proto/envoy/config/route/v3/scoped_route.proto
+- proto/envoy/extensions/load_balancing_policies/client_side_weighted_round_robin/v3/client_side_weighted_round_robin.proto
+- proto/envoy/extensions/load_balancing_policies/common/v3/common.proto
 - proto/envoy/extensions/transport_sockets/tls/v3/BUILD
 - proto/envoy/extensions/transport_sockets/tls/v3/cert.proto
 - proto/envoy/extensions/transport_sockets/tls/v3/common.proto
@@ -299,6 +312,7 @@ files:
 - proto/envoy/type/range.proto
 - proto/envoy/type/semantic_version.proto
 - proto/envoy/type/token_bucket.proto
+- proto/envoy/type/tracing/v3/custom_tag.proto
 - proto/envoy/type/v3/BUILD
 - proto/envoy/type/v3/hash_policy.proto
 - proto/envoy/type/v3/http.proto
@@ -336,6 +350,8 @@ files:
 - proto/xds/core/v3/resource.proto
 - proto/xds/core/v3/resource_locator.proto
 - proto/xds/core/v3/resource_name.proto
+- proto/xds/data/orca/v3/orca_load_report.proto
+- proto/xds/service/orca/v3/orca.proto
 - proto/xds/type/matcher/v3/cel.proto
 - proto/xds/type/matcher/v3/domain.proto
 - proto/xds/type/matcher/v3/http_inputs.proto