Ekspordi iga käivituse kohta jälg, milles on iga sammu kohta üks span, oma OTLP-taustsüsteemi.

Autonomy saab eksportida iga käivituse OpenTelemetry jäljena taustsüsteemi, mida sinu meeskond juba kasutab: Datadogi, Grafanasse, Honeycombi või mis tahes OTLP-otspunkti. Läbikukkunud sammudel on vea olek, nii et need ilmuvad samades jäljevaadetes, töölaudadel ja hoiatustes nagu sinu rakenduse liiklus.

Mida see teeb

Ekspordib iga käivituse kohta ühe jälje: autonomy.run spani, millel on iga sammu kohta üks autonomy.step alamspan.
Märgib läbikukkunud käivitused ja sammud OTLP vea olekuga.
Lisab igale spanile lingi käivitusele Autonomys.
Märgistab iga spani selle projektiga, et saaksid filtreerida ühe projekti käivitusi.
Saadab seaded sinu eest majutatud runneritele. Seadista üks kord; runneris ei muutu midagi.
Ei aeglusta kunagi käivitust: kui sinu otspunkt on aeglane või maas, jätkab käivitus ja midagi uuesti ei proovita.

Spanid

Span	Üks iga	Olek
`autonomy.run`	käivituse kohta	Viga, kui käivituse tulemus on Failed.
`autonomy.step`	testjuhtumi sammu kohta	Viga, kui samm kukkus läbi.

Sammu span hõlmab kogu sammu, agendi esimesest tegevusest kuni lõppkontrollini (Final check). Agendi üksikuid tegevusi spanidena ei ekspordita: need on Autonomys käivituse vaates Step Actions.

Mida eksporditakse

Spanidel on ainult lubatud loendis olevad atribuudid:

Atribuut	Kus	Sisu
`test.run_id`, `test.run_execution_id`	Käivitus, samm	Käivitus.
`test.plan_id`, `test.plan_name`	Käivitus	Testjuhtum, mis käivitus.
`test.platform`	Käivitus, samm	`web`, `ios`, `android` või `api`.
`test.status`	Käivitus, samm	Samm: `passed` või `failed`. Käivitus: `passed`, `failed`, `couldnt_start` või `cancelled`.
`test.step_index`	Samm	Sammu asukoht testjuhtumis.
`test.step_action`	Samm	Alati `check`.
`test.step_target`	Samm	Sammu oodatud tulemus, nagu see on testjuhtumisse kirjutatud.
`autonomy.diagnosis.category`	Samm	Kategooriakood selle kohta, miks samm ei läbinud, kui see on olemas.
`autonomy.project_id`, `autonomy.project_name`	Käivitus, samm	Käivituse projekt.
`autonomy.org_id`	Käivitus	Sinu organisatsioon.
`autonomy.run_url`	Käivitus, samm	Link käivitusele Autonomys.

Midagi muud Autonomyst ei lahku. AI-mudeli üksikasju, kulu, viipasid, tööriistade nimesid, ekraanipilte, lehe sisu ja toorveateateid ei ekspordita kunagi. Eksportija jätab välja iga atribuudi, mida loendis pole.

Seadistamine

Enne alustamist

Organisatsiooni omaniku või administraatori õigused Autonomys.
OTLP/HTTP jälgede vastuvõtt avalikul HTTPS-aadressil.
Sinu taustsüsteemi andmete vastuvõtu mandaat: API-võti, token või basic-auth päis.

Ava Organization → Integrations → OpenTelemetry.
Vali jaotises Trace export oma Vendor: Datadog, Grafana, Honeycomb või Generic. See täidab otspunkti ja päiste kuju.
Sisesta OTLP endpoint. Autonomy lisab /v1/traces ise. See peab kasutama HTTPS-i.
Sisesta Headers komadega eraldatud key=value paaridena. Need salvestatakse saladusena ja neid ei näidata enam kunagi.
Klõpsa Send test span. Autonomy saadab autonomy.test_connection spani ning näitab HTTP olekut ja kulunud aega.
Leia span oma jälgede uurijast teenuse autonomy-runner-labs alt. Seejärel lülita sisse Trace export ja klõpsa Save settings.

