Problembehandlung

So erfassen Sie Protokolle

Die Citrix Workspace-App für ChromeOS stellt Zeitstempel für die vom Benutzergerät generierten Protokolle bereit. Die Citrix Workspace-App unterstützt die Protokollerfassung für laufende virtuelle Desktop- und App-Sitzungen.

Als Endbenutzer können Sie Protokolle zur Unterstützung bei der Fehlerbehebung erfassen. Protokolle können sowohl auf dem Benutzergerät als auch auf den Maschinen generiert werden. Protokolle können für Desktops und Anwendungen sein.

Bisher konnten Sie Protokolle nur für Sitzungen erfassen, die nach der Auswahl von Protokollierung starten während einer laufenden Sitzung gestartet wurden. Jetzt werden die Protokolle für die laufende und spätere Sitzungen erfasst, bis Sie Protokollierung beenden auswählen.

Protokollierung auf Benutzergeräten

So aktivieren Sie die Protokollierung:

1. Starten Sie auf dem Benutzergerät die Citrix Workspace-App und navigieren Sie zur Anmeldeseite.

2. Klicken Sie auf das Einstellungen-Symbol (Zahnrad) unten rechts.

3. Wählen Sie im Dialogfeld Einstellungen die Option Protokollierung > Protokollierung starten.

   Details der erfassten Protokolldateien werden im Dialogfeld Einstellungen aufgelistet.

4. Wählen Sie Protokollierung beenden, um die Protokollerfassung auf dem Benutzergerät zu beenden.

Clientprotokolle

So erfassen Sie Clientprotokolle:

1. Klicken Sie auf das Einstellungen-Symbol (Zahnrad) unten rechts auf dem Anmeldebildschirm der Citrix Workspace-App.

   

2. Klicken Sie auf Protokollierung > Protokollierung starten, um die Protokollerfassung zu aktivieren.

   

3. Das Feld Protokollierung starten ändert sich in Protokollierung beenden. Diese Änderung zeigt an, dass die Protokollerfassung aktiviert ist.

   Schließen Sie das Dialogfeld Konto.

• 1. Melden Sie sich beim virtuellen Desktop der Citrix Workspace-App an, starten Sie Ihre virtuelle App-Sitzung und reproduzieren Sie das Problem, um Protokolle zu erfassen.

  

  Arbeiten Sie in der Sitzung weiter, um das Problem zu reproduzieren.

1. Sobald das Problem reproduziert wurde, schließen Sie die Sitzung.

2. Klicken Sie erneut auf Einstellungen, um das Dialogfeld Konto zu öffnen.

3. Wählen Sie die Registerkarte Protokollierung.

4. Das Dialogfeld Protokollierung zeigt die Liste der erfassten Protokolldateien an.

   

5. Bewegen Sie die Maus über eine der Protokolldateien. Rechts erscheint ein kleiner Pfeil.

   

6. Klicken Sie auf den Pfeil, um einige Protokolldateien herunterzuladen und zu speichern.

7. Klicken Sie auf Alle Protokolle herunterladen und teilen Sie sie mit dem Administrator oder dem Citrix® Support-Mitarbeiter.

8. Klicken Sie auf Protokollierung beenden.

Hinweis:

Im Kioskmodus können Dateien auf einem USB-Wechseldatenträger gespeichert werden.

Erweiterte Protokollerfassung

Ab Version 2411 können Benutzer Protokolle der Citrix Workspace™-App in einer ZIP-Datei herunterladen, was die Protokollabfrage und -analyse für eine bessere Fehlerbehebung und ein verbessertes Benutzererlebnis vereinfacht.

Die folgenden Vorteile bietet die Funktion:

• Benutzer müssen einzelne Protokolldateien nicht mehr manuell erfassen.
• Der optimierte Prozess macht den Zugriff auf Protokolle effizienter.
• Der einfache Zugriff auf umfassende Protokolle unterstützt ein schnelleres und effektiveres Debugging.

