icon-isolation.svg
Isolation (CBI)

Using Debug Mode for Isolation

Enabling Debug Mode for Users

Debug mode is a feature that admins can enable for users in their isolation profiles. To learn more, see Creating Isolation Profiles for ZIA and Creating Isolation Profiles for ZPA.

When an issue occurs during an isolated session, users can start debug mode to troubleshoot the issue. This allows users to decipher whether the issue occurring is related to the isolated session itself, or something else with their web browsing. Native browsers allow you to troubleshoot in a few ways, usually with developer tools. An end user of Isolation, however, should never be able to see these details that are typically available in the native browser. Debug mode allows users to troubleshoot the issue without revealing confidential information.

Starting Debug Mode

  1. Enter an isolation session on your browser.
  2. From the Isolation Menu, select Start debug mode.
  3. A message appears asking you to confirm starting debug mode. Click Start.
    1. The web page reloads with the same URL and restarts the isolation session with debug mode activated. The Debug Mode icon appears in the lower right of your web page, next to the Show Isolation Bar icon. If you have multiple tabs open for one isolation session, only the selected tab enters debug mode. The other tabs in the existing session close automatically, and any information on those tabs is lost when the session restarts. If you open new tabs while in the restarted isolated session, the new tabs are automatically in debug mode.
    2. To stop debug mode, click the Debug Mode icon. You can also click Stop debug mode from the Isolation Menu.
    3. A message appears asking you to confirm ending debug mode. Click Stop. If you do not manually stop debug mode, it will deactivate after a timeout period of 10 minutes. If you end your isolation session while using debug mode, all data from the debugging is still captured. If you stop debug mode when there are multiple tabs open, the data from all tabs is captured.
    4. After debug mode stops, a message appears confirming it has concluded. To return to the original isolated session without debug mode activated, click Restore session.
    5. When debug mode ends, a ZIP file is automatically generated and downloaded to your device. The ZIP file is named in the format "debug_DDMMYY: TimeinUTC" and is encrypted by a password set by the admin. It includes data for:
      • Console Logs: Information from the website(s) accessed by isolation.
      • HTTP Archive format (HAR) Data: Information about the isolated session.
      • Netlog Data: Information from the web browser used.
      • Network Latency: Information from the Isolation network diagnostics tab. To learn more, see Accessing Network Diagnostics in Isolation.
      • General Information: Information that pertains to Zscaler, such as:
        • User ID
        • Isolation profile name and ID
        • Zscaler Internet Access (ZIA) or Zscaler Private Access (ZPA) tenant ID (including the cloud name)
        • Isolation tenant ID
        • Name space ID
        • Isolation region and cluster information
        • Expected cooperative transmission count (ECTX) received from ZIA
        • Isolation browser egress IP address
        • ZIA PAC file
        • Modified PAC file (if applicable)
        • Flow details (ZIA Flow/IdP Proxy Flow/ZPA Flow)
        • Correlation IDs (endpoint session ID, pod ID, etc.)
Related Articles
Using Persistent State for IsolationAccessing Multiple Sessions In IsolationAccessing Network Diagnostics in IsolationUser Experience Modes in IsolationRead-Only Mode In IsolationUnderstanding Turbo Mode for IsolationUsing Debug Mode for IsolationUsing the Isolation Bar in Native Browser ExperienceUsing the Right-Click Menu in IsolationUsing Search in IsolationUnderstanding Language Translate for IsolationTransferring and Viewing Files in IsolationLocal Browser Rendering for IsolationBookmarking Web Pages in IsolationMobile User Experience in Isolation