Issue Description:
Users need to verify whether Cloud Proxy is enabled and actively being used in their Agora projects. They also want to confirm its configuration for calls and meetings, understand how usage is billed, and learn how to verify if Cloud Proxy traffic is being properly tracked and invoiced.
Platform/SDK:
Applicable to all Agora SDKs (e.g., Web, iOS, Android, Unity) using the Cloud Proxy feature.
Step by Step Solution:
1. Verify Cloud Proxy Configuration
- In your Agora project code, confirm that the setCloudProxy API is being called before initializing or joining a channel. - Ensure that the proxyType parameter is set correctly to either:
-
UDP_PROXYfor UDP-based proxy connections, or -
TCP_PROXYfor TCP-based proxy connections.
Example:
javascript
rtcEngine.setCloudProxy(1); // (1 for UDP_PROXY or 2 for TCP_PROXY)
2. Check Cloud Proxy Status in Agora Console
- Log in to your Agora Console.
- Navigate to Usage > Details.
- Under Feature Type, select Cloud Proxy.
- Review usage data for your project(s). If no usage is displayed, Cloud Proxy may not be active or properly configured.
3. Review Billing Information
- Cloud Proxy usage is billed based on duration or the number of Peak Concurrent Users (PCU), depending on proxy type and video quality.
- Billing occurs monthly, and detailed usage appears in your account invoice at the end of each calendar month.
4. Confirm Active Usage
- Conduct a test call or meeting using the same project/App ID with Cloud Proxy enabled.
- Return to the usage dashboard after several minutes to verify whether new data appears under the Cloud Proxy feature.
Root Cause:
If Cloud Proxy is not properly configured in the SDK or setCloudProxy is missing from the application code, sessions will bypass the proxy, resulting in no recorded usage or billing activity.
Prevention/Best Practice:
Always call setCloudProxy immediately after initializing the SDK and before joining a channel. Periodically review your usage dashboard to confirm the feature is working as expected, especially after configuration changes or during new deployments.
Corresponding Document/Link:
- Agora Cloud Proxy Overview and Pricing
- Agora Pricing Details