Produktdokumentation
Citrix DaaS™
PDF anzeigen

Konfigurationsprotokollierung

April 6, 2026
Beitrag von: 
C C

Hinweis:

Konfigurationsprotokolleinträge werden nur auf Englisch angezeigt, unabhängig davon, welche Sprache Sie für Ihr Citrix Cloud-Konto auswählen. Die mit diesen Einträgen verknüpften Datums- und Zeitangaben sind im Format MM/TT/JJ angegeben und werden in koordinierter Weltzeit (UTC) ausgedrückt.

  • 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 Änderungen.
  • 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 den Inhalt des Konfigurationsprotokolls anzeigen, gefiltert nach Datumsbereichen oder mittels Volltextsuche. Sie können auch einen CSV-Bericht mit PowerShell generieren. Über diese Konsole können Sie den Protokollinhalt weder bearbeiten noch löschen. Sie können das Remote PowerShell SDK verwenden, um die regelmäßige Datenlöschung aus dem Protokoll zu planen.

Aktualisieren der Aufbewahrungsdauer von DaaS-Konfigurationsprotokollen

Um die Leistung von DaaS-Mandanten aufrechtzuerhalten, wird die Aufbewahrungsdauer von Konfigurationsprotokollen 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 mit PowerShell herunterladen.

Was protokolliert wird

Die folgenden Vorgänge werden protokolliert:

  • Konfigurationsänderungen und administrative Aktivitäten, die über den Abschnitt Verwalten und den Knoten Überwachen initiiert wurden
  • PowerShell-Skripte

  • 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 umfassen 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 umfassen:

  • Energieverwaltung einer virtuellen Maschine oder eines Benutzerdesktops
  • Verwaltungs- oder Überwachungsfunktionen, 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 das Einschalten virtueller Maschinen durch Poolverwaltung.
  • Richtlinienaktionen, die über die Gruppenrichtlinien-Verwaltungskonsole (GPMC) implementiert wurden. 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

Führen Sie die folgenden Schritte aus, um den Konfigurationsprotokollinhalt anzuzeigen:

  1. Melden Sie sich bei Citrix Cloud an.
  2. Klicken Sie in der Kachel DaaS auf Verwalten.
    1. Wählen Sie im linken Bereich Protokollierung aus und klicken Sie auf die Registerkarte Ereignisse.

  • Standardmäßig werden Ereignisprotokolle nach Administratornamen 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 Filterbedingungen wie Tagesintervalle oder benutzerdefinierte Zeiträume festlegen oder vollständige oder teilweise Namen von Hauptaufgaben in das Suchfeld eingeben. Um nach der Suche zur Standardanzeige zurückzukehren, löschen Sie den Text im Suchfeld.
  • Protokolle exportieren. Exportieren Sie ausgewählte oder alle Protokolle in eine CSV-Datei zur Archivierung oder weiteren Analyse.
  • 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:

  • Übergeordnete Vorgänge, die während der Verwaltung und Überwachung erstellt wurden, werden im oberen mittleren Bereich aufgelistet. Ein übergeordneter Vorgang führt zu einem oder mehreren Diensten und PowerShell SDK-Aufrufen, die untergeordnete Vorgänge sind. Wenn Sie einen übergeordneten Vorgang im oberen mittleren Bereich auswählen, zeigt der untere Bereich die untergeordneten Vorgänge an.
  • Wenn Sie einen untergeordneten Vorgang in PowerShell erstellen, ohne einen übergeordneten Vorgang anzugeben, erstellt die Konfigurationsprotokollierung einen Ersatz-übergeordneten Vorgang.
  • Wenn ein Vorgang vor 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
  • Einen Katalog aktualisieren (Images oder Maschinen aktualisieren)
  • Maschinenaktualisierungen zurücksetzen

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 listet die Anzeige im mittleren Bereich protokollierte Aufgaben chronologisch (neueste Einträge zuerst), getrennt nach Datum, auf. Sie können die Anzeige nach Spaltenüberschrift sortieren. Um abgeschlossene Aufgaben zu löschen, klicken Sie unter 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 Logging > 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), getrennt nach Datum. 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-Wert-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 der 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 der 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, Wert)-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 verknüpften 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 verknüpften 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[String, String]") 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-Dienst im Citrix Virtual Apps and Desktops Remote PowerShell SDK. Weitere Informationen finden Sie unter:

Periodische Datenlöschung 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 Cmdlet Set-LogSite 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 Wahl, um einen CSV- oder HTML-Bericht der protokollierten 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.
Konfigurationsprotokollierung
April 6, 2026
Beitrag von: 
C C
April 6, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.