Nutzungsberichte

Die Usage-Berichte ermöglichen es Ihnen, detaillierte Request-Logs einzusehen, nach Projekt/Nutzer/Zeitraum zu filtern, nach Zeit oder Credits zu sortieren, Ergebnisse in der Vorschau anzuzeigen und als PDF oder Bulk-ZIP zu exportieren. Ohne Datumsangabe gilt der aktuelle Kalendermonat als Standard.

Was sind Usage Reports?

Usage Reports zeigen:

Jede einzelne Anfrage an die Middleware
Zeitstempel (wann wurde angefragt?)
Nutzer (wer hat angefragt?)
Projekt (zu welchem Projekt gehört der Nutzer?)
Provider & Modell (welcher Dienst wurde genutzt?)
Token/Zeichen/Zeit (wie viel wurde verbraucht?)
Credits (wie viel wurde abgerechnet?)
Status (erfolgreich/fehlgeschlagen?)

Transparenz

Usage Reports ermöglichen vollständige Transparenz über alle Anfragen und Kosten!

Usage-Übersicht aufrufen

Öffnen Sie das Admin-Dashboard
Navigieren Sie zu Usage
Standardmäßig wird der aktuelle Monat angezeigt

Standard-Zeitraum

Wichtig

Ohne explizite Datumsangabe zeigt Admin Bud-E automatisch den aktuellen Kalendermonat.

Beispiel: Heute ist 11. Oktober 2025 → Angezeigt wird: 1. Oktober 2025 00:00 - 31. Oktober 2025 23:59

Filtern

Nach Zeitraum

Vordefinierte Zeiträume:

Heute
Gestern
Letzte 7 Tage
Letzte 30 Tage
Aktueller Monat
Letzter Monat

Benutzerdefiniert:

Von: 01.09.2025
Bis: 30.09.2025

Nach Projekt

Dropdown-Liste aller Projekte:

[ Alle Projekte ▼ ]
  - Alle Projekte
  - Schüler
  - Lehrkräfte
  - Verwaltung
  - Oberstufe

Nach Nutzer

Option 1: Dropdown

[ Alle Nutzer ▼ ]
  - Alle Nutzer
  - klasse-7a
  - klasse-7b
  - lehrer-schmidt
  ...

Option 2: Suche

🔍 Nutzer suchen: [klasse     ]

Nach Provider

[ Alle Provider ▼ ]
  - Alle Provider
  - vertex
  - together
  - mistral
  - openai

Nach Modell

[ Alle Modelle ▼ ]
  - Alle Modelle
  - gemini-1.5-pro
  - gemini-1.5-flash
  - llama-3.1-70b
  ...

Nach Typ

[ Alle Typen ▼ ]
  - Alle Typen
  - LLM
  - VLM
  - TTS
  - ASR

Nach Status

[ Alle Status ▼ ]
  - Alle Status
  - ✅ Erfolgreich
  - ❌ Fehlgeschlagen
  - ⏱️ Timeout

Sortieren

Sortier-Optionen

Feld	Beschreibung	Verwendung
Zeitstempel	Nach Anfrage-Zeit	Chronologie verstehen
Nutzer	Alphabetisch nach Username	Nutzer-spezifische Analyse
Credits	Nach Kosten	Teuerste Anfragen finden
Tokens	Nach Token-Anzahl	Größte Anfragen finden
Dauer	Nach Response-Zeit	Performance-Probleme erkennen

Reihenfolge

Aufsteigend (↑): Kleinster zuerst
Absteigend (↓): Größter zuerst

Beispiele:

Sortierung: Credits (absteigend)
→ Teuerste Anfrage zuerst

Sortierung: Zeitstempel (absteigend)
→ Neueste Anfrage zuerst

Vorschau

Die Vorschau zeigt eine Tabelle mit allen gefilterten Anfragen:

Spalten

