Exportez une trace pour chaque exécution, avec un span par étape, vers votre backend OTLP.

Autonomy peut exporter chaque exécution sous forme de trace OpenTelemetry vers le backend que votre équipe utilise déjà : Datadog, Grafana, Honeycomb ou n'importe quel endpoint OTLP. Les étapes échouées portent un statut d'erreur : elles apparaissent donc dans les mêmes vues de traces, tableaux de bord et alertes que le trafic de votre application.

Ce qu'il fait

Exporte une trace par exécution : un span autonomy.run avec un enfant autonomy.step par étape.
Marque les exécutions échouées et les étapes échouées avec un statut d'erreur OTLP.
Ajoute sur chaque span un lien vers l'exécution dans Autonomy.
Associe chaque span à son projet, pour que vous puissiez filtrer les exécutions d'un projet.
Transmet pour vous les paramètres aux runners hébergés. Configurez-le une fois ; rien ne change sur le runner.
Ne ralentit jamais une exécution : si votre endpoint est lent ou indisponible, l'exécution continue et rien n'est retenté.

Les spans

Span	Un par	Statut
`autonomy.run`	Exécution	Erreur quand le résultat de l'exécution est Failed.
`autonomy.step`	Étape du cas de test	Erreur quand l'étape a échoué.

Un span d'étape couvre toute l'étape, de la première action de l'agent jusqu'à la Final check. Les actions individuelles de l'agent ne sont pas exportées sous forme de spans : elles se trouvent dans les Step Actions de l'exécution, dans Autonomy.

Ce qui est exporté

Les spans ne portent qu'un ensemble autorisé d'attributs :

Attribut	Sur	Contenu
`test.run_id`, `test.run_execution_id`	Exécution, étape	L'exécution.
`test.plan_id`, `test.plan_name`	Exécution	Le cas de test exécuté.
`test.platform`	Exécution, étape	`web`, `ios`, `android` ou `api`.
`test.status`	Exécution, étape	Étape : `passed` ou `failed`. Exécution : `passed`, `failed`, `couldnt_start` ou `cancelled`.
`test.step_index`	Étape	La position de l'étape dans le cas de test.
`test.step_action`	Étape	Toujours `check`.
`test.step_target`	Étape	Le résultat attendu de l'étape, tel qu'il est rédigé dans le cas de test.
`autonomy.diagnosis.category`	Étape	Pourquoi une étape n'a pas réussi, sous forme de code de catégorie, quand il y en a un.
`autonomy.project_id`, `autonomy.project_name`	Exécution, étape	Le projet de l'exécution.
`autonomy.org_id`	Exécution	Votre organisation.
`autonomy.run_url`	Exécution, étape	Un lien vers l'exécution dans Autonomy.

Rien d'autre ne quitte Autonomy. Les détails du modèle d'IA, les coûts, les prompts, les noms d'outils, les captures d'écran, le contenu des pages et les messages d'erreur bruts ne sont jamais exportés. L'exportateur supprime tout attribut qui ne figure pas dans la liste.

Configuration

Avant de commencer

Un accès propriétaire ou administrateur de l'organisation dans Autonomy.
Un point d'ingestion de traces OTLP/HTTP sur une adresse HTTPS publique.
Un identifiant d'ingestion pour votre backend : une clé API, un jeton ou un en-tête d'authentification basique.

Ouvrez Organization → Integrations → OpenTelemetry.
Sous Trace export, choisissez votre Vendor : Datadog, Grafana, Honeycomb ou Generic. Cela préremplit la forme de l'endpoint et des en-têtes.
Saisissez l'OTLP endpoint. Autonomy ajoute lui-même /v1/traces. Il doit utiliser HTTPS.
Saisissez les Headers sous forme de paires key=value séparées par des virgules. Ils sont stockés comme secret et ne sont plus jamais affichés.
Cliquez sur Send test span. Autonomy envoie un span autonomy.test_connection et affiche le statut HTTP ainsi que le temps de réponse.
Retrouvez le span dans votre explorateur de traces sous le service autonomy-runner-labs. Activez ensuite Trace export et cliquez sur Save settings.

