Florian Feuerwehrmanagement
Angebot anfordern
Angebot anfordernZum Kunden-Portal

Logs exportieren

Florian schreibt laufend ein Anwendungsprotokoll (Log) in Dateien auf dem Server. Bei einer Störung kann eine Plattform-Administratorin oder ein Plattform-Administrator diese Logs zusammen mit Systeminformationen als Diagnosepaket herunterladen und dem Support schicken. Geheimnisse wie Passwörter oder Tokens werden vorher automatisch entfernt.

Diagnosepaket herunterladen

  1. Melden Sie sich mit einem Konto an, das Plattform-Administrator ist und das Recht System verwalten hat.
  2. Öffnen Sie in der Navigation Diagnose (Bereich Einstellungen).
  3. Wählen Sie den Zeitraum (letzter Tag bis letzte 30 Tage). Voreingestellt sind 7 Tage.
  4. Klicken Sie auf Diagnosepaket herunterladen. Ihr Browser speichert eine Datei florian-diagnose-JJJJMMTT-hhmmss.zip.
  5. Hängen Sie die ZIP-Datei an Ihr Support-Ticket an.

Jeder Export wird im Audit-Log als „Log-Export durchgeführt" mit Zeitraum und Dateigröße vermerkt. Es kann immer nur ein Paket gleichzeitig erstellt werden; einen zweiten gleichzeitigen Export lehnt Florian ab. Versuchen Sie es in diesem Fall nach kurzer Zeit erneut.

Hinweis: Konten, die nur Administrator einer Feuerwehr (Mandant) sind, sehen die Seite, können aber kein Paket herunterladen. Die Logs betreffen die gesamte Installation und sind deshalb Plattform-Administratoren vorbehalten. API-Schlüssel können das Paket ebenfalls nicht abrufen.

Inhalt des Pakets

Datei Inhalt
logs/florian-JJJJMMTT.log Anwendungs-Logs im gewählten Zeitraum, neueste zuerst. Insgesamt höchstens 100 MB; ist mehr vorhanden, wird gekürzt und dies im Paket vermerkt.
audit-log.csv Audit-Log des gewählten Zeitraums: Zeitpunkt, Aktion, betroffener Datensatztyp und interne IDs. Feldinhalte (z. B. Namen oder Adressen von Mitgliedern) und Anzeigenamen sind nicht enthalten, IP-Adressen werden auf das Netz gekürzt (z. B. 203.0.113.0/24).
system-info.json Florian-Version, Betriebssystem, .NET-Version, Laufzeit seit Start, Datenbankgröße, Migrationsstatus, Lizenzstatus (nur Tier und Gültigkeit) und bereinigte Konfiguration (z. B. Mail-Server, Port und TLS)
health.json Status von Mailversand, FE2-/Alamos-Anbindung (Adressbuch und Kalender) und Sicherungen
README.txt Kurze Erklärung des Pakets

Datenschutz und Schwärzung

Vor dem Export entfernt Florian automatisch:

  • Passwörter, Tokens, API-Schlüssel, Lizenzschlüssel und private Schlüssel
  • Cookies und Authorization-Header
  • Links zum Zurücksetzen von Passwörtern und andere Links mit Zugangscodes
  • IBANs

E-Mail-Adressen werden gekürzt (***@beispiel.de). Schon beim Schreiben der Log-Dateien wird dieselbe Schwärzung angewendet, sodass solche Werte auch auf dem Server nicht im Klartext in den Logs stehen.

Achtung: Das Audit-Log im Paket enthält keine Feldinhalte, beschreibt über interne IDs aber, welches Konto wann was geändert hat. Prüfen Sie vor dem Versand, ob Sie das Paket in dieser Form weitergeben dürfen, und senden Sie es nur über den Support-Kanal. Löschen Sie die ZIP-Datei auf Ihrem Rechner, wenn der Fall abgeschlossen ist.

Wo die Logs liegen

Florian legt die Log-Dateien im Unterordner logs neben der Datenbankdatei ab. Die Dateien sind nur für das Konto lesbar, unter dem Florian läuft.

Plattform Standardort
Windows logs im Installationsordner (neben florian.db)
Linux /opt/florian/logs
macOS /usr/local/florian/logs
Docker logs neben florian.db im Arbeitsverzeichnis des Containers. Damit die Logs einen Neustart überstehen, binden Sie diesen Ordner als Volume ein.

Wurde der Datenbankpfad (ConnectionStrings:Florian) geändert, liegen die Logs im Ordner logs neben der konfigurierten Datenbank. Den tatsächlichen Ort zeigt die Seite Diagnose unter „Log-Verzeichnis".

Pro Tag entsteht eine Datei florian-JJJJMMTT.log; wird eine Datei größer als 10 MB, folgt florian-JJJJMMTT-1.log usw. Florian löscht Dateien, die älter als 7 Tage sind, und hält den Ordner insgesamt unter 50 MB.

Einstellungen

Die Protokollierung lässt sich in der Konfigurationsdatei appsettings.json oder über Umgebungsvariablen anpassen. In der Regel ist das nicht nötig.

Schlüssel Standard Bedeutung
Florian:Logging:File:Enabled true Datei-Logging ein- oder ausschalten
Florian:Logging:File:Directory logs neben der Datenbank Eigener Ordner für die Log-Dateien
Florian:Logging:File:RetentionDays 7 Aufbewahrungsdauer in Tagen
Florian:Logging:File:MaxTotalBytes 52428800 (50 MB) Höchstgröße aller Log-Dateien zusammen
Florian:Logging:File:MaxFileBytes 10485760 (10 MB) Höchstgröße einer einzelnen Datei
Florian:Logging:File:MinLevel Information Niedrigste protokollierte Stufe (Debug, Information, Warning, Error)

Als Umgebungsvariable ersetzen Sie die Doppelpunkte durch zwei Unterstriche, zum Beispiel Florian__Logging__File__RetentionDays=14. Nach einer Änderung starten Sie den Florian-Dienst neu.

Siehe auch