Spalte	Inhalt	Beispiel
Zeit	Zeitstempel	11.10.2025 14:23:15
Nutzer	Username	klasse-7a
Projekt	Projektname	Schüler
Typ	LLM/VLM/TTS/ASR	LLM
Provider	Anbieter	vertex
Modell	Modellname	gemini-1.5-flash
Input	Token/Zeichen	1.234 Tokens
Output	Token/Zeichen	567 Tokens
Credits	Kosten	0.0542
Status	Erfolgreich/Fehler	✅

Detail-Ansicht

Klick auf eine Zeile öffnet Details:

Anfrage-ID: req_1234567890abcdef
────────────────────────────────────────
Zeitstempel: 2025-10-11 14:23:15 UTC
Nutzer: klasse-7a (Projekt: Schüler)
────────────────────────────────────────
Provider: vertex
Modell: gemini-1.5-flash
Region: europe-west4
────────────────────────────────────────
Input: 1.234 Tokens
Output: 567 Tokens
Gesamt: 1.801 Tokens
────────────────────────────────────────
Preise:
  Input: $0.075 / 1M Tokens
  Output: $0.30 / 1M Tokens

Berechnung:
  Input: (1.234 / 1.000.000) × $0.075 = $0.0000926
  Output: (567 / 1.000.000) × $0.30 = $0.0001701
  Gesamt: $0.0002627

Credits: 0.0263 (aufgerundet)
────────────────────────────────────────
Status: ✅ Erfolgreich
Dauer: 1.234s

Export

Export-Formate

PDF (einzeln)

Für einzelne Berichte oder Präsentationen:

Filter/Sortierung anwenden
Klicken Sie auf Export PDF
PDF wird generiert und heruntergeladen

Enthält:

Zusammenfassung (Gesamt-Credits, Anzahl Anfragen)
Filter-Parameter
Tabelle aller Anfragen
Diagramme (optional)

Dateiname-Format:

usage_report_2025-10.pdf
usage_report_schueler_2025-09.pdf

CSV (Bulk)

Für Datenanalyse in Excel/Tools:

Filter anwenden
Klicken Sie auf Export CSV
CSV wird heruntergeladen

Spalten:

csv

timestamp,user,project,type,provider,model,input_tokens,output_tokens,credits,status
2025-10-11 14:23:15,klasse-7a,schueler,llm,vertex,gemini-1.5-flash,1234,567,0.0263,success
2025-10-11 14:25:42,klasse-7b,schueler,llm,vertex,gemini-1.5-flash,890,234,0.0178,success
...

ZIP (Bulk für mehrere Projekte)

Für monatliche Abrechnung aller Projekte:

Wählen Sie Zeitraum
Klicken Sie auf Export All Projects (ZIP)
ZIP-Datei mit einem PDF pro Projekt wird erstellt

Struktur:

usage_reports_2025-10.zip
├── schueler_2025-10.pdf
├── lehrkraefte_2025-10.pdf
├── verwaltung_2025-10.pdf
└── summary.pdf (Gesamt-Übersicht)

Analyse-Beispiele

Beispiel 1: Monatsverbrauch pro Projekt

Filter:

Zeitraum: Letzter Monat (September)
Gruppierung: Nach Projekt

Ergebnis:

Projekt Schüler:
  Anfragen: 12.345
  Credits: 1.234.56
  Ø pro Anfrage: 0.10

Projekt Lehrkräfte:
  Anfragen: 890
  Credits: 234.50
  Ø pro Anfrage: 0.26

Projekt Verwaltung:
  Anfragen: 123
  Credits: 45.67
  Ø pro Anfrage: 0.37

Beispiel 2: Top-10-Nutzer nach Verbrauch

Filter:

Zeitraum: Aktueller Monat
Sortierung: Credits (absteigend)
Limit: 10

Ergebnis:

