Anthropic lisää OpenTelemetry-jälkien viennin Claude Platformiin

Anthropic on lisännyt OpenTelemetry-jälkien viennin Claude Platformiin. Yhtiö ilmoitti 14. lokakuuta 2026, että kehittäjät voivat nyt lähettää Claude Managed Agents -agenttien, Messages API:n ja Claude SDK:iden jälkiä mihin tahansa standardia tukevaan havainnointityökaluun. Ominaisuus on saatavilla julkisena beetaversiona.

Anthropicin ilmoituksessa yhtiö kertoi, että kohteen lisääminen Claude Consoleen lähettää jokaisen agentin vuoron, mallikutsun ja työkalun käytön käyttäjän havainnointityökaluun tavanomaisena OpenTelemetry-jälkenä, joka sisältää viiveen, tokenien määrän ja tunnisteet. Managed Agents ja Messages API edellyttävät tällaisen kohteen lisäämistä Consoleen, kun taas Claude SDK:t vievät jäljet automaattisesti. Kehittäjät, jotka lähettävät jo Claude Code- tai Cowork-jälkiä havainnointityökaluun, voivat tarkastella Claude Platformille rakennettuja agentteja samassa paikassa.

Anthropicin mukaan Claude-jäljissä noudatetaan OpenTelemetry GenAI -semanttisia käytäntöjä, joten Clauden ja muiden palveluntarjoajien tiedot toimivat samoissa työkaluissa ja koontinäytöissä. Jäljet toimivat myös minkä tahansa OpenTelemetry-työkalun kanssa, joka hyväksyy standardinmukaisen OTLP-päätepisteen.

Kaksi määritystapaa ja yksi jälkimalli

Claude Platformin dokumentaatiossa jälki määritellään kattavaksi tallenteeksi järjestelmän läpi kulkevasta yksittäisestä pyynnöstä ja span yhdeksi jäljen vaiheeksi, kuten mallipyynnöksi tai työkalun käytöksi. Dokumentaatiossa esitellään kaksi määritystapaa. SDK-jäljitys määritetään koodissa asentamalla SDK ja rekisteröimällä jäljityksen tarjoaja, eikä se edellytä erityisiä käyttöoikeuksia. API-jäljitys määritetään lisäämällä kohde Claude Consoleen, ja siihen tarvitaan järjestelmänvalvojan oikeudet.

Jäljityksen kattavuus vaihtelee näiden kahden tavan välillä. API-jäljitys tallentaa jokaisen pyynnön mallisuorituksen, Managed Agents -agenttien vuorot sekä API:n suorittamat palvelinpuolen työkalut. SDK-jäljitys lisää mukaan työkalusuorittimen suorittamat asiakaspuolen työkalut, itse ylläpidetyn hiekkalaatikon työkalut sekä muut API-pyynnöt, kuten tiedostojen lataukset. Kun molemmat tavat otetaan käyttöön, pyynnön SDK- ja API-spanit sijoittuvat samaan jälkeen. AWS:n Claude Platformiin suuntautuvien pyyntöjen API-spanit näkyvät sen sijaan omissa jäljissään.

Managed Agentsissa istunto tuottaa spanin jokaisesta Sessions API -pyynnöstä ja vuorospanin jokaisesta agentin vuorosta. Kukin vuoro sisältää spanit jokaisesta mallipyynnöstä, jokaisesta API:n suorittamasta työkalusta ja jokaisesta tuloksen arvioinnista. Dokumentaatiossa Claude Code-, Agent SDK- ja Cowork-käyttäjät ohjataan tutustumaan näiden tuotteiden erillisiin valvonta- ja havainnointidokumentaatioihin.

Sisältötilat, rajoitukset ja vaatimustenmukaisuus

Jokaiselle kohteelle ja SDK-asiakasohjelmalle voi määrittää sisältötilan, joka ratkaisee, sisällytetäänkö spaneihin mallikehotteet ja vastaukset. Oletustila, vain metatiedot, tallentaa tunnisteet, ajoitustiedot, tilan, tokenien määrän sekä käyttäjän valitseman tekstin, kuten agenttien ja työkalujen nimet ja kuvaukset sekä MCP-palvelinten nimet. Täysi sisältö sisältää lisäksi mallikehotteet ja vastaukset.

Täyden sisällön tilassa kuhunkin spaniin mahtuu oletusarvoisesti enintään 0,75 megatavua sisältöä. Dokumentaation mukaan tämä riittää 200 000 tokenin englanninkieliseen konteksti-ikkunaan ja jää alle monien havainnointialustojen ja välityspalvelinten 1 megatavun pyyntörajan. Kokonainen miljoonan tokenin konteksti-ikkuna vaatii noin 4 megatavua. Jos sisältö ylittää rajan, SDK tai API lyhentää sitä ja asettaa anthropic.content.truncated-määritteen arvoksi true. Pyyntöjen spaneista poistetaan ensin järjestelmäkehote ja vanhimmat viestit, ja kuvat sekä asiakirjat esitetään vain tyyppinsä mukaisesti.

