Fehlerbehebung

HTML5-Protokolle

Die Citrix Workspace-App für HTML5 stellt Zeitstempel für die vom Benutzergerät generierten Protokolle bereit.

Hinweis:

• Um die Fehlerbehebung zu unterstützen, können Sie die Sitzungsprotokolle der Citrix Workspace-App für HTML5 anzeigen.

Die Protokollseite ermöglicht Benutzern Folgendes:

• Protokollierung aktivieren: Aktivieren Sie die Protokollierung, um die HTML5-Protokolle anzuzeigen.
• Protokollierung deaktivieren: Deaktivieren Sie die Protokollierung, um die Protokollierung in einer Sitzung zu beenden.
• Protokolle anzeigen: Zeigen Sie die für eine Sitzung generierten Protokolle an.
• Protokolle löschen: Löschen Sie die in einer Sitzung generierte Protokolldatei.
• Protokolldatei herunterladen: Laden Sie die Protokolldatei an einen gewünschten Speicherort herunter.

Die Citrix Workspace-App unterstützt die Protokollsammlung für laufende virtuelle Desktop- und App-Sitzungen. Zuvor wurden Protokolle nur für Sitzungen gesammelt, die nach der Auswahl von Protokollierung starten während einer laufenden Sitzung gestartet wurden. Jetzt werden die Protokolle für die laufende und die nächsten Sitzungen gesammelt, bis Sie Protokollierung beenden auswählen.

Verbesserung der Fehlerbehebung für mobile Geräte

Sie können schnell auf die Sitzungsprotokolldatei zugreifen, indem Sie auf die Option Protokolle abrufen tippen. Die Protokollierungsoption wurde von Protokollierung in Protokolle abrufen umbenannt. Wenn Sie Protokolle abrufen aus dem Sekundärmenü auswählen, wird die Protokolldatei auf Ihr Gerät heruntergeladen, anstatt in einem neuen Browser-Tab geöffnet zu werden.

Hinweis:

Sie können Protokolle für die aktuelle Sitzung und maximal die fünf vorherigen Sitzungen sammeln.

So sammeln Sie Protokolle

Gehen Sie wie folgt vor, um Clientprotokolle der Citrix Workspace-App für HTML5 zu sammeln:

1. Melden Sie sich bei der Citrix Workspace-App für HTML5 an.

2. Greifen Sie wie folgt auf die Seite “Protokolldateien” zu:
   • Öffnen Sie für Citrix Workspace-App-Versionen 1908 und höher eine neue Registerkarte und navigieren Sie zu siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, wobei siteurl die URL der Workspace für Web-Site ist, z. B. https://server.domain/Citrix/StoreWeb.
   • Öffnen Sie für Citrix Workspace-App-Versionen 1907 und früher eine neue Registerkarte und navigieren Sie zu siteurl/Clients/HTML5Client/src/ViewLog.html, wobei siteurl die URL der Citrix Workspace für Web-Site ist, z. B. https://server.domain/Citrix/StoreWeb.

3. Klicken Sie auf der Seite Protokolldateien auf Protokollierung starten.

   

   Die Protokollierung ist für den nächsten Sitzungsstart aktiviert, nicht für die aktuelle aktive Sitzung (falls vorhanden).

4. Melden Sie sich bei der Citrix Workspace-App an, starten Sie Ihre virtuelle App-Sitzung und reproduzieren Sie das Problem, um Protokolle zu sammeln. Arbeiten Sie weiter an der Sitzung, um das Problem zu reproduzieren.

5. Schließen Sie die Sitzung, sobald das Problem reproduziert wurde.

6. Die für die Citrix Workspace-App für HTML5-Sitzung generierten Protokolldateien werden auf der Protokollierungsseite angezeigt.

   

7. Klicken Sie auf die Pfeilschaltfläche, um die Protokolldatei herunterzuladen und zu speichern.

   

Hinweis:

• Um die Protokolle der Citrix Workspace-App für HTML5 zu aktivieren und anzuzeigen, können Sie die Option Protokollierung aus dem Sitzungssymbolleistenmenü verwenden.

