Skip to main content
Nutzungsexporte sind für Workspace-Administratoren verfügbar und bieten bis zu 12 Monate historische Daten über Nutzer, Agenten, API-Schlüssel, Projekte, Modelle und Workflows.

​
Zugriff auf Nutzungsexporte

Du kannst Nutzungsdaten in der Langdock-Oberfläche exportieren oder programmatisch über die Usage Export API abrufen. Um den Export in der Oberfläche zu starten, öffne die Analyseseite deines Workspaces und klicke oben rechts auf Exportieren.
1

Öffne Analysen

Gehe in den Workspace-Einstellungen zu deiner Workspace-Analyseseite.
2

Klicke auf Exportieren

Wähle oben rechts den Exportieren-Button.
3

Konfiguriere den Export

Wähle Datentyp und Datumsbereich im Export-Dialog.
4

CSV generieren

Klicke auf CSV generieren. Der Button zeigt Wird vorbereitet…. Du kannst den Dialog schließen.
5

Datei herunterladen

Wenn der Export bereit ist, bekommst du die Inbox-Benachrichtigung Nutzungsexport bereit. Unter Letzte Exporte auf der Analyseseite siehst du In der Warteschlange, Wird vorbereitet, Bereit und Fehlgeschlagen. Klicke auf Herunterladen, wenn der Status Bereit ist.
Pro Workspace läuft nur ein Analytics-Export gleichzeitig. Wenn du CSV generieren klickst, während ein anderer Export in der Warteschlange steht oder vorbereitet wird, siehst du Es läuft bereits ein Export. Warte, bis er fertig ist, oder schau unter Letzte Exporte.

​
Export-Konfiguration

​
Datentypen

Wähle aus, welche Nutzungsdaten exportiert werden sollen:
  • Nutzer - Nutzeraktivität, Nachrichtenanzahl und Feature-Nutzung im gewählten Zeitraum
  • Agenten - Agenten-Nutzungsstatistiken, Interaktionen und KPI-Metriken
  • API-Schlüssel - API-Nutzung und Kosten gruppiert nach API-Schlüssel, einschließlich persönlicher API-Keys
  • Projekte - Nutzungsdaten auf Projektebene
  • Modelle - Modellnutzung, Anfragen und BYOK-Token-Verbrauch
  • Workflows - Workflow-Kosten, Läufe und Auslastung des monatlichen Caps

​
Datumsbereich

Wähle einen vordefinierten Bereich oder einen benutzerdefinierten Zeitraum:
  • Dieser Monat
  • Letzter Monat
  • Diese Woche
  • Letzte Woche
  • Nutzerdefinierten Bereich wählen

​
Export-Limits

Nutzungsexporte enthalten historische Daten aus bis zu 12 Monaten. In Analytics kann ein Export bis zu 1.000.000 CSV-Zeilen enthalten und muss innerhalb von 15 Minuten fertig sein. Wenn ein Export zu viele Zeilen hat oder zu lange dauert, wähle einen kürzeren Zeitraum und füge die CSV-Dateien anschließend zusammen. Die Usage Export API kann bis zu 1.000.000 Nutzungszeilen pro Anfrage verarbeiten.

​
Export-Datenstruktur

Jeder Export erzeugt eine CSV-Datei mit einer Zeile pro Entität im gewählten Zeitraum.
Einige Spalten sind nur für Workspaces mit Bring Your Own Key (BYOK) verfügbar. Diese sind unten als Nur bei BYOK-Workspaces gekennzeichnet.

​
Nutzungsexporte

Der Nutzer-Export enthält individuelle Nutzeraktivität im gewählten Zeitraum.
Die Einstellung Daten auf User-Ebene steuert, ob nutzerbezogene Detailspalten enthalten sind. Wenn sie deaktiviert ist, werden die unten gekennzeichneten Spalten aus dem Export ausgeschlossen, darunter name und email. API-Zeilen, die nach Abteilung oder Firmenname gruppiert sind, enthalten den Gruppierungsschlüssel trotzdem.

​
Spaltendefinitionen

