ZCC-Troubleshooting

Zscaler Client Connector Logs analysieren: vom Export zum Befund

Die Logs des Zscaler Client Connector beantworten viele Supportfälle, wenn man sie lesen kann. CentaurNexus macht daraus zwei unterstützte Arbeitswege: den Upload in den Log Analyzer und die on-device Auswertung durch den CentaurNexusAgent direkt im Unified Support Center.

7. August 2026 · CentaurNexus · Lesezeit ca. 5 Minuten

Ablaufvergleich: der übliche Weg über fünf Schritte gegenüber drei Schritten mit Log Analyzer, in unter drei Minuten.
CentaurNexus: Zscaler Client Connector Logs analysieren: vom Export zum Befund

ZCC-Logs sind eine Goldgrube, aber mühsam zu lesen

Wenn ein Nutzer meldet, dass eine Anwendung nicht erreichbar ist oder die Anmeldung hängt, steht die Antwort oft schon in den Logs des Zscaler Client Connector (ZCC). Dort protokollieren mehrere Komponenten parallel: Tunnelaufbau, Dienststatus, Updates und weitere Abläufe verteilen sich auf Dateien wie ZSATunnel.log, ZSAService.log oder ZSAUpm.log.

Genau das macht die manuelle Auswertung mühsam. Ein exportiertes Log-Bundle enthält viele Dateien, rotierte Archive und Zehntausende Zeilen. Die relevanten Muster sind kryptisch, verteilen sich über mehrere Dateien und müssen zeitlich zueinander in Beziehung gesetzt werden. Im Helpdesk-Alltag fehlt dafür meist die Zeit, und die Erfahrung, welche Zeile auf welche Ursache deutet, ist ungleich verteilt.

Weg 1: Log-Bundle hochladen und auswerten lassen

Der Log Analyzer in CentaurNexus nimmt diesen Schritt ab. Der Ablauf für den Upload-Weg:

  1. Der Nutzer exportiert die Logs in ZCC über das Zahnrad, dann About, dann Export Logs beziehungsweise Collect Logs.
  2. Die exportierte ZIP wird direkt in den Log Analyzer hochgeladen. Sie wird lokal im Browser entpackt; übernommen werden nur die enthaltenen .log- und .txt-Dateien. Alternativ lassen sich einzelne Dateien wie ZSATunnel.log oder ZSAService.log hochladen.
  3. Die Analyse läuft automatisch und liefert severity-sortierte Befunde von Kritisch bis Niedrig.
  4. Jeder Befund zeigt Trefferzahl, Erst- und Letztauftreten, betroffene Dateien, Beispielzeilen und eine konkrete Fix-Empfehlung.

Zusätzlich fasst ein Überblick die Metadaten des Bundles zusammen: ZCC-Version, Betriebssystem, Z-Tunnel-Version, abgedeckter Zeitraum sowie die Zähler für Fehler und Warnungen. So ist auf einen Blick klar, welchen Client-Stand und welches Zeitfenster die Analyse überhaupt betrachtet.

Welche Störungsmuster erkannt werden

Die Auswertung sucht nach bekannten Mustern und ordnet sie Kategorien zu, unter anderem: Authentifizierungs-Schleifen und Login-Fehler, gestörte Z-Tunnel-Verbindungen, fehlgeschlagene DNS-Auflösung, PAC-Datei-Fehler, nicht erfüllte Geräte-Posture, SSL- und Zertifikatsfehler, lokale AV- oder Firewall-Blockaden der ZPA-Loopback-Pakete, erkannte Captive Portals und hängende ZCC-Upgrades.

Zu jeder Kategorie gehört eine Empfehlung, die den nächsten sinnvollen Prüfschritt benennt: etwa IdP- und SAML-Konfiguration samt Systemzeit bei Authentifizierungs-Schleifen, den Netzwerkpfad zum Service Edge bei Tunnelstörungen oder die Trust-Store-Kette bei Zertifikatsfehlern. Der Bearbeiter beginnt nicht bei Zeile eins, sondern beim wahrscheinlichsten Hebel.

