Charles is a web proxy that runs on your computer and allows you to record data that is sent and received between your web browser and the server. Using Charles makes it easy to diagnose and fix problems. For details, see the Charles web proxy site.
Steps to create a Charles log
The following steps lead you through using the Charles web proxy to create a recorded log.
If you are using Firefox, you should be prompted to install the Add-on for Firefox.
- On your computer, run Charles. From the menu, select Proxy > Proxy Settings. Ensure a port has been assigned (e.g., 8888) and the Enable transparent HTTP proxying option is selected.
- Select OK to save changes and close the dialog.
- Install the Charles SSL certificate. From the menu, select Help > SSL Proxying > Install Charles Root Certificate.
- In the Add Certificate dialog, select Add.
- Enable SSL proxying in Charles. From the menu, select Proxy > SSL Proxy Settings. Ensure the Enable SSL Proxying option is selected. In the Location section, select the Add button.
- In the Edit Location dialog, navigate to the Port field and enter 443. Select OK to save this change.
- Select OK to close the Edit Location dialog.
- Select OK to exit the SSL Proxying Settings dialog.
- It's recommended that you restart your computer at this point to make sure that Charles picks up the new certificate settings.
- Keep Charles open while you do the next steps.
- Paste the URL to the page that contains the Brightcove Player you are troubleshooting into the browser's address bar, and then press Enter to load the page.
- Run through the steps you previously used to reproduce the error or issue. Charles will automatically record what is happening.
- If network traffic is needed for when the player is playing a video, start the video.
- After reproducing the error, return to Charles and select Stop Recording.
- Save the current session in a file.
- Email the Charles session file to the appropriate support personnel.