Metrics API-t indított a Mastra a tokenhasználat és költségek követésére
A Mastra új Metrics API-ja részletes lekérdezéseket kínál a tokenhasználatról, a modellköltségekről, a késleltetésről és a hibaarányokról. Az adatokból egyedi jelentések, irányítópultok és automatikus riasztások is készíthetők.
- A Metrics API tokenhasználati, költség-, késleltetési és hibaarány-adatokat kérdez le.
- Az adatok SDK-n, Mastra CLI-n vagy observability végpontokon keresztül érhetők el.
- A lekérdezések összesítéseket, bontásokat, idősorokat és percentiliseket adhatnak vissza.
- Egyedi jelentések, irányítópultok és automatikus csevegőplatformos riasztások készíthetők.
- A használathoz platform-hozzáférési token és projektazonosító szükséges.
A futások összesített adatait kérdezhetik le
A Mastra 2026. október 13-án jelentette be a Metrics API-t a platformjához. A szolgáltatás a production Mastra-projektek adataiból képes összesítéseket, bontásokat, idősorokat és percentilisadatokat visszaadni. A lekérdezések a Mastra Client SDK-n, a Mastra CLI-n vagy az observability végpontokon keresztül indíthatók.
A Mastra különbséget tesz a trace-ek és a metrikák között. A trace egyetlen futás eseményeit mutatja meg, a metrikák viszont az összes futáson keresztül aggregálják az adatokat. Így megvizsgálható, hogy melyik modell, beszélgetés vagy eszközhívás kerül a legtöbbe, melyik fut a leglassabban, illetve melyik hibásodik meg a leggyakrabban.
A lekérdezések kombinálhatók időtartományokkal és állapotszűrőkkel is. Ez lehetővé teszi, hogy a csapatok célzottan emeljék ki a fontos változásokat és eredményeket.
Egyedi jelentések és riasztások készülhetnek
A Mastra szerint a metrikák az év eleje óta megtekinthetők voltak a platformon és a Studio felületén. A Metrics API ehhez képest saját lekérdezések összeállítását teszi lehetővé. A fejlesztők egyedi jelentéseket hozhatnak létre, irányítópultokat építhetnek, vagy továbbíthatják az adatokat más szolgáltatásokba.
A rendszer arra is használható, hogy riasztást küldjön csatlakoztatott csevegőplatformokra, amikor emelkedik a modellek költsége vagy a hibák aránya. A Metrics API a code mode funkcióval együtt olyan ügynökök építését is támogatja, amelyek menet közben állítják össze a saját lekérdezéseiket. Ezek az ügynökök kérdésekre válaszolhatnak, összefoglalhatják a metrikákból kirajzolódó eredményeket, vagy PDF-dokumentumokat készíthetnek a csapattagok és az érintettek számára.
SDK-val, parancssorból vagy HTTP-kéréssel használható
A metrikalekérdezésekhez platform-hozzáférési tokenre és a projekt azonosítójára van szükség, ezeket minden kérésben meg kell adni. A megfelelő observability alapcímet a projekt régiója határozza meg. Az Egyesült Államokhoz a https://observability.mastra.ai, az Európai Unióhoz a https://observability.eu.mastra.ai cím tartozik.
A Client SDK használatához a Mastra a @mastra/[email protected] vagy újabb verziót írja elő. A parancssoros használathoz a [email protected] vagy frissebb CLI-verzió szükséges. A lekérdezések JSON-formátumban érkeznek vissza. A bemutatott példa az elmúlt 30 nap tokenfelhasználását és becsült költségét összesíti, valamint az előző időszakkal is összehasonlítja.
A válaszban szerepelhet többek között az összesített érték, a becsült költség, a pénznem, az előző időszak értéke és a százalékos változás. Ha a kezdő- és záróidőpontot nem adják meg, a lekérdezés az összes elérhető adatot visszaadja.
Költség, teljesítmény és hibák egy helyen
A példák között szerepel a költség tokenfajtánkénti vizsgálata. A gyorsítótárba írt tokenek, a gyorsítótárból olvasott tokenek és a kimeneti tokenek eltérő árazásúak, ezért külön is lekérdezhetők. A tokenfelhasználás beszélgetésenként a threadId, modellenként a model, ügynök vagy munkafolyamat szerint pedig a rootEntityName alapján csoportosítható.
Idősoros lekérdezéssel a napi tokenhasználat követhető. A futási idők esetében a rendszer napi bontásban a p50 és p95 percentiliseket is meg tudja adni. A hibás futások számlálásához az állapotcímkénél az error érték szűrhető.
Ez a fejlesztők számára közvetlenebb ellenőrzést ad a Mastra-projektek működéséről. A platform beépített nézetei mellett saját riportokat, figyelmeztetéseket és csapatszintű elemzéseket készíthetnek ugyanazokból a költség-, sebesség- és hibaarány-adatokból.
