Skip to main content
Version: 12.x (Current)


In this section we provide some guidelines on how to configure the Form Service Backend for optimal performance and efficiency.

Cache lookup

If you use the form data CSV export feature, available since version 1.7.0, you should monitor the CPU and memory usage of your microservice to ensure the size of the cache does not negatively affect your service performance.

We ran some tests to evaluate the CPU and memory usage and response times depending on the cache size and state (if it's empty or full). We configured a single lookup on users, resolving their Auth0 ID in the full name. The size of the cache, meaning the number of its entries, corresponds to the total number of records from all the data sources configured in the lookups. So, for example, you configure two lookups for users and locations and you have 50000 users and 5000 locations, the number of cache entries you can expect is 55000 (50000 users plus 5000 locations).

The Form Service Backend microservice was configured as follows:

  • CPU request: 50 m
  • CPU limits: 200 m
  • RAM request: 50 Mi
  • RAM limits: 200 Mi

The following table summarizes the results of the tests:

Cache entriesEstimated cache size (in MiB)Response time (cache empty)Response time (cache full)
50002~6 secondsLess than 1 second
100005~7 secondsLess than 1 second
500009~15 secondsLess than 1 second
10000012~40 secondsLess than 1 second
25000050~50 secondsLess than 1 second

The main takeways from the tests are:

  • memory usage grows proportionally with the size of the cache, so we recommend setting up the memory limits according to the size of the lookup dataset (in the example, the cache entries reflect the total number of users in the lookup data source);
  • response time can grow significantly (by an order of magnitude) when the cache is empty, while we noticed a constant level of performance when the cache is full.

If you are dealing with hundreds of thousands or millions of lookup records, we strongly recommend running some load tests to find the best combination of CPU and memory requests and limits.

Form CSV export

We ran some tests to evaluate the response time and size of the form data CSV export, available since version 1.7.0, using a basic form with five fields: first name, last name, gender, email address and phone number.

The Form Service Backend microservice was configured as follows:

  • CPU request: 50 m
  • CPU limits: 70 m
  • RAM request: 250 Mi
  • RAM limits: 320 Mi

The following table summarizes the results of the tests:

FormsResponse timeResponse size
2501.5 s58.7 kB
5003.3 s117 kB
10005.3 s234 kB
200010 s468 kB
500035 s1.2 MB
1000052 s2.3 MB

Since the CPU was the bottleneck, we raised the CPU limits to 150 and ran the test, starting with 1000 forms up to 10000.

FormsResponse timeResponse size
10003.4 s234 kB
20004.3 s468 kB
500011 s1.2 MB
1000020 s2.3 MB

As you can see, raising the CPU limits dramatically reduced the response time with 5000 forms, from 35 to 11 seconds.

The main takeaways from the tests are:

  • the CPU represents the main bottleneck, so you should raise the CPU limits according to your use case, looking in particular at:
    • the size of the form, i.e. the number of fields;
    • the average number of forms to export;
    • the target response time, e.g. less than a second;
  • the memory usage remains constant, no matter the number of the forms, since we are using streams in the entire pipeline, from fetching the form data to returning the CSV to the client.