Troubleshooting
The following issues were reported by customers. We've collected what we've learned and provided the possible solutions below.
Long response times and connection issues
First, check the Service Status Monitor to see if ConfigCat is up and running or if there is any planned maintenance.
General SDK Checklist
- Make sure you're using the latest version of the ConfigCat SDK.
- Check if you've configured the Data Governance functionality correctly.
- Singleton: We strongly recommend using the ConfigCat SDK as a Singleton object. Initializing the SDK multiple times can cause serious performance issues in production. If you need to use multiple SDK Keys in the same application, create only one ConfigCat Client per SDK Key.
- Are you using the proper polling mode for your use case? Details on polling modes in the SDK Docs.
- Are you using the right polling interval for
Auto Polling
? Too frequent polling will increase your network traffic. Please check the SDK Docs. - In
Manual Polling
mode, are you callingforceRefresh()
in your code as frequently as needed? Excessive refreshes will increase your network traffic. - You can try one of our lightweight sample applications to rule out local issues. Find in the repository of each SDK.
Network Checklist
Please, do not load test the ConfigCat production infrastructure without our consent.
- You can check response times manually by navigating to
https://cdn.configcat.com/ping.txt
and opening your browser's network tab. - Does the machine/server running your code have access to the above address?
- 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
This issue can occur due to Angular's Hot Module Replacement functionality during development when you have a class that wraps the ConfigCat SDK running in Auto Polling mode and the wrapper class is edited. The Hot Module Replacement may reinitialize the whole class without stopping the ConfigCat SDK's Auto Polling timer in the old, replaced module.
We consider this a rare edge case that only happens during development.
Python Auto Polling issue with uWSGI web server
The Python SDK's Auto Polling mode runs its polling job in a threading.Thread
object. If you run 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.