A Mastra már külső megfigyelési szolgáltatások nyomait is importálja
A Mastra Platform új trace-importálási funkciójával külső megfigyelési szolgáltatásokban tárolt nyomkövetési adatokat lehet a Mastra projektjeibe átemelni. Az első támogatott szolgáltatás a Langfuse, a Mastra szerint további integrációk is érkeznek.
- A Mastra Platform külső szolgáltatásokból is képes trace-eket importálni.
- Az első támogatott szolgáltatás a Langfuse.
- Megmaradnak a span-típusok, a kapcsolatok, az időbélyegek, a bemenetek és a kimenetek.
- A pontszámok, visszajelzések, adatkészletek, csatolmányok és naplók nem kerülnek át.
- Az import a Mastra CLI-ből, előnézettel és megadott dátumtartománnyal indítható.
A korábbi trace-ek is elérhetők maradnak
A Mastra október 14-i bejelentése szerint az importált trace-ek a Mastra által létrehozott nyomok mellett jelennek meg a Mastra Platformon és a telepített Studióban. A felhasználók így ugyanazon a felületen hibakereshetik, szűrhetik és összehasonlíthatják a trace-előzményeket, anélkül hogy különböző eszközök között kellene váltaniuk.
A funkció azoknak lehet fontos, akik megfigyelési szolgáltatót váltanak. Ilyenkor a korábbi szolgáltatónál tárolt trace-előzmények eddig hátramaradtak. A trace-importálással a Mastra Platformra történő átálláskor ezek az adatok is átvihetők.
A részletek megmaradnak, de vannak korlátok
A Mastra korábbi működésében a megfigyelési adatok csak külső szolgáltatókba voltak exportálhatók. Az új funkció lehetővé teszi az adatok visszahozását, miközben több fontos részlet megmarad. Az importált adatokban változatlanul elérhetők az olyan span-típusok, mint az agent_run, a model_generation és a tool_call.
Az import megőrzi a szülő-gyermek kapcsolatokat, az időbélyegeket, a bemeneteket, a kimeneteket, valamint a használati és költségadatokat is. A Mastra közlése szerint csak a trace-megfigyelések kerülnek át. A pontszámok, a visszajelzések, az adatkészletek, a csatolmányok és a naplók kimaradnak.
Az induláskor a Langfuse támogatott. A Mastra további szolgáltatók támogatását ígéri, konkrét szolgáltatásokat vagy ütemezést azonban nem nevezett meg.
Parancssorból indítható az import
A használathoz frissíteni kell a Mastra CLI-t és a @mastra/core csomagot. A funkcióhoz legalább a [email protected] és a @mastra/[email protected] verzió szükséges. A fejlesztők a funkciót a #24145 és a #26779 pull requestben adták hozzá.
Az import egy Mastra Platformra telepített projektet céloz. A projekt hozzáférési tokenjét és azonosítóját a környezeti változók között kell megadni, Langfuse esetén pedig a nyilvános és titkos API-kulcsot, valamint a Langfuse végpontját is be kell állítani. A LANGFUSE_BASE_URL alapértelmezésben az EU-régióra mutat, de megadható az amerikai régió vagy egy saját üzemeltetésű URL is.
Az import először a --dry-run kapcsolóval próbálható ki. A Mastra CLI ilyenkor megmutatja a forrást és a célprojektet, az időablakot, az előkészített trace-ek és spanek számát, valamint a kihagyott elemeket. A tényleges feltöltéshez el kell hagyni ezt a kapcsolót, vagy a --resume opcióval lehet folytatni egy korábban előkészített importot.
A dátumtartomány a --since és --until kapcsolókkal adható meg ISO 8601 formátumban. A CLI a feltöltés után mintát ellenőriz a Mastra Platformon, majd jelentést készít az import eredményéről.
