Nutzungsberichte

Nutzungsberichte zeigt, wer in Ihrem Workspace was nutzt: welche Bildschirme, Dashboards, Apps und Notebooks Benutzer öffnen, wie viele Benutzer wiederkehren und wohin sie als Nächstes wechseln. Damit sehen Sie, was Ihre Mitglieder annehmen, welche Dashboards und Apps sich bewähren und an welcher Stelle Benutzer einen Prozess abbrechen.

Öffnen Sie die Berichte über die Registerkarte Identität, neben dem Sicherheitsprotokoll.

Wer Zugriff hat

Nutzungsberichte erfordert dieselbe Berechtigung wie das Sicherheitsprotokoll: identity.security_log.read. Ohne sie wird die Schaltfläche nicht angeboten, und ein Mitglied, das den Bericht trotzdem öffnet, sieht einen Hinweis, dass es keinen Zugriff hat.

Die Berichte zeigen die Nutzung pro Mitglied an zwei Stellen: auf der Registerkarte Benutzer sowie in den Exporten Tägliche Aktivität nach Mitglied und Erste Nutzung, die Mitglieds-IDs enthalten. Alles andere wird über alle Mitglieder hinweg gezählt. Erteilen Sie die Berechtigung nur Personen, die individuelle Aktivitäten einsehen dürfen.

Was gezählt wird

Nutzungsberichte kombiniert fünf Quellen. Wählen Sie unter Quelle eine aus, oder lassen Sie die Einstellung auf Alle Quellen.

Quelle	Was erfasst wird
PlaidCloud-App	Die Bildschirme, die Mitglieder öffnen, und die Aktionen, die sie in der App ausführen.
Superset	Aufrufe von Dashboards und Diagrammen.
Panel-Apps	App-Besuche und die Zeit, die Mitglieder in jeder App verbringen.
JupyterHub	Zeit, die Mitglieder in JupyterHub-Sitzungen verbringen.
Jupyter-Notebooks	Die Notebooks, die Mitglieder öffnen und speichern.

JupyterHub-Sitzungen und Jupyter-Notebooks sind getrennte Quellen, sodass Sie jeweils eine davon auswählen können. Panel-Apps sind eine einzelne Quelle. Notebook-Ereignisse werden nur für Notebooks erfasst, die auf dem Standard-Notebook-Image laufen. Ein benutzerdefiniertes Image meldet sie nicht.

Hinweis

Jeder Tag in den Berichten ist ein UTC-Tag. Ein Mitglied, das am späten Abend in Nord- oder Südamerika arbeitet, kann am Folgetag erscheinen.

Berichte lesen

Wählen Sie oben im Fenster eine Quelle und einen Datumsbereich aus und wählen Sie dann Aktualisieren. Zur Auswahl stehen die letzten 7, 30, 90 oder 180 Tage. Jede Registerkarte wird beim ersten Öffnen geladen und erneut, wenn Sie die Quelle oder den Bereich ändern.

Übersicht

Die wichtigsten Kennzahlen für den Bereich:

Zahl	Bedeutung
Aktive Benutzer	Mitglieder mit beliebiger Aktivität.
Neue Benutzer	Mitglieder, die im Bereich zum ersten Mal erfasst wurden.
Wiederkehrende Benutzer	Aktive Mitglieder, die schon vor dem Bereich erstmals erfasst wurden.
Aktive Minuten	Näherungswert: fünf Minuten für jeden Zeitraum mit Aktivität.
Ereignisse	Alles, was erfasst wurde.
Nicht zugeordnete Ereignisse	Ereignisse, für die sich kein Mitglied benennen ließ. Sie zählen als Ereignisse, nicht als Benutzer.
Sitzungsminuten	Sitzungszeit in Panel und JupyterHub, getrennt von den aktiven Minuten gezählt.

