UiPath Documentation
test-cloud
latest
false
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Guide de l'administrateur de Test Cloud

Modèle de données d'exportation de données

L’exportation de données envoie des données dans deux formats selon la source de données sélectionnée:

  • Basé sur les événements — événements distincts émis lorsque quelque chose se produit dans UiPath (une tâche change d'état, un élément de la file d'attente est traité, une action d'audit est enregistrée). Livré à Azure Event Hub ou AWS SQS.
  • Traçage OTEL — étendues hiérarchiques représentant les traces d'exécution de l'agent et de Maestro au format OpenTelemetry. Livré à Arize, Databricks ou tout point de terminaison compatible OTLP.

Exportations basées sur les événements

Événements Orchestrator

Orchestrator génère des événements pour les tâches, les éléments de file d'attente, les machines et les journaux de robot. Chaque événement comprend une enveloppe commune et un corps spécifique à l'entité.

Champs communs

Tous les événements Orchestrator incluent les champs suivants:

ChampDescription
TypeÉvénementChaîne identifiant le type d’événement (par exemple, job.created, queueitem.added).
SchemaVersionIdentificateur de version de schéma.
HorodatageHorodatage UTC de l'événement.
TenantKeyIdentifiant du locataire.
NomLocataireNom complet du locataire.
FolderKeyIdentificateur de dossier.
NomDossierNom complet du dossier.
FullFolderPathChemin d’accès complet au dossier.
Job events

Date d'émission: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating

ChampSaisie de texteDescription
Clé (Key)GUIDIdentificateur de tâche unique.
Heure de créationHorodatageHeure de création de la tâche.
StartTimeHorodatageHeure de début de l'exécution.
EndTimeHorodatageHeure de fin de l'exécution.
État (State)Chaîne de caractères (string)Statut de la tâche: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed.
ProcessNameChaîne de caractères (string)Nom du package source.
DisplayNameChaîne de caractères (string)Nom affiché dans Orchestrator.
Nom du Robot (RobotName)Chaîne de caractères (string)Exécution de l'identifiant du robot.
Nom de la machine hôteChaîne de caractères (string)Nom de la machine d'exécution.
Queue item events

Date d'émission: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted

ChampSaisie de texteDescription
Clé (Key)GUIDIdentificateur d'élément de la file d'attente.
QueueDefinitionIdNumériqueID numérique de file d'attente.
État (Status)Chaîne de caractères (string)Statut de l'élément: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown.
État de révision (ReviewStatus)Chaîne de caractères (string)Classification de la revue: None, InReview, Verified, Retried, Unknown
Priorité (Priority)Chaîne de caractères (string)Priorité de l'élément: High, Normal, Low, Unknown.
DueDateDateTimeÉchéance de traitement.
Heure de créationDateTimeHorodatage de création.
Démarrer le traitement (StartProcessing)DateTimeHeure de début du traitement.
Terminer le traitement (EndProcessing)DateTimeHeure d'achèvement du traitement.
DeferDateDateTimeHeure de traitement disponible la plus ancienne.
SecondsInPreviousAttemptsNumériqueDurée de la tentative précédente en secondes.
Nombre de nouvelles tentatives (RetryNumber)NumériqueNombre de tentatives de traitement.
Progression (Progress)Chaîne de caractères (string)Progression du flux métier.
Données d'analyseChaîne de caractères (string)Paires clé-valeur de propriété d'analyse.
SortieChaîne de caractères (string)Données de sortie de l'activité Définir le statut de la transaction.
Données spécifiques (SpecificData)Chaîne de caractères (string)Données personnalisées de la propriété Contenu spécifique ou de l'activité Ajouter un élément de la file d'attente.
CreatorJobIdNumériqueCréation de l’identifiant de la tâche.
ExecutorJobIdNumériqueExécution de l'identifiant de la tâche.
ProcessExceptionReasonChaîne de caractères (string)Résumé de l’échec.
ProcessExceptionDetailsChaîne de caractères (string)Détails de l'échec.
ProcessExceptionTypeChaîne de caractères (string)Type d’erreur: ApplicationException, BusinessException, None.

L'objet Queue intégré dans chaque événement comprend: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.

Remarque :

SpecificData, SpecificContent et Output ne sont pas inclus dans les événements queueItem.deferred et queueItem.reviewStatusChanged .

Machine events

Date d'émission: machine.created, machine.updated, machine.deleted, machine.assign, machine.unassign

ChampSaisie de texteDescription
Id de la machineNumériqueID numérique de la machine.
MachineKeyGUIDIdentifiant de la machine.
Nom de machine (Machine Name)Chaîne de caractères (string)Nom personnalisé de la machine.
AutomationCloudSlotsNumériqueEmplacements de runtime réservés.
HeadlessSlotsNumériqueEmplacements en mode sans affichage.
NonProductionSlotsNumériqueEmplacements dans l'environnement de non-production.
UnattendedSlotsNumériqueEmplacements d'exécution non assistés.

Les événements de session machine (machineSession.status) incluent:

ChampSaisie de texteDescription
MachineKeyGUIDIdentifiant de la machine.
Nom de machine (Machine Name)Chaîne de caractères (string)Nom personnalisé de la machine.
Nom de la machine hôteChaîne de caractères (string)Nom du système hôte.
Nom d'utilisateur du serviceChaîne de caractères (string)Compte de service de robot UiPath.
Statut de la machineChaîne de caractères (string)Statut: Available, Busy, Disconnected, Unknown.
HorodatageDateTimeHorodatage de l'événement.
IsUnresponsiveBooléenIndique si la connexion ne répond pas.
Événements du journal du robot

Date d'émission: robotlog

ChampSaisie de texteDescription
MessageChaîne de caractères (string)Consigner le contenu.
Niveau (Level)Chaîne de caractères (string)Gravité: Trace, Info, Warn, Error, Fatal.
TypeJournalChaîne de caractères (string)Catégorie: User, Default, Error, Business, ExecutionStep, Info, Security, Technical.
HorodatageDateTimeHorodatage de la génération.
JobIdGUIDClé de la tâche.
ProcessNameChaîne de caractères (string)Exécution du nom du processus.
Version du processusChaîne de caractères (string)Version du processus.
Nom du Robot (RobotName)Chaîne de caractères (string)Identifiant du Robot.
Id de la machineNumériqueID numérique de la machine.
MachineKeyGUIDIdentifiant de la machine.
Nom de machine (Machine Name)Chaîne de caractères (string)Nom de machine.
Nom de la machine hôteChaîne de caractères (string)Nom de la machine hôte (journaux de session uniquement).
Identité WindowsChaîne de caractères (string)Action du compte utilisateur.
InitiéPar (initiatedBy)Chaîne de caractères (string)Source d'exécution: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI.
FileNameChaîne de caractères (string)Nom du fichier .xaml exécuté.
InfoActivitéJSONMétadonnées d'activité: DisplayName, State, Activity, Arguments.
Champs personnalisésJSONChamps personnalisés ajoutés via l’activité AjouterChampsJournaux.
QueueNameChaîne de caractères (string)Nom de la file d'attente source (traitement des files d'attente uniquement).
Id de la transactionGUIDClé de transaction (traitement des files d'attente uniquement).
transactionStateChaîne de caractères (string)Started, Ended, Postponed (traitement des files d'attente uniquement).
transactionStatusChaîne de caractères (string)Start, Success, Failed, BusinessException, ApplicationException (traitement des files d'attente uniquement).
Délai d'exécution de la transaction (Transaction Execution Time)NumériqueDurée d’exécution en secondes (traitement des files d’attente uniquement).
totalExecutionTimeInSecondsNumériqueDurée totale d'exécution (traitement des files d'attente uniquement).
queueItemPriorityChaîne de caractères (string)High, Normal, Low (journaux de fin de transaction de file d'attente uniquement).
queueItemReviewStatusChaîne de caractères (string)InReview, Verified, Reported, Retried (journaux de fin de transaction de file d'attente uniquement).
ProcessingExceptionReasonChaîne de caractères (string)Raison de l'exception (journaux de fin de transaction de file d'attente uniquement).
Type d'exception de traitementChaîne de caractères (string)ApplicationException ou BusinessException (journaux de fin de transaction de file d'attente uniquement).

Événements Maestro

Maestro génère des événements pour les exécutions de processus, les exécutions d'éléments et les incidents.

Champs standard

Tous les événements Maestro incluent les champs suivants:

ChampDescription
OrganizationIdIdentificateur de l'organisation générant l'événement.
TenantIdIdentificateur du locataire générant l'événement.
FolderKeyIdentifiant du dossier ou de l’espace de travail.
Clé du processusIdentificateur de la définition du processus.
IDInstanceIdentificateur de l'instance du processus.
RunIdIdentificateur de l'exécution du processus.
TypeÉtendueType d'événement Maestro: Incident, ProcessRun, ElementRun, InstanceOperation.
État (Status)État du cycle de vie actuel de l'événement.
IDUniqueÉvénementL'identifiant global unique de l'événement émis.
EventTimeUtcHorodatage de l'émission de l'événement.
Attributs de traçageMétadonnées au niveau de la trace facultatives (nulables).
AttributsÉtendueJSON converti sous forme de chaîne d'attributs supplémentaires spécifiques à l'étendue.
Champs d’incidents
ChampDescription
ElementIdÉlément où l’incident s’est produit.
RunId de l'élémentExécution d’élément associée à l’incident.
DateMiseÀJourIncident (UTC)Horodatage de la date de dernière mise à jour de l'incident.
Commentaire (Comment)Commentaire facultatif associé à l’incident.
Code dʹerreurCode d’erreur de l’incident.
MessageErreurMessage d'erreur court.
Détails de l’erreurInformations détaillées sur les erreurs.
DebugModeÉtat du mode débogage lorsque l'incident s'est produit.
Champs d'exécution de processus
ChampDescription
HeureDébutUTCHeure de début de l’exécution du processus au format UTC.
NomÉtendueNom de l'étendue ou de l'événement lisible par un humain.
Identifiant du traçageIdentificateur de traçage distribué pour la corrélation.
IDÉtendueIdentifiant d'étendue pour cette exécution de processus.
IDÉtendueParentIdentifiant de l’étendue parente (nul pour les étendues racines).
PackageIdIdentificateur de package.
PackageKeyClé de package, inclut généralement la version.
PackageVersionVersion du package.
Nom de la versionNom de la version lisible par un humain.
ID externeIdentificateur de corrélation externe.
SourceSource du déclencheur de l'exécution (par exemple, Manual).
TypeModeDébogageConfiguration du mode de débogage.
CléUtilisateurCréateurL'utilisateur qui a initié l'exécution (nullable).
CaseInstanceIdIdentificateur d’instance de cas (nul).
Métadonnées de gestion des casMétadonnées de gestion des cas (nul).
Champs d'exécution d'éléments
ChampDescription
HeureDébutUTCHeure de début de l’exécution de l’élément en UTC.
HeureFinUTCHeure de fin de l’exécution de l’élément au format UTC.
NomÉtendueNom de l'étendue ou de l'événement lisible par un humain.
Identifiant du traçageIdentificateur de traçage distribué pour la corrélation.
IDÉtendueIdentificateur d'étendue pour cette exécution d'élément.
IDÉtendueParentIdentifiant de l’étendue parente (nullable).
VariablesVariables structurées capturées lors de l’exécution de l’élément.
FichierJson - VariablesVariables sérialisées au format JSON.
ExécutionÉlément.IDÉlémentIdentificateur de l'élément.
ExécutionÉlément.NomÉlémentNom affiché de l'élément.
ExécutionÉlément.TypeÉlémentType d’élément.
ElementRun.ElementExtensionTypeType d’extension (nul).
ExécutionÉlément.IdExécutionÉlémentIdentificateur d’exécution d’élément.
ElementRun.IncomingFlowIdIdentifiant du flux entrant.
ElementRun.IncomingFlowIdsTableau des identificateurs de flux entrants (nul).
ElementRun.CaseStageElementIdIdentificateur d’élément d’étape du cas (nul).
ElementRun.CaseManagementMetadataMétadonnées de cas au niveau de l’élément (nullable).
Exemple: événement d’exécution d’élément
{
  "ElementRun": {
    "ProcessRun": {
      "ProcessInstance": {
        "OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
        "TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
        "FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
        "PackageId": "Trace.Test.agentic.Agentic.Process",
        "PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
        "PackageVersion": "1.0.0",
        "ReleaseName": "Agentic Process",
        "ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
        "InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
        "CaseInstanceId": null,
        "ExternalId": "44777039",
        "Source": "Manual",
        "DebugModeType": "None",
        "CreatorUserKey": null
      },
      "RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
      "CaseManagementMetadata": null
    },
    "ElementId": "__Action=Pending__",
    "ElementName": "",
    "ElementType": "__InstanceAction__",
    "ElementExtensionType": null,
    "ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
    "IncomingFlowId": "",
    "IncomingFlowIds": null,
    "CaseStageElementId": null,
    "CaseManagementMetadata": null
  },
  "StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "Status": "Pending",
  "Variables": {},
  "VariablesJson": "{}",
  "SpanName": "Instance Created",
  "TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
  "SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
  "ParentSpanId": null,
  "SpanType": "InstanceOperation",
  "EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
  "EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "TraceAttributes": null,
  "SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}
{
  "ElementRun": {
    "ProcessRun": {
      "ProcessInstance": {
        "OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
        "TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
        "FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
        "PackageId": "Trace.Test.agentic.Agentic.Process",
        "PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
        "PackageVersion": "1.0.0",
        "ReleaseName": "Agentic Process",
        "ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
        "InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
        "CaseInstanceId": null,
        "ExternalId": "44777039",
        "Source": "Manual",
        "DebugModeType": "None",
        "CreatorUserKey": null
      },
      "RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
      "CaseManagementMetadata": null
    },
    "ElementId": "__Action=Pending__",
    "ElementName": "",
    "ElementType": "__InstanceAction__",
    "ElementExtensionType": null,
    "ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
    "IncomingFlowId": "",
    "IncomingFlowIds": null,
    "CaseStageElementId": null,
    "CaseManagementMetadata": null
  },
  "StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "Status": "Pending",
  "Variables": {},
  "VariablesJson": "{}",
  "SpanName": "Instance Created",
  "TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
  "SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
  "ParentSpanId": null,
  "SpanType": "InstanceOperation",
  "EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
  "EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "TraceAttributes": null,
  "SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}

Événements du journal d'audit

Les exportations de journaux d’audit prennent en charge à la fois les événements d’audit au niveau du locataire et de l’organisation.

Sources au niveau du locataire:

Identité et accès: Identité, OMS, KMS, Licences, AuthZ, Routage

Produits et services: Integration Service, Data Service, Test Manager, Automation Ops, Apps, Document Understanding

Sources au niveau de l'organisation: politique au niveau de l'organisation et événements de gestion des utilisateurs.

Champs standard
ChampDescription
IdIdentificateur unique au niveau global de l’événement d’audit.
IDLocalIdentificateur séquentiel interne pour la commande.
Date de créationHorodatage de la création de l'événement.
Dernière modificationHorodatage de la dernière modification (nul).
VersionVersion de l’enregistrement de l’événement d’audit.
État (State)État du cycle de vie interne de l’événement.
État (Status)Résultat de l'événement (enum numérique).
TypeÉvénementIdentificateur de l'action effectuée.
EventSourceIdentifiant du produit ou du système générant l'événement.
EventTargetIdentificateur de la catégorie d'événement.
EventDetailsJSON intégré avec des détails spécifiques à l'événement (voir ci-dessous).
ServiceNameNom lisible par un humain du service d'envoi.
InformationsClientJSON intégré avec IpAddress et IpCountry.
IDTacteurIdentificateur unique de l'acteur.
ActorNameNom complet de l'acteur.
EmailacteurL’e-mail de l’acteur (nul).
DétailsacteurJSON intégré avec des métadonnées décrivant l'acteur.
OrganizationIdIdentifiant de l'organisation.
NomOrganisationNom de l'organisation.
TenantIdIdentifiant du locataire (nul pour les événements au niveau de l'organisation).
NomLocataireNom du locataire (nul pour les événements au niveau de l'organisation).
OrigineOrigine de l’infrastructure ou de la région de l’événement.
Champs DétailsÉvénement par service

Le champ EventDetails est une chaîne JSON dont la structure dépend du service émetteur.

Événements d’identité / d’authentification:

ChampDescription
ID.UtilisateurIdentificateur de l'utilisateur.
NomComplet.UtilisateurNom complet de l'utilisateur.
Email.UtilisateurAdresse e-mail de l'utilisateur.
Type.UtilisateurType d'utilisateur.
Méthode de connexionMéthode d’authentification.
ID de clientIdentifiant de client OAuth.
ÉtenduesÉtendues accordées ou demandées.

Événements Apps:

ChampDescription
ID de l’applicationIdentifiant d'application unique.
appNameNom de l'application.
Type d'applicationType d'application.
versionVersion de l’application.
DescriptionDescription de l'application.
NomDossierDossier contenant l'application.
EstApplicationActionIndique si l'application est une application d'action.
EstApplicationPubliqueIndique si l'application est visible publiquement.

Événements Integration Service:

ChampDescription
ConnectionIdIdentificateur de connexion d'intégration.
ConnectionNameNom de la connexion.
ConnecteurNom complet du connecteur.
ConnectorKeyClé de connecteur unique.

Événements d’administration/de politique:

ChampDescription
PolicyIdIdentificateur de politique.
PolicyNameNom de la politique.
Politique crééeMétadonnées de création de politique.
Politique suppriméeMétadonnées de suppression de la politique.
ModifiedFieldsLes champs ont été modifiés lors de la mise à jour.

Événements du gestionnaire de ressources de licence:

ChampDescription
Nom du produitNom du produit sous licence.
OldQuantityQuantité de licences précédente.
NewQuantityMise à jour de la quantité de licences.
TenantIdLocataire affecté.
NomLocataireNom du locataire affecté.
AdminNameL'administrateur qui a effectué la modification.

Événements Data Service:

ChampDescription
EntityIdIdentificateur de l'entité DataFabric.
EntityName (Nom de l'entité)Nom de l’entité.
RecordId (ID de l'enregistrement)Identificateur de l'enregistrement affecté.
PropriétésModifiéesPropriétés modifiées par l'opération.
HorodatageHorodatage d'événement spécifique à DataFabric.
Exemple: événement du journal d'audit
{
  "LocalId": 158693,
  "State": 0,
  "LastModified": null,
  "Version": 1,
  "Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
  "CreatedOn": "2026-01-10T16:15:46.5597482",
  "OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "TenantId": null,
  "TenantName": null,
  "ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
  "ActorName": "System Administrator",
  "ActorEmail": null,
  "ActorDetails": "{\"Type\":1}",
  "EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
  "EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
  "EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
  "EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"plt_basic_auth_multi_org@uipath-qa.com\",\"Type\":0}}",
  "ServiceName": "Identity",
  "Status": 0,
  "ClientInfo": null,
  "Origin": "alp-wus2-01-platform"
}
{
  "LocalId": 158693,
  "State": 0,
  "LastModified": null,
  "Version": 1,
  "Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
  "CreatedOn": "2026-01-10T16:15:46.5597482",
  "OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "TenantId": null,
  "TenantName": null,
  "ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
  "ActorName": "System Administrator",
  "ActorEmail": null,
  "ActorDetails": "{\"Type\":1}",
  "EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
  "EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
  "EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
  "EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"plt_basic_auth_multi_org@uipath-qa.com\",\"Type\":0}}",
  "ServiceName": "Identity",
  "Status": 0,
  "ClientInfo": null,
  "Origin": "alp-wus2-01-platform"
}

Exportations de traçage OTEL

Les traçages d'agent et de Maestro sont exportés au format OpenTelemetry. Chaque exécution génère une arborescence d'étendues: une étendue racine par agent ou exécution Maestro, avec des étendues enfants pour chaque appel LLM, appel d'outil et évaluation de garde-fous.

Champs d’étendue OTEL

Champ OTELDescription
Identifiant du traçageIdentificateur de traçage. Regroupe toutes les étendues appartenant à une seule exécution.
ÉtendueIdentificateur unique pour cette étendue.
IDÉtendueParentIdentifiant de l'étendue parente. Chaîne vide pour les étendues de racines.
nameNom d'étendue lisible par un humain (par exemple, Agent run - googlesearch, LLM call).
kindType d’étendue: SPAN_KIND_INTERNAL ou SPAN_KIND_CLIENT.
HeureDébut - Unix - ActivationHeure de début de la période en millisecondes Unix.
FinHeureUnixNomaHeure de fin de la période au format Unix.
status.codeStatut de l'exécution: STATUS_CODE_OK ou STATUS_CODE_ERROR.
message.statutMessage de statut (chaîne vide en l'absence d'erreurs).
attributs.*Les attributs Étendue sont aplatis à l’aide de la notation pointée (voir ci-dessous).

Mappage des attributs UiPath

Les champs de traçage internes d’UiPath correspondent aux attributs OTEL comme suit:

Champ UiPathAttribut OTELRemarques
IdID_étendueIdentificateur d'étendue unique.
Identifiant du traçageID_TraçageIdentificateur de traçage.
ParentIdID_étendue_parentNull pour les étendues de racines.
NomnameNom de l’étendue.
StartTimeheure_début_unix_nnonConverti en Platforms Unix.
EndTimeheure_fin_unix_narioConverti en Platforms Unix.
État (Status)status.code1 = OK, 2 = ERREUR.
AttributsAttributsChaîne JSON analysée en paires clé-valeur à l'aide d'une notation pointée.
SpanType, OrganizationId, TenantId, FolderKey, JobKey, ProcessKey, Source, VerbosityLevelattributs.uipath.*Tous les champs de métadonnées UiPath.

Types d’attributs de l’étendue

Le champ Attributes du schéma interne d’UiPath contient une chaîne JSON qui est analysée et aplatie dans les attributs d’étendue OTEL à l’aide de la notation pointée. La structure dépend du type d'étendue.

Attributs agentRun (attributes.type = "agentRun"):

AttributDescription
type, agentId, agentName, agentVersionChamps d’identité de l’agent.
InviteSystème, InviteUtilisateurRequêtes de l’agent.
SchémaEntrée, SchémaSortieSchémas d'entrée et de sortie.
entrée, sortie, sourceEntrées d'exécution, sorties et source du déclencheur.
ErreurLes détails de l'erreur, le cas échéant.

attributs de complétion (attributes.type = "completion"):

AttributDescription
type, modèleType d'étendue et identifiant de modèle LLM.
paramètres.maxJetons, paramètres.températureParamètres LLM.
toolCallsTableau des appels d’outils effectués lors de l’achèvement.
utilisation.completionTokens, utilisation.inviteTokens, utilisation.totalJetonsUtilisation de jetons.
utilisation.isParioExécution, utilisation.exécutionDéploiementType, utilisation.estPIIMasquéMétadonnées d’exécution.
ErreurLes détails de l'erreur, le cas échéant.

Attributs ToolCall (attributes.type = "toolCall"):

AttributDescription
type, IDappel, NomOutilIdentité de l'appel de l'outil.
Arguments, TypeOutilArguments d'appel et type d'outil.
RésultatRésultat de l’appel d’outil.
ErreurLes détails de l'erreur, le cas échéant.

Attributs Tool GuardrailEvaluation (attributes.type = "toolGuardrailEvaluation"):

AttributDescription
type, guardrailName, guardrailDescriptionIdentité du garde-fou.
garde-fouAction, détails, actionAction et résultat du garde-fou.
arguments, résultatEntrées et résultats de l'évaluation.
Niveau de gravitéClassification de gravité.
ErreurLes détails de l'erreur, le cas échéant.

Limites d’exportation

LimiteValeur (Value)
Valeur maximale de l’attribut individuel32 Ko
Nombre total maximal d’attributs par étendue256 Ko
Taille de lot UTLP maximale~1 Mo
Pièces jointesMétadonnées uniquement (ID, nom de fichier, type MIME). Le contenu du fichier n’est pas exporté.
Exemple: Traçage OTEL (erreur de quatre étendues pour une exécution d’agent)
[
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "a4bd5687817248fc",
    "parentSpanId": "",
    "name": "Agent run - googlesearch",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000235632009500",
    "endTimeUnixNano": "1728000248153231700",
    "attributes.type": "agentRun",
    "attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
    "attributes.agentName": "googlesearch",
    "attributes.agentVersion": "1.0.0",
    "attributes.input.search_query": "google",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.source": "playground",
    "attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
    "attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
    "attributes.uipath.span_type": "agentRun",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "4c10aa5169c44a17",
    "parentSpanId": "a4bd5687817248fc",
    "name": "LLM call",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238084433000",
    "endTimeUnixNano": "1728000245772907200",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.settings.maxTokens": 16384,
    "attributes.settings.temperature": 0,
    "attributes.usage.completionTokens": 491,
    "attributes.usage.promptTokens": 1110,
    "attributes.usage.totalTokens": 1601,
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "0fde078a923d484e",
    "parentSpanId": "4c10aa5169c44a17",
    "name": "LLM",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238979846800",
    "endTimeUnixNano": "1728000245095082400",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "7fc828f5295d4788",
    "parentSpanId": "a4bd5687817248fc",
    "name": "Agent output",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000246820034400",
    "endTimeUnixNano": "1728000246820034400",
    "attributes.type": "agentOutput",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.uipath.span_type": "agentOutput",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  }
]
[
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "a4bd5687817248fc",
    "parentSpanId": "",
    "name": "Agent run - googlesearch",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000235632009500",
    "endTimeUnixNano": "1728000248153231700",
    "attributes.type": "agentRun",
    "attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
    "attributes.agentName": "googlesearch",
    "attributes.agentVersion": "1.0.0",
    "attributes.input.search_query": "google",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.source": "playground",
    "attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
    "attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
    "attributes.uipath.span_type": "agentRun",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "4c10aa5169c44a17",
    "parentSpanId": "a4bd5687817248fc",
    "name": "LLM call",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238084433000",
    "endTimeUnixNano": "1728000245772907200",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.settings.maxTokens": 16384,
    "attributes.settings.temperature": 0,
    "attributes.usage.completionTokens": 491,
    "attributes.usage.promptTokens": 1110,
    "attributes.usage.totalTokens": 1601,
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "0fde078a923d484e",
    "parentSpanId": "4c10aa5169c44a17",
    "name": "LLM",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238979846800",
    "endTimeUnixNano": "1728000245095082400",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "7fc828f5295d4788",
    "parentSpanId": "a4bd5687817248fc",
    "name": "Agent output",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000246820034400",
    "endTimeUnixNano": "1728000246820034400",
    "attributes.type": "agentOutput",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.uipath.span_type": "agentOutput",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  }
]

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour