Skip to content

Troubleshooting · 15.10

Logs and diagnosis

TLSPilot writes events to the Windows Event Viewer and to log files. The logs are also available in the Desktop Admin console under Tools → View logs & audit…, see chapter Logging, and with Get-TLSPilotLog.

Where TLSPilot writes events and logs
WhereWhat you find there
Event Viewer → Applications and Services Logs → iTrain-TLSPilot → OperationalCycle, issue, renewal, deployment, Health, license and service events.
… → iTrain-TLSPilot → AuditChanges by users, for example certificates, credentials, RBAC, settings, opened views and revealed passwords.
… → iTrain-TLSPilot → DebugDetails such as HTTP calls to the CA (1542), DNS providers (1801) and Microsoft Graph (1802).
Event Viewer → Windows Logs → Application and SystemStart failures of the services as reported by Windows, for example from the sources Service Control Manager, .NET Runtime or Application Error. The details are in service-<date>.log or webservice-<date>.log.
%ProgramData%\iTrain\TLSPilot\logs\service-<date>.logLog of the management service, kept for 30 days.
…\logs\webservice-<date>.logLog of the WebUI service.
…\logs\issue-diagnostic.logDetails of internal errors while issuing.
Event IDs of TLSPilot
Event IDsArea
1100–1106Daily cycle: trigger, start, complete, failed, per certificate, skipped
1200–1232Certificates: create, issue, renew, fail (1213), Force renew, revoke, renewal window, rollback, export, CA emergency (1221), move to tenant (1232)
1300–1322Deployments and Health: start, ok, fail (1302), dry run, warning (1305), Health ok (1321) and fail (1322)
1400–1422Credentials and external credential stores
1500–1570RBAC, configuration, backup, license (1530–1538), ACME account, alerts, tenants, Entra test
1600–1603Private CA: generate, renew, decommission, restore
1700–1716Opened views (Audit)
1800–1802Scheduler and HTTP calls (Debug)
1900–1990Services, Event Log registration (1910), API errors (1990)
1000–1002, 2000–2002, 3000–3002Other events in the channels Audit, Operational and Debug
Troubleshooting: logs and diagnosis
SymptomCauseSolution
Event 1910: Event Log registration failed or channels are not published.The channels iTrain-TLSPilot/* are not registered.Run Register-TLSPilotEventLogs.cmd from the installation folder (for example C:\Program Files\iTrain\TLSPilot\Tools) as administrator, or repair the installation with Setup.exe.
Log: Event log manifest missing (<file>). Reinstall with Setup.exe so channels can be created.The manifest of the event channels is missing.Repair the installation with Setup.exe.