So erfassen Sie Konsolenprotokolle

Um Konsolenprotokolle der Citrix Workspace-App für HTML5 zu erfassen, gehen Sie wie folgt vor:

1. Öffnen Sie die Entwicklertools auf der Browserregisterkarte, auf der die Sitzung ausgeführt wird. Zum Beispiel finden Sie im Google Chrome-Browser die Entwicklertools unter der Option Weitere Tools.

   

2. Klicken Sie im geöffneten Entwicklertool auf Konsole.

3. Klicken Sie mit der rechten Maustaste und wählen Sie die Option Speichern unter, um alle Protokolle zu speichern.

   

So erfassen Sie USB-Umleitungs-Protokolle

Um die Protokollierung zu aktivieren und Protokolle für Probleme im Zusammenhang mit der USB-Umleitung zu erfassen, gehen Sie wie folgt vor:

Protokolle aktivieren

1. Bearbeiten Sie die Datei configuration.js und navigieren Sie zum Abschnitt HTML5_CONFIG.

2. Fügen Sie den Wert moreLogs{‘usb’: true} hinzu. Diese Einstellung ist für StoreFront relevant. Die configuration.js-Datei befindet sich unter C:\program Files\Citrix <actual path>\HTML5Client.

Protokolle erfassen

Informationen zum Sammeln von Protokollen finden Sie unter So erfassen Sie Protokolle.

Geräteprotokolle

Um Geräteprotokolle zu sammeln, öffnen Sie einen neuen Tab im Google Chrome-Browser und geben Sie chrome://device-log ein und teilen Sie die Protokolle.

So erfassen Sie Microsoft Teams-Optimierungsprotokolle

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

Um die aktuell verwendete Shim-Version zu ermitteln:

1. Öffnen Sie die Microsoft Teams-Anwendung und starten 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 jetzt im Downloads-Ordner im VDA anzeigen.

4. Öffnen Sie die Datei MSTeams_Diagnostics Log <date><time>.txt und suchen Sie nach der Shim-Version unter type_script. Zum Beispiel: „version“:{„type_script“:„1.10.0.0“}.

Erweiterte Protokollerfassung

Ab Version 2411 können Benutzer Citrix Workspace™ App-Protokolle in einer Zip-Datei herunterladen, was die Protokollabfrage und -analyse für eine bessere Fehlerbehebung und eine verbesserte Benutzererfahrung vereinfacht.

Im Folgenden sind die Vorteile der Funktion aufgeführt:

• Benutzer müssen einzelne Protokolldateien nicht mehr manuell sammeln.
• Der optimierte Prozess macht den Zugriff auf Protokolle effizienter.
• Der einfache Zugriff auf umfassende Protokolle trägt zu einem schnelleren und effektiveren Debugging bei.

Always On Tracing (AOT)

Die Citrix Workspace-App für HTML5 unterstützt jetzt Always On Tracing (AOT), ein modernes Diagnose-Framework von Citrix, das kontinuierlich relevante Protokolldaten in der 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, wodurch die Notwendigkeit entfällt, Probleme zu reproduzieren.

AOT macht Protokolle ohne Fachkenntnisse auf Ingenieursniveau leicht zugänglich und lesbar, was Self-Service-Diagnosen ermöglicht, um die Abhängigkeit vom Citrix Support zu reduzieren und die mittlere Lösungszeit zu verbessern.

Vorteile

AOT bietet Kunden einen erheblichen Mehrwert, indem es:

• Protokolldaten automatisch erfasst für Benutzersitzungen und Systemereignisse ohne manuelles Eingreifen
• Die Notwendigkeit entfällt, Probleme zu reproduzieren, da Protokolle während des normalen Betriebs kontinuierlich gesammelt werden
• Protokolle leicht zugänglich und lesbar macht ohne Fachkenntnisse auf Ingenieursniveau zu erfordern
• Self-Service-Diagnosen ermöglicht, um die Abhängigkeit vom Citrix Support zu reduzieren
• Die mittlere Lösungszeit verbessert 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.

Hinweis:

