Konfigurationsprotokollierung
Die Konfigurationsprotokollierung erfasst Standortkonfigurationsänderungen und administrative Aktivitäten in der Datenbank. Sie können die protokollierten Inhalte verwenden, um:
- Probleme nach Konfigurationsänderungen zu diagnostizieren und zu beheben; das Protokoll bietet einen Audit-Trail
- Das Änderungsmanagement zu unterstützen und Konfigurationen zu verfolgen
- Administrative Aktivitäten zu melden
Sie legen die Einstellungen für die Konfigurationsprotokollierung fest, zeigen Konfigurationsprotokolle an und generieren HTML- und CSV-Berichte aus Citrix Studio. Sie können die Anzeige der Konfigurationsprotokolle nach Datumsbereichen und nach Volltextsuchergebnissen filtern. Die obligatorische Protokollierung verhindert, wenn aktiviert, dass Konfigurationsänderungen vorgenommen werden, es sei denn, sie können protokolliert werden. Mit der entsprechenden Berechtigung können Sie Einträge aus dem Konfigurationsprotokoll löschen. Sie können die Funktion zur Konfigurationsprotokollierung nicht verwenden, um Protokollinhalte zu bearbeiten.
Die Konfigurationsprotokollierung verwendet ein PowerShell SDK und den Konfigurationsprotokollierungsdienst. Der Konfigurationsprotokollierungsdienst läuft auf jedem Controller im Standort; wenn ein Controller ausfällt, übernimmt der Dienst auf einem anderen Controller automatisch die Protokollierungsanfragen.
Standardmäßig ist die Funktion zur Konfigurationsprotokollierung aktiviert und verwendet die Datenbank, die beim Erstellen des Standorts erstellt wird (die Standortkonfigurationsdatenbank). Sie können einen anderen Speicherort für die Datenbank angeben. Die Konfigurationsprotokollierungsdatenbank unterstützt dieselben Hochverfügbarkeitsfunktionen wie die Standortkonfigurationsdatenbank.
Der Zugriff auf die Konfigurationsprotokollierung wird über die delegierte Administration mit den Berechtigungen zum Bearbeiten von Protokollierungseinstellungen und zum Anzeigen von Konfigurationsprotokollen gesteuert.
Konfigurationsprotokolle werden bei ihrer Erstellung lokalisiert. Zum Beispiel wird ein in Englisch erstelltes Protokoll in Englisch gelesen, unabhängig vom Gebietsschema des Lesers.
Was protokolliert wird
Konfigurationsänderungen und administrative Aktivitäten, die von Studio, Director und PowerShell-Skripten initiiert werden, werden protokolliert. Beispiele für protokollierte Konfigurationsänderungen sind 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 sind:
- Energieverwaltung einer virtuellen Maschine oder eines Benutzerdesktops
- Studio oder Director senden eine Nachricht an einen Benutzer
Die folgenden Vorgänge werden nicht protokolliert:
- Autonome 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, den direkten Zugriff auf die Datenbank oder aus anderen Quellen als Studio, Director oder PowerShell vorgenommen wurden.
- Wenn die Bereitstellung initialisiert wird, wird die Konfigurationsprotokollierung verfügbar, sobald die erste Instanz des Konfigurationsprotokollierungsdienstes beim Konfigurationsdienst registriert wird. Daher werden die sehr frühen Phasen der Konfiguration nicht protokolliert (z. B. wenn das Datenbankschema abgerufen und angewendet wird, wenn ein Hypervisor initialisiert wird).
Konfigurationsprotokollierung verwalten
Standardmäßig verwendet die Konfigurationsprotokollierung die Datenbank, die beim Erstellen einer Site erstellt wird (auch als Site-Konfigurationsdatenbank bezeichnet). Citrix empfiehlt aus den folgenden Gründen, einen separaten Speicherort für die Konfigurationsprotokollierungsdatenbank (und die Überwachungsdatenbank) zu verwenden:
- Die Sicherungsstrategie für die Konfigurationsprotokollierungsdatenbank unterscheidet sich wahrscheinlich von der Sicherungsstrategie für die Site-Konfigurationsdatenbank.
- Das für die Konfigurationsprotokollierung (und den Überwachungsdienst) gesammelte Datenvolumen könnte den für die Site-Konfigurationsdatenbank verfügbaren Speicherplatz negativ beeinflussen.
- Es teilt den Single Point of Failure für die drei Datenbanken auf.
Hinweis: Produkteditionen, die die Konfigurationsprotokollierung nicht unterstützen, haben keinen Protokollierungsknoten in Studio.
Konfigurationsprotokollierung und obligatorische Protokollierung aktivieren und deaktivieren
Standardmäßig ist die Konfigurationsprotokollierung aktiviert und die obligatorische Protokollierung deaktiviert.
- Wählen Sie Protokollierung im Navigationsbereich von Studio.
- Wählen Sie Einstellungen im Aktionsbereich. Das Dialogfeld Konfigurationsprotokollierung enthält Datenbankinformationen und zeigt an, ob die Konfigurationsprotokollierung und die obligatorische Protokollierung aktiviert oder deaktiviert sind.
- Wählen Sie die gewünschte Aktion aus:
Um die Konfigurationsprotokollierung zu aktivieren, wählen Sie die Optionsschaltfläche Aktivieren. Dies ist die Standardeinstellung. Wenn nicht in die Datenbank geschrieben werden kann, werden die Protokollierungsinformationen verworfen, der Vorgang wird jedoch fortgesetzt.
Um die Konfigurationsprotokollierung zu deaktivieren, wählen Sie die Optionsschaltfläche Deaktivieren. Wenn die Protokollierung zuvor aktiviert war, bleiben vorhandene Protokolle mit dem PowerShell SDK lesbar.
Um die obligatorische Protokollierung zu aktivieren, wählen Sie die Optionsschaltfläche Änderungen an der Sitekonfiguration verhindern, wenn die Datenbank nicht verfügbar ist. Es sind keine Konfigurationsänderungen oder administrativen Aktivitäten zulässig, die normalerweise protokolliert würden, es sei denn, sie können in die Konfigurationsprotokollierungsdatenbank geschrieben werden. Sie können die obligatorische Protokollierung nur aktivieren, wenn die Konfigurationsprotokollierung aktiviert ist, d. h. wenn die Optionsschaltfläche Aktivieren ausgewählt ist. Wenn der Konfigurationsprotokollierungsdienst fehlschlägt und Hochverfügbarkeit nicht verwendet wird, wird die obligatorische Protokollierung angenommen. In solchen Fällen werden Vorgänge, die normalerweise protokolliert würden, nicht ausgeführt.
Um die obligatorische Protokollierung zu deaktivieren, wählen Sie die Optionsschaltfläche Änderungen an der Sitekonfiguration zulassen, wenn die Datenbank nicht verfügbar ist. Konfigurationsänderungen und administrative Aktivitäten sind zulässig, auch wenn auf die für die Konfigurationsprotokollierung verwendete Datenbank nicht zugegriffen werden kann. Dies ist die Standardeinstellung.
Speicherort der Konfigurationsprotokollierungsdatenbank ändern
Hinweis: Sie können den Speicherort der Datenbank nicht ändern, wenn die obligatorische Protokollierung aktiviert ist, da die Speicherortänderung ein kurzes Trennintervall beinhaltet, das nicht protokolliert werden kann.
- Erstellen Sie einen Datenbankserver unter Verwendung einer unterstützten SQL Server-Version.
- Wählen Sie Protokollierung im Navigationsbereich von Studio.
- Wählen Sie Einstellungen im Aktionsbereich.
- Wählen Sie im Dialogfeld „Logging-Einstellungen“ die Option Logging-Datenbank ändern.
- Geben Sie im Dialogfeld „Logging-Datenbank ändern“ den Speicherort des Servers an, der den neuen Datenbankserver enthält. Gültige Formate sind im Artikel „Datenbanken“ aufgeführt.
- Klicken Sie auf OK, damit Studio die Datenbank erstellen kann. Klicken Sie auf OK, wenn Sie dazu aufgefordert werden, und die Datenbank wird automatisch erstellt. Studio versucht, mit den Anmeldeinformationen des aktuellen Studio-Benutzers auf die Datenbank zuzugreifen; schlägt dies fehl, werden Sie zur Eingabe der Anmeldeinformationen des Datenbankbenutzers aufgefordert. Studio lädt dann das Datenbankschema in die Datenbank hoch. (Die Anmeldeinformationen werden nur während der Datenbankerstellung beibehalten.)
- Um die Datenbank manuell zu erstellen, klicken Sie auf Datenbankskript generieren. Das generierte Skript enthält Anweisungen zur manuellen Erstellung der Datenbank. Stellen Sie sicher, dass die Datenbank leer ist und dass mindestens ein Benutzer die Berechtigung zum Zugriff auf und zur Änderung der Datenbank hat, bevor Sie das Schema hochladen.
Die Konfigurationsprotokollierungsdaten in der vorherigen Datenbank werden nicht in die neue Datenbank importiert. Protokolle können beim Abrufen nicht aus beiden Datenbanken aggregiert werden. Der erste Protokolleintrag in der neuen Konfigurationsprotokollierungsdatenbank zeigt an, dass eine Datenbankänderung stattgefunden hat, identifiziert jedoch nicht die vorherige Datenbank.
Konfigurationsprotokollinhalt anzeigen
Beim Initiieren von Konfigurationsänderungen und administrativen Aktivitäten werden die von Studio und Director erstellten übergeordneten Vorgänge im oberen mittleren Bereich in Studio angezeigt. Ein übergeordneter Vorgang führt zu einem oder mehreren Dienst- und SDK-Aufrufen, die untergeordnete Vorgänge sind. Wenn Sie einen übergeordneten Vorgang im oberen mittleren Bereich auswählen, zeigt der untere mittlere Bereich die untergeordneten Vorgänge an.
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 beispielsweise alle Protokolle der letzten fünf Tage angefordert werden und ein Protokoll mit einer Startzeit in den letzten fünf Tagen, aber ohne Endzeit existiert, wird es eingeschlossen.
Wenn Sie ein Skript verwenden, das PowerShell-Cmdlets aufruft, und Sie einen untergeordneten Vorgang erstellen, ohne einen übergeordneten Vorgang anzugeben, erstellt die Konfigurationsprotokollierung einen Ersatz-übergeordneten Vorgang.
Um den Konfigurationsprotokollinhalt anzuzeigen, wählen Sie im Navigationsbereich von Studio die Option Logging. Standardmäßig listet die Anzeige im mittleren Bereich den Protokollinhalt chronologisch (neueste Einträge zuerst), nach Datum getrennt, auf.
| Anzeige filtern nach | Diese Aktion ausführen |
|---|---|
| Suchergebnisse | Geben Sie Text in das Suchfeld oben im mittleren Bereich ein. Die gefilterte Anzeige enthält die Anzahl der Suchergebnisse. Um zur Standard-Logging-Anzeige zurückzukehren, löschen Sie den Text im Suchfeld. |
| Spaltenüberschrift | Klicken Sie auf eine Spaltenüberschrift, um die Anzeige nach diesem Feld zu sortieren. |
| Ein Datumsbereich | Wählen Sie ein Intervall aus der Dropdown-Liste neben dem Suchfeld oben im mittleren Bereich aus. |
Berichte generieren
Sie können CSV- und HTML-Berichte mit Konfigurationsprotokolldaten generieren.
- Der CSV-Bericht enthält alle Protokolldaten aus einem angegebenen Zeitintervall. Die hierarchischen Daten in der Datenbank werden in einer einzigen CSV-Tabelle zusammengeführt. Kein Aspekt der Daten hat in der Datei Vorrang. Es wird keine Formatierung verwendet und keine menschliche Lesbarkeit vorausgesetzt. Die Datei (mit dem Namen MyReport) enthält die Daten einfach in einem universell verwendbaren Format. CSV-Dateien werden häufig zur Archivierung von Daten oder als Datenquelle für ein Berichts- oder Datenbearbeitungstool wie Microsoft Excel verwendet.
- Der HTML-Bericht bietet eine menschenlesbare Form der Protokolldaten für ein angegebenes Zeitintervall. Er bietet eine strukturierte, navigierbare Ansicht zur Überprüfung von Änderungen. Ein HTML-Bericht besteht aus zwei Dateien mit den Namen Summary und Details. Summary listet übergeordnete Vorgänge auf: wann jeder Vorgang stattfand, von wem und das Ergebnis. Wenn Sie auf einen Details-Link neben jedem Vorgang klicken, gelangen Sie zu den untergeordneten Vorgängen in der Details-Datei, die zusätzliche Informationen enthält.
Um einen Konfigurationsprotokollbericht zu generieren, wählen Sie Logging im Studio-Navigationsbereich und dann Benutzerdefinierten Bericht erstellen im Aktionen-Bereich aus.
- Wählen Sie den Datumsbereich für den Bericht aus.
- Wählen Sie das Berichtsformat aus: CSV, HTML oder beides.
- Navigieren Sie zu dem Speicherort, an dem der Bericht gespeichert werden soll.
Konfigurationsprotokollinhalt löschen
Um das Konfigurationsprotokoll zu löschen, müssen Sie über bestimmte Berechtigungen für die Delegierte Administration und die SQL Server-Datenbank verfügen.
-
Delegierte Administration — Sie müssen über eine Rolle für die Delegierte Administration verfügen, die das Lesen der Bereitstellungskonfiguration ermöglicht. Die integrierte Volladministratorrolle besitzt diese Berechtigung. Eine benutzerdefinierte Rolle muss in der Kategorie „Andere Berechtigungen“ die Option „Nur Lesen“ oder „Verwalten“ ausgewählt haben.
Um eine Sicherung der Konfigurationsprotokolldaten zu erstellen, bevor diese gelöscht werden, muss die benutzerdefinierte Rolle auch in der Kategorie „Protokollierungsberechtigungen“ die Option „Nur Lesen“ oder „Verwalten“ ausgewählt haben.
-
SQL Server-Datenbank – Sie müssen über ein SQL Server-Login mit der Berechtigung zum Löschen von Datensätzen aus der Datenbank verfügen. Dies kann auf zwei Arten erfolgen:
-
Verwenden Sie ein SQL Server-Datenbank-Login mit einer sysadmin-Serverrolle, die Ihnen die Durchführung beliebiger Aktivitäten auf dem Datenbankserver ermöglicht. Alternativ ermöglichen die Serverrollen serveradmin oder setupadmin das Ausführen von Löschvorgängen.
-
Wenn Ihre Bereitstellung zusätzliche Sicherheit erfordert, verwenden Sie ein Nicht-sysadmin-Datenbank-Login, das einem Datenbankbenutzer zugeordnet ist, der die Berechtigung zum Löschen von Datensätzen aus der Datenbank besitzt.
- Erstellen Sie in SQL Server Management Studio ein SQL Server-Login mit einer anderen Serverrolle als ‘sysadmin’.
- Ordnen Sie das Login einem Benutzer in der Datenbank zu; SQL Server erstellt automatisch einen Benutzer in der Datenbank mit demselben Namen wie das Login.
- Geben Sie in der Datenbankrollenmitgliedschaft mindestens eines der Rollenmitglieder für den Datenbankbenutzer an: ConfigurationLoggingSchema_ROLE oder dbowner.
Weitere Informationen finden Sie in der Dokumentation zu SQL Server Management Studio.
-
So löschen Sie die Konfigurationsprotokolle:
- Wählen Sie im Navigationsbereich von Studio die Option Protokollierung aus.
- Wählen Sie im Aktionsbereich die Option Protokolle löschen aus.
- Sie werden gefragt, ob Sie ein Backup der Protokolle erstellen möchten, bevor diese gelöscht werden. Wenn Sie ein Backup erstellen möchten, navigieren Sie zu dem Speicherort, an dem das Backup-Archiv gespeichert werden soll. Das Backup wird als CSV-Datei erstellt.
Nachdem die Konfigurationsprotokolle gelöscht wurden, ist die Protokolllöschung die erste Aktivität, die im leeren Protokoll erfasst wird. Dieser Eintrag enthält Details darüber, wer die Protokolle wann gelöscht hat.
In diesem Artikel
- Was protokolliert wird
- Konfigurationsprotokollierung verwalten
- Konfigurationsprotokollierung und obligatorische Protokollierung aktivieren und deaktivieren
- Speicherort der Konfigurationsprotokollierungsdatenbank ändern
- Konfigurationsprotokollinhalt anzeigen
- Berichte generieren
- Konfigurationsprotokollinhalt löschen