While microservice architectures ofer many advantages to developers of web applications, it remains dificult to test the resilience of these applications to faults. Common approaches such as chaos engineering require dedicated personnel and carry the risk of the testing taking place in a production environment, while resilience testing tools require specifying execution scenarios and cannot test paths not exercised by those scenarios. In this paper, we introduce Onweer, a resilience tester which integrates coverage-guided fuzzing and fault injection. Fuzzing is used to explore the execution space of the application and to collect potential fault injection points. Subsequent fuzzing iterations can then inject faults as part of the fuzzing process. That is, faults are added to test cases by mutators applied to the population, and if they increase coverage these test cases with faults are added to the population for further mutation. We evaluate this approach by using three case studies of theretryresilience pattern and find that Onweer is able to both increase coverage by exploring otherwise inaccessible branches and reveal resilience defects.
Microservice architectures are a popular choice for the development of web applications, as they ofer many advantages in scaling and ease of development. However, they also introduce new complexities to the software development process. While in monolithic systems communication between modules happens via function calls which cannot themselves fail, in microservice systems this communication occurs over the network. Thus, messages may be dropped, potentially causing a transaction to occur twice, or individual services may crash, potentially bringing down the entire application. The application should be resilientto these faults, as they cannot be prevented.
Achieving resilience is quite dificult in practice, as faults mainly occur when deployed at scale and subjected to production loads, while testing environments or developer machines may not experience any faults at all. Thus, developers may not see the need for resilience or know how to implement it efectively and inadvertently introduce resilience defectsinto the application.
In order to test the resilience of their applications, many large organizations practcicheaos
engineering[
Ideally, resilience would be tested automatically and in a staging environment. However, real-world
resilience testing without the loads of a production system is dificult. Some defects may only occur on
specific execution paths, or require a combination of multiple faults in a specific order. Defects
requiring multiple faults are especially dificult to detect, as the search space quickly becomes intractable
even with just a few faults. Several tools have been developed to solve this problem4][[
In this paper we present a prototype of Onweer, a tool aimed at fully automating the resilience testing process. Our tool uses coverage-guided fuzzing to automatically explore the execution space of the system under test and generate a diverse set of test inputs. During this fuzzing process, potential fault injection points are collected, and faults are injected as part of the fuzzing process.
In this work, we answer the following research questions: RQ1 Can fault injection as part of the fuzzing process be used to increase coverage? RQ2 Can fault injection as part of the fuzzing process reveal resilience defects?
In order to answer these research questions, we use Onweer to test several diferent implementations of the retryresilience pattern, and show how fault injection reveals defects and explores otherwise inaccessible branches.
As a motivating example, consider an application with two servicesp,ing and pong. Both services have a counter, which they attempt to keep in sync. Sending a POST request to thpeing service increments both counters with the value given in the request body and returns the value of the counters.
As can be seen in Figure1, pong is relatively simple: it checks whether the request is in the accepted range, increments its counter, and sends the value back. If the request is not in the valid ranpgoen,g responds with a generic400 Bad Request error.
ping, then, must simply pass along the amount to increment by, increment its own counter, and respond with both counter values. However, there are some extra complexities to consider. The response frompong must be checked to see whether the request was valid, but errors on the connection to pong must also be taken into account.
Figure2 shows an implementation ofping which takes all of these factors into account, checking for all status codes and incorporating a bounded retry pattern. The implementation grows quite complex because of these additional checks, and hence features more conditional branches than an implementation that would ignore these checks would have. Manual testing of an application like this requires taking in account every failure condition to ensure that every branch is covered. If an exception is not handled, it is even possible that full code coverage is achieved in the presence of a defect, with no indication that some cases have not been tested.
Therefore, we would like to automatically test code like this, to achieve high coverage while minimizing manual efort, and to ensure that “invisible” defects are revealed. In order to find such resilience defects, we must explore both the input space of the application to determine which code is reached under which inputs, as well as the fault space to determine whether that code is resilient to faults.
Fuzzing allows us to eficiently explore the input space, especially if we incorporate coverage feedback. This still leaves the issue of fault injection, specifically knowing where faults can be injected and how to eficiently explore the fault space of the program. We propose that fuzzing can be leveraged to explore the fault space as well, by discovering potential fault injection points during fuzzing and by using coverage feedback to identify interesting faults similar to how we identify interesting inputs.
Figure3 contains an overview of Onweer’s architecture. The tool is divided into thOenweer controller and the Onweer agents attached to the system’s microservices.
The agents are attached to each of the services in the system. They collect coverage information and fault injection points during execution. Agents are also responsible for injecting the faults associated with a test case. Currently, the only agent implementation is a Java age1n,tbut communication occurs via a simple REST interface and thus other languages can be supported with a modest amount of efort.
The Onweer controller is a coverage-guided fuzzer written in Python. It uses a conventional fuzzing architecture: test cases are drawn from a population, mutated, ran, and the mutated test is added to the population if it increases coverage as reported by the agents. However, this architecture is complicated by several additions to support REST APIs and fault injection. For the purposes of mutation, test cases are split into REST request data and to fault injection data, and these two parts are mutated separately.
REST requests are generated with the help of an OpenAPI6][ schema. OpenAPI is a standard for specifying the endpoints, arguments and responses of a REST API. The schema for thpeing service is shown in Figure4. It first defines a schema for two JSON objects, an IncrementRequest object containing a single integer and aPingResponse object containing two integers. It then defines the paths and methods available onping, in this case only thePOST method on the /ping path. It requires the body of requests to this endpoint to beIncrementRequest and the response to be either a200 status code with a PingResponse body or a 400 status code with no schema specified for its body. We 1Using JaCoCo for code coverage and ByteBuddy for instrumentation base our fuzzer on such a schema as it is otherwise infeasible to automatically discover all the endpoints in an API, which arguments these endpoints take, etc.
Test cases are generated using Hypothesis7[] data generation strategies. Hypothesis is a propertybased testing library for Python, and as such includes advanced data generation strategies. Specifically, we use the Schemathesis [8] library to create a Hypothesis data generation strategy for every operation in the API. The Schemathesis data generation strategies produce executable test cases which conform to the schema.
Rather than drawing from a seeded random generator, Hypothesis strategies instead draw from an input bitstream [9], using the values of that bitstream to generate values or decide which branch to take. When a strategy is used to generate a structured input, such as a REST request, each part of the input bitstream corresponds to a specific structural element in the generated output. Furthermore, by construction every input bitstream results in either a schema-conforming REST request or an exception indicating that generation failed for this bitstream.
As described in [10], by mutating the underlying bitstream we can thus safely mutate structured test cases without having to implement complex structural and schema-preserving mutators. For example, if the schema requires that a request body contains one of two fields, then the first byte of the bitstream might encode which field is used. If then those two fields have diferent types, the second byte could be interpreted as either an integer or a floating point number depending on which field is chosen. If a mutator changes the first byte of the bitstream, the request produced will use a diferent field, and the second byte will be transparently reinterpreted as a diferent type by the generator, requiring no extra code in the mutator. On the other hand, if the mutator changes the second byte of the bitstream, this will change the value in that field to another valid value of its type, without the mutator needing to know which type that is or even how that byte is interpreted at all.
Fault injection is fully automated as part of the fuzzing process. In order to inject faults, Onweer must also automatically discover fault injection points.
When the system under test starts, all potential fault injection points (such as REST call sites) are instrumented so that whenever a point is executed, it is added to tarace of fault injection points. This instrumentation also adds code to enable fault injection at these points. After the execution of a test case, Onweer fetches the traces from every agent and merges them, storing it with the test case. This merged trace then contains every fault injection point that is executed by that test case.
This allows us to add faults to a test case by defining a mutator, in the same way we define mutators to generate new REST requests from the population. When this mutator is run, it picks a fault from the test’s trace and adds it to the list of faults to be injected. Then, before the test is executed, the controller sends this list of faults to the appropriate agents, which will inject it when the execution reaches the specified point.
Currently, the only agent implementation is a Java instrumentation agent which intercepts Spring Boot API calls, and thus fault injection points correspond to the source code location of Spring REST requests. There are currently two kinds of faults that can be injected at these points:ReastClientException thrown before or thrown after sending the corresponding request. An exception thrown before a REST request simulates a connection error causing the initial request to be lost, whereas an exception thrown after simulates the response to that request being lost. These two fault types cause diferent behavior which must be appropriately handled by the application for correct operation. Other types of faults are possible and occur in production systems, but the faults we have implemented are common in production systems, and even these two simple fault types already enable us to explore interesting behaviors of the application under test. Furthermore, these faults also clearly demonstrate the principle of Onweer, as it is clear that any application should be resilient to them, and thus it is reasonable to consider any failure to handle these faults to be a bug.
Along with the point and type, the controller also determines the number of times executing the point results in a fault being injected. For example, if a fault is injected once, an exception will be thrown only the first time the fault injection point is executed. If it is injected five times, an exception will be thrown the first five times the point is executed. This allows Onweer to explore retry mechanisms, which might require multiple consecutive faults to reach some branches.
To evaluate Onweer we use three implementations of theretry pattern as case studies. The retry pattern is a simple resilience pattern where a failed request is retried a bounded number of tries to attempt to successfully complete the request [11]. However, it is still not trivial to implement correctly, as the case where all retries fail must be handled, idempotency of the retried request must be taken into account, etc. Each of these case studies implementsping in a diferent way while using the same pong discussed in Section2 and shown in Figure1.
Case study #1, shown in Figure5, is a naive implementation without any resilience pattern, so any fault injected here will result in a bug being found. This case study also does not check for the 400 Bad Request error condition and thus contains a bug that can be found without fault injection.
Case study #2, shown in Figure6, implements a “naive” retry pattern, as it assumes that the fault is transient and will not occur a second time. Hence, injecting one fault will not reveal the defect, but injecting two faults will.
Case study #3, as shown in Figure2 and discussed in Section2, features a correct implementation of the retry pattern. As the implementation is correct, Onweer will not be able to find a defect, but it does include several branches which are only reachable if a fault occurs.
We compare the coverage achieved and defects found between Onweer using only fuzzing but without the fault injection mutator enabled, and Onweer with fault injection enabled to determine the advantages of using fault injection. In both cases, both theping and pong services are instrumented by Onweer agents in order to gather coverage and trace data and inject faults.
We perform 10 fuzzing runs for every case study with and without fault injection. Every fuzzing run starts with a seed population of 1 test case and runs for 2 minutes or until a bug is found. Bugs are identified by a 500 status code returned by the server.
Table 1 contains the results of the experiment, listing how often an error was found, the percentage of lines covered, population size (how many coverage-increasing test cases were found), the number of fuzzing iterations ran and the time taken.
Starting with case study #1, we can see that both with and without fault injection Onweer quickly ifnds an error and terminates. However, the error found difers. Without fault injection, the error found is that the increment is out of range forpong, which case study #1 does not check for. With fault injection, Onweer can find both errors, finding the resilience defect 4 out of 10 times in our tests. Notably, this also results in a significantly higher coverage in the runs where the resilience defect was found, resulting in a higher average coverage.
In case study #2, running without fault injection results in no error being found, as the bug cannot occur without a fault. Thus, Onweer executes around 4800 requests over the 2 minutes of allowed runtime. The final population is 2.7 and the final coverage is 87.8% on average. There is some variance in these results because the fuzzing process depends on the initial population and which mutations are chosen, and we use a short runtime and small initial population for this evaluation. Proper tuning of the fuzzing parameters and a longer runtime is likely to make results more consistent.
With fault injection, however, the resilience defect in case study #2 is found quickly, even though it requires two consecutive faults to be injected rather than only one. However, a few more iterations are necessary than for case study #1 and the population size is slightly larger on average. This is because injecting one fault increases the coverage and is thus saved to the population, which can then be mutated to inject the second fault and find the defect. This shows that the combination of fuzzing and fault injection is efective in finding resilience defects. Note that while the coverage is lower with fault injection, this is expected as the fuzzing process stops after finding an error and thus does not fully explore the application.
In case study #3, Onweer runs for 2 minutes both with and without fault injection since there is no bug to be found. It again executes about 4800 iterations without fault injection and slightly less with fault injection. However, both the population and the coverage are notably higher with fault injection, as Onweer is able to use fault injection to explore several branches that are otherwise unreachable and find more interesting inputs. In fact, Onweer with fault injection is able to explore all branches in case study #3 and achieved this on several runs. The metric in Tabl1eis somewhat lower as the short runtime and small initial population mean this was not achieved on every run due to randomness.
While our evaluation is limited by the small number of case studies, we can answer our research questions afirmatively: RQ1 In case studies #1 and #3, we see that adding fault injection to the fuzzing process can increase the coverage of a fuzzer. The reduced coverage of case study #2 does not invalidate this, as it is easily explained by early stopping.
RQ2 Case studies #1 and #2 show that adding fault injection to the fuzzing process enables our fuzzer to find resilience defects that cannot be found by a regular fuzzer.
Currently, Onweer only supports sending single REST requests. Most REST APIs, however, are stateful; intended for use with sequences of requests where an object is created and then manipulated on the server. In order to be able to efectively test real-world applications, we thus plan on adding stateful fuzzing to Onweer, whereby it should be able to automatically create interesting sequences of requests rather than only single requests.
Several tools already exist on which our approach can be modeled, such as RESTler12[]. However, most approaches currently described in the literature are black-box methods. Ideally we would extend the methods used in these tools to use coverage feedback. Of course, we will have to integrate fault injection into these frameworks as well.
As most microservice applications are stateful, it is likely that some test cases will either not always take the same path through the application or be flaky. For example, when using certain resilience patterns it is possible that a request influences the path taken or result of a subsequent request, even if those requests operate on diferent server-side objects. Because startup times are typically quite long for these systems, restarting after every test case is not a viable solution. To ensure our tool is robust and eficient, we must take these cases into account and attempt to mitigate them. This could take the form of periodically “resetting” the system if its API exposes such a functionality, using distributed tracing to accurately track all paths associated with a test case, or a combination of these methods.
As mentioned in Section3.3, currently the only fault that is injected is a generic exception thrown
before or after a Spring REST request. This is a restricted view of fault injection, as many other kinds
of faults occur in real-world systems1[
We have designed Onweer so that the framework can easily accommodate new kinds of faults. The controller only receives traces from the agents and sends back which faults are to be injected, without making many assumptions about what a fault is. All other logic, such as which fault injection points are recorded and how a fault is injected, is handled by the agents. Thus, a new fault can be implemented in an agent simply by reporting it as a fault injection point in the trace and implementing the fault injection logic, without modifying the controller at all.
Furthermore, the controller and agents communicate through a simple REST API, making it straightforward to write new agents. This way, Onweer can be expanded to include fault injection not only in the business logic of a microservice application, but also in the infrastructure surrounding it such as load balancers or API gateways.
The concept of using fault injection to test the resilience of distributed applications is not new, and many tools exist in the literature. However, as discussed in Sectio1n, most tools require the developer to specify part of the execution or fault scenario.
FATE and DESTINI [
Gremlin [
Chaokka [14] is focused on Akka actor systems. It traces the execution of a user-defined test case, and injects faults using delta-debugging to try and find a minimal set of faults which can change the outcome of the test case.
Filibuster [
Even though Onweer is focused on resilience testing, it uses REST API fuzzing to explore the execution space of the program and enable fault injection. Thus, it is important to consider the state of the art in this field. Most of the current approaches are black-box, and not all of them easily permit integration with fault injection.
Schemathesis [8] is used as a library by Onweer, but it can also be used a standalone property-based testing tool for REST API testing. It focuses on eficient generation of diverse inputs that conform to an OpenAPI schema and checks the responses to verify whether they match the responses defined in the schema. However, Schemathesis features no automated generation of request sequences and requires dependencies between operations to be specified in the schema instead. A Schemathesis run produces a test suite which may be kept for continued integration testing of the application.
RestTestGen [15] is an extensible REST API testing framework, which features a variety of built-in data generation strategies. Like Schemathesis, it relies on OpenAPI schemas to generate request values and to determine dependencies between operations. However, it supports custom ordering algorithms for request sequences.
Evomaster [16] is a search-based test generation tool for REST APIs. It works only for Java applications, as it uses code coverage and branch distance metrics to speed up testing, but also has a black-box mode usable on any REST API. It uses predefined “templates” to create sequences of requests, which may be mutated somewhat. Similarly to Schemathesis, Evomaster produces a test suite which aims to cover as much of the application as possible in as few tests as possible.
RESTler [12] is a REST API fuzzer focused on building sequences of requests, using objects returned in previous requests as arguments in future requests. It iteratively builds request sequences by appending API operations to sequences. An operation may only be appended when its dependencies are fulfilled, that is, when operations earlier in the sequence have created or fetched the server-side objects it uses. RESTler uses several heuristics to make this process more eficient. It also uses feedback from the server, in the form of response codes, to infer which sequences result in an error and should thus not be further extended.
In this paper we presented Onweer, a prototype resilience testing tool which combines fault injection and fuzzing. Onweer leverages fuzzing to generate interesting paths for fault injection and to collect fault injection points. It integrates fault injection into the fuzzing process by making faults part of the test case and mutating them in the same way as other inputs. This approach allows resilience testing to be fully automated with minimal developer intervention. Through three case studies, we show that Onweer is able to find resilience defects in microservice systems and test branches which are otherwise unreachable to regular testing. puting Systems (ICDCS), 2016, pp. 57–66. URL: https://ieeexplore.ieee.org/document/753650.5 doi:10.1109/ICDCS.2016.11. [6] D. Miller, J. Whitlock, M. Gardiner, M. Ralphson, R. Ratovsky, U. Sarid, OpenAPI Specification, 2021. URL: https://spec.openapis.org/oas/v3.1.0.html. [7] Hypothesis, 2024. URL: https://hypothesis.works/. [8] Z. Hatfield-Dodds, D. Dygalo, Deriving semantics-aware fuzzers from web API schemas, in: Proceedings of the ACM/IEEE 44th International Conference on Software Engineering: Companion Proceedings, ICSE ’22, Association for Computing Machinery, New York, NY, USA, 2022, pp. 345–346. URL: https://doi.org/10.1145/3510454.3528637. doi:10.1145/3510454.3528637. [9] D. MacIver, How Hypothesis Works, 2016. URL: https://hypothesis.works/articles/ how-hypothesis-works/. [10] R. Padhye, C. Lemieux, K. Sen, M. Papadakis, Y. Le Traon, Semantic fuzzing with zest, in: Proceedings of the 28th ACM SIGSOFT International Symposium on Software Testing and Analysis, ISSTA 2019, Association for Computing Machinery, New York, NY, USA, 2019, pp. 329–340. URL: https://dl.acm.org/doi/10.1145/3293882.3330576. doi:10.1145/3293882.3330576. [11] R. Kuhn, B. Hanafee, J. Allen, Reactive Design Patterns, Manning, 2017. [12] V. Atlidakis, P. Godefroid, M. Polishchuk, RESTler: Stateful REST API Fuzzing, in: 2019 IEEE/ACM 41st International Conference on Software Engineering (ICSE), 2019, pp. 748–758. doi:10.1109/ICSE.2019.00083. [13] F. Silva, V. Lelli, I. Santos, R. Andrade, Towards a Fault Taxonomy for Microservices-Based Applications, in: Proceedings of the XXXVI Brazilian Symposium on Software Engineering, SBES ’22, Association for Computing Machinery, New York, NY, USA, 2022, pp. 247–256. doi:10.1145/3555228.3555245. [14] J. De Bleser, D. Di Nucci, C. De Roover, A Delta-Debugging Approach to Assessing the Resilience of Actor Programs through Run-time Test Perturbations, in: Proceedings of the IEEE/ACM 1st International Conference on Automation of Software Test, AST ’20, Association for Computing Machinery, New York, NY, USA, 2020, pp. 21–30. URL:https://dl.acm.org/doi/10.1145/3387903. 3389303. doi:10.1145/3387903.3389303. [15] D. Corradini, A. Zampieri, M. Pasqua, M. Ceccato, RestTestGen: An Extensible Framework for Automated Black-box Testing of RESTful APIs, in: 2022 IEEE International Conference on Software Maintenance and Evolution (ICSME), 2022, pp. 504–508. URLh:ttps://ieeexplore.ieee.org/ document/9978261. doi:10.1109/ICSME55016.2022.00068. [16] A. Arcuri, RESTful API Automated Test Case Generation with EvoMaster, ACM Transactions on Software Engineering and Methodology 28 (2019) 3:1–3:37. URL: https://dl.acm.org/doi/10.1145/ 3293455. doi:10.1145/3293455.