Claude API ja Managed Agents jäljed beetaversioonis

Anthropic avas 14. oktoobril 2026 avalikus beetaversioonis OpenTelemetry jälgede ekspordi Claude’i Messages API ja Managed Agents jaoks. Mudelipäringute, agendi töövoorude ja API käivitatud tööriistade sammud saab saata ettevõtte enda seiresüsteemi. Seal on näha nende kestus, olek ja tokenikasutus.

Olemasoleva rakenduse jäljega ühendamiseks tuleb Claude Console’is määrata API jälgede sihtkoht ning anda päringuga edasi aktiivne jäljekontekst. Claude SDK lisab oma päringute ja rakenduses käivitatud tööriistade span’id; koos API span’idega moodustavad need sama tehingu sündmuste ahela. Seega saab eristada, kas viivitus tekkis rakenduses, mudelikutsel või tööriista kasutamisel.

API eksport vajab oma sihtkohta

Claude API seadistusjuhend kirjeldab Console’i sihtkohta kui OTLP/HTTP vastuvõtupunkti koos autentimisandmetega. Vastuvõtupunkt peab kasutama HTTPS-i pordil 443 ja protobuf-vormingut. Organisatsiooni administraator saab valida, kas sihtkoht hõlmab kõiki töökeskkondi, üksnes valituid või kõiki peale valitute. Kui ettevõte kasutab oma OpenTelemetry Collectorit selle tavapordil, on API ekspordi jaoks vaja sobivat HTTPS-vastuvõttu või selle ette puhverserverit.

Console’i sihtkoht puudutab Claude Platformilt tulevaid span’e. SDK loob kliendipoolsed span’id rakenduse protsessis ning need saadab edasi rakenduse enda OpenTelemetry eksportija. Mõlemad eksporditeed tuleb suunata samasse seireplatvormi, kui soovitakse näha kogu ahelat ühe jäljena. Ainult Console’i sihtkoha lisamisel ilmuvad API sammud küll seiresse, kuid vaikimisi eraldi jälgedena.

Sihtkoha seadetes saab saata testspan’i ja vaadata selle saabumist seireplatvormis. See eristab ühenduse viga olukorrast, kus päringule ei loodud jälge. API poolelt saab päringuid leida teenusenime claude-platform järgi; see on kasulik siis, kui sama vastuvõtupunkt kogub juba teiste rakenduste telemeetriat.

Üks tehingujälg näitab, kes tööriista käivitas

Kui Claude SDK kutse tehakse rakenduse aktiivse span’i sees, annab SDK W3C traceparent-päisega konteksti API-le edasi. API päringuspan asub siis SDK päringuspan’i all ning mõlemad rakenduse tehinguspan’i all. Ilma edasi antud kontekstita tekib API poolel omaette jälg, mida ei saa sama kasutajatehingu külge span’ide sugulussuhtena paigutada. Muu HTTP-kliendi korral võib aktiivse konteksti päisesse lisada rakendus ise.

Messages API päringus võib mudelikäigu kõrval olla API enda käivitatud serveritööriista või MCP-ühenduse tööriista span. Claude SDK tööriistakäitaja kaudu rakenduse koodis käivitatud tööriistale tekib seevastu kliendipoolne span. Fixteri tehniline ülevaade näitab nende vahet Managed Agents seansi näitel: API töövooru mudeli- ja tööriistasammude kõrval paikneb rakenduse enda tööriist eraldi SDK span’ina.

Tinglikus teenuses algab jälg kasutaja päringu vastuvõtust, jätkub SDK sõnumikutsena ja selle all API mudelipäringuna. Kui mudel kasutab API serveritööriista, paikneb selle kasutus API poolel. Kui mudel küsib tööriista, mille kood töötab teenuses, ilmub selle täitmine SDK tööriistakäitaja juures. Sama ajatelg näitab siis nii välise mudelikutse kui ka kohaliku tööriista kestust, ilma et neid peaks üksnes logiridade järgi kokku sobitama.

Managed Agents puhul annab töövooru span täiendava piiri: selle sees on näha mudelipäringud ja API käivitatud tööriistad. MCP-server võib jätkata sama jälge, kui ühendus annab konteksti serverile edasi ja server ise loob span’e. Nii jääb tööriista aeg nähtavaks ka siis, kui töö toimub väljaspool Claude’i põhiteenust. Kui traceparent-päise sampled-lipp on välja lülitatud, ei väljasta API selle päringu ega selle alamsammude span’e.

Sisurežiim määrab, mis ettevõtte seiresse jõuab

Vaikimisi kasutatav Metadata only sisaldab tunnuseid, ajastust, olekut ja tokenite arvu ning jätab mudeli sisendi ja vastuse välja. See ei tähenda täiesti tekstivaba jälge: arendaja antud agendi ja tööriista nimed või kirjeldused ning MCP-serveri nimed võivad endiselt väljuda. Kui nendes väljades on kliendinimi, sisemine projektitähis või saladus, jõuab see ka seiresüsteemi.

Full content lisab mudeli sisendid ja vastused, sealhulgas vestluse ning tööriistade argumendid ja tulemused. Selline jälg võib aidata konkreetset tõrget mõista, kuid sisaldab potentsiaalselt kasutaja teksti ja teenuse tagastatud andmeid. Pärast eksporti kehtivad andmetele valitud seireplatvormi ligipääsu- ja säilitustingimused. Seetõttu on sisurežiim andmevalik, mitte pelgalt kuvatava detaili hulk.

API sihtkohal ja SDK kliendil on sisurežiim eraldi. Mõlema poole seadistus peab vastama sellele, kas seires on vaja ainult kestust ja olekut või ka päringu sisu. Ettevaatlik valik on hoida tootmiskeskkonnas sisend, vastus, tööriista argumendid ja tulemus ekspordist väljas ning kasutada isikuandmeteta nimesid ja tunnuseid. Ka vestluse identifikaatorisse ei tasu panna e-posti aadressi või muud äratuntavat teksti, sest see kuulub metaandmete hulka.

Jälg selgitab viivitust, kuid vajab õiget arvestust

Span’ide kestus ja olek võimaldavad eristada aeglast mudelipäringut, pikale veninud tööriistakutset ning töövoorude vahele jäävat rakenduse tegevust. Kui vastus saabub pärast mitut sammu, näitab ühine jälg nende järjekorda. See on täpsem tõrke asukoha määramiseks kui üksnes kogu päringu kestus, kuid nähtav on ainult valitud ja kohale jõudnud telemeetria.

Tokenikasutust ei saa kõigi span’ide peale liita. Ühel Messages API päringul võivad nii SDK kliendispan kui ka API serverispan kanda sama kasutusinfot; API päringu ja selle mudelialamsammude arvud võivad samuti kattuda. Arvestuses tuleb valida üks tase. Lisaks võib API sihtkoht korduskatse tõttu sama span’i mitu korda saata või span võib enne kohaletoimetamist kaduda. Duplikaadi eristamiseks sobivad jälje ja span’i tunnus, täieliku kasutusarvestuse jaoks eraldi kasutusandmed.

Beetaversiooni vahetu mõju on seega nähtav ühe konkreetse tehingu juures: teenuse, Claude’i mudelikäigu ja tööriista käivitamise ajad saab paigutada ühisele ajateljele. Selle väärtus sõltub aga kahest tehnilisest piirist, mis jäävad tiimi enda määrata: kas jäljekontekst liigub kogu ahelas kaasa ning kas eksporditavad atribuudid sobivad ettevõtte andmekaitsenõuetega.

Loe ka: