// // Copyright 2021 gRPC authors. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // #ifndef GRPC_SRC_CORE_EXT_FILTERS_FAULT_INJECTION_FAULT_INJECTION_SERVICE_CONFIG_PARSER_H #define GRPC_SRC_CORE_EXT_FILTERS_FAULT_INJECTION_FAULT_INJECTION_SERVICE_CONFIG_PARSER_H #include #include #include #include #include #include #include #include "absl/strings/string_view.h" #include #include "src/core/lib/channel/channel_args.h" #include "src/core/lib/config/core_configuration.h" #include "src/core/lib/gprpp/time.h" #include "src/core/lib/gprpp/validation_errors.h" #include "src/core/lib/json/json.h" #include "src/core/lib/json/json_args.h" #include "src/core/lib/json/json_object_loader.h" #include "src/core/service_config/service_config_parser.h" // Channel arg key for enabling parsing fault injection via method config. #define GRPC_ARG_PARSE_FAULT_INJECTION_METHOD_CONFIG \ "grpc.internal.parse_fault_injection_method_config" namespace grpc_core { class FaultInjectionMethodParsedConfig : public ServiceConfigParser::ParsedConfig { public: struct FaultInjectionPolicy { grpc_status_code abort_code = GRPC_STATUS_OK; std::string abort_message = "Fault injected"; std::string abort_code_header; std::string abort_percentage_header; uint32_t abort_percentage_numerator = 0; uint32_t abort_percentage_denominator = 100; Duration delay; std::string delay_header; std::string delay_percentage_header; uint32_t delay_percentage_numerator = 0; uint32_t delay_percentage_denominator = 100; // By default, the max allowed active faults are unlimited. uint32_t max_faults = std::numeric_limits::max(); static const JsonLoaderInterface* JsonLoader(const JsonArgs&); void JsonPostLoad(const Json& json, const JsonArgs&, ValidationErrors* errors); }; // Returns the fault injection policy at certain index. // There might be multiple fault injection policies functioning at the same // time. The order between the policies are stable, and an index is used to // keep track of their relative positions. The FaultInjectionFilter uses this // method to access the parsed fault injection policy in service config, // whether it came from xDS resolver or directly from service config const FaultInjectionPolicy* fault_injection_policy(size_t index) const { if (index >= fault_injection_policies_.size()) { return nullptr; } return &fault_injection_policies_[index]; } static const JsonLoaderInterface* JsonLoader(const JsonArgs&); private: std::vector fault_injection_policies_; }; class FaultInjectionServiceConfigParser final : public ServiceConfigParser::Parser { public: absl::string_view name() const override { return parser_name(); } // Parses the per-method service config for fault injection filter. std::unique_ptr ParsePerMethodParams( const ChannelArgs& args, const Json& json, ValidationErrors* errors) override; // Returns the parser index for FaultInjectionServiceConfigParser. static size_t ParserIndex(); // Registers FaultInjectionServiceConfigParser to ServiceConfigParser. static void Register(CoreConfiguration::Builder* builder); private: static absl::string_view parser_name() { return "fault_injection"; } }; } // namespace grpc_core #endif // GRPC_SRC_CORE_EXT_FILTERS_FAULT_INJECTION_FAULT_INJECTION_SERVICE_CONFIG_PARSER_H