Endbenutzererfahrung

Klicken Sie auf dem Bildschirm Protokollierung auf Alle Protokolle herunterladen. Die App erfasst alle relevanten Protokolldateien und komprimiert sie in einem ZIP-Archiv. Die heruntergeladene Datei verwendet eine standardisierte Benennungskonvention, z. B. CWA_CHROME_LOGS_[timestamp].zip, um Klarheit und einfache Identifizierung zu gewährleisten.

Konsolenprotokolle

So erfassen Sie Konsolenprotokolle:

• 1. Öffnen Sie die Seite chrome://inspect/#apps im Google Chrome-Browser Ihrer Citrix Workspace-App.

1. Klicken Sie auf der Registerkarte Apps auf inspect für alle Citrix Workspace-bezogenen Fenster: SessionWindow.html, Main.html (und deren untergeordnete Knoten).

   

   

2. Klicken Sie für jedes geöffnete Entwicklertools-Fenster auf Console. Speichern Sie dann das gesamte Protokoll, indem Sie mit der rechten Maustaste klicken und die Option Speichern unter auswählen.

• 

• USB-Umleitungs-Protokolle

• So erfassen Sie USB-Umleitungs-Protokolle:

1. Befolgen Sie die Schritte unter Verwenden von Web.config für ChromeOS und aktivieren Sie moreLogs für USB, indem Sie:

• Den Konfigurationswert moreLogs zu chromeAppPreferences in der Datei web.config auf dem StoreFront hinzufügen:
• chromeAppPreferences ='{"moreLogs":{"usb":true}}'

1. Öffnen Sie dann einen neuen Tab im Google Chrome-Browser, geben Sie chrome://device-log ein und teilen Sie die Protokolle.

   

Dateiübertragungsprotokolle

Die Dateiübertragungsprotokolle können sowohl vom Client als auch vom Server abgerufen werden.

So rufen Sie Dateiübertragungsprotokolle vom Client ab:

1. Starten Sie einen Browser.
2. Rufen Sie die folgende URL auf, um die Protokollierung zu starten: <storefronturl>/clients/html5client/src/viewlog.html wobei <storefronturl> der FQDN oder die IP-Adresse des StoreFront-Servers ist, auf dem der Store konfiguriert ist.

Weitere Informationen zur Dateiübertragung finden Sie unter HTML5 and Chrome File Transfer Explained.

Microsoft Teams-Optimierungsprotokolle

Die Microsoft Teams-Optimierung unterstützt die neueste Shim-Bibliotheksversion 1.8.0.12.

So ermitteln Sie die aktuelle Shim-Version, die Sie verwenden:

1. Starten Sie die Microsoft Teams-Anwendung und initiieren Sie einen Anruf mit einem der Benutzer.

2. Maximieren Sie das Microsoft Teams-Fenster, nachdem der Anruf hergestellt wurde.

3. Öffnen Sie die Bildschirmtastatur innerhalb der Sitzung und klicken Sie auf die Tasten Strg + Alt + Umschalt + 1. Sie können die Protokolldateien nun im Ordner “Downloads” anzeigen.

4. Öffnen Sie die Datei MSTeams Diagnostics Log <date><time>_vdi partner.txt und suchen Sie nach der Shim-Version unter type_script. Vergleichen Sie die Shim-Version mit 1.8.0.12.

5. (Optional) Wenn die Shim-Version nicht 1.8.0.12 ist, wenden Sie sich an Ihren Administrator, um ein Upgrade auf die neueste Version durchzuführen.

• Clientprotokolle im Kioskmodus

So erfassen Sie die Protokolle im Kioskmodus:

1. Schließen Sie ein wechselbares USB-Gerät an Ihr Chromebook an.

2. Laden Sie die Protokolldatei herunter.

3. Speichern Sie die Protokolldatei auf dem angeschlossenen USB-Gerät.

   Die Protokolldatei wird auf das USB-Gerät übertragen.

Tastenkombinationen