payg_limit_current ist das Extra-Nutzungslimit zum Zeitpunkt des Exports: in EUR in Langdock Cloud Workspaces ohne BYOK, in USD bei BYOK und Dedicated Deployments. Ein unbegrenztes Limit bleibt leer. payg_consumption_in_period ist die Ausgabe im gewählten Zeitraum, gerundet auf zwei Dezimalstellen. Ohne BYOK ist das die Extra-Nutzung in EUR. Ausgaben, die auf das eigene Nutzungslimit eines Agenten gebucht werden, fehlen in diesem Betrag. Bei BYOK und Dedicated Deployments ist es der USD-Betrag jeder Zeile, die auf Nutzungslimits angerechnet wird, auch Ausgaben auf dem eigenen Nutzungslimit eines Agenten.payg_utilization_pct_current ist dieser Verbrauch geteilt durch das aktuelle Limit, gerundet auf vier Dezimalstellen. Das ist ein Verhältnis, kein Prozentwert von 0 bis 100, und der Wert kann größer als 1 sein. Die Zelle bleibt leer, wenn das Limit unbegrenzt, 0 oder negativ ist. Bei einem positiven Limit ohne Verbrauch im Zeitraum steht 0.payg_limit_source ist plan, user, group oder workspace. Unter Nutzung und Limits erscheinen sie als Individuell, Workspace sowie Plan oder Gruppe mit dem Namen des Plans oder der Gruppe. Ohne BYOK und mit aktiver Extra-Nutzung gilt standardmäßig das höchste anwendbare Plan- oder Gruppenlimit. Unbegrenzt zählt als höchstes Limit. Bei Gleichstand, auch zwischen zwei unbegrenzten Limits, gewinnt eine Gruppe vor dem Plan und die alphabetisch erste Gruppe vor anderen Gruppen. Ein individuelles Limit mit Individuell oder Unbegrenzt überschreibt es, auch ein Betrag von 0. payg_limit_group_name ist der Name der Gruppe, deren Limit gilt, sonst leer. Pro Nutzer gibt es einen Verbrauch, nicht einen pro Gruppe.Ist Extra-Nutzung in Langdock Cloud Workspaces ohne BYOK aus, ist payg_limit_current 0 und payg_limit_source workspace. Bei BYOK und Dedicated Deployments kommt das Limit nur aus der individuellen Extra-Nutzung. Ohne Individuell und ohne Unbegrenzt sind Betrag 0 und Quelle user.

​
Zusätzliche Spalten für BYOK-Workspaces

​
Zeilen unterteilen

Nutze im Export-Dialog Zeilen unterteilen, um jeden Nutzer in eine Zeile pro verwendetem Modell aufzuteilen. Wähle Keine Gruppierung, um eine Zeile pro Nutzer zu behalten.Bei Unterteilung nach Modell werden Ranking-, JSON-Aufschlüsselungs- und Aktionsspalten sowie projects_messaged ausgelassen. payg_consumption_in_period und payg_utilization_pct_current gelten dann nur für dieses Modell. payg_limit_current, payg_limit_source und payg_limit_group_name wiederholen auf jeder Modellzeile das aktuelle Limit des Nutzers. Zähle payg_limit_current nicht über die Modellzeilen zusammen.Der Export-Dialog bietet nur Keine Gruppierung und Modell. Nach Abteilung oder Firmenname gruppierst du über die Usage Export API. Jedes Nutzungsereignis zählt für die Abteilung oder Firma, die bei der letzten Anmeldung des Nutzers im Workspace davor erfasst wurde.

​
Im Nutzer-Export referenzierte Aktionen

Die folgenden Aktionen können in der Spalte action_to_messages erscheinen:
Wird verwendet, um Dokumente und Code in einer strukturierten Oberfläche zu bearbeiten.
Wird verwendet, um externe Webquellen nach Echtzeitinformationen zu durchsuchen.
Wird verwendet, um hochgeladene Dokumente, Tabellen und andere Dateitypen zu analysieren.
Wird verwendet, um Code in verschiedenen Programmiersprachen auszuführen und zu testen.
Aktionen aus verbundenen Integrationen, zum Beispiel Hubspot_create_contact oder Slack_send_message.

​
Datenverarbeitung und Datenschutz

​
Null-Werte

Leere oder nicht verfügbare Datenfelder werden so behandelt:
  • Numerische Felder: 0 oder leer
  • Textfelder: leere Zeichenketten
  • JSON-Objekte: leere Objekte {}

​
Datenspeicherung

  • Historische Daten sind bis zu 12 Monate verfügbar.
  • Exportdaten spiegeln den Stand zum Zeitpunkt des Exports wider.
  • Nutzerrollen, Namen, Abteilungen und andere Attribute zeigen die aktuellen Werte zum Zeitpunkt des Exports. Die Gruppierung nach Abteilung oder Firmenname in der Usage Export API nutzt für jedes Nutzungsereignis den Wert, der bei der letzten Anmeldung des Nutzers davor erfasst wurde.