1. klasse-8a: 125.45 Credits
2. lehrer-mueller: 98.23 Credits
3. klasse-7b: 87.90 Credits
4. lehrer-schmidt: 76.54 Credits
5. klasse-9a: 65.32 Credits
...

Beispiel 3: Fehlerhafte Anfragen

Filter:

Zeitraum: Letzte 7 Tage
Status: Fehlgeschlagen

Analyse:

Gesamt Fehler: 45

Nach Fehler-Typ:
  - Rate Limit (429): 32
  - Server Error (500): 8
  - Timeout: 5

Nach Provider:
  - vertex: 30 Fehler
  - together: 10 Fehler
  - mistral: 5 Fehler

→ Aktion: Vertex-Limits prüfen, ggf. erhöhen

Beispiel 4: Modell-Vergleich

Filter:

Zeitraum: September 2025
Typ: LLM

Analyse:

Gemini 1.5 Pro:
  Anfragen: 2.345
  Credits: 456.78
  Ø pro Anfrage: 0.195

Gemini 1.5 Flash:
  Anfragen: 8.901
  Credits: 678.90
  Ø pro Anfrage: 0.076

→ Flash ist 2.5× günstiger!

Beispiel 5: TTS-Nutzung

Filter:

Zeitraum: Aktueller Monat
Typ: TTS

Analyse:

Gesamt TTS-Anfragen: 1.234
Gesamt Zeichen: 456.789
Gesamt Credits: 7.31

Ø Zeichen/Anfrage: 370
Ø Credits/Anfrage: 0.0059

Top-Nutzer:
  - klasse-5a: 89 Anfragen (viel Audio-Output)
  - lehrer-mueller: 67 Anfragen

Automatisierung

Geplante Berichte

Richten Sie automatische monatliche Berichte ein:

Konfiguration:

yaml

scheduled_reports:
  - name: "Monatsbericht Alle Projekte"
    schedule: "0 0 1 * *"  # Jeden 1. des Monats
    format: pdf
    scope: all_projects
    email: admin@schule.de

  - name: "Wöchentlicher Top-10"
    schedule: "0 0 * * 1"  # Jeden Montag
    format: csv
    scope: top_users
    limit: 10
    email: schulleitung@schule.de

API-Zugriff

Für externe Tools (z.B. BI-Systeme):

bash

# Alle Anfragen des letzten Monats abrufen
curl -X GET "https://ihr-server.de/api/usage?from=2025-09-01&to=2025-09-30" \
  -H "Authorization: Bearer ADMIN_TOKEN"

# Als CSV
curl -X GET "https://ihr-server.de/api/usage?from=2025-09-01&to=2025-09-30&format=csv" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -o usage_september.csv

Best Practices

1. Regelmäßige Überprüfung

Täglich:

Fehlerhafte Anfragen prüfen
Ungewöhnlich hohe Verbrauchspeaks

Wöchentlich:

Top-10-Nutzer checken
Provider-Performance vergleichen

Monatlich:

Gesamt-Verbrauch analysieren
Budget vs. tatsächliche Kosten
Trend-Analyse (steigend/sinkend?)

2. Alarme einrichten

Definieren Sie Schwellwerte:

⚠️ Warnung: Projekt-Verbrauch > 80% Budget
⚠️ Warnung: Einzelnutzer > 10× Durchschnitt
🚨 Kritisch: Fehlerrate > 5%
🚨 Kritisch: Credits/Anfrage > 2× erwartet

3. Historische Daten archivieren

Monatliches Archiv anlegen:

/backups/usage/
  ├── 2025-01_all_projects.zip
  ├── 2025-02_all_projects.zip
  ├── ...
  └── 2025-10_all_projects.zip

4. Datenschutz beachten

DSGVO

Usage Logs enthalten möglicherweise personenbezogene Daten (je nach Username-Vergabe).

Speichern Sie Logs sicher
Begrenzen Sie Zugriff (nur Admins)
Löschen Sie alte Logs nach X Monaten
Anonymisieren Sie bei Bedarf

