Creating a Charles Log

Product(s)
Brightcove Player
Video Cloud
Role(s)
Player Developer
Topic(s)
Troubleshooting/Error Handling

In this topic, you will learn how to create and save a Charles log. This can be helpful when working with support, and they may ask you to send the log to them.

 

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.

  1. Download and install Charles on your machine. Charles is compatible with Windows, Mac and Linux. For platform specific details about installing Charles, see the Charles Installation notes.

    If you are using Firefox, you should be prompted to install the Add-on for Firefox.

  2. 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.
    Proxy settings
    Proxy settings
  3. Select OK to save changes and close the dialog.
  4. Install the Charles SSL certificate. From the menu, select Help > SSL Proxying > Install Charles Root Certificate.
    Install Charles SSL certificate
    Install Charles SSL certificate
  5. In the Add Certificate dialog, select Add.
    Add Charles SSL certificate
    Add Charles SSL certificate
  6. 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.
    SSL Proxy settings
    SSL Proxy settings
  7. In the Edit Location dialog, navigate to the Port field and enter 443. Select OK to save this change.
    Location port 443
    Location port 443
  8. Select OK to close the Edit Location dialog.
    SSL settings with location
    SSL settings with location
  9. Select OK to exit the SSL Proxying Settings dialog.
  10. It's recommended that you restart your computer at this point to make sure that Charles picks up the new certificate settings.
  11. Keep Charles open while you do the next steps.
  12. 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.
  13. Run through the steps you previously used to reproduce the error or issue. Charles will automatically record what is happening.
  14. If network traffic is needed for when the player is playing a video, start the video.
  15. After reproducing the error, return to Charles and select Stop Recording.
    Charles stop recording
    Charles stop recording
  16. Save the current session in a file.
    Charles save session
    Charles save session
  17. Email the Charles session file to the appropriate support personnel.