Konfigurationsprotokollierung

Last published : Nov 03, 2026
Hinweis:
Konfigurationsprotokolleinträge werden nur auf Englisch angezeigt, unabhängig davon, welche Sprache Sie für Ihr Citrix Cloud-Konto auswählen. Datums- und Zeitangaben, die mit diesen Einträgen verknüpft sind, haben das Format MM/TT/JJ und werden in koordinierter Weltzeit (UTC) ausgedrückt.
Die Konfigurationsprotokollierung ist eine Funktion, die Konfigurationsänderungen und administrative Aktivitäten von Citrix Virtual Apps and Desktops™- und Citrix DaaS-Bereitstellungen (ehemals Citrix Virtual Apps and Desktops Service) in einer Protokollierungsdatenbank in Citrix Cloud erfasst. Sie können die protokollierten Inhalte verwenden, um:
  • Probleme nach Konfigurationsänderungen zu diagnostizieren und zu beheben. Das Protokoll bietet eine Nachverfolgung der Schritte.
  • Das Änderungsmanagement zu unterstützen und Konfigurationen zu verfolgen.
  • Administrative Aktivitäten zu melden.
In diesem Citrix DaaS™ ist die Konfigurationsprotokollierung immer aktiviert. Sie können sie nicht deaktivieren.
Über Studio können Sie Konfigurationsprotokollinhalte anzeigen, gefiltert nach Datumsbereichen oder nach Volltextsuche. Sie können auch einen CSV-Bericht mit PowerShell generieren. Über diese Konsole können Sie Protokollinhalte nicht bearbeiten oder löschen. Sie können das Remote PowerShell SDK verwenden, um die regelmäßige Datenlöschung aus dem Protokoll zu planen.
Related information
Verwalten

Aufbewahrung von DaaS-Konfigurationsprotokollen aktualisieren

Um die Leistung von DaaS-Mandanten aufrechtzuerhalten, wird die Aufbewahrungsdauer für Konfigurationsprotokolle ab dem 9. September 2024 auf 180 Tage festgelegt.
Protokolle, die am 9. September 2024 älter als 180 Tage sind, werden gelöscht. Da wir unsere DaaS-Grenzwerte für einen einzelnen DaaS-Mandanten ständig erweitern, gewährleistet diese Implementierung die beste Leistung und Ausfallsicherheit für unsere Kunden.
Als Best Practice empfehlen wir Kunden, einen vierteljährlichen Exportmechanismus zu implementieren. Dies kann über PowerShell erfolgen, siehe Berichte generieren. Wir empfehlen Kunden außerdem, die regelmäßige Datenlöschung zu planen, siehe Regelmäßige Datenlöschung planen.
Erforderliche Berechtigungen (siehe Delegierte Administration):
  • Vollständige Administratoren in Citrix Cloud™ sowie Citrix DaaS Cloud-Administratoren und schreibgeschützte Administratoren können Konfigurationsprotokolle in Studio anzeigen.
  • Vollständige Administratoren und Cloud-Administratoren können auch einen CSV-Bericht der Protokollierungsaktivitäten mithilfe von PowerShell herunterladen.

Was wird protokolliert?

Die folgenden Vorgänge werden protokolliert:
  • Konfigurationsänderungen und administrative Aktivitäten, die über den Abschnitt Verwalten und den Knoten Überwachen initiiert wurden
  • PowerShell-Skripts
  • REST-API-Anfragen
Hinweis:
Sie können keine Protokolleinträge für interne Vorgänge der Citrix Cloud-Plattform sehen, wie z. B. Datenbankeinrichtung und -verwaltung.
Beispiele für protokollierte Konfigurationsänderungen sind die Arbeit mit (Erstellen, Bearbeiten, Löschen, Zuweisen von):
  • Maschinenkatalogen
  • Bereitstellungsgruppen (einschließlich Ändern der Energieverwaltungseinstellungen)
  • Administratorrollen und -bereichen
  • Hostressourcen und -verbindungen
  • Citrix®-Richtlinien über Studio
Beispiele für protokollierte administrative Änderungen sind:
  • Energieverwaltung einer virtuellen Maschine oder eines Benutzerdesktops
  • Funktionen verwalten oder überwachen, die eine Nachricht an einen Benutzer senden
Die folgenden Vorgänge werden nicht protokolliert. (Viele davon stehen Kundenadministratoren nicht zur Verfügung.)
  • Automatische Vorgänge wie z. B. das Einschalten virtueller Maschinen durch die Poolverwaltung.
  • Richtlinienaktionen, die über die Gruppenrichtlinien-Verwaltungskonsole (GPMC) implementiert werden. Verwenden Sie Microsoft-Tools, um Protokolle dieser Aktionen anzuzeigen.
  • Änderungen, die über die Registrierung oder aus anderen Quellen als Studio, Monitor oder PowerShell vorgenommen wurden.