Eksporditakse käivitused, mis algavad pärast salvestamist.

Teenusepakkujate seadistamine

Datadog

Vaata lehelt Datadog iga Datadogi saidi otspunkti, API-võtme päist ja läbikukkunud sammude otsinguid.

Grafana Cloud (Tempo)

Otspunkt: https://otlp-gateway-<region>.grafana.net/otlp, sinu stack'i OpenTelemetry üksikasjade lehelt.
Päised: Authorization=Basic <base64 of instanceID:token>, tokeniga, mis saab jälgi kirjutada.
Kust vaadata: Explore koos Tempo andmeallikaga ja päring {resource.service.name="autonomy-runner-labs"}.

Honeycomb

Otspunkt: https://api.honeycomb.io või ELis https://api.eu1.honeycomb.io.
Päised: x-honeycomb-team=<your ingest key>. Honeycomb Classicus lisa x-honeycomb-dataset=<dataset>.
Kust vaadata: andmestik autonomy-runner-labs. Proovi esmalt test.status = failed.

Üldine OTLP

Sobib iga kollektor või teenusepakkuja, mis võtab aadressil /v1/traces vastu OTLP/HTTP-d JSON-iga, näiteks OpenTelemetry Collector. Kasuta selle baas-URL-i avalikul HTTPS-hostinimel ja neid autentimispäiseid, mida see ootab.

Filtreeri projekti järgi

Igal spanil on autonomy.project_id ja autonomy.project_name. Kasuta neid, et luua iga projekti jaoks oma töölaud või hoiatus, näiteks läbikukkunud sammud, kus autonomy.project_name on Storefront.

Oma runnerid

Töölaua seaded jõuavad ka sinu enda runneriteni. Oma runner, millel neid seadeid pole, saab eksportida iseseisvalt runneri masina keskkonnamuutujatega:

Muutuja	Kohustuslik	Tähendus
`AUTONOMY_OBSERVABILITY_EXPORT`	Jah	Ekspordi sisselülitamiseks sea väärtuseks `otel`.
`OTEL_EXPORTER_OTLP_ENDPOINT`	Jah	OTLP baasotspunkt. Lisatakse `/v1/traces`.
`OTEL_EXPORTER_OTLP_HEADERS`	Ei	Komadega eraldatud `key=value` paarid, mis saadetakse iga ekspordiga.
`OTEL_SERVICE_NAME`	Ei	Teenuse nimi spanidel. Vaikimisi `autonomy-runner-labs`.

Vaata Runnerid.

Mandaatide muutmine või eemaldamine

Päised on ainult kirjutatavad. Nende muutmiseks sisesta uus väärtus ja salvesta; see asendab vana. Eemaldamiseks klõpsa Clear stored headers. Otspunkt jääb alles, kuid ekspordid lähevad ilma mandaatideta, mille enamik taustsüsteeme tagasi lükkab, kuni salvestad uued.

Tõrkeotsing

Send test span tagastab 401 või 403

Sinu taustsüsteem lükkas mandaadi tagasi. Kontrolli oma teenusepakkuja päise nime (dd-api-key, Authorization, x-honeycomb-team) ja seda, et mandaat saab jälgi kirjutada.

Send test span tagastab 404

Sellel aadressil pole jälgede vastuvõttu. Sisesta ainult baasotspunkt: Autonomy lisab /v1/traces, nii et tavaliselt on põhjuseks topelt tee.

Otspunkt lükatakse tagasi

Aktsepteeritakse ainult avalikke HTTPS-hostinimesid. Tavaline HTTP, IP-aadressid, localhost ning .internal või .local nimed lükatakse tagasi. Kui kollektor on sinu sisevõrgus, pane selle ette HTTPS-ingress.

Testspan jõuab kohale, kuid käivitused ei ekspordi midagi

Kontrolli, et Trace export on sees ja salvestatud ning et käivitus algas pärast salvestamist. Ekspordiprobleemid ei muuda kunagi käivitust, seega annab vale mandaat end tunda puuduvate spanide, mitte käivituse vigadena. Kontrollimiseks saada uuesti testspan.

OpenTelemetry eksport