Skip to main content
Version: Config V2

Troubleshooting

The following issues were reported by customers. We collected what we learned and the possible solutions.

Long response times and connection issues​

First, you can verify on the Service Status Monitor whether ConfigCat is up and running or there is a planned maintenance.

General SDK Checklist​

  1. It might be a good idea to update the ConfigCat SDK to the latest version.
  2. Check if you configured the Data Governance functionality properly.
  3. Singleton: We strongly recommend using the ConfigCat SDK as a Singleton. Initializing the SDK over and over again can cause serious performance issues in production. If you want to use multiple SDK Keys in the same application, create only one ConfigCat Client per SDK Key.
  4. Are you using the proper polling mode for your use case? Details on polling modes in the SDK Docs.
  5. Might be a too frequent Auto Polling interval. Please check the SDK Docs.
  6. In Manual Polling mode, it could be a too frequent forceRefresh() call in your code, making the SDK download the config JSON often.
  7. You can try one of our lightweight sample applications to rule out local issues. Find in the repository of each SDK.

Network Checklist​

caution

Please, do not load test the ConfigCat production infrastructure without our consent.

  1. You can check the response times manually by navigating to https://cdn.configcat.com/ping.txt and opening your browser's network tab.
  2. Does the machine/server your code runs on has access to the above address?
  3. You might need to whitelist the following addresses in your firewall: cdn.configcat.com, cdn-eu.configcat.com, cdn-global.configcat.com.

Too many requests error in Angular​

The problem was caused by Angular's Hot Module Replacement functionality during development. The wrapper class, which contained the auto polling ConfigCat SDK was edited, and the Hot Module Replacement reinitialized the whole class without releasing the old, replaced module's Auto Polling timer. We believe that this is a really rare case, it could happen only during development.

Python Auto polling issue with uWSGI web server​

The Python SDK's Auto polling mode utilizes its polling job in a threading.Thread object. If you are running your application behind an uWSGI web server, the auto polling mode may not work as expected because the uWSGI web server disables Python's threading by default. Please enable threading or switch to another polling mode in this case.