Konfigurationsprotokollinhalt anzeigen

Um den Konfigurationsprotokollinhalt anzuzeigen, führen Sie die folgenden Schritte aus:
  1. Melden Sie sich bei Citrix Cloud an.
  2. Klicken Sie in der Kachel DaaS auf Verwalten.
  3. Wählen Sie im linken Bereich Protokollierung aus und klicken Sie auf die Registerkarte Ereignisse.
Standardmäßig werden Ereignisprotokolle nach Administratorennamen aufgelistet. Sie können bei Bedarf die folgenden Aufgaben ausführen:
  • Anzeige sortieren. Sortieren Sie die Anzeige, indem Sie auf eine Spaltenüberschrift klicken.
  • Protokolle filtern. Verfeinern Sie die Anzeige, indem Sie Filter festlegen, z. B.:
    • Tagesintervalle oder benutzerdefinierte Zeiträume.
    • Vollständige oder teilweise Namen von Hauptaufgaben.
    • Details zu Low-Level-Vorgängen, z. B. Maschinenname und VDI-Name. Um Low-Level-Details zu durchsuchen, wählen Sie Suchbereich erweitern, um Details einzuschließen, bevor Sie Ihren Suchbegriff eingeben.
      Hinweis:
      • Das Aktivieren dieser Option kann die Suchzeit verlängern, da das System einen breiteren Satz von Protokolleinträgen durchsucht.
      • Die Auswahl wird nur für die aktuelle Web Studio-Sitzung gespeichert. Wenn Sie sich abmelden oder eine neue Sitzung starten, wählen Sie die Option erneut aus, wenn Sie Low-Level-Vorgangsdetails in die Suche einbeziehen möchten.
  • Protokolle exportieren. Ausgewählte oder alle Protokolle zur Archivierung oder weiteren Analyse in eine CSV-Datei exportieren.
  • Spalten anpassen. Passen Sie die Anzeige an Ihre Bedürfnisse an, indem Sie nicht standardmäßige Spalten wie Client-IP und Bezeichnungen hinzufügen.
  • Bezeichnungen verwalten. Fügen Sie Bezeichnungen für Ereignisprotokolle hinzu, bearbeiten und entfernen Sie sie, um die Protokollorganisation und -verfolgung zu verbessern.
Anzeigemerkmale:
  • High-Level-Vorgänge, die während der Verwaltung und Überwachung erstellt wurden, werden im oberen mittleren Bereich aufgelistet. Ein High-Level-Vorgang führt zu einem oder mehreren Diensten und PowerShell SDK-Aufrufen, die Low-Level-Vorgänge sind. Wenn Sie einen High-Level-Vorgang im oberen mittleren Bereich auswählen, zeigt der untere Bereich die Low-Level-Vorgänge an.
  • Wenn Sie einen Low-Level-Vorgang in PowerShell erstellen, ohne einen übergeordneten High-Level-Vorgang anzugeben, erstellt die Konfigurationsprotokollierung einen Ersatz-High-Level-Vorgang.
  • Wenn ein Vorgang vor dem Abschluss fehlschlägt, wird der Protokollvorgang möglicherweise nicht in der Datenbank abgeschlossen. Beispielsweise hat ein Startdatensatz keinen entsprechenden Stoppdatensatz. In solchen Fällen zeigt das Protokoll an, dass Informationen fehlen. Wenn Sie Protokolle basierend auf Zeitbereichen anzeigen, werden unvollständige Protokolle angezeigt, wenn die Daten in den Protokollen den Kriterien entsprechen. Wenn Sie beispielsweise Protokolle für die letzten fünf Tage anfordern und ein Protokoll mit einer Startzeit in den letzten fünf Tagen keine Endzeit hat, wird es eingeschlossen.
  • Denken Sie daran: Sie können keine Protokolleinträge für interne Vorgänge der Citrix Cloud-Plattform sehen, wie z. B. Datenbankeinrichtung und -verwaltung.

Aufgaben im Zusammenhang mit Maschinenkatalogvorgängen anzeigen

Um Aufgaben im Zusammenhang mit Maschinenkatalogvorgängen anzuzeigen, navigieren Sie zu Protokollierung > Aufgaben. Die Registerkarte Aufgaben zeigt nur Aufgaben an, die sich auf Kataloge beziehen, die über Machine Creation Services™ (MCS) oder Provisioning Services (PVS) erstellt wurden. Insbesondere werden Aufgaben angezeigt, die mit den folgenden Maschinenkatalogvorgängen verbunden sind:
  • Kataloge erstellen
  • Kataloge klonen
  • Maschinen hinzufügen
  • Maschinen entfernen
  • Katalog aktualisieren (Images oder Maschinen aktualisieren)
  • Maschinenaktualisierungen rückgängig machen
