Logging

NodePilot schreibt Anwendungslogs über Serilog. Logging:Format bestimmt das Ausgabeformat:

Wo die Dateien liegen

Zwei Datei-Sinks, beide im selben Ordner:

Ein relativer Wert wird gegen den ContentRoot aufgelöst, ein absoluter unverändert übernommen. Die Installationsprogramme setzen beide Schlüssel auf C:\ProgramData\NodePilot\logs\; eine aus dem Quellcode gestartete Entwicklungsinstanz schreibt entsprechend nach src\NodePilot.Api\logs\.

Das Anwendungslog rollt täglich und zusätzlich bei Logging:File:FileSizeLimitBytes (Default 100 MB, Suffix _001, _002 …). Logging:File:RetainedFileCountLimit (Default 7) begrenzt die Anzahl aufbewahrter Dateien: auf einem gesprächigen System sind sieben Dateien weniger als sieben Tage.

Ausgeliefert wird Logging:Format=cmtrace, nicht der Code-Default text. Die Sektion ist nicht hot-reloadbar — ein Formatwechsel wirkt erst nach einem Neustart des Dienstes.

Welche Datei bei welchem Störungsbild weiterhilft, steht unter Logs & Diagnose.

Output-Redaction

OutputRedactor maskiert Secrets. Immer aktiv. Custom-Patterns via Logging:Redaction:Patterns; ein Pattern, das kein gültiger regulärer Ausdruck ist, verhindert den Start des Dienstes, statt übersprungen zu werden.

Support-Log & SupportEvents

Zwei Sub-Sinks aus demselben Serilog-Filter (für Operator/Ticket-Diagnose):

1. Plain-Text-File {Logging:SupportLog:Path} (Produktion: C:\ProgramData\NodePilot\logs\nodepilot-support-*.log). Logging:SupportLog:RetainedFileCountLimit (default 90) begrenzt die Anzahl aufbewahrter Dateien, nicht die Tage: bei täglichem Rollover entspricht das ~90 Tagen, aber Logging:SupportLog:FileSizeLimitBytes (default 10 MiB) rollt zusätzlich innerhalb eines Tages — auf sehr gesprächigen Systemen deckt das Limit entsprechend weniger Tage ab.
2. DB-Tabelle SupportEvents für den Web-Viewer (Filter/Cursor/Export) — Toggle Logging:SupportLog:DbProjectionEnabled (default true). Geschrieben via gepuffertem SupportEventFlushService, getrimmt durch SupportEventRetentionService (90 d).

Endpoints: GET /api/diagnostics/support-log|support-log/download|support-events|support-events/export (Admin). UI: eigene Hauptmenü-Seite /support-log (Admin-only, im Sidebar unter „Alerting").

Server-Protokoll (Anwendungslog) in der Oberfläche

Dieselbe Seite zeigt über den Umschalter Server-Protokoll (/support-log?source=server) das Anwendungslog nodepilot-YYYYMMDD.log: Fehler, Warnungen und Startmeldungen von NodePilot selbst. Die Ansicht Probleme fasst gleiche Ursachen zu einer Karte mit Zähler zusammen, Verlauf listet jeden Eintrag mit Filter nach Schweregrad, Bereich und Text. Das gilt, solange die API antwortet; Startfehler früherer Starts stehen dort, sobald der Dienst wieder läuft. Antwortet die API nicht, bleibt der Dateizugriff (siehe Logs & Diagnose).

Der Server liest die Dateien neueste zuerst mit einem Budget von 8 MiB und meldet in jeder Antwort, wie viel des Zeitraums er gesehen hat. „Keine Probleme" erscheint nur bei vollständig gelesenem Zeitraum; sonst steht dort „im gelesenen Ausschnitt (seit …)", weil die Dateiaufbewahrung (7 Dateien) oder das Budget ältere Einträge ausschließen können. Gelesen werden alle vier Formate (cmtrace, text, json, ecs-json). cmtrace faltet beim Schreiben Error mit Fatal und Info mit Debug zusammen, flacht Zeilenumbrüche ab und kürzt Meldungen auf 3800 Zeichen — „Kritisch" und vollständige Stacktraces lassen sich daraus nicht rekonstruieren. Die Zeit des Textformats hat keinen Offset und wird in der Zeitzone des Servers gelesen.

Endpoints (Admin): GET /api/diagnostics/app-log (hours 1–168, minLevel, q, take ≤ 1000; minLevel und q filtern vor take, summary zählt immer über das ganze gelesene Fenster) und GET /api/diagnostics/app-log/download?date=yyyy-MM-dd. Der Download ist ein zusammengeführter, redigierter Tagesexport nodepilot-app-<Datum>.redacted.log (alle Segmente des Tages), kein unveränderter Dateiabzug, und wird als APP_LOG_DOWNLOADED im Audit-Log vermerkt. Die Ausgaberedaktion arbeitet zeilenweise; mehrzeilige PEM-Blöcke werden zustandsbehaftet entfernt, unbekannte Secret-Muster bleiben möglich.

Security-Headers (Non-Dev)

HSTS, CSP, X-Frame-Options=DENY, nosniff, Referrer-Policy.

SignalR-Auth

httpOnly np_auth-Cookie beim WebSocket-Upgrade (nur /hubs/); kein ?access_token=-Querystring.