Issue Description:
The user reports an issue with not being able to record classroom sessions using the Agora Webpage Recorder. The error received indicates that the web server might not be accessing the class URL correctly, resulting in failed recordings.
Platform/SDK:
Agora Webpage Recording using GCP (Google Cloud Platform) web server.
Error Message:
errorCode: 503, errorMsg: "ACCESS_URL_FAILED" which translates to a 404 (Not Found) error for the classroom URL.
Step by Step Solution:
1. Verify URL Endpoint:
Check the classroom URL being used by the webpage recorder to ensure it is correct and currently active.
2. Check Server Configuration:
Examine your GCP web server configuration to ensure it can correctly serve the requested classroom URL.
3. Handle Authentication:
If your webpage requires authentication, consider integrating an authentication token directly in the request URL for the webpage recorder.
4. Server Logs:
Review the server logs to identify why a 404 error is being returned when accessing the URL.
5. Webhook Event Check:
Listen for webhook event 71 from Agora to understand additional errors and take corrective action in your application logic.
6. Improve Error Handling:
Improve your recording task's error handling and logging to differentiate between status code errors and other application-level issues.
Root Cause:
The webpage recorder faced an "ACCESS_URL_FAILED" error due to a 404 response from the GCP web server, indicating the requested URL was not found, possibly due to a misconfiguration or incorrect URL.
Prevention/Best Practice:
Ensure all URLs are validated and correct before starting a recording session. Enhance server configuration to ensure all valid URL requests are properly resolved by the server. Consider using additional error logging to detect such issues early.
Corresponding Document/Link (optional):
For more details on handling webhooks and error codes, refer to this Agora documentation link: Agora With Webhooks