Saada Autonomy käivituste jäljed Datadog APM-i, leia läbikukkunud sammud ja võrdle neid oma rakenduse jälgedega.

Autonomy saadab käivituste jäljed Datadogi selle OTLP/HTTP jälgede vastuvõtu kaudu. Igast käivitusest saab autonomy.run span, millel on iga sammu kohta üks autonomy.step span. Seadista see lehel Organization → Integrations → OpenTelemetry. Spanide sisu kohta vaata OpenTelemetry eksport.

Enne alustamist

Vajalikud õigused

Organisatsiooni omaniku või administraatori õigused Autonomys.
Datadogi organisatsioon, kus APM-andmete vastuvõtt on sisse lülitatud, ja juurdepääs selle Trace Explorerile.
Datadogi API-võti, mis on loodud selle Datadogi organisatsiooni lehel Organization Settings → API Keys.
Sinu Datadogi sait, mille tunned ära aadressist, kus sisse logid.

Mandaat on Datadogi API-võti. Datadogi rakendusevõtmed ja Autonomy aut_ võtmed ei tööta. Pane see väljale Headers, kus Autonomy salvestab selle saladusena ega näita seda enam kunagi.

Vali oma Datadogi otspunkt

Sisesta väljale OTLP endpoint oma Datadogi saidi baas-URL. Autonomy lisab /v1/traces ja saadab JSON-i üle HTTPS-i, mida Datadog aktsepteerib.

Datadogi sait	Sisselogimise aadress	OTLP-otspunkt
US1	`app.datadoghq.com`	`https://otlp.datadoghq.com`
US3	`us3.datadoghq.com`	`https://otlp.us3.datadoghq.com`
US5	`us5.datadoghq.com`	`https://otlp.us5.datadoghq.com`
EU	`app.datadoghq.eu`	`https://otlp.datadoghq.eu`
AP1	`ap1.datadoghq.com`	`https://otlp.ap1.datadoghq.com`
AP2	`ap2.datadoghq.com`	`https://otlp.ap2.datadoghq.com`
UK1	`uk1.datadoghq.com`	`https://otlp.uk1.datadoghq.com`
US1-FED	`app.ddog-gov.com`	`https://otlp.ddog-gov.com`
US2-FED	`us2.ddog-gov.com`	`https://otlp.us2.ddog-gov.com`

Need järgivad Datadogi OTLP jälgede vastuvõtu saidivalijat. Ühe saidi võti ei tööta teise saidi vastuvõtus.

Ühenda ja kontrolli

Ava Organization → Integrations → OpenTelemetry ja vali väljal Vendor Datadog.
Kleebi oma saidi baas-URL väljale OTLP endpoint. Sisesta see ka siis, kui kohatäide näitab juba õiget aadressi.
Sisesta väljale Headers järgmine rida, asendades YOUR_DATADOG_API_KEY oma API-võtmega:
```
dd-api-key=YOUR_DATADOG_API_KEY
```
Klõpsa Send test span. Õnnestunud vastus tähendab, et Datadog võttis päringu vastu; spani otsitavaks muutumine võib võtta hetke.
Ava Datadogis APM → Trace Explorer, vali hiljutine ajavahemik ja otsi service:autonomy-runner-labs. Leia autonomy.test_connection span.
Lülita sisse Trace export ja klõpsa Save settings. Alusta uus käivitus.
Kui käivitus lõpeb, otsi seda. Asenda RUN_ID ID-ga, mis on Autonomys käivituse aadressi lõpus:

service:autonomy-runner-labs @test.run_id:"RUN_ID"

Datadogi APM-i jälgede mõõdikute jaoks lisa väljale Headers ,compute_stats=true. Muidu Datadog otse vastu võetud jälgede jaoks neid ei arvuta. Päiste muutmisel või roteerimisel salvesta kogu väärtus koos dd-api-key osaga.

Leia läbikukkunud samm

Otsi läbikukkunud samme:

service:autonomy-runner-labs status:error @test.status:failed @test.step_index:*

Piira otsing ühe projektiga, lisades @autonomy.project_name:"Storefront".

Läbikukkunud autonomy.step spanil on vea olek. Selle test.step_target on sammu oodatud tulemus, nagu see on testjuhtumisse kirjutatud, ja autonomy.diagnosis.category ütleb, kui see on olemas, miks samm ei läbinud. Testjuhtumi nimi (test.plan_name) on käivituse spanil.

Igal spanil on autonomy.run_url. Ava see, et näha käivitust Autonomys, sealhulgas agendi tegevusi (Step Actions) ja lõppkontrolli (Final check): need üksikasjad jäävad Autonomysse ja neid ei ekspordita. AI-mudeli üksikasju, viipasid, ekraanipilte ja toorveateateid ei saadeta kunagi Datadogi.

Datadog võib näidata spanide nimesid oma operatsiooni- ja ressursiväljadena. Täpsuse huvides filtreeri ülaltoodud atribuutide järgi. Vaata Datadogi jälgede otsingu süntaksit.

Võrdle rakenduse jäljega

Igal käivitusel on oma jälje ID. Autonomy ei anna seda ID-d ega traceparent päist sinu rakendusele edasi, seega on käivituse jälg ja sinu rakenduse päringute jäljed eraldi. Käivituse ID järgi otsing sinu rakenduse päringuid ei leia.

Instrumenteeri oma rakendus ja selle taustsüsteem nii, et need saadaksid Datadogi oma jäljed koos teenuse, keskkonna ja päringu ressursiga. Päringu- või tellimuse ID-d aitavad vastet kitsendada.
Pane läbikukkunud sammu juures kirja selle ajavahemik ja oodatud tulemus. Ava autonomy.run_url ja otsi käivituse tõenditest päringu ID-d või muud identifikaatorit, mida sinu rakendus näitab.
Otsi teisel Trace Exploreri vahekaardil samas ajavahemikus oma rakenduse teenust ja keskkonda ning kitsenda seejärel ressursi või päringu ID järgi. Kohanda seda oma rakenduse siltidega:
```
service:checkout-api env:production resource_name:"POST /orders"
```
Enne selle päringu süüdistamist kontrolli, et identifikaatorid ja ajastus klapivad. Kui käivitus testis eelvaadet, otsi eelvaate keskkonnast: samal ajal tehtud production-päring pole iseenesest vaste.

See käib käsitsi. Ilma rakenduse jälgede või käivituse tõendites oleva identifikaatorita pole võimalik üht päringut välja valida.

Tõrkeotsing

401 või 403: kontrolli Datadogi saiti ja API-võtit. Kasuta dd-api-key, mitte rakendusevõtit ega Autonomy võtit.
404: kopeeri baas-URL tabelist. Päringu tee peab lõppema kujul /v1/traces.
Testspan jõuab kohale, kuid käivituste spanid mitte: kontrolli, et Trace export on sees ja salvestatud ning et käivitus algas pärast seda.
Spanid kaovad otsingutest: kontrolli ajavahemikku ja Datadogi jälgede säilitamise seadeid. Vastu võetud eksport ei ole alati hilisemateks otsinguteks indekseeritud.
Käivitus läbis Datadogi katkestuse ajal: eksport ei muuda kunagi käivituse tulemust. Kasuta CI tingimuseks Autonomy tulemust, mitte jälge.

Oma runnerite ja mandaatide eemaldamise kohta vaata OpenTelemetry eksport.

Datadog