Tipp:
Die Registerkarte Aufgaben zeigt nur Aufgaben an, die sich auf Änderungen des Bereitstellungsschemas beziehen (Erstellen oder Ändern eines Bereitstellungsschemas).
Eine Aufgabe kann sich in folgendem Zustand befinden:
  • Abgeschlossen
  • Nicht gestartet
  • Wird ausgeführt
  • Abgebrochen
  • Fehlgeschlagen
  • Unbekannt
Um eine laufende Aufgabe abzubrechen, wählen Sie die Aufgabe aus und klicken Sie dann auf Abbrechen. Der Abbruch dauert einige Zeit.
Beispiele für protokollierte Aufgaben sind:
  • Image-Update für einen bestimmten Katalog abgeschlossen
  • Fehler beim Aktualisieren des Images für einen bestimmten Katalog
  • Abgebrochenes Image-Update für einen bestimmten Katalog
  • Bereitstellen von VMs für einen bestimmten Katalog
  • Entfernen von VMs aus einem bestimmten Katalog
  • Einen bestimmten Katalog erstellt
Standardmäßig werden in der mittleren Spalte die protokollierten Aufgaben chronologisch (neueste Einträge zuerst), nach Datum getrennt, angezeigt. Sie können die Anzeige nach Spaltenüberschrift sortieren. Um abgeschlossene Aufgaben zu löschen, klicken Sie auf der Registerkarte Aufgaben auf Abgeschlossene Aufgaben löschen. Um auszuwählen, welche Spalten in der Anzeige erscheinen sollen, wählen Sie das Symbol Anzuzeigende Spalten in der oberen rechten Ecke der Tabelle aus.

API-Protokolle anzeigen

Um REST-API-Protokolle anzuzeigen, navigieren Sie zu Protokollierung > APIs. Die Registerkarte APIs zeigt REST-API-Anfragen an, die während eines bestimmten Zeitraums gestellt wurden.
Beachten Sie die folgenden Punkte:
  • REST-API-Protokolle werden gelöscht, nachdem Sie sich von der Konsole abgemeldet haben. (Sie werden auch gelöscht, wenn Sie Ihr Browserfenster aktualisieren.)
  • Alle Vorgänge in der Konsole, die zu API-Aufrufen führen, zeigen ihre entsprechenden API-Anfragen auf der Registerkarte APIs an.
  • Die Anzeige listet die API-Anfragen chronologisch (neueste Einträge zuerst), nach Datum getrennt, auf. Die maximale Anzahl von API-Anfragen in der Anzeige beträgt 1.000.

PowerShell-Protokolle anzeigen

Um PowerShell-Befehle anzuzeigen, die den von Ihnen im Laufe des Tages ausgeführten UI-Aktionen entsprechen, navigieren Sie zur Registerkarte Logging > PowerShell.

Metadaten mit Konfigurationsprotokollen verknüpfen

Sie können Metadaten an Konfigurationsprotokolle anhängen, indem Sie ein name-value-Paar namens MetadataMap mit den Protokolldatensätzen verknüpfen.
Hinweis:
  • Sie können Metadaten nur an übergeordnete Vorgangsobjekte anhängen.
  • Metadaten werden zum Zeitpunkt der Ausführung mit den vorhandenen Datensätzen verknüpft.

Metadaten festlegen

Führen Sie den PowerShell-Befehl Set-LogHighLevelOperationMetadata aus, um einen Protokolldatensatz mit dem MetadataMap zu verknüpfen. Set-LogHighLevelOperationMetadata akzeptiert die folgenden Parameter:
  • Id: ID des übergeordneten Vorgangs.
  • InputObject: Die übergeordneten Vorgänge, denen Sie die Metadaten hinzufügen. Dies ist eine Alternative zum Id-Parameter, bei dem ein übergeordnetes Vorgangsobjekt oder eine Liste von Objekten an den PowerShell-Befehl übergeben wird.
  • Name: Eigenschaftsname der hinzuzufügenden Metadaten. Die Eigenschaft muss für den angegebenen übergeordneten Vorgang eindeutig sein. Die Eigenschaft darf keines der folgenden Zeichen enthalten: ()\/;:#.*?=<>|[]"'
  • Value: Wert für die Eigenschaft.
  • Map: Wörterbuch von (name, value)-Paaren für die Eigenschaften. Dies ist eine Alternative zum Festlegen der Metadaten mithilfe der Parameter -Name und -Value.
