My Schedule - Nutzungsprotokoll: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
Zeile 33: Zeile 33:
 
!colspan="2"|Schlüssel!!Beschreibung
 
!colspan="2"|Schlüssel!!Beschreibung
 
|-
 
|-
−
|colspan="2"|eventType||Ereignistyp
+
|colspan="2"|<code>eventType</code>||Ereignistyp
 
|-
 
|-
−
|colspan="2"|user||Benutzer, welcher das Ereignis ausgelöst hat (falls zutreffend)
+
|colspan="2"|<code>user</code>||Benutzer, welcher das Ereignis ausgelöst hat (falls zutreffend)
 
|-
 
|-
−
| ||userId||Benutzer-ID
+
| ||<code>userId</code>||Benutzer-ID
 
|-
 
|-
−
| ||username||Benutzername
+
| ||<code>username</code>||Benutzername
 
|-
 
|-
−
|colspan="2"|req||Informationen zum HTTP-Request, welcher das Ereignis ausgelöst hat (falls zutreffend)
+
|colspan="2"|<code>req</code>||Informationen zum HTTP-Request, welcher das Ereignis ausgelöst hat (falls zutreffend)
 
|-
 
|-
−
| ||method||HTTP-Methode (z.B. <code>POST</code>)
+
| ||<code>method</code>||HTTP-Methode (z.B. <code>POST</code>)
 
|-
 
|-
−
| ||path||Der angefragt Pfad (z.B. <code>/api/auth/login</code>)
+
| ||<code>path</code>||Der angefragt Pfad (z.B. <code>/api/auth/login</code>)
 
|-
 
|-
−
| ||ip||IP-Adresse des Clients
+
| ||<code>ip</code>||IP-Adresse des Clients
 
|-
 
|-
−
|colspan="2"|details||Weitere Informationen zum im Kontext des Ereignisses
+
|colspan="2"|<code>details</code>||Weitere Informationen zum im Kontext des Ereignisses
 
|-
 
|-
−
|colspan="2"|timestamp||Zeitstempel des Ereignisses
+
|colspan="2"|<code>timestamp</code>||Zeitstempel des Ereignisses
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== Ereignisse ==
−
 
+
Die folgenden Ereignisse werden protokolliert:
 +
{| class="wikitable"
 +
|+
 +
!Ereignistyp!!Beschreibung!!Zusätzlicher Hinweis||Details!!Beschreibung der Details
 +
|-
 +
|rowspan="2"|<code>ws:server:start</code>||rowspan="2"|Server (bzw. Dienst) wurde gestartet||rowspan="2"| ||<code>port</code>||Horchender Port
 +
|-
 +
|<code>https</code>||HTTPS-Aktivierungsstatus
 +
|-
 +
|rowspan="4"|<code>ws:user:created</code>||rowspan="4"|Benutzer wurde hinzugefügt||rowspan="4"| ||<code>ID</code>||ID des neuen Benutzers
 +
|-
 +
|<code>username</code>||Benutzername des neuen Benutzers
 +
|-
 +
|<code>type</code>||Authentifizierungsart des neuen Benutzers
 +
|-
 +
|<code>roles</code>||Berechtigungen des neuen Benutzers
 +
|-
 +
|<code>ws:user:login:success</code>||Benutzer hat sich erfolgreich eingeloggt|| || ||''Nicht zutreffend''
 +
|-
 +
|rowspan="2"|<code>ws:user:login:failure</code>||rowspan="2"|Einloggen des Benutzers ist fehlgeschlagen||rowspan="2"|<code>user</code> wird hier nicht gesetzt||<code>username</code>||Benutzername des Einlogversuchs
 +
|-
 +
|<code>reason</code>||Grund des Fehlschlagens
 +
|-
 +
|rowspan="2"|<code>ws:user:removed</code>||rowspan="2"|Benutzer wurde gelöscht||rowspan="2"|<code>user</code> ist hier der löschende Benutzer||<code>ID</code>||ID des gelöschten Benutzers
 +
|-
 +
|<code>username</code>||Benutzername des gelöschten Benutzers
 +
|-
 +
|<code>ws:user:logout</code>||Benutzer hat sich ausgeloggt|| || ||''Nicht zutreffend''
 +
|-
 +
|rowspan="3"|<code>my-schedule:license:ccu:added</code>||rowspan="3"|Neue CCU-Verbindung wurde akzeptiert||rowspan="3"|"CCU" = [https://de.wikipedia.org/wiki/Concurrent-User-Lizenzmodell '''C'''on'''c'''urrent '''U'''ser]||<code>pool</code>||CCU-Pool dem Benutzer hinzugefügt wurde
 +
|-
 +
|<code>currentCount</code>||Anzahl gleichzeitiger Benutzer nachdem diese Verbindung akzeptiert wurde
 +
|-
 +
|<code>myxCount</code>||Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan
 +
|-
 +
|}
  
 
<hr>
 
<hr>
 
<div align="right">[[Asprova My Schedule]]</div>
 
<div align="right">[[Asprova My Schedule]]</div>

Version vom 13. April 2026, 08:16 Uhr

Asprova My Schedule

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 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
myxCount Maximal erlaubte Anzahl gleichzeitiger Benutzer in diesem Plan
Asprova My Schedule
Abgerufen von „http://hilfe.asprova.eu/index.php?title=My_Schedule_-_Nutzungsprotokoll&oldid=8335“