Troubleshooting

If ZHERO misbehaves (data not loading, charts not appearing in the console, tables rendering oddly), the steps below resolve almost every issue you may encounter. They are ordered from least to most invasive: start at the top and stop as soon as the problem is gone.

Quick reference

Symptom	Start from
A table renders partially, looks frozen or empty	Step 1
Charts or data not loading, analysis templates or posture scoring look off	Step 2
ZHERO shows a configuration that does not match what you see in Zscaler	Step 3
Anything else, or the steps above did not help	Step 4

The troubleshooting ladder

1. Force a re-render. If the issue is visual and confined to a table, scroll up or down to force the rows to render again. Alternatively, switch to another tab or menu entry and come back: returning to the view re-renders it.

2. Refresh the page. ZHERO reinitializes most of its features on page load, so a browser refresh is a valid general-purpose fix. It typically resolves issues with analysis templates, posture scoring and rendering.

3. Reload specific entities. If ZHERO shows a configuration that differs from what you know is in Zscaler, some entities may need a reload. Hover over the ZHERO icon in the Zscaler console header and choose Reload: from there you can force a reload of specific entities.

   

4. Reload ALL policies. Click the ZHERO extension icon in the browser toolbar and click Reload ALL policies. ZHERO reloads the console, clears its cache and reloads all the information from the Zscaler console. This resolves the large majority of remaining issues.

   If you do not see the extension icon, open the browser’s extensions list and pin ZHERO so the icon stays visible.

   

5. Log out and log back in, using the Logout button in the same extension popup.

6. Reinstall the extension. As a last resort, remove the extension from the browser and install it again following the Installation Guide.

How ZHERO stays in sync with Zscaler

Changes you make in your own browser are detected right away, and ZHERO refreshes the affected entities immediately. Changes made by other administrators are picked up by polling the Zscaler audit logs every five minutes: when ZHERO detects a change, it automatically reloads the affected entities. A mismatch between ZHERO and Zscaler should therefore never last more than a few minutes. If it does, use Reload (step 3) or Reload ALL policies (step 4).

When to report an issue

Fixed it with step 4 or beyond? Please tell us anyway

Steps 1 to 3 are part of how a browser extension normally lives inside a complex console. But if you needed Reload ALL policies, a re-login or a reinstall to fix something, that is unexpected behavior: even if the problem is now solved, we would love to hear about it so we can fix the root cause.

To report an issue:

1. If you can, reproduce the problem first: trigger the error again right before sending the report, so the diagnostic logs capture it.
2. Hover over the ZHERO icon in the Zscaler console header and choose Send Feedback / Feature Request.
3. Describe what happened, what you expected and the steps that led there. You can attach up to 5 files (5MB total), for example screenshots of the issue.
4. Under Diagnostic Logs, pick a time window that covers the problem (from the last 5 up to the last 30 minutes) and check Include diagnostic logs with feedback before sending.

Tip

Diagnostic logs may contain session data such as URLs and configuration details. If your organization does not allow sharing them, you can still send the report without logs, or use Download Logs to review them first.