Mastra Platform unterstützt jetzt Trace-Importe, zunächst von Langfuse

Was Trace-Importe leisten

Importierte Traces erscheinen in der Mastra Platform und im bereitgestellten Studio neben den von Mastra selbst erzeugten Traces. Laut Mastra können Entwickler so ihre gesamte Trace-Historie debuggen, filtern und vergleichen, ohne zwischen verschiedenen Tools wechseln zu müssen.

Das Unternehmen verweist auf ein verbreitetes Problem: Wer den Observability-Anbieter wechselt, verliert oft wertvolle Trace-Historie, weil die bestehenden Daten beim bisherigen Anbieter bleiben. Mit Trace-Importen können Teams zu Mastra wechseln und ihre Historie mitnehmen.

Bislang ließen sich Observability-Daten aus Mastra nur an Drittanbieter exportieren. Trace-Importe ergänzen nun die Gegenrichtung. Laut Mastra bleiben die Details erhalten: Span-Typen wie agent_run, model_generation und tool_call bleiben ebenso erhalten wie die Eltern-Kind-Struktur, Zeitstempel, Eingaben, Ausgaben, Nutzung und Kosten.

Es gibt allerdings Grenzen. Importiert werden nur Trace-Observations. Scores, Feedback, Datasets, Anhänge und Logs bleiben außen vor.

Import aus Langfuse einrichten

Zunächst müssen Nutzer die Mastra CLI und die Abhängigkeit @mastra/core auf die neuesten Versionen aktualisieren. Mastra zufolge setzt die Funktion [email protected] und @mastra/[email protected] oder neuer voraus.

Trace-Importe zielen auf ein Mastra-Projekt, das bereits in der Mastra Platform bereitgestellt ist. Das Zugriffstoken und die ID des Projekts sollten in der Datei .env bereits als MASTRA_PLATFORM_ACCESS_TOKEN und MASTRA_PROJECT_ID hinterlegt sein.

Auf der Langfuse-Seite erstellen Nutzer unter Settings und API Keys einen API-Schlüssel und ergänzen drei Umgebungsvariablen: LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY und LANGFUSE_BASE_URL. Die Basis-URL verweist standardmäßig auf die EU-Region. Wer eine andere Langfuse-Region oder eine selbst gehostete Instanz nutzt, muss sie daher ausdrücklich setzen. Im Beispiel der Ankündigung kommt https://us.cloud.langfuse.com zum Einsatz.

Importe vorab prüfen, ausführen und fortsetzen

Der Import läuft über die CLI mit dem Befehl mastra traces import langfuse und dem Flag --target-project, das das bereitgestellte Mastra-Projekt benennt. Mit --dry-run lässt sich der Import zunächst als Vorschau durchspielen.

In Mastras Beispiel nannte die Vorschau eine Import-ID, das Langfuse-Quellprojekt, das Zielprojekt in der Mastra Platform, den Zeitraum und das Datenvolumen: 6 Traces und 146 Spans waren vorbereitet, keiner wurde übersprungen, bei 916,5 KiB lokalen Daten. Am Ende des Dry-Runs steht ein Befehl, mit dem sich der Upload später anhand der Import-ID nachholen lässt.

Ohne --dry-run zeigt die CLI dieselbe Zusammenfassung, fragt nach einer Bestätigung, lädt die Traces hoch und prüft anschließend über die Mastra Platform eine Stichprobe. Das Flag --yes überspringt die Bestätigung. Im Beispiel waren am Ende 6 Traces und 146 Spans importiert, ein Bericht wurde im lokalen Verzeichnis ~/.mastra/imports/traces gespeichert.

• --since und --until begrenzen den Import auf einen Zeitraum, angegeben als ISO-8601-Zeitstempel.
• --resume mit der Import-ID setzt einen unterbrochenen Import fort oder lädt einen zuvor mit --dry-run geprüften Import hoch.

Was das für Teams bedeutet

Für Teams, die bereits Langfuse nutzen, räumt die Funktion ein Hindernis beim Ausprobieren der Mastra Platform aus dem Weg: Ältere Traces müssen nicht mehr in einem separaten Tool verbleiben. Datumsfilter und fortsetzbare Uploads erlauben es, die Historie schrittweise zu übertragen. Da Scores, Feedback, Datasets, Anhänge und Logs nicht übernommen werden, müssen Teams, die darauf angewiesen sind, diese weiterhin in Langfuse vorhalten. Welche Anbieter nach Langfuse folgen, hat Mastra nicht mitgeteilt.