Die Citrix Workspace-App für HTML5 2603 unterstützt jetzt AOT-Protokoll-Uploads auf zentralisierte Protokollserver für lokale Setups, die ein Gateway im Pfad enthalten.

Ab der Citrix Workspace-App für HTML5 2603 können Sie die AOT-Funktion durch Hinzufügen der folgenden Konfiguration deaktivieren:

{
  "aot": {
    "enabled": false
  }
}
<!--NeedCopy-->

Voraussetzungen

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

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

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

Einschränkungen

AOT-Protokolle können nicht hochgeladen werden, wenn der Protokollserver HTTP verwendet und die Browser Mozilla Firefox und Apple Safari zum Einsatz kommen.

Konfiguration

Zur Konfiguration müssen Sie zunächst den Protokollserver installieren und konfigurieren. Detaillierte Schritte zur Installation und Konfiguration finden Sie unter Installieren und Konfigurieren des Protokollservers.

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

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

So aktivieren Sie CORS:

1. Wenn der Protokollserver ausgeführt wird, beenden 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 Protokollserver mit StartLogServer.bat (oder StartLogServer.sh unter Linux) neu.

Benutzererfahrung

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

Weitere Informationen finden Sie unter So erfassen Sie Protokolle.

Endpunkttelemetrie in Citrix Director anzeigen

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

Voraussetzungen

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

Diagnosen zum Sitzungsstart

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

Weitere Informationen finden Sie unter Diagnosen zum Sitzungsstart in der Citrix Monitor-Dokumentation.

Herunterladen von Citrix Workspace-App-Protokollen in Fehlerdialogen deaktivieren

Ab Version 2505 können Administratoren die Schaltfläche Protokoll herunterladen in allen Fehlerdialogen für App- und Desktopsitzungen in der Citrix Workspace-App für HTML5 (Cloud und On-Prem) ausblenden.

Hinweis:

Diese Funktion ist standardmäßig deaktiviert. Mit anderen Worten, der Benutzer hat die Möglichkeit, Protokolle aus dem Fehlerdialog herunterzuladen.

Weitere Informationen finden Sie unter Herunterladen von Citrix Workspace-App-Protokollen in Fehlerdialogen deaktivieren.

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

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

So sammeln Sie Protokolle:

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

2. Sammeln Sie die Netzwerk-Traces für den Abrufstatus des Microsoft Authentication Library (MSAL)-Tokens:

   i. Installieren Sie Charles oder Fiddler auf dem Endpunkt. ii. Melden Sie sich im Browser, in dem das Problem auftritt, beim Microsoft Entra ID Store an. iii. Starten Sie die Charles- oder Fiddler-App. iv. Starten Sie die Citrix Workspace-App für HTML5-Sitzung. Nachdem Sie das Problem reproduziert haben, exportieren Sie die Fiddler-Traces, indem Sie auf Datei > Speichern > Alle Sitzungen klicken. Dadurch werden die Traces heruntergeladen, die Sie mit Citrix teilen. Weitere Informationen finden Sie im folgenden Screenshot:

   

3. Sammeln Sie Citrix Diagnostic Facility (CDF)-Traces vom VDA für alle Module und die Startverfolgung. Befolgen Sie die Schritte, um einen CDF-Trace beim Systemstart zu sammeln, da SSO auch bei erfolgreicher Funktionsaushandlung von der Citrix Workspace-App fehlschlagen kann.

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 HTML5 finden Sie in der Produktdokumentation.

Wie greife ich auf technische Vorschaufunktionen zu?

Informationen zu den 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 passe ich die Symbolleiste innerhalb einer 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 sie mithilfe des Global App Configuration-Dienstes anpassen. Weitere Informationen finden Sie unter Symbolleistenanpassung in der Produktdokumentation.

Wie konfiguriere ich Chiffre-Suites für den SSL-fähigen VDA mit der Citrix Workspace-App für HTML5?

Um die Chiffre-Suites zu konfigurieren, siehe den Artikel Chiffre-Suite in der Dokumentation zur Citrix Workspace-App für HTML5.