Maximale Debug-Protokollierung für SWG-Modul aktivieren

Einleitung

In diesem Dokument wird beschrieben, wie die maximale Debug-Protokollierung auf dem Secure Web Gateway (SWG)-Modul für AnyConnect und Cisco Secure Client (CSC) aktiviert wird.

Anwendungsbeispiele für die Aktivierung der maximalen Debug-Protokollierung

Aktivieren Sie die maximale Debug-Protokollierung auf dem SWG-Modul, wenn Sie Probleme wie die folgenden beheben:

• Hotspot-Probleme über Captive Portal
• Liste der externen Domänenumgehungen wird nicht angewendet
• Unterbrechungsfreie DNS- oder Web-Performance-Probleme

Maximale Debug-Protokollierung auf AnyConnect 4.10 MR7, CSC 5.0 MR2 oder älteren Geräten aktivieren

Wenn Sie AnyConnect 4.10 MR7, CSC 5.0 MR2 oder eine ältere Version verwenden, gehen Sie wie folgt vor. Standardmäßig ist die maximale Debug-Protokollierung nicht aktiviert, und die Konfiguration ist über das Umbrella Dashboard oder ASA nicht möglich. Sie müssen "logLevel": "1" dem orgConfig Objekt in der SWGConfig.json Datei manuell hinzufügen. Wenn Sie die neueste Version von AnyConnect oder Cisco Secure Client verwenden, können Sie diesen Abschnitt überspringen.

Ort SWGConfig.json

• Windows (AnyConnect):
  

  C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\SWG\

• Windows (sicherer Client):
  

  C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\SWG\

• macOS (AnyConnect):
  

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (Secure Client):
  

  /opt/cisco/secureclient/umbrella/swg/

Dauerhafte Debugprotokollierung

Die geänderte SWGConfig.json Datei bleibt nur bis zur nächsten API-Synchronisierung durch das Cisco AnyConnect Umbrella-Modul erhalten. Um diese Konfiguration beizubehalten und zu verhindern, dass sie durch eine API-Synchronisierung überschrieben wird, stellen Sie eine swg_org_config.flag Datei im Ordner bereit Umbrella/data.

1. Flag-Datei erstellen

   • Erstellen Sie eine neue Datei mit dem Namen swg_org_config.flag im Ordner Umbrella Data. Die Dateierweiterung muss .flag.



   • Windows (AnyConnect):

   • C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\data\swg_org_config.flag

   • Windows (sicherer Client):

   • C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\data\swg_org_config.flag

   • macOS (AnyConnect):

   • /opt/cisco/anyconnect/umbrella/data/swg_org_config.flag

   • macOS (Secure Client):

   • /opt/cisco/secureclient/umbrella/data/swg_org_config.flag

