Logging

TLSPilot schreibt seine Logs in die Windows-Ereignisanzeige und in Logdateien. Um festzulegen, was protokolliert wird, klicken Sie unten rechts in der Desktop Admin Console auf Settings… und öffnen den Tab Logging:

• Windows-Ereignisanzeige: Die Logs liegen in der Ereignisanzeige unter Applications and Services Logs im Ordner iTrain-TLSPilot, aufgeteilt in die Logs Audit, Operational und Debug. Write Audit log hält fest, wer wann was getan hat. Mit Verbose (also log views and opens) wird auch festgehalten, wenn jemand etwas nur ansieht oder einen Dialog öffnet. Verbose ist nur für die Fehlersuche gedacht und erzeugt viele Einträge; schalten Sie es danach wieder aus. Write Operational log hält Ausstellung, Erneuerung und jedes Deployment-Ziel fest.
• Logdateien: Die Dateien liegen unter %ProgramData%\iTrain\TLSPilot\logs\. Write rolling file logs schreibt die Logs des Management-Dienstes und des WebUI-Dienstes (service-*.log, webservice-*.log). Write Audit Log schreibt das Audit-Log als audit-*.jsonl, ebenfalls mit optionalem Verbose-Modus. Unter Retention (days) legen Sie fest, wie lange die *.jsonl-Dateien für Audit, Debug und Operational aufbewahrt werden, standardmässig 30 Tage, von 1 bis 365 Tagen. service-*.log und webservice-*.log werden unabhängig von diesem Wert höchstens etwa 30 Tage aufbewahrt. Erhöhen Sie den Wert nur vorübergehend, wenn Sie Informationen von weiter zurück brauchen.
• Write Debug log (Event Viewer and debug-*.jsonl): Hält deutlich mehr Details zu den Abläufen fest, sowohl in der Ereignisanzeige als auch als debug-*.jsonl. Es ist ausgeschaltet, bis Sie es aktivieren.

Um die Logs in TLSPilot zu lesen, wählen Sie Tools, View logs & audit…. Mit RBAC wird das Audit-Log nur Benutzern mit Audit-Berechtigung angezeigt. Die Aufbewahrung der Logs in der Ereignisanzeige stellen Sie in der Windows-Ereignisanzeige ein. In der Ereignisanzeige hat jeder Eintrag eine Event-ID und Details, etwa wer ein Deployment gestartet hat, für welches Zertifikat und ob es erfolgreich war.