Organisaatioissa, joita koskee HIPAA-, FERPA- tai K–12-tietojenkäsittelyrajoitus Anthropicin kanssa, vientikohteisiin viedään vain metatiedot valitusta sisältötilasta riippumatta, mutta rajoitus ei vaikuta SDK-spanien sisältöön. Tietojen nollasäilytyksen yhteydessä täyttä sisältöä voi edelleen käyttää, koska API säilyttää vietävää sisältöä vain muistissa siihen asti, että se toimittaa sen kohteeseen. Claude Managed Agents ei sovellu käytettäväksi tietojen nollasäilytyksen kanssa, eivätkä sen säilytysehdot muutu OpenTelemetryn käytön myötä.

Tokenien laskentaa koskevissa ohjeissa käyttäjiä neuvotaan laskemaan kukin token vain kerran summaamalla kustakin pyynnöstä spanit vain yhdestä lähteestä. Jos pyynnössä on sekä SDK- että API-spaneja, tulee käyttää API-spaneja. Ohjeissa huomautetaan myös, että spanit voivat saapua useammin kuin kerran, jos toimitusta yritetään uudelleen.

Nimetyt integraatiot ja varhaisten asiakkaiden kommentit

Ilmoituksessa tuetut havainnointialustat ryhmitellään käyttötarkoituksen mukaan. Ohjelmistopinon muun toiminnan rinnalla tapahtuvaan agenttien virheiden selvittämiseen mainitaan Grafana Cloud, Honeycomb, Sentry ja Splunk. Niissä agenttien jäljet näkyvät lokien ja metriikoiden rinnalla, joten kehittäjät näkevät, mistä palvelusta hidas tai epäonnistunut vaihe johtuu. Tuotantodatan avulla tapahtuvaan agenttien kehittämiseen mainitaan Arize AI, Braintrust, Datadog, Langfuse, LangSmith by LangChain, New Relic ja PostHog. Käyttötapoihin kuuluvat esimerkiksi todellisten jälkien muuntaminen arvioinneiksi ja laatuongelmien havaitseminen. Organisaation käytön seurantaan mainitaan Databricks Unity Gateway, jonka avulla alusta- ja tietoturvatiimit voivat tarkastella tokenien käyttöä tiimeittäin ja havaita poikkeavaa toimintaa.

Useat varhaiset asiakkaat kuvailivat käyttöönottojaan ilmoituksessa. Foxgloven perustaja ja teknologiajohtaja Roman Shtylman kertoi, että yhtiö rakentaa agentteja, jotka auttavat robotiikkatiimejä selvittämään robottien vikoja. Hän lisäsi, että Claude Platformin natiivi OpenTelemetry-vienti mahdollistaa agenttien vuorovaikutuksen analysoinnin PostHogissa tuotteen käyttötietojen rinnalla, jolloin yhtiö voi arvioida agenttien toimintaa käytännössä ja priorisoida robotiikkatiimeille tehtäviä parannuksia.

Rampin vanhempi ohjelmistosuunnittelija David Traina kertoi, että yritys rakensi Reflectin, agenttipohjaisen järjestelmän, joka pisteyttää Langfuse-jälkiä, tunnistaa toistuvia virheitä ja ehdottaa korjauksia. ”Joidenkin agenttien tokenien käyttöä on saatu vähennettyä 10–20 % ja istunnot ovat nopeutuneet 30 %”, Traina sanoi. Hän lisäsi, että Claude API:n natiivi OpenTelemetry-vienti voi syöttää instrumentointitiedot suoraan tähän kehityssilmukkaan ilman lisätoimia.

Sterling Labsin teknologiajohtaja Hyon Lee kertoi, että natiivi vienti siirtää kaikki jäljet Langfuseen ilman mukautettua instrumentointia yrityksen agenteille, jotka analysoivat reaaliaikaisia markkinoita. FloQastin infrastruktuurista vastaava johtaja Ankush Sharma kertoi, että kirjanpito-ohjelmistoyrityksen agentit toimivat Claude-alustalla ja niiden telemetriatiedot ovat Grafana Cloudissa. Näin kunkin mallikutsun sisältävä jälki sisältää myös sen täsmäytys- tai kirjausvientityönkulun jäljen, jonka osana kutsu suoritettiin. Tämän ansiosta yritys voi vastata tilintarkastajien kysymyksiin siitä, mitä agentti teki, yhdestä aikajanasta.