2. Inhalte kopieren und ändern

   • Kopieren Sie den Inhalt des orgConfig Objekts aus der SWGConfig.json Datei in die swg_org_config.flag Datei.

   • Anfügen mit "logLevel": "1".

   • Beispiele:

     {
     "exceptionList": [
     "www.example.com",
     "smh.com.au",
     "*.smh.com.au",
     "www.blue.com",
     "*.www.blue.com",
     "146.112.133.72"
     // ...additional entries...
     ],
     "failOpen": 1,
     "logLevel": "1",
     "swgAnycast": "146.112.255.50",
     "swgDomain": "swg-url-proxy-https.sigproxy.qq.opendns.com",
     "swgEchoService": "http://www.msftconnecttest.com/connecttest.txt"
     }

   • Stellen Sie sicher, dass die Flagdatei mit beginnt { "exceptionList": [...] und mit "SWGEchoService": "http://www.msftconecttest.com/connecttest.txt"}endet.

   • Vermeiden Sie das Kopieren zusätzlicher Zeilen vor oder nach dem Objekt.

   • Das falsche Kopieren von Zeilen wie identity, deviceIdoder kann die SWG-FunktionadUserIDunterbrechen.
     
     

   Falsches Beispiel: Die Flagdatei enthält Schlüssel wie identity, deviceIdoder dUserID vor dem
   

   Richtiges Beispiel: Die Flagdatei beginnt mit { "exceptionList":
   14970100184724

3. Dienst neu starten

   • Starten Sie den Cisco AnyConnect Secure Mobility Agent-/Secure Client-Dienst neu, starten Sie den Computer neu, oder stellen Sie eine Verbindung mit dem VPN her, und trennen Sie die Verbindung.
     
     

4. Konfiguration überprüfen

   • Öffnen Sie nach dem Neustart oder nach dem VPN-Verbinden/Trennen die SWGConfig.json Datei, um zu bestätigen, dass die maximale Debug-Protokollstufe für die SWG festgelegt ist. Nach der Konfiguration wird dieser Eintrag in der Datei angezeigt:

     "logLevel": "1"

Überprüfen und Bereitstellen der maximalen Anzahl von Debug-Protokollen

Windows-Überprüfung

1. Öffnen Sie die Windows-Ereignisanzeige.

2. Suchen Sie nach Protokollzeilen, die diesen Beispielen ähneln. Dies zeigt an, dass die maximale Debug-Protokollierung erfolgreich aktiviert wurde.
   
   Beispiel 1:
   

   BRIDGE | Thread 1d18 | Connection : Resolved IP from 'swg-url-proxy-https.sigproxy.qq.opendns.com' is 146.112.57.199
   THREAD | Thread 1d18 | SetGUID '959bfe4d6fba87a65b433321c6748d761d9492cb'

   Beispiel 2: Alle Webanfragen, für die ein Proxy erstellt wird, werden protokolliert. Webanfragen, die die AnyConnect-SWG gemäß interner/externer Domänenliste umgehen, werden nicht protokolliert.

   LISTEN | Thread 1d18 | Connection : Hostnames from KDF are login.live.com

3. Verwenden Sie den PowerShell-Befehl, um die maximale Anzahl an Debug-Ereignisprotokollen (.evtx) in txt zu konvertieren:

   Get-WinEvent -Path C:\Desktop\Umbrella.evtx | Format-Table -AutoSize | Out-File C:\Desktop\Umbrella.txt -append -width 750

macOS-Verifizierung

Unter Mac OSX kann die Debug-Protokollierung mit diesem Befehl angezeigt werden (Sie können sie in Text schreiben oder grep).

1. Führen Sie den folgenden Befehl aus:

   >log show --predicate 'subsystem contains "com.cisco.anyconnect.swg" || senderImagePath endswith "acswgagent"' --debug --info --last 2d | grep -i purple

   • Beispielausgabe beim Durchsuchen von purple.com bei aktivierter Max Debug-Protokollierung:

     2022-09-19 10:51:15.627229+1000 0x16b121 Default 0x0 98970 0 acswgagent: Connection : Hostnames from KDF are purple.com.

2. Das AnyConnect DART-Paket enthält die maximale Anzahl an Debug-Protokollen. Stellen Sie nach der Überprüfung der Aktivierung das Problem erneut her, zeichnen Sie den Zeitstempel, die Benutzerumgebung und die fragliche Domäne auf, und stellen Sie diese Informationen zusammen mit dem zu unterstützenden DART-Paket bereit.

Zusätzliche Hinweise

• Bei der maximalen Debug-Protokollierung werden ausführliche Protokolle generiert. Konfigurieren Sie die Protokollgröße des Umbrella Roaming Security-Moduls in der Windows-Ereignisanzeige, um große Protokolle aufzunehmen, insbesondere bei zeitweiligen Problemen.
  360056784112
• Entfernen oder benennen Sie die swg_org_config.flag Datei um, um die maximale Debug-Protokollierung zu deaktivieren, wenn die Fehlerbehebung abgeschlossen ist.

Aktivieren der maximalen Debug-Protokollierung auf CSC 5.0 MR3 und AC 4.10 MR8 oder höher

Überblick

Beginnend mit CSC 5.0 MR3 und AC 4.10 MR8 nutzt die Debug-Protokollierung einen einfacheren Prozess.

Änderungen

• Kopieren Sie die SWGConfigOverride.json Datei (mit statischem Inhalt) in den SWG-Ordner, um die Debug-Protokollierung zu aktivieren.
• Das orgConfig muss nicht kopiert oder geändert werden SWGConfig.json. Der Inhalt dieser Datei ändert org nicht in org.
• Keine Abhängigkeit vom DNS-Modul bei der Durchführung einer Konfigurationssynchronisierung oder beim Lesen aus der Flagdatei. Die SWGConfig.json Datei bleibt unberührt.

Debug-Protokollierung aktivieren

Der Konfigurationswert in SWGConfigOverride.json hat Vorrang vor dem Wert (falls vorhanden) in SWGConfig.json. The SWGConfigOverride.json kann nur zwei Konfigurationen enthalten und überschreiben: logLevel (zum Aktivieren/Deaktivieren der Debug-Protokollierung) und Autotuning (zum Aktivieren/Deaktivieren der automatischen Optimierung des Sendepuffers).

1. Um die Debug-Protokollierung zu aktivieren, kopieren Sie den folgenden InhaltSWGConfigOverride.jsonmit:

   {"logLevel": "1"}

   • Verwenden Sie Folgendes, um sowohl die Debug-Protokollierung als auch die automatische Optimierung zu aktivieren:

     {"logLevel": "1", "autotuning": "1"}

2. Im SWGConfigOverride.json SWG-Ordner ablegen:
   
   

• Windows (AnyConnect):

  C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\SWG\

• Windows (sicherer Client):

  C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\SWG\

• macOS (AnyConnect):

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (Secure Client):

  /opt/cisco/secureclient/umbrella/swg/

3. Starten Sie die SWG oder den Umbrella-Service neu, oder starten Sie das System neu.

• MacOS: Beenden und starten Sie den AnyConnect- oder Secure Client-Agenten.
• Windows: Starten Sie den Secure Web Gateway-Dienst (acswgagent in 4.10.x builds /csc_swgagent in 5.x builds) über das MMC-Snap-In für Dienste neu (Start > Ausführen > Services.msc).
  
  

Anmerkung: Die ältere Methode zur Aktivierung der Debug-Protokollierung wird weiterhin unterstützt und kann weiterhin verwendet werden. Sie ist die einzige Option für Clients, die älter als 5.0 MR3 oder 4.10 MR8 sind.

Konfigurations- und Betriebshinweise

• Bei SWGConfig.json der Datei wird die Groß- und Kleinschreibung unterschieden. Verwenden Sie "logLevel": "1" mit doppelten Anführungszeichen.
• DerlogLevelWert ist eine Zeichenfolge 1, keine ganze Zahl, daher muss er "1" mit doppelten Anführungszeichen sein.
• Die swg_org_config.flag Datei muss eine .flag Erweiterung haben, nicht .txt.
• Die maximale Debug-Protokollierung generiert äußerst detaillierte Protokolle. Aktivieren Sie die maximale Debug-Protokollierung nur, wenn Sie von einem Umbrella Support-Techniker dazu aufgefordert werden.
• Dieswg_org_config.flagDatei enthält eine statische Liste umgehender Domänen und wird nicht mit externen Domänen synchronisiert, die unter Dashboard > Deployments > Domain Management (Dashboard > Bereitstellungen > Domänenmanagement) aufgeführt sind.

Zugehörige Informationen

• Technischer Support und Downloads von Cisco
• Cisco Secure Access-Hilfecenter
• Cisco SASE Designleitfaden