Akzeptanz listet jeden Bildschirm, jedes Dashboard, Diagramm oder Element mit seiner Quelle, dem Ereignis, der Anzahl der Benutzer, dem Anteil an den aktiven Benutzern, den Ereignissen und den nicht zugeordneten Ereignissen auf. Nach Monat zeigt für jeden Monat die aktiven Benutzer, die durchschnittlichen täglichen Benutzer und die Stickiness, mit einem Hinweis, wenn der Monat noch läuft, nur teilweise abgedeckt ist oder ein eingefrorener Snapshot ist.

Aktivität

Aktive Benutzer nach Zeitraum Täglich, Wöchentlich oder Monatlich, dazu Bindung nach erster Woche: Für jede Woche, in der Mitglieder erstmals erschienen, wie viele in jeder darauffolgenden Woche wiederkamen. Ein Zeitraum mit Sternchen liegt nicht vollständig im Bereich.

Pfade

Die am häufigsten genommenen Wechsel zwischen Bildschirmen, als Gewechselt von, Gewechselt zu und Häufigkeit, über Apps und Quellen hinweg. Pfade umfassen höchstens die letzten 30 Tage.

Benutzer

Eine Zeile pro Mitglied: Name, Benutzername, aktive Tage, Ereignisse, aktive Minuten, Sitzungsminuten sowie der Zeitpunkt, zu dem das Mitglied erstmals und zuletzt erfasst wurde.

Exporte

Laden Sie eine Zusammenfassung als CSV-Datei herunter. Wählen Sie die Zusammenfassung und einen Datumsbereich von bis zu 25 Monaten und wählen Sie dann CSV herunterladen.

Zusammenfassung	Inhalt
Tägliche Aktivität	Benutzer und Ereignisse für jeden Tag, jede Quelle, jedes Ereignis und jeden Betreff.
Tägliche Aktivität nach Mitglied	Dasselbe für jedes Mitglied, mit Mitglieds-IDs.
Monatliche Akzeptanz	Benutzer und Ereignisse für jeden Monat, jede Quelle, jedes Ereignis und jeden Betreff.
Monatlich aktive Benutzer	Aktive Benutzer für jeden Monat und jede Quelle.
Erste Nutzung	Wann jedes Mitglied jede Quelle erstmals genutzt hat, mit Mitglieds-IDs.

Der Export verwendet die Quelle, die Sie oberhalb der Registerkarten gewählt haben. Eine große Zusammenfassung wird in Blöcken von bis zu 50.000 Zeilen heruntergeladen, und das Fenster fügt sie zu einer Datei zusammen. Wäre die Datei größer, als das Fenster aufbauen kann, speichert es, was es hat, und weist Sie darauf hin, dass die Datei unvollständig ist: Wählen Sie einen kürzeren Bereich, um den Rest zu erhalten.

Jeder Export schreibt einen Eintrag in das Sicherheitsprotokoll, der festhält, wer welche Zusammenfassung exportiert hat, den Bereich und die Zeilenanzahl. Eine Zusammenfassung, die sich über mehrere Blöcke erstreckt, schreibt für jeden Block einen Eintrag.

Achtung

Die monatlichen Zusammenfassungen enthalten für jedes Ereignis eine Summenzeile mit dem Betreff *. Diese Zeile enthält die eindeutigen Benutzer und Ereignisse über alle Betreffe des Ereignisses hinweg. Addieren Sie sie nicht zu den Betreffzeilen, sonst zählen Sie alles doppelt.

Trichter

Sehen Sie, wie viele Mitglieder eine Abfolge von Schritten durchlaufen. Ein Schritt ist ein Ereignis aus einer der Quellen für einen bestimmten Betreff oder für Beliebiger Betreff.

1. Wählen Sie Schritt hinzufügen und legen Sie für jeden Schritt die Quelle, das Ereignis und den Betreff fest. Ein Trichter hat 2 bis 6 Schritte.
2. Wählen Sie die Erlaubte Zeit zwischen Schritten: 1, 6, 24, 72 oder 168 Stunden.
3. Wählen Sie einen Datumsbereich von 7, 30 oder 90 Tagen.
4. Wählen Sie Trichter ausführen.

