- Introdução
- Segurança de dados e conformidade
- Organizações
- Autenticação e segurança
- Licenciamento
- Sobre as licenças
- Preço unificado: estrutura do plano de licenciamento
- Ativar sua licença Enterprise
- Migre do Test Suite para o Test Cloud
- Migração de licença
- Atribuição de Licenças a Tenants
- Atribuição de licenças aos usuários
- Desalocando licenças de usuário
- Monitoring license allocation
- Atribuição excessiva de licenças
- Notificações de licenciamento
- Gerenciamento de Licenças de Usuário
- Tenants e serviços
- Contas e funções
- AI Trust Layer
- Aplicativos Externos
- Notificações
- Geração de logs
- Exportação de dados
- Testes em sua organização
- Solução de problemas
- Migração para o Test Cloud
Guia do administrador do Test Cloud
A Exportação de dados envia dados em dois formatos, dependendo da origem de dados selecionada:
- Baseado em evento (JSON) — eventos discretas emitidos quando algo acontece na UiPath (um trabalho muda de estado, um item de fila é processado, uma ação de auditoria é gravada). Entregue no Azure Event Hub ou AWS SQS.
- OTEL Trace — Períodos hierárquicos que representam traces de execução do agente e do Maestro no formato OpenTelemetry. Entregue à Arize, Databricks ou qualquer ponto de extremidade compatível com OTLP (OpenTelemetry Protocol).
Exportações baseadas em eventos (JSON)
Eventos do Orchestrator
O Orchestrator emite eventos para trabalhos, itens de fila, máquinas e logs de robôs. Cada evento inclui um envelope comum e um corpo específico da entidade.
Campos comuns
Todos os eventos do Orchestrator incluem os seguintes campos:
| Campo | Description |
|---|---|
| TipoDeEvento | String que identifica o tipo de evento (por exemplo, job.created, queueitem.added). |
| SchemaVersion | Identificador da versão do esquema. |
| Carimbo de data/hora | Carimbo de data/hora UTC do evento. |
| TenantKey | Identificador do tenant. |
| NomeDoTenant | Nome de exibição do tenant. |
| FolderKey | Identificador da pasta. |
| NomeDaPasta | Nome de exibição da pasta. |
| FullFolderPath | Caminho completo da pasta. |
Job events
Emitido em: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating
| Campo | Tipo | Description |
|---|---|---|
| Chave | Guid | Identificador de trabalho exclusivo. |
| Hora de Criação | Carimbo de data/hora | Hora de criação do trabalho. |
| StartTime | Carimbo de data/hora | Hora de início da execução. |
| EndTime | Carimbo de data/hora | Hora de término da execução. |
| Estado | String | Status do trabalho: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed. |
| ProcessName | String | Nome do pacote de origem. |
| NomeDeExibição | String | Nome de exibição no Orchestrator. |
| Nome do Robô | String | Executando o identificador do robô. |
| Nome da Máquina do Host | String | Nome da máquina de execução. |
Queue item events
Emitido em: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted
| Campo | Tipo | Description |
|---|---|---|
| Chave | Guid | Identificador do item da fila. |
| IdDeDefiniçãoDeFila | Número | ID numérico da fila. |
| Status | String | Status do item: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown. |
| ReviewStatus | String | Revisar classificação: None, InReview, Verified, Retried, Unknown. |
| Prioridade | String | Prioridade do item: High, Normal, Low, Unknown. |
| DueDate | DateTime | Prazo de processamento. |
| Hora de Criação | DateTime | Carimbo de data/hora de criação. |
| StartProcessing | DateTime | Hora de início do processamento. |
| Encerrar Processamento | DateTime | Tempo de conclusão do processamento. |
| DeferDate | DateTime | Tempo de processamento mais antigo disponível. |
| SegundosEmAnteriorTentativa | Número | Duração da tentativa anterior em segundos. |
| Número da Tentativa | Número | Número de tentativas de processamento. |
| Progresso | String | Progresso do fluxo de negócios. |
| Dados de Análise | String | Pares de chave-valor de propriedades de análise. |
| Saída | String | Dados de saída da atividade Definir Status da Transação. |
| Dados Específicos | String | Dados personalizados da propriedade Conteúdo Específico ou da atividade Adicionar Item de Fila. |
| ID do Trabalho do Criador | Número | Criando identificador do trabalho. |
| ID do Trabalho do Executador | Número | Executando o identificador do trabalho. |
| ProcessExceptionReason | String | Resumo da falha. |
| ProcessExceptionDetails | String | Detalhes da falha. |
| ProcessExceptionType | String | Tipo de erro: ApplicationException, BusinessException, None. |
O objeto Queue incorporado em cada evento inclui: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.
SpecificData, SpecificContent e Output não estão incluídos nos eventos queueItem.deferred e queueItem.reviewStatusChanged .
Machine events
Emitido em: machine.created, machine.updated, machine.deleted, machine.assign, machine.unassign
| Campo | Tipo | Description |
|---|---|---|
| ID da Máquina | Número | ID numérico da máquina. |
| MachineKey | Guid | Identificador da máquina. |
| Nome da máquina | String | Nome personalizado da máquina. |
| AutomationCloudSlots | Número | Slots de runtime reservados. |
| HeadlessSlots | Número | Slots no modo sem periféricos. |
| NonProductionSlots | Número | Slots de ambiente non-production. |
| UnattendedSlots | Número | Slots de execução unattended. |
Os eventos de sessão de máquina (machineSession.status) incluem:
| Campo | Tipo | Description |
|---|---|---|
| MachineKey | Guid | Identificador da máquina. |
| Nome da máquina | String | Nome personalizado da máquina. |
| Nome da Máquina do Host | String | Nome do sistema do host. |
| Nome de Usuário do Serviço | String | Conta de serviço do robô. |
| Status da Máquina | String | Status: Available, Busy, Disconnected, Unknown. |
| Carimbo de data/hora | DateTime | Carimbo de data/hora do evento. |
| IsUnresponsive | Booleano | Se a conexão está sem resposta. |
Eventos de log do robô
Emitido em: robotlog
| Campo | Tipo | Description |
|---|---|---|
| Mensagem | String | Conteúdo do log. |
| Nível | String | Gravidade: Trace, Info, Warn, Error, Fatal. |
| TipoDeLog | String | Categoria: User, Default, Error, Business, ExecutionStep, Info, Security, Technical. |
| Carimbo de data/hora | DateTime | Carimbo de data/hora de geração. |
| JobId | Guid | Chave do trabalho. |
| ProcessName | String | Nome do processo de execução. |
| Versão do Processo | String | Versão do processo. |
| Nome do Robô | String | Identificador do robô. |
| ID da Máquina | Número | ID numérico da máquina. |
| MachineKey | Guid | Identificador da máquina. |
| Nome da máquina | String | Nome da máquina. |
| Nome da Máquina do Host | String | Nome da máquina do host (apenas logs de sessão). |
| Identidade do Windows | String | Conta de usuário agente. |
| initiatedBy | String | Origem de execução: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI. |
| NomeDoArquivo | String | Nome do arquivo .xaml executado. |
| InformaçõesDaAtividade | JSON | Metadados de atividade: DisplayName, State, Activity, Arguments. |
| Custom Fields | JSON | Campos personalizados adicionados por meio da atividade AddLogFields. |
| QueueName | String | Nome da fila de origem (apenas processamento de fila). |
| ID da Transação | Guid | Chave de transação (apenas processamento de fila). |
| transactionState | String | Started, Ended, Postponed (apenas processamento de fila). |
| transactionStatus | String | Start, Success, Failed, BusinessException, ApplicationException (apenas processamento de fila). |
| Tempo de Execução da Transação | Número | Duração da execução em segundos (apenas processamento de filas). |
| TempoTotalDeExecuçãoEmSegundos | Número | Duração total de execução (apenas processamento de filas). |
| queueItemPriority | String | High, Normal, Low (enfileira apenas logs de término de transação). |
| StatusDeRevisãoDeItemDaFila | String | InReview, Verified, Reported, Retried (enfileira apenas logs de término de transação). |
| ProcessingExceptionReason | String | Motivo da exceção (apenas logs de término de transação de fila). |
| Tipo da Exceção de Processamento | String | ApplicationException ou ( BusinessException logs de término de transação de fila). |
Eventos do Maestro
O Maestro emite eventos para Execuções de processos, Execuções de elementos e Incidentes.
Campos padrão
Todos os eventos do Maestro incluem os seguintes campos:
| Campo | Description |
|---|---|
| OrganizationId | Identificador da organização remetendo o evento. |
| TenantId | Identificador do tenant atribuindo o evento. |
| FolderKey | Identificador da pasta ou espaço de trabalho. |
| Chave do Processo | Identificador da definição do processo. |
| IdDaInstância | Identificador da instância do processo. |
| RunId | Identificador da execução do processo. |
| TipoDeExtensão | Tipo de evento do Maestro: Incident, ProcessRun, ElementRun, InstanceOperation. |
| Status | Estado do ciclo de vida atual do evento. |
| IdExclusivoDoEvento | Identificador globalmente exclusivo do evento emitido. |
| EventTimeUtc | Registro de data e hora em que o evento foi emitido. |
| Atributos de trace | Metadados opcionais no nível de trace (nuláveis). |
| Atributos pontos | JSON com strings de atributos adicionais específicos do intervalo. |
Campos de incidentes
| Campo | Description |
|---|---|
| ElementId | Elemento onde o incidente ocorreu. |
| IdDeExecução do Elemento | Execução do elemento associada ao incidente. |
| UtcDaHoraDeAtualizaçãoDoIncidente | Registro de data e hora de quando o incidente foi atualizado pela última vez. |
| Comentar | Comentário opcional associado ao incidente. |
| Código de Erro | Código de erro do incidente. |
| MensagemDeErro | Breve mensagem de erro. |
| Detalhes do Erro | Informações detalhadas do erro. |
| DebugMode | Estado do modo de depuração quando o incidente ocorreu. |
Campos de execução do processo
| Campo | Description |
|---|---|
| UtcDaHoraInício | Hora de início da execução do processo em UTC. |
| NomeDoExtensão | Nome legível por humanos do intervalo ou evento. |
| ID do trace | Identificador de trace distribuído para correlação. |
| ID do intervalo | Identificador de intervalo para esta execução de processo. |
| ID do intervalo pai | Identificador de intervalo pai (nulável para intervalos raiz). |
| PackageId | Identificador do pacote. |
| PackageKey | Chave do pacote, normalmente inclui a versão. |
| PackageVersion | Versão do pacote. |
| Nome da versão | Nome da versão legível por humanos. |
| ID Externo | Identificador de correlação externa. |
| Origem | Origem do disparo da execução (por exemplo, Manual). |
| TipoDeModoDeDepuração | Configuração do modo de depuração. |
| ChaveDeUsuário Criador | Usuário que iniciou a execução (nulável). |
| CaseInstanceId | Identificador da instância do caso (nulável). |
| MetadadosDeGerenciamentoDeCaso | Metadados de gerenciamento de caso (nuláveis). |
Campos de execução do elemento
| Campo | Description |
|---|---|
| UtcDaHoraInício | Hora de início da execução do elemento em UTC. |
| UtcDaHoraDeTérmino | Hora de término da execução do elemento em UTC. |
| NomeDoExtensão | Nome legível por humanos do intervalo ou evento. |
| ID do trace | Identificador de trace distribuído para correlação. |
| ID do intervalo | Identificador de intervalo para esta execução de elemento. |
| ID do intervalo pai | Identificador do intervalo pai (nulável). |
| Variáveis | Variáveis estruturadas capturadas na execução do elemento. |
| Variáveis JSON | Variáveis serializadas como JSON. |
| Execução do elemento.IdDoElemento | Identificador do elemento. |
| ExecuçãoDoElemento.NomeDoElemento | Nome de exibição do elemento. |
| Execução do Elemento.TipoDeElemento | Tipo de elemento. |
| Execução do Elemento.TipoDeExtensãoDoElemento | Tipo de extensão (nulável). |
| ElementRun.ElementRunId | Identificador de execução do elemento. |
| ElementRun.IncomingFlowId | Identificador do fluxo de entrada. |
| ElementRun.IncomingFlowIds | Array de identificadores de fluxo de entrada (nulável). |
| ElementRun.CaseStageElementId | Identificador do elemento do estágio do caso (nulável). |
| ElementRun.Case ManagementMetadata | Metadados do caso no nível do elemento (nulável). |
Exemplo: evento de execução 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 do log de auditoria
As exportações de log de auditoria são compatíveis com eventos de auditoria no nível do tenant e no nível da organização.
Origens no nível do tenant:
Identidade e acesso: Identity, OMS, KMS, Licenciamento, AuthZ, Roteamento
Produtos e serviços: Integration Service, Data Service, Test Manager, Automation Ops, Apps, Document Understanding
Fontes no nível da organização: política com escopo de organização e eventos de gerenciamento de usuários.
Campos padrão
| Campo | Description |
|---|---|
| Id | Identificador globalmente exclusivo do evento de auditoria. |
| IdDoLocal | Identificador sequencial interno para ordenar. |
| Criado Em | Carimbo de data e hora em que o evento foi criado. |
| Última Modificação | Registro de data/hora da última modificação (nulável). |
| Versão | Versão do registro do evento de auditoria. |
| Estado | Estado do ciclo de vida interno do evento. |
| Status | Resultado do evento (enum numérico). |
| TipoDeEvento | Identificador da ação realizada. |
| EventSource | Identificador do produto ou sistema que emite o evento. |
| EventTarget | Identificador da categoria de evento. |
| EventDetails | JSON incorporado com detalhes específicos do evento (veja abaixo). |
| ServiceName | Nome legível por humanos do serviço de emissão. |
| Informações do cliente | JSON incorporado com IpAddress e IpCountry. |
| ID do ator | Identificador exclusivo do ator. |
| ActorName | Nome de exibição do ator. |
| E-mail do ator | E-mail do ator (nulável). |
| Detalhes do ator | JSON incorporado com metadados descrevendo o ator. |
| OrganizationId | Identificador da organização. |
| NomeDaOrganização | Nome da organização. |
| TenantId | Identificador do tenant (nulo para eventos no nível da organização). |
| NomeDoTenant | Nome do tenant (nulo para eventos no nível da organização). |
| Origem | Infraestrutura ou origem regional do evento. |
Campos EventDetails por serviço
O campo é uma string EventDetails cuja estrutura depende do serviço de emissão.
Eventos de Identidade/Autenticação:
| Campo | Description |
|---|---|
| ID do usuário | Identificador do usuário. |
| Usuário.NomeDeExibição | Nome de exibição do usuário. |
| Usuário.Email | E-mail do usuário. |
| Usuário.Tipo | Tipo de usuário (enum). |
| MétodoDeLogin | Método de autenticação. |
| ClientId | Identificador do cliente OAuth. |
| Escopos | Escopos concedidos ou solicitados. |
Eventos do Apps:
| Campo | Description |
|---|---|
| ID do Aplicativo | Identificador exclusivo do aplicativo. |
| appName | Nome do aplicativo. |
| Tipo de app | Tipo de aplicativo. |
| 2019.x | Versão do aplicativo. |
| Descrição | Descrição do aplicativo. |
| NomeDaPasta | Pasta que contém o aplicativo. |
| ÉAçãoAplicativo | Se o aplicativo é um aplicativo de ação. |
| ÉAplicativoPúblico | Se o aplicativo é visível publicamente. |
Eventos do Integration Service:
| Campo | Description |
|---|---|
| ConnectionId | Identificador de conexão de integração. |
| ConnectionName | Nome da conexão. |
| Conector | Nome de exibição do conector. |
| ConnectorKey | Chave de conector exclusiva. |
Eventos de administrador/política:
| Campo | Description |
|---|---|
| PolicyId | Identificador da política. |
| PolicyName | Nome da política. |
| Política criada | Metadados de criação de políticas. |
| Política excluída | Metadados de exclusão da política. |
| ModifiedFields | Campos alterados durante a atualização. |
Eventos do License Resource Manager:
| Campo | Description |
|---|---|
| Nome do Produto | Nome do produto licenciado. |
| OldQuantity | Quantidade de licenças anteriores. |
| NewQuantity | Quantidade de licenças atualizada. |
| TenantId | Tenant afetado. |
| NomeDoTenant | Nome do tenant afetado. |
| AdminName | Administrator que realizou a alteração. |
Eventos do Data Service (DataFabric):
| Campo | Description |
|---|---|
| EntityId | Identificador da entidade DataFabric. |
| NomedaEntidade | Nome da entidade. |
| IdDoRegistro | Identificador do registro afetado. |
| PropriedadesAlteradas | Propriedades modificadas pela operação. |
| Carimbo de data/hora | Carimbo de data/hora do evento específico do DataFabric. |
Exemplo: evento de log de auditoria
{
"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"
}
Exportações de trace do OTEL
Os traces de agente e Maestro são exportados no formato OpenTelemetry (OTEL). Cada execução gera uma árvore de spans — um intervalo raiz por agente ou execução do Maestro, com intervalos filhos para cada chamada de LLM, chamada de ferramenta e avaliação de proteção.
Campos de intervalo do OTEL
| Campo OTEL | Description |
|---|---|
| ID do trace | Identificador do rastreamento. Agrupa todos os intervalos pertencentes a uma execução. |
| ID do intervalo | Identificador exclusivo para este período. |
| ID do intervalo pai | Identificador do intervalo pai. String vazia para intervalos raiz. |
| name | Nome do intervalo legível por humanos (por exemplo, Agent run - googlesearch, LLM call). |
| kind | Tipo de intervalo: SPAN_KIND_INTERNAL ou SPAN_KIND_CLIENT. |
| DataDeInícioUnixNano | Horário de início do intervalo em nanossegundos Unix. |
| EndTimeUnixNano | Tempo de término do intervalo em nanossegundos Unix. |
| status.código | Status da execução: STATUS_CODE_OK ou STATUS_CODE_ERROR. |
| status.mensagem | Mensagem de status (string vazia quando não há erro). |
| atributos.* | Atributos de extensão mesclados usando notação de ponto (veja abaixo). |
Mapeamento de atributos da UiPath
Os campos de trace internos da UiPath mapeiam para atributos OTEL da seguinte forma:
| Campo do UiPath | Atributo OTEL | Observações |
|---|---|---|
| Id | ID_espaço | Identificador de intervalo exclusivo. |
| ID do trace | ID_trace | Identificador do rastreamento. |
| ParentId | ID_intervalo_pai | Nulo para intervalos raiz. |
| Name | name | Nome do intervalo. |
| StartTime | hora_início_unix_nano | Convertido para nanossegundos Unix. |
| EndTime | hora_fim_unix_nano | Convertido para nanossegundos Unix. |
| Status | status.código | 1 = OK, 2 = ERRO. |
| Atributos | Atributos | String JSON analisada em pares de chave-valor usando notação de ponto. |
| SpnType, OrganizationId, TenantId, FolderKey, JobKey, ProcessKey, Source, VerbotyLevel | atributos.uipath.* | Todos os campos de metadados da UiPath. |
Tipos de atributo de intervalo
O campo Attributes no esquema interno da UiPath contém uma string JSON que é analisada e mesclada em atributos de span OTEL usando a notação de ponto. A estrutura depende do tipo de intervalo.
Atributos do agentRun (attributes.type = "agentRun"):
| Atributo | Description |
|---|---|
| tipo, agentId, agentName, agentVersion | Campos de identidade do agente. |
| systemPrompt, userPrompt | Solicitações de agentes. |
| EsquemaDeEntrada, EsquemaDeSaída | Esquemas de entrada e saída. |
| entrada, saída, origem | Entradas de execução, saídas e origem do gatilho. |
| erro | Detalhes do erro, se houver. |
atributos de conclusão (attributes.type = "completion"):
| Atributo | Description |
|---|---|
| tipo, modelo | Tipo de intervalo e identificador de modelo de LLM. |
| configurações.maxTokens, setting.temperature | Configurações do LLM. |
| toolCalls | Matriz de chamadas de ferramenta feitas durante a conclusão. |
| uso.completionTokens, uso.promptTokens, uso.totalTokens | Uso de token. |
| use.isByoExecution, use.executionDeploymentType, use.isPiiMascare | Metadados de execução. |
| erro | Detalhes do erro, se houver. |
Atributos de ferramentaCall (attributes.type = "toolCall"):
| Atributo | Description |
|---|---|
| tipo, callId, ferramentaNome | Identidade da chamada de ferramenta. |
| argumentos, ferramentaType | Argumentos de chamada e tipo de ferramenta. |
| Resultado | Resultado da chamada de ferramenta. |
| erro | Detalhes do erro, se houver. |
Atributos ferramenta GuardrailEvaluation (attributes.type = "toolGuardrailEvaluation"):
| Atributo | Description |
|---|---|
| tipo, guardrailName, guardrailDescription | Identidade da proteção. |
| guardrail Action, detalhes, ação | Ação e resultado da proteção. |
| argumentos, resultado | Entradas e resultado da avaliação. |
| Nível de severidade | Classificação de gravidade. |
| erro | Detalhes do erro, se houver. |
Exportar limites
| Limite | Valor |
|---|---|
| Valor máximo do atributo individual | 32 kB |
| Total máximo de atributos por intervalo | 256 kB |
| Tamanho máximo do lote OTLP | ~1 MB (protobuf) |
| File attachments | Apenas metadados (ID, nome do arquivo, tipo MIME). O conteúdo do arquivo não é exportado. |
Exemplo: trace OTEL (quatro intervalos para uma execução 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": ""
}
]