5. Performance optimieren

Bei großen Datenmengen:

✅ Gut:
- Filter vor Export anwenden
- Zeitraum begrenzen (max. 3 Monate)
- CSV für große Exporte (nicht PDF)

❌ Schlecht:
- Alle Daten auf einmal exportieren
- Mehrere Jahre gleichzeitig
- PDF mit 10.000+ Zeilen

Problembehebung

Export dauert sehr lange

Ursache: Zu viele Daten

Lösung:

Zeitraum einschränken (z.B. nur 1 Monat)
Nach Projekt filtern
CSV statt PDF verwenden

Keine Daten sichtbar

Checkliste:

✅ Richtiger Zeitraum gewählt?
✅ Filter zu restriktiv?
✅ Wurden Anfragen tatsächlich gemacht?
✅ Provider richtig konfiguriert?

Credits stimmen nicht

Prüfen Sie:

Pricing-Konfiguration korrekt?
Token-Zählung plausibel?
Rundungsfehler (sehr kleine Beträge)?
Log-Zeitstempel vs. Abrechnung

Nächste Schritte

Nach der Usage-Analyse:

Budgets anpassen - Budget-Konfiguration optimieren
Pricing überprüfen - Preise aktualisieren
Backups erstellen - Usage-Daten sichern

Nutzungsberichte ​

Was sind Usage Reports? ​

Usage-Übersicht aufrufen ​

Standard-Zeitraum ​

Filtern ​

Nach Zeitraum ​

Nach Projekt ​

Nach Nutzer ​

Nach Provider ​

Nach Modell ​

Nach Typ ​

Nach Status ​

Sortieren ​

Sortier-Optionen ​

Reihenfolge ​

Vorschau ​

Spalten ​

Detail-Ansicht ​

Export ​

Export-Formate ​

PDF (einzeln) ​

CSV (Bulk) ​

ZIP (Bulk für mehrere Projekte) ​

Analyse-Beispiele ​

Beispiel 1: Monatsverbrauch pro Projekt ​

Beispiel 2: Top-10-Nutzer nach Verbrauch ​

Beispiel 3: Fehlerhafte Anfragen ​

Beispiel 4: Modell-Vergleich ​

Beispiel 5: TTS-Nutzung ​

Automatisierung ​

Geplante Berichte ​

API-Zugriff ​

Best Practices ​

1. Regelmäßige Überprüfung ​

2. Alarme einrichten ​

3. Historische Daten archivieren ​

4. Datenschutz beachten ​

5. Performance optimieren ​

Problembehebung ​

Export dauert sehr lange ​

Keine Daten sichtbar ​

Credits stimmen nicht ​

Nächste Schritte ​

Nutzungsberichte

Was sind Usage Reports?

Usage-Übersicht aufrufen

Standard-Zeitraum

Filtern

Nach Zeitraum

Nach Projekt

Nach Nutzer

Nach Provider

Nach Modell

Nach Typ

Nach Status

Sortieren

Sortier-Optionen

Reihenfolge

Vorschau

Spalten

Detail-Ansicht

Export

Export-Formate

PDF (einzeln)

CSV (Bulk)

ZIP (Bulk für mehrere Projekte)

Analyse-Beispiele

Beispiel 1: Monatsverbrauch pro Projekt

Beispiel 2: Top-10-Nutzer nach Verbrauch

Beispiel 3: Fehlerhafte Anfragen

Beispiel 4: Modell-Vergleich

Beispiel 5: TTS-Nutzung

Automatisierung

Geplante Berichte

API-Zugriff

Best Practices

1. Regelmäßige Überprüfung

2. Alarme einrichten

3. Historische Daten archivieren

4. Datenschutz beachten

5. Performance optimieren

Problembehebung

Export dauert sehr lange

Keine Daten sichtbar

Credits stimmen nicht

Nächste Schritte