My Schedule - Nutzungsprotokoll: Unterschied zwischen den Versionen

Aktuelle Version vom 19. April 2026, 10:06 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 Konfigurationsdatei config.json können Sie die Protokollierung aktivieren und steuern.

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:

Hinweis 

Die Reihenfolge der Schlüssel ist (derzeit noch) nicht fest vorgegeben.

Ereignisse

Die folgenden Ereignisse werden protokolliert:

Analyse mit DuckDB

Dieser Abschnitt beschreibt die beispielhafte und optionale Analyse der Nutzungsprotokolle mittels der kostenfreien Software DuckDB. Weder ist dies der von uns empfohlene Weg, noch können wir für DuckDB Unterstützung leisten.

Vorbereitung

1. Öffnen Sie die Eingabeaufforderung oder PowerShell
2. Starten Sie DuckDB
3. Setzen Sie in DuckDB das Protokollverzeichnis von Asprova WS als Arbeitsverzeichnis
4. Erstellen Sie eine View:

Um das Nutzungsprotokoll eines bestimmten Tages abzufragen:

CREATE VIEW usage_logs AS SELECT * FROM read_json_auto('usage-2026-04-10.log');

Um alle Nutzungsprotokolle abzufragen:

CREATE VIEW usage_logs AS SELECT * FROM read_json_auto('usage-*.log', filename=true);

Beispiele

Ereignisse nach Ereignistyp zählen

SELECT eventType, count(*) AS count
FROM usage_logs
GROUP BY eventType
ORDER BY count DESC;

Fehlgeschlagene Einlogversuche

SELECT timestamp, details.username, req.ip
FROM usage_logs
WHERE eventType = 'ws:user:login:failure'
ORDER BY timestamp;

Ansichtszugriffe aktiver Benutzer

SELECT "user".username, details.projectId, details.viewName, count(*) AS accesses
FROM usage_logs
WHERE eventType = 'my-schedule:view:accessed'
GROUP BY "user".username, details.projectId, details.viewName
ORDER BY accesses DESC;

CCU-Nutzung im Zeitverlauf

SELECT timestamp, eventType, details.pool, details.currentCount, details.maxCount
FROM usage_logs
WHERE eventType LIKE 'my-schedule:license:ccu:%'
ORDER BY timestamp;