Les exécutions qui démarrent après l'enregistrement sont exportées.

Configuration par fournisseur

Datadog

Consultez Datadog pour l'endpoint de chaque site Datadog, l'en-tête de la clé API et les recherches d'étapes échouées.

Grafana Cloud (Tempo)

Endpoint : https://otlp-gateway-<region>.grafana.net/otlp, indiqué sur la page des détails OpenTelemetry de votre stack.
Headers : Authorization=Basic <base64 of instanceID:token>, avec un jeton autorisé à écrire des traces.
Où regarder : Explore avec la source de données Tempo, et la requête {resource.service.name="autonomy-runner-labs"}.

Honeycomb

Endpoint : https://api.honeycomb.io, ou https://api.eu1.honeycomb.io dans l'UE.
Headers : x-honeycomb-team=<your ingest key>. Sur Honeycomb Classic, ajoutez x-honeycomb-dataset=<dataset>.
Où regarder : le dataset autonomy-runner-labs. Essayez d'abord test.status = failed.

OTLP générique

Tout collecteur ou fournisseur qui accepte OTLP/HTTP avec JSON sur /v1/traces fonctionne, par exemple un OpenTelemetry Collector. Utilisez son URL de base sur un nom d'hôte HTTPS public, avec les en-têtes d'authentification qu'il attend.

Filtrer par projet

Chaque span porte autonomy.project_id et autonomy.project_name. Utilisez-les pour créer un tableau de bord ou une alerte par projet, par exemple les étapes échouées dont autonomy.project_name vaut Storefront.

Runners auto-hébergés

Les paramètres du tableau de bord atteignent aussi les runners auto-hébergés. Un runner auto-hébergé qui ne les reçoit pas peut exporter de lui-même grâce à des variables d'environnement sur la machine du runner :

Variable	Obligatoire	Signification
`AUTONOMY_OBSERVABILITY_EXPORT`	Oui	Définissez-la à `otel` pour activer l'export.
`OTEL_EXPORTER_OTLP_ENDPOINT`	Oui	L'endpoint OTLP de base. `/v1/traces` y est ajouté.
`OTEL_EXPORTER_OTLP_HEADERS`	Non	Des paires `key=value` séparées par des virgules, envoyées avec chaque export.
`OTEL_SERVICE_NAME`	Non	Le nom de service sur les spans. Par défaut : `autonomy-runner-labs`.

Voir Runners.

Modifier ou supprimer les identifiants

Les en-têtes sont en écriture seule. Pour les modifier, saisissez la nouvelle valeur et enregistrez ; elle remplace l'ancienne. Pour les supprimer, cliquez sur Clear stored headers. L'endpoint reste, mais les exports partent sans identifiants, ce que la plupart des backends refusent, jusqu'à ce que vous en enregistriez de nouveaux.

Dépannage

Send test span renvoie 401 ou 403

Votre backend a refusé l'identifiant. Vérifiez le nom de l'en-tête pour votre fournisseur (dd-api-key, Authorization, x-honeycomb-team) et que l'identifiant est autorisé à écrire des traces.

Send test span renvoie 404

Il n'y a pas de point d'ingestion de traces à cette adresse. Saisissez uniquement l'endpoint de base : Autonomy ajoute /v1/traces, et un chemin dupliqué en est la cause habituelle.

L'endpoint est refusé

Seuls les noms d'hôte HTTPS publics sont acceptés. Le HTTP simple, les adresses IP, localhost et les noms en .internal ou .local sont refusés. Pour un collecteur situé dans votre réseau, placez devant lui un point d'entrée HTTPS.

Le span de test arrive, mais les exécutions n'exportent rien

Vérifiez que Trace export est activé et enregistré, et que l'exécution a démarré après l'enregistrement. Les problèmes d'export ne modifient jamais une exécution : un identifiant erroné se traduit donc par des spans manquants, pas par des erreurs d'exécution. Renvoyez un span de test pour vérifier.

Export OpenTelemetry