Weg 2: Mit dem CentaurNexusAgent entfallen Export und Upload

Auf Geräten mit dem CentaurNexusAgent geht derselbe Vorgang ohne Zutun des Nutzers. Der CentaurNexusAgent wertet die ZCC-Logs direkt auf dem Gerät aus und überträgt ausschließlich strukturierte Befunde. Kein Export, keine ZIP, kein Upload, keine Wartezeit im Ticket.

Öffnet ein berechtigter Bearbeiter im Unified Support Center den betroffenen Nutzer, erscheinen die Client-Log-Befunde inline im selben Arbeitskontext, in derselben Befund-Ansicht wie beim Upload-Weg. Jeder Befund trägt sein Zeitfenster sowie Erst- und Letztauftreten; auch eine Störung, die vor Stunden auftrat, bleibt damit nachvollziehbar, ohne dass der Nutzer sie reproduzieren muss. Ein Klick öffnet dieselben Befunde in der vollständigen Log-Analyzer-Ansicht.

Datenminimierung als Grundprinzip: Beim CentaurNexusAgent verlassen die Rohzeilen der Logs das Gerät nie. Übertragen werden nur strukturierte Befunde mit Kategorie, Schweregrad, Zeitfenster und Zählern.

Datenschutz in beiden Arbeitswegen

Auch der Upload-Weg ist auf Datensparsamkeit ausgelegt: Die Logs werden nur im Arbeitsspeicher ausgewertet und nicht gespeichert. Personenbezogene Angaben in Beispielzeilen werden gemäß Tenant-Einstellung obfuskiert, und jeder Abruf wird auditiert.

Der Zugriff auf Befunde ist rollenbezogen abgesichert. Ihn erhält nur, wer den Log Analyzer oder ein Support-Center nutzen darf, und ein auf Domänen gescopter Administrator sieht ausschließlich Nutzer seiner eigenen Domäne. Damit bleibt die Log-Analyse ein kontrollierter Arbeitsweg und wird nicht zum Nebeneingang für breite Einsichtsrechte.

Zscaler bleibt Kernanbieter

Der Zscaler Client Connector bleibt die maßgebliche Client-Software und Quelle der Logdaten. CentaurNexus ergänzt den unterstützten Ablauf um Auswertung, Einordnung und Fix-Empfehlungen in einem gemeinsamen Arbeitskontext für Helpdesk und Administration. Die Befunde verweisen bewusst zurück auf die Zscaler-Seite des Problems, etwa Posture-Profile, PAC-Dateien oder die Tunnel-Konfiguration, damit die Korrektur dort stattfindet, wo sie hingehört.

Häufige Fragen

Muss ich das ZCC-Log-Bundle vor dem Upload entpacken?

Nein. Die exportierte ZIP kann direkt hochgeladen werden und wird lokal im Browser entpackt. Alternativ lassen sich einzelne .log- oder .txt-Dateien hochladen.

Verlassen Rohlogs das Gerät, wenn der CentaurNexusAgent auswertet?

Nein. Der CentaurNexusAgent wertet die Logs auf dem Gerät aus und überträgt ausschließlich strukturierte Befunde. Roh-Auszüge bleiben auf dem Gerät.

Welche Störungsmuster erkennt die Analyse?

Unter anderem Authentifizierungs-Schleifen, gestörte Z-Tunnel-Verbindungen, DNS- und PAC-Fehler, nicht erfüllte Geräte-Posture, SSL- und Zertifikatsfehler, blockierte ZPA-Loopback-Pakete, Captive Portals und hängende ZCC-Upgrades.

Den Arbeitsablauf im Kontext ansehen

Wählen Sie im Demo-Launcher die passende Rolle. Die Demo verwendet vorbereitete Beispieldaten.

Demo-Launcher öffnen