- Primeros pasos
- Seguridad y cumplimiento de los datos
- Organizaciones
- Autenticación y seguridad
- Licencia
- Acerca de la licencia
- Precios unificados: marco del plan de licencias
- Activar su licencia Enterprise
- Migrar de Test Suite a Test Cloud
- Migración de licencias
- Asignar licencias a tenants
- Asignación de licencias de usuario
- Anular la asignación de licencias de usuarios
- Monitoring license allocation
- Licencias con exceso de asignación
- Notificaciones de licencias
- Administración de licencias de usuario
- Tenants y servicios
- Cuentas y roles
- Ai Trust Layer
- Aplicaciones externas
- Notificaciones
- Registro
- Exportación de datos
- Acerca de la exportación de datos
- Modelo de datos de exportación de datos
- Configurar Azure Event Hub
- Configurar AWS SQS
- Configurar Arize
- Configurar Databricks
- Configurar un recopilador de OpenTelemetry
- Pruebas en su organización
- Solución de problemas
- Migrar a Test Cloud
Guía de administración de Test Cloud
La exportación de datos envía datos en dos formatos dependiendo de la fuente de datos seleccionada:
- Basado en eventos (JSON) : eventos discretos emitidos cuando algo sucede en UiPath (un trabajo cambia de estado, se procesa un elemento de cola, se registra una acción de auditoría). Entregado a Azure Event Hub o AWS SQS.
- Seguimiento OTEL : intervalos jerárquicos que representan seguimientos de ejecución de agente y Maestro en formato OpenTelemetry. Entregado a Arize, Databricks o cualquier punto final compatible con OTLP (OpenTelemetry Protocol).
Exportaciones basadas en eventos (JSON)
Eventos de Orchestrator
Orchestrator emite eventos para trabajos, artículos en cola, máquinas y registros de robot. Cada evento incluye un sobre común más un cuerpo específico de la entidad.
Campos comunes
Todos los eventos de Orchestrator incluyen los siguientes campos:
| Campo | Descripción |
|---|---|
| TipoDeEvento | Cadena que identifica el tipo de evento (por ejemplo, job.created, queueitem.added). |
| SchemaVersion | Identificador de versión del esquema. |
| Marca de tiempo | Marca de tiempo UTC del evento. |
| TenantKey | Identificador de tenant. |
| NombreDeTenant | Nombre para mostrar del tenant. |
| FolderKey | Identificador de carpeta. |
| NombreDeCarpeta | Nombre para mostrar de la carpeta. |
| FullFolderPath | Ruta completa de la carpeta. |
Job events
Emitido el: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating
| Campo | Tipo | Descripción |
|---|---|---|
| Clave | GUID | Identificador único de trabajo. |
| Hora de creación | Marca de tiempo | Hora de creación del trabajo. |
| HoraDeInicio | Marca de tiempo | Hora de inicio de la ejecución. |
| HoraDeFinalización | Marca de tiempo | Hora de finalización de la ejecución. |
| Estado | Cadena | Estado del trabajo: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed. |
| NombreDelProceso | Cadena | Nombre del paquete de origen. |
| NombreParaMostrar | Cadena | Nombre para mostrar en Orchestrator. |
| Nombre del robot | Cadena | Ejecutando identificador de robot. |
| Nombre del equipo host | Cadena | Nombre de la máquina de ejecución. |
Queue item events
Emitido el: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted
| Campo | Tipo | Descripción |
|---|---|---|
| Clave | GUID | Identificador de artículo en cola. |
| QueueDefinitionId | Número | ID numérico de cola. |
| Estado | Cadena | Estado del elemento: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown. |
| ReviewStatus | Cadena | Clasificación de revisión: None, InReview, Verified, Retried, Unknown. |
| Prioridad | Cadena | Prioridad del elemento: High, Normal, Low, Unknown. |
| DueDate | Datetime | Fecha límite de procesamiento. |
| Hora de creación | Datetime | Marca de tiempo de creación. |
| StartProcessing | Datetime | Hora de inicio del procesamiento. |
| Finalizar procesamiento | Datetime | Hora de finalización del procesamiento. |
| DeferDate | Datetime | Tiempo de procesamiento más temprano disponible. |
| SecondsInPre anterior | Número | Duración del intento anterior en segundos. |
| Número de reintento | Número | Número de intentos de procesamiento. |
| Progreso | Cadena | Progreso del flujo empresarial. |
| Datos de análisis | Cadena | Pares clave-valor de propiedad de análisis. |
| Salida | Cadena | Datos de salida de la actividad Establecer estado de transacción. |
| Datos específicos | Cadena | Datos personalizados de la propiedad Contenido específico o la actividad Añadir artículo en cola. |
| ID de trabajo del creador | Número | Creando identificador de trabajo. |
| ID de trabajo del ejecutor | Número | Identificador de trabajo en ejecución. |
| ProcessExceptionReason | Cadena | Resumen de fallos. |
| ProcessExceptionDetails | Cadena | Detalles del fallo. |
| ProcessExceptionType | Cadena | Tipo de error: ApplicationException, BusinessException, None. |
El objeto Queue incrustado en cada evento incluye: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.
SpecificData, SpecificContent y Output no se incluyen en los eventos queueItem.deferred y queueItem.reviewStatusChanged .
Machine events
Emitido el: machine.created, machine.updated, machine.deleted, machine.assign, machine.unassign
| Campo | Tipo | Descripción |
|---|---|---|
| ID de equipo | Número | ID numérico de la máquina. |
| Clave de máquina | GUID | Identificador de máquina. |
| Nombre de la máquina | Cadena | Nombre personalizado de la máquina. |
| AutomationCloudSlots | Número | Ranuras de runtime reservadas. |
| HeadlessSlots | Número | Ranuras en modo headless. |
| NonProductionSlots | Número | Ranuras de entorno de no producción. |
| UnattendedSlots | Número | Ranuras de ejecución unattended. |
Los eventos de sesión de la máquina (machineSession.status) incluyen:
| Campo | Tipo | Descripción |
|---|---|---|
| Clave de máquina | GUID | Identificador de máquina. |
| Nombre de la máquina | Cadena | Nombre personalizado de la máquina. |
| Nombre del equipo host | Cadena | Nombre del sistema host. |
| Nombre de usuario del servicio | Cadena | Cuenta de servicio de robot. |
| Estado de la máquina | Cadena | Estado: Available, Busy, Disconnected, Unknown. |
| Marca de tiempo | Datetime | Marca de tiempo del evento. |
| IsUnresponsive | Booleano | Si la conexión no responde. |
Eventos de registro de robot
Emitido el: robotlog
| Campo | Tipo | Descripción |
|---|---|---|
| Mensaje | Cadena | Contenido del registro. |
| Nivel | Cadena | Gravedad: Trace, Info, Warn, Error, Fatal. |
| TipoDeRegistro | Cadena | Categoría: User, Default, Error, Business, ExecutionStep, Info, Security, Technical. |
| Marca de tiempo | Datetime | Marca de tiempo de generación. |
| ID del trabajo | GUID | Clave del trabajo. |
| NombreDelProceso | Cadena | Nombre del proceso en ejecución. |
| Versión de proceso | Cadena | Versión del proceso. |
| Nombre del robot | Cadena | Identificador de robot. |
| ID de equipo | Número | ID numérico de la máquina. |
| Clave de máquina | GUID | Identificador de máquina. |
| Nombre de la máquina | Cadena | Nombre de la máquina. |
| Nombre del equipo host | Cadena | Nombre de la máquina host (solo registros de sesión). |
| Identidad de Windows | Cadena | Cuenta de usuario interina. |
| iniciado por | Cadena | Origen de ejecución: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI. |
| NombreDeArchivo | Cadena | Nombre del archivo .xaml ejecutado. |
| InformaciónDeActividad | JSON | Metadatos de actividad: DisplayName, State, Activity, Arguments. |
| Campos personalizados | JSON | Campos personalizados añadidos a través de la actividad AñadirCamposDeRegistro. |
| NombreDeCola | Cadena | Nombre de la cola de origen (solo procesamiento de colas). |
| ID de transacción | GUID | Clave de transacción (solo procesamiento de colas). |
| EstadoDeTransacción | Cadena | Started, Ended, Postponed (solo procesamiento de colas). |
| EstatusDeTransacción | Cadena | Start, Success, Failed, BusinessException, ApplicationException (solo procesamiento de colas). |
| TiempoDeEjecuciónDeTransacción | Número | Duración de la ejecución en segundos (solo procesamiento de colas). |
| TiempoTotalDeEjecuciónEnSegundos | Número | Duración total de la ejecución (solo procesamiento de colas). |
| PrioridadDeElementoDeCola | Cadena | High, Normal, Low (solo registros de fin de transacción en cola). |
| EstadoDeRevisiónDeArtículoEnCola | Cadena | InReview, Verified, Reported, Retried (solo registros de fin de transacción en cola). |
| ProcessingExceptionReason | Cadena | Motivo de la excepción (solo registros de fin de transacción en cola). |
| TipoDeExcepciónDeProcedimiento | Cadena | ApplicationException o BusinessException (solo registros de fin de transacción en cola). |
Eventos de Maestro
Maestro emite eventos para ejecuciones de procesos, ejecuciones de elementos e incidentes.
Campos estándar
Todos los eventos de Maestro incluyen los siguientes campos:
| Campo | Descripción |
|---|---|
| IDDeOrganización | Identificador de la organización que emite el evento. |
| IDdeTenant | Identificador del tenant que emite el evento. |
| FolderKey | Identificador de carpeta o espacio de trabajo. |
| Clave de proceso | Identificador de la definición del proceso. |
| IDDeInstancia | Identificador de la instancia de proceso. |
| RunId | Identificador de la ejecución del proceso. |
| Tipo de intervalo | Tipo de evento de Maestro: Incident, ProcessRun, ElementRun, InstanceOperation. |
| Estado | Estado actual del ciclo de vida del evento. |
| ID único de evento | Identificador único global del evento emitido. |
| EventTimeUtc | Marca de tiempo en que se emitió el evento. |
| AtributosDeSeguimiento | Metadatos de nivel de seguimiento opcionales (anulables). |
| Atributos de intervalo | JSON en cadena de atributos adicionales específicos del intervalo. |
Campos de incidentes
| Campo | Descripción |
|---|---|
| ElementId | Elemento donde se produjo el incidente. |
| IdDeEjecución de elemento | Ejecución de elemento asociado al incidente. |
| HoraUtcDeActualizaciónDeIncidente | Fecha en que se actualizó el incidente por última vez. |
| Comentario | Comentario opcional asociado al incidente. |
| Código de error | Código de error para el incidente. |
| MensajeDeError | Breve mensaje de error. |
| Detalles de error | Información detallada del error. |
| DebugMode | Estado del modo de depuración cuando se produjo el incidente. |
Campos de ejecución de procesos
| Campo | Descripción |
|---|---|
| HoraUtc de inicio | Hora de inicio de ejecución del proceso en UTC. |
| NombreDeEspacio | Nombre legible por humanos del intervalo o evento. |
| ID de seguimiento | Identificador de seguimiento distribuido para la correlación. |
| ID de intervalo | Identificador de intervalo para esta ejecución de proceso. |
| ID de segmento principal | Identificador de intervalo principal (anulable para intervalos raíz). |
| PackageId | Identificador de paquete. |
| PackageKey | Clave del paquete, normalmente incluye la versión. |
| PackageVersion | Versión del paquete. |
| Nombre de la versión | Nombre de la versión legible por humanos. |
| ID externo | Identificador de correlación externo. |
| Origen | Origen del desencadenador de la ejecución (por ejemplo, Manual). |
| TipoDeModoDeDepuración | Configuración del modo de depuración. |
| ClaveDeUsuarioCreador | Usuario que inició la ejecución (anulable). |
| CaseInstanceId | Identificador de instancia de caso (anulable). |
| MetadatosDeGestiónDeCasos | Metadatos de gestión de casos (anulables). |
Campos de ejecución de elementos
| Campo | Descripción |
|---|---|
| HoraUtc de inicio | Hora de inicio de la ejecución del elemento en UTC. |
| HoraUtcDeFinalización | Hora de finalización de la ejecución del elemento en UTC. |
| NombreDeEspacio | Nombre legible por humanos del intervalo o evento. |
| ID de seguimiento | Identificador de seguimiento distribuido para la correlación. |
| ID de intervalo | Identificador de intervalo para esta ejecución de elemento. |
| ID de segmento principal | Identificador de intervalo principal (anulable). |
| Variables | Variables estructuradas capturadas en la ejecución del elemento. |
| VariablesJson | Variables serializadas como JSON. |
| EjecuciónDeElemento.IdDeElemento | Identificador del elemento. |
| EjecuciónDeElemento.NombreDeElemento | Nombre para mostrar del elemento. |
| EjecuciónDeElemento.TipoDeElemento | Tipo de elemento. |
| EjecuciónDeElemento.TipoDeExtensiónDeElemento | Tipo de extensión (anulable). |
| EjecuciónDeElemento.IdDeEjecuciónDeElemento | Identificador de ejecución de elemento. |
| ElementRun.IncomingFlowId | Identificador de flujo entrante. |
| ElementRun.IncomingFlowIds | Matriz de identificadores de flujo entrante (anulable). |
| ElementRun.CasoStageElementId | Identificador de elemento de etapa del caso (anulable). |
| ElementRun.CaseManagementMetadata | Metadatos del caso en el nivel de elemento (anulables). |
Ejemplo: evento de ejecución de elemento
{
"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\"}"
}
Eventos de registro de auditoría
Las exportaciones de registros de auditoría admiten eventos de auditoría tanto a nivel de tenant como a nivel de organización.
Orígenes en el nivel de tenant:
Identidad y acceso: identidad, OMS, KMS, licencias, AuthZ, enrutamiento
Productos y servicios: Integration Service, Data Service, Test Manager, Automation Ops, Apps, Document Understanding
Orígenes en el nivel de organización: política de ámbito de la organización y eventos de gestión de usuarios.
Campos estándar
| Campo | Descripción |
|---|---|
| ID | Identificador único global del evento de auditoría. |
| ID local | Identificador secuencial interno para realizar pedidos. |
| Creado en | Marca de tiempo en que se creó el evento. |
| Última modificación | Marca de tiempo de la última modificación (anulable). |
| Versión | Versión del registro del evento de auditoría. |
| Estado | Estado del ciclo de vida interno del evento. |
| Estado | Resultado del evento (enumeración numérica). |
| TipoDeEvento | Identificador de la acción realizada. |
| EventSource | Identificador del producto o sistema que emite el evento. |
| EventTarget | Identificador de la categoría de evento. |
| EventDetails | JSON integrado con detalles específicos del evento (ver más abajo). |
| ServiceName | Nombre legible por humanos del servicio emisor. |
| Información del cliente | JSON incrustado con IpAddress y IpCountry. |
| ID de actor | Identificador único del actor. |
| ActorName | Nombre para mostrar del actor. |
| Correo electrónico del actor | Correo electrónico del actor (anulable). |
| Detalles del actor | JSON incrustado con metadatos que describen al actor. |
| IDDeOrganización | Identificador de la organización. |
| NombreDeLaOrganización | Nombre de la organización. |
| IDdeTenant | Identificador de tenant (anulable para eventos en el nivel de organización). |
| NombreDeTenant | Nombre del tenant (anulable para eventos en el nivel de organización). |
| Origen | Infraestructura u origen regional del evento. |
Campos de DetallesDeEvento por servicio
El campo EventDetails es una cadena JSON cuya estructura depende del servicio emisor.
Eventos de identidad/autenticación:
| Campo | Descripción |
|---|---|
| ID.de.usuario | Identificador del usuario. |
| Usuario.NombreParaMostrar | Nombre para mostrar del usuario. |
| Usuario.Correo electrónico | Correo electrónico del usuario. |
| Usuario.Tipo | Tipo de usuario (enum). |
| Método de inicio de sesión | Método de autenticación. |
| ClientId | Identificador de cliente OAuth. |
| Ámbitos | Ámbitos concedidos o solicitados. |
Eventos de Apps:
| Campo | Descripción |
|---|---|
| ID de aplicación | Identificador único de la aplicación. |
| appName | Nombre de la aplicación. |
| Tipo de aplicación | Tipo de aplicación. |
| 2020.x | Versión de la aplicación. |
| Descripción | Descripción de la aplicación. |
| NombreDeCarpeta | Carpeta que contiene la aplicación. |
| EsAplicaciónDeAcción | Si la aplicación es una aplicación de acción. |
| Es una aplicación pública | Si la aplicación es visible públicamente. |
Eventos de Integration Service:
| Campo | Descripción |
|---|---|
| ConnectionId | Identificador de conexión de integración. |
| ConnectionName | Nombre de la conexión. |
| Conector | Nombre para mostrar del conector. |
| ConnectorKey | Clave de conector única. |
Eventos de administración/política:
| Campo | Descripción |
|---|---|
| PolicyId | Identificador de política. |
| Nombre de la política | Nombre de la política. |
| Política creada | Metadatos de creación de políticas. |
| Política eliminada | Metadatos de eliminación de políticas. |
| ModifiedFields | Los campos cambiaron durante la actualización. |
Eventos de License Resource Manager:
| Campo | Descripción |
|---|---|
| Nombre del producto | Nombre del producto con licencia. |
| OldQuantity | Cantidad de licencias anteriores. |
| NewQuantity | Cantidad de licencias actualizada. |
| IDdeTenant | Tenant afectado. |
| NombreDeTenant | Nombre del tenant afectado. |
| AdminName | Administrador que realizó el cambio. |
Eventos de Data Service (DataFabric):
| Campo | Descripción |
|---|---|
| EntityId | Identificador de la entidad DataFabric. |
| NombreDeEntidad | Nombre de la entidad. |
| IdDeRegistro | Identificador del registro afectado. |
| Propiedades modificadas | Propiedades modificadas por la operación. |
| Marca de tiempo | Marca de tiempo del evento específico de DataFabric. |
Ejemplo: evento de registro de auditoría
{
"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\":\"[email protected]\",\"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\":\"[email protected]\",\"Type\":0}}",
"ServiceName": "Identity",
"Status": 0,
"ClientInfo": null,
"Origin": "alp-wus2-01-platform"
}
Exportaciones de OTEL Trace
Los seguimientos de agente y Maestro se exportan en formato OpenTelemetry (OTEL). Cada ejecución genera un árbol de intervalos: un intervalo raíz por agente o ejecución de Maestro, con intervalos secundarios para cada llamada de LLM, llamada de herramienta y evaluación de barrera de seguridad.
Campos de intervalo de OTEL
| Campo OTEL | Descripción |
|---|---|
| ID de seguimiento | Identificador de seguimiento. Agrupa todos los intervalos que pertenecen a una ejecución. |
| ID de intervalo | Identificador único para este intervalo. |
| ID de segmento principal | Identificador de intervalo principal. Cadena vacía para los rangos de raíz. |
| name | Nombre de intervalo legible por humanos (por ejemplo, Agent run - googlesearch, LLM call). |
| kind | Tipo de intervalo: SPAN_KIND_INTERNAL o SPAN_KIND_CLIENT. |
| HoraDeInicioUnixNano | Hora de inicio del intervalo en nanosegundos Unix. |
| HoraDeFinalizaciónUnixNano | Hora de finalización del intervalo en nanosegundos Unix. |
| código.de.estado | Estado de ejecución: STATUS_CODE_OK o STATUS_CODE_ERROR. |
| mensaje.de.estado | Mensaje de estado (cadena vacía cuando no hay error). |
| atributos.* | Atributos de intervalo aplanados utilizando la notación de puntos (ver más abajo). |
Asignación de atributos de UiPath
Los campos de seguimiento internos de UiPath se asignan a los atributos OTEL de la siguiente manera:
| Campo de UiPath | Atributo OTEL | Notas |
|---|---|---|
| ID | ID_span | Identificador de intervalo único. |
| ID de seguimiento | ID_de_seguimiento | Identificador de seguimiento. |
| ParentId | ID_span_principal | Nulo para intervalos de raíz. |
| Nombre | name | Nombre del intervalo. |
| HoraDeInicio | start_time_unix_nano | Convertido a nanosegundos de Unix. |
| HoraDeFinalización | end_time_unix_nano | Convertido a nanosegundos de Unix. |
| Estado | código.de.estado | 1 = OK, 2 = ERROR. |
| Atributos | Atributos | Cadena JSON analizada en pares clave-valor utilizando la notación de puntos. |
| SpanType, OrganizationId, TenantId, FolderKey, JobKey, ProcessKey, Source, VerbosityLevel | atributos.uipath.* | Todos los campos de metadatos de UiPath. |
Tipos de atributos de intervalo
El campo Attributes en el esquema interno de UiPath contiene una cadena JSON que se analiza y aplana en atributos de intervalo OTEL utilizando la notación de puntos. La estructura depende del tipo de intervalo.
Atributos de agentRun (attributes.type = "agentRun"):
| Atributo | Descripción |
|---|---|
| tipo, IDDeAgente, NombreDeAgente, VersiónDeAgente | Campos de identidad del agente. |
| Solicitud del sistema, Solicitud del usuario | Solicitudes del agente. |
| EsquemaDeEntrada, EsquemaDeSalida | Esquemas de entrada y salida. |
| entrada, salida, origen | Entradas de ejecución, salidas y origen del desencadenador. |
| error | Detalles del error, si está presente. |
atributos de finalización (attributes.type = "completion"):
| Atributo | Descripción |
|---|---|
| tipo, modelo | Tipo de intervalo e identificador de modelo LLM. |
| configuración.maxTokens, ajustes.temperatura | Configuración de LLM. |
| toolCalls | Matriz de llamadas de herramientas realizadas durante la finalización. |
| uso.completionTokens, uso.solicitudTokens, uso.totalTokens | Uso de tokens. |
| uso.isByoExecution, uses.executionDeploymentType, uso.isPiiMasked | Metadatos de ejecución. |
| error | Detalles del error, si está presente. |
atributos de toolCall (attributes.type = "toolCall"):
| Atributo | Descripción |
|---|---|
| tipo, IDDeLlamada, nombreDeHerramienta | Identidad de llamada de herramienta. |
| argumentos, tipo de herramienta | Argumentos de llamada y tipo de herramienta. |
| Resultado | Resultado de la llamada de herramienta. |
| error | Detalles del error, si está presente. |
Atributos de toolGuardrailEvaluation (attributes.type = "toolGuardrailEvaluation"):
| Atributo | Descripción |
|---|---|
| tipo, NombreDeLaBarrera, DescripciónDeLaBarrera | Identidad de barrera de seguridad. |
| GuardrailAcción, detalles, acción | Acción de barrera de seguridad y resultado. |
| argumentos, resultado | Entradas de evaluación y resultado. |
| Nivel de gravedad | Clasificación de gravedad. |
| error | Detalles del error, si está presente. |
Límites de exportación
| Límite | Valor |
|---|---|
| Valor máximo de atributo individual | 32 KB |
| Atributos totales máximos por intervalo | 256 KB |
| Tamaño máximo del lote de OTLP | ~1 MB (protobuf) |
| File attachments | Solo metadatos (ID, nombre de archivo, tipo MIME). El contenido del archivo no se exporta. |
Ejemplo: seguimiento de OTEL (cuatro intervalos para una ejecución de agente)
[
{
"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": ""
}
]