My Schedule - Nutzungsprotokoll: Unterschied zwischen den Versionen
Aus Asprova Hilfe
GK (Diskussion | Beiträge) (→Ereignisse) |
GK (Diskussion | Beiträge) (→Logdateien) |
||
| Zeile 26: | Zeile 26: | ||
== Logdateien == | == Logdateien == | ||
| − | Die Dateien der Nutzungsprotokolle werden im <code>\data</code> Unterverzeichnis des Serververzeichnisses (i.d.R. <code>C:\ProgramData\Asprova\Asprova My Schedule\WS</code>) abgelegt. Für jeden Tag wird eine neue Datei mit Dateinamen <code>usage-YYYY-MM-DD.log</code> angelegt. Alte Dateien werden nach Ablauf der Aufbewahrungsfrist automatisch gelöscht. | + | Die Dateien der Nutzungsprotokolle werden im <code>\data</code> Unterverzeichnis des Serververzeichnisses (i.d.R. <code>C:\ProgramData\Asprova\Asprova My Schedule\WS</code>) abgelegt. Für jeden Tag wird eine neue Datei ([https://de.wikipedia.org/wiki/JSON_streaming#Line-delimited_JSON NDJSON bzw. line-delimited JSON]) mit Dateinamen <code>usage-YYYY-MM-DD.log</code> angelegt. Alte Dateien werden nach Ablauf der Aufbewahrungsfrist automatisch gelöscht. |
Jede Zeile ist ein JSON-Objekt mit den folgenden Eigenschaften: | Jede Zeile ist ein JSON-Objekt mit den folgenden Eigenschaften: | ||
Version vom 13. April 2026, 09:13 Uhr
Achtung, dies ist derzeit eine experimentelle Funktion, deren Verhalten sich in zukünftigen Versionen ändern kann!
Asprova My Schedule bzw. Asprova WS können Benutzerereignisse wie Einloggen, Ausloggen und Datenzugriffe protokollieren. Die Protokollierung kann ggf. die Geschwindigkeit des Servers beeinträchtigen.
Konfiguration
Standardmäßig ist die Protokollierung deaktiviert. Über die config.json können Sie die Protokollierung aktivieren und steuern.
| Parameter | Standardwert | Beschreibung |
|---|---|---|
enable_usage_log |
false |
Protokollierung ein- oder ausschalten |
usage_log_retention |
"30d" |
Aufbewahrungsfrist bevor Protokolle automatisch gelöscht werden. |
Um die Protokollierung zu aktivieren, so setzen Sie in der Datei folgendes:
{
"enable_usage_log": true
}
Logdateien
Die Dateien der Nutzungsprotokolle werden im \data Unterverzeichnis des Serververzeichnisses (i.d.R. C:\ProgramData\Asprova\Asprova My Schedule\WS) abgelegt. Für jeden Tag wird eine neue Datei (NDJSON bzw. line-delimited JSON) mit Dateinamen usage-YYYY-MM-DD.log angelegt. Alte Dateien werden nach Ablauf der Aufbewahrungsfrist automatisch gelöscht.
Jede Zeile ist ein JSON-Objekt mit den folgenden Eigenschaften:
| Schlüssel | Beschreibung | |
|---|---|---|
eventType |
Ereignistyp | |
user |
Benutzer, welcher das Ereignis ausgelöst hat (falls zutreffend) | |
userId |
Benutzer-ID | |
username |
Benutzername | |
req |
Informationen zum HTTP-Request, welcher das Ereignis ausgelöst hat (falls zutreffend) | |
method |
HTTP-Methode (z.B. POST)
| |
path |
Der angefragt Pfad (z.B. /api/auth/login)
| |
ip |
IP-Adresse des Clients | |
details |
Weitere Informationen zum im Kontext des Ereignisses | |
timestamp |
Zeitstempel des Ereignisses | |
Ereignisse
Die folgenden Ereignisse werden protokolliert:
| Ereignistyp | Beschreibung | Zusätzlicher Hinweis | Details | Beschreibung der Details |
|---|---|---|---|---|
ws:server:start |
Server (bzw. Dienst) wurde gestartet | port |
Horchender Port | |
https |
HTTPS-Aktivierungsstatus | |||
ws:user:created |
Benutzer wurde hinzugefügt | ID |
ID des neuen Benutzers | |
username |
Benutzername des neuen Benutzers | |||
type |
Authentifizierungsart des neuen Benutzers | |||
roles |
Berechtigungen des neuen Benutzers | |||
ws:user:login:success |
Benutzer hat sich erfolgreich eingeloggt | Nicht zutreffend | ||
ws:user:login:failure |
Einloggen des Benutzers ist fehlgeschlagen | user wird hier nicht gesetzt |
username |
Benutzername des Einlogversuchs |
reason |
Grund des Fehlschlagens | |||
ws:user:removed |
Benutzer wurde gelöscht | user ist hier der löschende Benutzer |
ID |
ID des gelöschten Benutzers |
username |
Benutzername des gelöschten Benutzers | |||
ws:user:logout |
Benutzer hat sich ausgeloggt | Nicht zutreffend | ||
my-schedule:license:ccu:added |
Neue CCU-Verbindung wurde akzeptiert | "CCU" = Concurrent User | pool |
CCU-Pool dem Benutzer hinzugefügt wurde |
currentCount |
Anzahl gleichzeitiger Benutzer nachdem diese Verbindung akzeptiert wurde | |||
maxCount |
Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan | |||
my-schedule:license:ccu:max-reached |
Verbindung wurde verweigert, da maximal erlaubte Anzahl gleichzeitiger Benutzer bereits erreicht ist | pool |
CCU-Pool dessen maximale Anzahl erreicht wurde | |
currentCount |
Gegenwärtige Anzahl gleichzeitiger Benutzer in diesem Plan | |||
maxCount |
Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan | |||
my-schedule:license:ccu:released-with-logout |
CCU-Verbindung wurde durch Logout freigegeben | pool |
CCU-Pool aus dem Benutzer entfernt wurde | |
currentCount |
Gegenwärtige Anzahl gleichzeitiger Benutzer in diesem Plan | |||
maxCount |
Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan | |||
my-schedule:license:ccu:expired |
CCU-Verbindung wurde wegen Inaktivität freigegeben | pool |
CCU-Pool aus dem Benutzer entfernt wurde | |
currentCount |
Gegenwärtige Anzahl gleichzeitiger Benutzer in diesem Plan | |||
maxCount |
Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan | |||
my-schedule:license:maintenance-mode:entered |
Aufgrund unzureichender freier Lizenzen ist der Server in den Wartungsmodus gewechselt | Nicht zutreffend | ||
my-schedule:license:maintenance-mode:left |
Server hat Wartungsmodus verlassen | Nicht zutreffend | ||
my-schedule:view:accessed |
Benutzer hat auf eine Ansicht zugegriffen | Ereignis wird dedupliziert (d.h. innerhalb eines kleinen Zeitfensters wird je Benutzer, Projekt und Ansicht nur ein Ereignis protokolliert) | projectId |
Projekt-ID |
viewName |
Ansichtsname (z.B. "ResGantt" oder "DispatchingView") | |||
my-schedule:view:uploaded |
Für eine Ansicht wurden Daten hochgeladen | projectId |
Projekt-ID | |
viewName |
Ansichtsname (z.B. "ResGantt" oder "DispatchingView") |