Das Ergebnis zeigt für jeden Schritt, wie viele Mitglieder ihn erreicht haben, den Anteil derer, die begonnen haben, wie viele dort aufgehört haben und die mittlere Zeit seit dem vorherigen Schritt. Schritte können Quellen mischen, sodass Sie ein Mitglied von einem PlaidCloud-Bildschirm zu einem Superset-Dashboard verfolgen können. Mit Zuletzt verwendete Trichter öffnen Sie einen zuvor ausgeführten Trichter erneut. Eine Schrittliste bietet nur Ereignisse an, die im Bereich erfasst wurden.

Nicht zugeordnete Nutzung

Manche Ereignisse lassen sich keinem PlaidCloud-Mitglied zuordnen. Sie zählen unter Ereignisse und unter Nicht zugeordnete Ereignisse, aber nie in den Benutzerzahlen. Die wichtigsten Fälle:

• Ein Superset-Konto, das in Superset statt über PlaidCloud erstellt wurde.
• Der Aufruf eines eingebetteten Dashboards, das keinen Superset-Benutzer hat.
• Panel- und JupyterHub-Aktivität, die die Plattformprotokolle keinem Mitglied zuordnen können. Ihre Zuordnung stammt aus diesen Protokollen und ist daher nur eine bestmögliche Näherung.

Ein hoher Anteil nicht zugeordneter Ereignisse bei einer Quelle bedeutet, dass deren Benutzerzahlen zu niedrig ausgewiesen werden.

Wann der Verlauf beginnt

Der Verlauf beginnt, wenn die Nutzungserfassung für Ihren Workspace eingeschaltet wird, und ein Tag oder Monat davor zeigt keine Aktivität. Der erste Monat mit Daten wird als teilweise markiert.

Panel und JupyterHub werden aus Plattformprotokollen gelesen, die etwa 90 Tage aufbewahrt werden. Wenn die Erfassung startet, füllen sich diese beiden Quellen mit höchstens so viel früherem Verlauf. Superset füllt sich aus seinen eigenen Protokollen, bis zu 180 Tage. Nur die PlaidCloud-App beginnt beim Start der Erfassung bei null.

Nutzungsberichte bewahrt Rohereignisse 180 Tage lang auf, weshalb der längste Bereich 180 Tage beträgt, und monatliche Zusammenfassungen 25 Monate lang. Wird ein Mitglied außerhalb von PlaidCloud entfernt, zum Beispiel über SCIM oder Keycloak, laufen seine Rohdaten zur Nutzung nach 180 Tagen ab und sein Eintrag zur ersten Nutzung nach 25 Monaten.

Nutzungsdaten eines Mitglieds löschen

Ein Workspace-Administrator (oder Superuser) mit der Berechtigung identity.security_log.read kann die Nutzungsdaten eines Mitglieds löschen und deren Erfassung beenden und die Löschung später wieder aufheben. Sowohl Löschen als auch Wiederherstellen erfordern diese Berechtigung und diese Rolle. Diese beiden Aktionen sind nur über die REST-API verfügbar.

Aktion	Anfrage
Löschen	DELETE /rest/v1/identity/usage/users/{user_id}
Wiederherstellen	DELETE /rest/v1/identity/usage/users/{user_id}/erasure

Das Löschen entfernt die Ereignisse und den Eintrag zur ersten Nutzung des Mitglieds, und ab diesem Moment lassen die Berichte und Exporte das Mitglied aus. Seine Nutzung wird nicht erneut erfasst, und Verlauf, der später aus Panel- und JupyterHub-Protokollen eingelesen wird, wird ebenfalls verworfen. Wenn sich das Entfernen nicht sofort abschließen lässt, weist die Antwort darauf hin, und der nächste stündliche Wartungslauf schließt es ab.

Das Wiederherstellen hebt die Löschung auf, sodass neue Aktivität wieder erfasst wird. Es bringt nicht zurück, was gelöscht wurde.

Beide Aktionen schreiben einen Eintrag in das Sicherheitsprotokoll.

Verwandte Themen

• Identitäts- und Zugriffsverwaltung
• Sicherheitsgruppen verwalten