• Die Tastenkombination Strg+ Alt + Umschalt +1 funktioniert möglicherweise nicht in optimierten Microsoft Teams innerhalb eines virtuellen Desktops. Öffnen Sie als Problemumgehung die Bildschirmtastatur und verwenden Sie die Tastenkombination. [RFHTMCRM-5441]

Endpunkt-Telemetrie in Citrix Director anzeigen

Diese Funktion verbessert die Möglichkeit für Administratoren, Endpunkt-Telemetriedaten direkt in Citrix Director anzuzeigen.

Voraussetzungen

• Citrix Workspace-App für ChromeOS 2411 und höher
• VDA-Version 2411 und höher
• Citrix Director

Sitzungsstartdiagnose

Ab Version 2502 haben wir einen verbesserten Supportprozess für Sitzungsfehler implementiert. Helpdesk-Administratoren verfügen nun über umfassende Einblicke in Fehlerpfade, wodurch sie Fehler effektiv priorisieren und die Anzahl der Supportfälle im Zusammenhang mit Sitzungsfehlern erheblich reduzieren können.

Weitere Informationen finden Sie unter Sitzungsstartdiagnose in der Citrix Monitor-Dokumentation.

Always On Tracing (AOT)

Die Citrix Workspace-App für ChromeOS unterstützt jetzt Always On Tracing (AOT), ein modernes Diagnose-Framework von Citrix, das kontinuierlich relevante Protokolldaten in der gesamten Citrix Virtual Apps and Desktops-Umgebung erfasst. Diese Funktion vereinfacht die Fehlerbehebung für IT-Administratoren und Citrix-Supportteams, indem sie Protokolldaten für Benutzersitzungen und Systemereignisse automatisch erfasst und so die Notwendigkeit entfällt, Probleme zu reproduzieren.

• AOT macht Protokolle ohne technisches Fachwissen leicht zugänglich und lesbar, was Self-Service-Diagnosen ermöglicht, die Abhängigkeit vom Citrix Support reduziert und die mittlere Reparaturzeit (Mean-Time-To-Resolution) verbessert.

Vorteile

AOT bietet Kunden einen erheblichen Mehrwert durch:

• Automatisches Erfassen von Protokolldaten für Benutzersitzungen und Systemereignisse ohne manuelles Eingreifen
• Eliminierung der Notwendigkeit, Probleme zu reproduzieren, da Protokolle während des normalen Betriebs kontinuierlich gesammelt werden
• Leicht zugängliche und lesbare Protokolle ohne technisches Fachwissen
• Ermöglichung von Self-Service-Diagnosen zur Reduzierung der Abhängigkeit vom Citrix Support
• Verbesserung der mittleren Reparaturzeit (Mean-Time-To-Resolution) für Fehlerbehebungsszenarien

Anwendungsfälle

AOT passt in den folgenden Szenarien zu Ihrer Gesamterfahrung:

• Proaktive Überwachung: Kontinuierliche Überwachung von Benutzersitzungen und Systemereignissen, um potenzielle Probleme zu identifizieren, bevor sie Benutzer beeinträchtigen
• Schnelle Fehlerbehebung: Sofortiger Zugriff auf umfassende Protokolldaten bei Auftreten von Problemen, ohne auf die Reproduktion von Protokollen warten zu müssen
• Self-Service-Support: Ermöglichen Sie IT-Administratoren, häufige Probleme mithilfe zugänglicher Protokolldaten selbstständig zu diagnostizieren und zu beheben

AOT-Protokolle auf den zentralen AOT-Protokollserver hochladen

Der AOT-Protokollserver dient als zentrales Ziel zum Sammeln und Speichern von Always On Tracing (AOT)-Protokollen von verschiedenen Citrix®-Komponenten. Er ist mithilfe der Docker-Technologie containerisiert und wird vorzugsweise unter Linux bereitgestellt, obwohl er auch Windows-Umgebungen über Docker Desktop unterstützt.

Hinweise:

• In dieser Version der Citrix Workspace-App für ChromeOS 2511 werden AOT-Protokolle nur für lokale Setups ohne Gateway im Pfad erfasst.
• In der Citrix Workspace-App für ChromeOS 2603 unterstützen AOT-Protokoll-Uploads auf zentralisierte Protokollserver sowohl lokale Setups ohne Gateway als auch lokale Setups mit Gateway im Pfad.

Konfiguration

Ab der Citrix Workspace-App für ChromeOS 2603 können Sie die AOT-Funktion durch Hinzufügen der folgenden Konfiguration deaktivieren. Für verwaltete Geräte und Benutzer können Administratoren AOT mithilfe der Google Admin Policy wie folgt deaktivieren:

1. Melden Sie sich bei der Google Admin-Richtlinie an.

2. Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Nutzereinstellungen.

   Hinweis:

   Sie können diese Konfiguration auch auf Folgendes anwenden:

   • Gerät > Chrome > Apps und Erweiterungen > Benutzer und Browser > Suchen Sie nach der Erweiterung > Richtlinie für Erweiterungen.
   • Gerät > Chrome > Apps und Erweiterungen > Kioske > Suchen Sie nach der Erweiterung > Richtlinie für Erweiterungen.
   • Gerät > Chrome > Apps und Erweiterungen > Verwaltete Gast-Sitzungen > Suchen Sie nach der Erweiterung > Richtlinie für Erweiterungen.

3. Fügen Sie die folgenden Zeichenfolgen zur Datei policy.txt unter dem Schlüssel engine_settings hinzu.

   Stellen Sie sicher, dass Sie "enabled": false unter dem Objekt aot festlegen. Es folgt ein Beispiel für JSON-Daten:

   {
   "settings": {
   "Value": {
   "settings_version": "1.0",
   "engine_settings": {
       "aot": {
           "enabled": false
               }
           }
       }
       }
   }
   <!--NeedCopy-->
   

Voraussetzungen

Diese Funktion ist nur verfügbar, wenn Sie eine Sitzung mit Folgendem öffnen:

• Citrix Virtual Apps and Desktops™ Version 2507 CU1 oder höher

• Citrix Virtual Apps and Desktops™ Version 2511 oder höher

Konfiguration

Zur Konfiguration müssen Sie zuerst den Log-Server installieren und konfigurieren. Detaillierte Installations- und Konfigurationsschritte finden Sie unter Log-Server installieren und konfigurieren.

Nach der Installation des Log-Servers generiert das System ein StartLogServer-Skript am selben Speicherort. Der Dateiname ist StartLogServer.bat unter Windows oder StartLogServer.sh unter Linux.

Um die Kommunikation zwischen der Citrix Workspace-App für ChromeOS und dem Log-Server zu ermöglichen, müssen Sie den Log-Server so konfigurieren, dass er die StoreFront FQDN-URL akzeptiert, indem Sie Cross-Origin Resource Sharing (CORS) im Log-Server aktivieren.

So aktivieren Sie CORS:

1. Wenn der Log-Server läuft, stoppen Sie ihn mit dem folgenden Befehl:

   docker stop logserver
   <!--NeedCopy-->

1. Fügen Sie die folgenden Umgebungsvariablen zu StartLogServer.bat (oder StartLogServer.sh unter Linux) hinzu, indem Sie den Parameter CORS_ORIGINS bearbeiten:

   -e CORS_ORIGINS=""
   <!--NeedCopy-->

Beispiel für eine einzelne URL:

   -e CORS_ORIGINS="https://xyz.bvt.local;"
   <!--NeedCopy-->

Beispiel für mehrere URLs:

   -e CORS_ORIGINS="url1;url2;url3"
   <!--NeedCopy-->

Verwenden Sie Semikolons (;) zur Trennung mehrerer URLs.

1. Starten Sie den Log-Server mit dem Befehl StartLogServer.bat (oder StartLogServer.sh unter Linux) neu.