Um beispielsweise die Metadaten an alle übergeordneten Protokolldatensätze mit der Id 40 anzuhängen, führen Sie den folgenden PowerShell-Befehl aus:
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
Um die Metadaten an den übergeordneten Datensatz mit dem Benutzer abc@example.com anzuhängen, führen Sie den folgenden PowerShell-Befehl aus:
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D

Abrufen mithilfe der Metadaten

Führen Sie die folgenden PowerShell-Befehle aus, um die zugehörigen Metadaten zum Abrufen der Protokolldatensätze zu verwenden:
  • Suche nach Schlüssel und Wert:
    Get-LogHighLevelOperation -Metadata "Key:Value"
  • Suche nach Wert und beliebigem Schlüssel:
    Get-LogHighLevelOperation -Metadata "*:Value"
  • Suche nach Schlüssel und beliebigem Wert:
    Get-LogHighLevelOperation -Metadata "Key:*"

Metadaten entfernen

Führen Sie den PowerShell-Befehl Remove-LogHighLevelOperationMetadata aus, um die zugehörigen Metadaten zu entfernen. Remove-LogHighLevelOperationMetadata akzeptiert die folgenden Parameter:
  • Id: ID des übergeordneten Vorgangs.
  • InputObject: Die übergeordneten Vorgänge, denen Sie die Metadaten hinzufügen. Dies ist eine Alternative zum `Id``-Parameter, bei der ein übergeordnetes Vorgangsobjekt oder eine Liste von Objekten an den PowerShell-Befehl übergeben wird.
  • Name: Eigenschaftsname der zu entfernenden Metadaten. Auf $null setzen, um alle Metadaten für das angegebene Objekt zu entfernen.
  • Map: Wörterbuch von (Name, Wert)-Paaren für die Eigenschaften. Dies kann entweder eine Hashtabelle (erstellt mit @{"name1" = "val1"; "name2" = "val2"}) oder ein String-Wörterbuch (erstellt mit new-object "System.Collections.Generic.Dictionary") sein. Die Eigenschaften, deren Namen mit den Schlüsseln in der Map übereinstimmen, werden entfernt.

Berichte generieren

Um einen CSV- oder HTML-Bericht mit Konfigurationsprotokolldaten zu generieren, verwenden Sie PowerShell-Cmdlets für den ConfigLogging Service im Citrix Virtual Apps and Desktops Remote PowerShell SDK. Weitere Informationen finden Sie unter:
  • Export-LogReportCsv
  • Export-LogReportHtml

Regelmäßiges Löschen von Daten planen

Verwenden Sie das Remote PowerShell SDK, um festzulegen, wie lange Daten in der Konfigurationsprotokollierungsdatenbank aufbewahrt werden. (Diese Funktion ist in Studio nicht verfügbar.) In Citrix DaaS müssen Sie über Vollzugriff verfügen.
Im Set-LogSite-Cmdlet gibt der Parameter -LoggingDBPurgeDurationDays an, wie viele Tage Daten in der Konfigurationsprotokollierungsdatenbank aufbewahrt werden, bevor sie automatisch gelöscht werden.
  • Standardmäßig ist der Wert dieses Parameters 0. Ein Wert von Null bedeutet, dass Daten in der Konfigurationsprotokollierungsdatenbank niemals automatisch gelöscht werden.
  • Wenn Sie einen Wert ungleich Null festlegen, wird die Datenbank alle 120 Minuten überprüft. Daten, die älter als der Aufbewahrungszeitraum sind, werden gelöscht.
Verwenden Sie Get-LogSite, um den aktuellen Wert des Parameters anzuzeigen.

Unterschiede zu lokalen Citrix Virtual Apps and Desktops

Wenn Sie mit der Konfigurationsprotokollierung im lokalen Virtual Apps and Desktops-Produkt vertraut sind, weist die Citrix Cloud-Version mehrere Unterschiede auf. In Citrix Cloud:
  • Die Konfigurationsprotokollierung ist immer aktiviert. Sie können sie nicht deaktivieren. Eine obligatorische Protokollierung ist nicht verfügbar.
  • Sie können den Speicherort der Konfigurationsprotokollierungsdatenbank nicht ändern, da die Datenbank in der Citrix Cloud-Plattform verwaltet wird.
  • Konfigurationsprotokollanzeigen enthalten keine Vorgänge und Aktivitäten, die innerhalb der Citrix Cloud-Plattform ausgeführt werden.
  • PowerShell ist Ihre einzige Möglichkeit, einen CSV- oder HTML-Bericht über protokollierte Vorgänge zu erstellen. Im lokalen Produkt können Berichte aus Citrix Studio oder PowerShell generiert werden.
  • Sie können den Inhalt des Konfigurationsprotokolls nicht löschen.