Konfigurationsprotokollierung
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 verbundenen Datums- und Zeitangaben sind im 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 (ehemals Citrix Virtual Apps and Desktops Service) in einer Protokolldatenbank in Citrix Cloud erfasst. Sie können den protokollierten Inhalt verwenden, um:
- Probleme nach Konfigurationsänderungen zu diagnostizieren und zu beheben. Das Protokoll bietet eine Nachverfolgung.
- 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.
Von Studio aus können Sie den Inhalt des Konfigurationsprotokolls anzeigen, gefiltert nach Datumsbereichen oder nach Volltextsuche. Sie können auch einen CSV-Bericht mit PowerShell generieren. Über diese Konsole können Sie den Protokollinhalt nicht bearbeiten oder löschen. Sie können das Remote PowerShell SDK verwenden, um die regelmäßige Datenlöschung aus dem Protokoll zu planen.
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-(/de-de/citrix-daas/limits.html) 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 (/de-de/citrix-daas/manage-deployment/configuration-logging.html#generate-reports). Wir empfehlen Kunden auch, die regelmäßige Datenlöschung zu planen, siehe (/de-de/citrix-daas/manage-deployment/configuration-logging.html#schedule-periodic-data-deletion).
Erforderliche Berechtigungen (siehe (/de-de/citrix-daas/manage-deployment/delegated-administration.html)):
- 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ät mithilfe von PowerShell herunterladen.
Was protokolliert wird
Die folgenden Vorgänge werden protokolliert:
- Konfigurationsänderungen und administrative Aktivitäten, die im Abschnitt Verwalten und im 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):
- Maschinenkataloge
- Bereitstellungsgruppen (einschließlich der Änderung von Energieverwaltungseinstellungen)
- Administratorrollen und -bereiche
- Hostressourcen und -verbindungen
- Citrix®-Richtlinien über Studio
Beispiele für protokollierte administrative Änderungen umfassen:
- 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 das Einschalten virtueller Maschinen durch das Poolmanagement.
- 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.
Inhalt des Konfigurationsprotokolls anzeigen
Gehen Sie wie folgt vor, um den Inhalt des Konfigurationsprotokolls anzuzeigen:
- Melden Sie sich bei Citrix Cloud an.
- Klicken Sie in der Kachel DaaS auf Verwalten.
- 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 durch Festlegen von Filtern, z. B.:
- Tagesintervalle oder benutzerdefinierte Zeiträume.
- Vollständige oder teilweise Namen der 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. 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:
- 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)
- Maschinenupdates 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), nach Datum getrennt, 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.
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, haben ihre entsprechenden API-Anfragen auf der Registerkarte APIs angezeigt.
- 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, Wert)-Paaren für die Eigenschaften. Dies ist eine Alternative zum Festlegen der Metadaten mithilfe der Parameter
-Nameund-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 Zeichenfolgenwö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 Service im Citrix Virtual Apps and Desktops Remote PowerShell SDK. Weitere Informationen finden Sie unter:
Regelmäßiges Löschen von Daten planen
Verwenden Sie das Remote PowerShell SDK, um anzugeben, wie lange Daten in der Konfigurationsprotokollierungsdatenbank aufbewahrt werden. (Diese Funktion ist in Studio nicht verfügbar.) In Citrix DaaS müssen Sie über Full access 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. Mandatory logging ist nicht verfügbar.
- Sie können den Speicherort der Konfigurationsprotokollierungsdatenbank nicht ändern, da die Datenbank in der Citrix Cloud-Plattform verwaltet wird.
- Anzeigen von Konfigurationsprotokollen 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 protokollierter Vorgänge zu erstellen. Im lokalen Produkt können Berichte aus Citrix Studio oder PowerShell generiert werden.
- Sie können Konfigurationsprotokollinhalte nicht löschen.
In diesem Artikel
- Aufbewahrung von DaaS-Konfigurationsprotokollen aktualisieren
- Was protokolliert wird
- Inhalt des Konfigurationsprotokolls anzeigen
- Aufgaben im Zusammenhang mit Maschinenkatalogvorgängen anzeigen
- API-Protokolle anzeigen
- PowerShell-Protokolle anzeigen
- Metadaten mit Konfigurationsprotokollen verknüpfen
- Berichte generieren
- Regelmäßiges Löschen von Daten planen
- Unterschiede zu lokalen Citrix Virtual Apps and Desktops