Protokolle zur Fehlerbehebung bei der Entra ID Single Sign-On-Unterstützung für VDA mit Azure AD-Anmeldeinformationen

Dieser Artikel beschreibt die Protokolle, die Sie sammeln können, wenn SSO fehlschlägt und Benutzer nach dem Start der Sitzung unerwartete Anmeldeaufforderungen erhalten.

So sammeln Sie Protokolle:

1. Sammeln Sie die grundlegenden Protokolle der Citrix Workspace-App. Weitere Informationen finden Sie unter So sammeln Sie Protokolle.

2. Sammeln Sie die Netzwerk-Traces für den MSAL-Token-Abrufstatus:

   i. Öffnen Sie den Chrome-Browser und navigieren Sie zu chrome://net-export/. ii. Wählen Sie Protokollierung auf Festplatte starten und die Option Rohdaten einschließen (enthält Cookies und Anmeldeinformationen), wie im folgenden Screenshot gezeigt. Wählen Sie den Dateispeicherort aus.

   

   iii. Starten Sie eine Citrix Workspace-App für ChromeOS-Sitzung, um das Problem zu reproduzieren und die Traces zu sammeln. Wählen Sie Protokollierung beenden in chrome://net-export/.

3. Sammeln Sie Citrix Diagnostic Facility (CDF)-Traces vom VDA für alle Module und das Start-Tracing. Befolgen Sie die Schritte zum Sammeln eines CDF-Traces beim Systemstart, da SSO auch bei erfolgreicher Fähigkeitsaushandlung von der Citrix Workspace-App fehlschlagen kann.

Bekannte Einschränkungen

• Die Citrix Workspace-App für ChromeOS unterstützt SSO für den hybriden Start nicht, da ihr die In-Memory-ICA-Unterstützung fehlt.

• Wenn der Sitzungsstart länger als 30 Sekunden dauert, kann die AAD SSO-Anmeldung fehlschlagen und Benutzer zur Eingabe von Anmeldeinformationen auffordern.

Häufig gestellte Fragen

Wo finde ich die neuesten Informationen zu den neu hinzugefügten Funktionen oder Verbesserungen?

Die neuesten Informationen zur Citrix Workspace-App für ChromeOS finden Sie in der Produktdokumentation.

Wie greife ich auf technische Vorschaufunktionen zu?

Informationen zu Funktionen, die sich in der technischen Vorschau befinden, finden Sie unter Funktionen in der technischen Vorschau.

Wie gebe ich Feedback zu EAR?

Um Feedback zur EAR-Version zu geben, klicken Sie auf https://forms.gle/ef3eFFKBk7gvTi1b6.

Wie installiere ich die Citrix Workspace-App für ChromeOS aus dem Chrome Web Store?

Der Endbenutzer kann die Citrix Workspace-App für ChromeOS aus dem Chrome Web Store installieren. Weitere Informationen finden Sie unter Installation aus dem Chrome Web Store in der Produktdokumentation.

Wie passe ich die Symbolleiste innerhalb der Citrix Workspace-App-Sitzung an?

Administratoren können die Symbolleiste anpassen, indem sie auswählen, welche Optionen für Endbenutzer sichtbar sind. Administratoren können dies mithilfe des Global App Configuration-Dienstes anpassen. Weitere Informationen finden Sie unter Anpassung der Symbolleiste in der Produktdokumentation.

Wie konfiguriere ich die USB-Umleitung?

Die Citrix Workspace-App für ChromeOS unterstützt eine Vielzahl von USB-Peripheriegeräten. Mit dieser zusätzlichen Funktionalität können Sie eine Google-Richtlinie erstellen, um die PID/VID des Geräts zu identifizieren und dessen Verwendung in der Citrix Workspace-App zu ermöglichen. Diese Unterstützung erstreckt sich auch auf neue USB-Geräte. Informationen zur Konfiguration dieser Funktion finden Sie unter USB-Konfiguration in der Produktdokumentation.