UiPath Documentation
maestro
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Maestro

Última atualização 22 de abr de 2026

Trabalho com o gerenciamento de instâncias

A página inicial de Visão geral do processo fornece um resumo operacional de todas as instâncias de processos e inclui um painel de instâncias ativas, uma tabela de todos os incidentes e uma tabela de todos os processos.

Painel de instâncias ativas

O painel de instâncias ativas exibe a contagem de todas as instâncias, divididas por instâncias em execução versus instâncias com falha.

todas as instâncias ativas

Tabela de incidentes

A tabela de incidentes exibe todos os incidentes não resolvidos, com cada incidente correspondente a uma instância com falha. A tabela é organizada por mensagem de erro por processo e inclui o tempo decorrido desde que uma mensagem de erro específica foi vista pela primeira vez para esse processo.

incidentes

Tabela de processos

A tabela de processos contém uma lista de todos os processos no tenant ao qual o usuário tem acesso. A tabela inclui as contagens para o número de instâncias em execução, instâncias com falha e instâncias totais, bem como o número de versões e o local da pasta no Orchestrator.

Observação:

Os processos nessa visualização são baseados nas permissões que você tem como usuário no Orchestrator, mais especificamente uma permissão de pasta para visualização de processos, ou você pode usar a função de pasta predefinida Automation User.

Processos

Detalhes do Processo

Quando você selecionar um processo específico da tabela Processos, uma tabela de todas as instâncias para esse processo aparecerá. Além disso, você pode visualizar um diagrama representando o modelo de processo selecionando uma única versão na tabela.

visualização de todas as instâncias

Painel de todas as instâncias do processo

O painel de todas as instâncias do processo oferece uma visualização histórica e em tempo real de cada execução do processo em seu espaço de trabalho. Use essa tela para monitorar a atividade de automação, solucionar falhas e entender as tendências de desempenho.

Imagem dos documentos

  1. Principais processos por instâncias

    Ver quais processos são executados com mais frequência. Essa visualização ajuda a identificar fluxos de trabalho de alto volume que podem precisar de otimização ou monitoramento adicionais.

    • Exibe a contagem total de execuções por processo.
    • Os links permitem que você navegue diretamente para o histórico detalhado desse processoExemplo: com 151 instâncias é o processo mais ativo neste WorkSpace.
  2. Principais processos por duração

    Identificar processos com os tempos de execução agregados mais longos. Isso pode descobrir gargalos ou fluxos de longa duração que precisam de revisão.

    • Agrega o runtime total de todas as instâncias.
    • Útil para monitoramento e otimização de desempenho.

    O mesmo processo Loan.Origination.and.Review tem mais de 201 dias de runtime combinado.

  3. Status da instância do processo (gráfico de barras)

    Um gráfico visual mostrando quantas instâncias foram concluídas, falharam ou foram canceladas ao longo do tempo.

    • Concluído (verde)
    • Com falha (vermelho)
    • Cancelado (cinza) Use isso para detectar tendências ao longo dos dias ou identificar anomalias. Um pico de falhas e conclusões em 22 de abril pode indicar uma implantação recente ou uma falha em um sistema a montante.
  4. Tabela de processos (com filtros)

    Essa tabela fornece uma especificação detalhada por nomes de processo, incluindo:

    ColunaDescription
    Em execuçãoInstâncias de processo ativas no momento
    ConcluídoTotal concluído com sucesso
    Com falhaTotal que falhou devido a erro
    TotalContagem combinada de todas as execuções
    VersõesNúmero de versões de processo publicadas
    LocationPasta do Orchestrator onde o processo é implantado
    Dica:

    Você pode pesquisar, filtrar por local ou atualizar esta tabela em tempo real.

  5. Explorando detalhes da instância

    Para visualizar informações detalhadas sobre execuções de processos individuais:

    1. Selecione o link do nome do processo (por exemplo, Loan.Origination.and.Review) na lista ou gráficos. Isso abre a visualização de detalhes da instância.
    2. Usar filtros para visualizar instâncias por:
      • Status: Em execução, Concluído, Com falha, Cancelado
      • Intervalo de data/hora
      • Version number
      • Filtros de valores personalizados
      • Elementos específicosEssa Visualização detalhada ajuda você a Debug, auditoria e otimizar com Completa transparência.

Visualização de instância única

Quando você seleciona uma única instância na visualização Todas as instâncias, um diagrama mostrando o status de execução de cada etapa aparece. Esse diagrama é acompanhado pela trilha de execução da instância e dados de histórico de variáveis e ações pertinentes. A visualização de instância única permite que você veja toda a trilha de execução, histórico de ações, detalhes da etapa e variáveis globais em um local centralizado.

A trilha de execução da instância delineia claramente cada etapa na execução do processo da instância, incluindo etapas hierárquicas, como agentes e subprocessos. Para investigar mais a fundo, você pode selecionar um nó específico no diagrama ou uma etapa na Trilha de execução. O componente selecionado será destacado em azul, revelando detalhes como ID da etapa, rótulo, variáveis de entrada/saída, duração de execução e links para tarefas adicionais, como abrir um trabalho ou tarefa de aplicativo.

A guia Histórico de ações exibe detalhes para ações de gerenciamento de instâncias que foram adotadas, incluindo detalhes sobre a ação realizada, o indivíduo responsável e quaisquer comentários fornecidos. Essas informações completas garantem transparência completa e rastreabilidade de cada etapa na execução da instância.

Visualização de instância única

Na guia Trilha de execução, se você clicar na primeira linha, você exibirá as Variáveis globais, mas se clicar em qualquer outra linha, você disparará a exibição das Variáveis.

  • As variáveis globais são compartilhadas entre instâncias do mesmo processo, elas são persistentes e mantêm seu valor além de uma instância.
  • As variáveis são locais para a instância do processo, são definidas dentro de uma determinada instância de processo e representam o estado atual ou o contexto de dados dessa instância específica.

Funções e permissões

Os processos nesta visualização são baseados nas permissões que você tem como usuário no Orchestrator, mais especificamente:

  • uma permissão de pasta para visualização de trabalhos, ou você pode usar a função de pasta predefinida do Automation User.
  • uma permissão do tenant para visualizar pacotes, ou você pode usar a função predefinida de tenant Permitir que seja Automation User.

Gerenciar uma instância

Você também pode gerenciar a instância, incluindo pausar, retomar, tentar novamente, cancelar, mover e migrar.Quando você executa uma dessas ações, há uma seção de comentários onde você pode registrar detalhes adicionais. Esses comentários são então exibidos na seção de histórico de ações.

Pausar

A execução da ação de pausa em uma instância pausa a execução após a conclusão de todas as etapas atualmente em execução.

Retomar

Retomar a execução em uma instância retomará a execução.

Tentar novamente

A execução da ação de tentar novamente em uma instância reinicia todas as atividades atuais no fluxo de trabalho a partir da última etapa concluída. Normalmente, isso é feito após editar uma variável ou atualizar algo em um sistema externo para uma instância com falha.

repetir instância

Migrar

A execução da ação de migração em uma instância a atualiza para uma versão diferente do processo.Isso permite que você atualize a instância com a lógica e as configurações mais recentes da versão de destino.

Migrar instância

migrar a instância para um callout de nova versão

Cancelar

A execução da ação de cancelamento em uma instância interromperá todas as atividades atuais e encerrará seu progresso no processo com agente.Esta ação é irreversível.

Observação:

Se você cancelar uma instância que contém uma tarefa com intervenção humana, o Maestro exclui automaticamente essa tarefa para que você não precise acessar o Action Center e removê-la manualmente.

Mover

A execução da ação Mover em uma instância permite que você altere a sequência realocando a execução para um elemento de processo diferente. Isso é normalmente aplicado a instâncias com falha ou pausadas quando uma etapa anterior requer nova execução ou quando você deseja ignorar as etapas atuais e prosseguir para as posteriores.

Após executar o Mover, você deve selecionar a opção Tentar novamente ou Migrar para retomar a execução.

Observação:

Essa operação pode resultar em interrupção do caminho de execução em andamento e potencialmente afetar a consistência do processo. Certos valores de variáveis necessários no novo local podem não ser gerados automaticamente, necessitando de possíveis atualizações manuais para maior precisão.

mover instância

Registo, trilhas de auditoria e rastreabilidade de execuções

Esta página explica como o Maestro é compatível com auditabilidade, rastreabilidade operacional e conformidade para processos de longa duração e com vários atores. Ele descreve quais dados de execução o Maestro registra, por que esses dados são gravados, onde você pode acessá-los e como pode retê-los ou exportá-los para atender a requisitos regulatórios e operacionais.

Essas informações aplicam-se a processes orquestrados pelo Maestro no UiPath Automation Cloud. O Maestro depende dos principais Serviços da UiPath Platform (como Orchestrator, registros de auditoria do Automation Cloud, Insights e AI Trust Layer) para aplicar registro, retenção e controles de acesso.

Intenção da execução e objetivos da auditoria

O registro do Maestro é projetado para oferecer suporte aos seguintes resultados:

  • Rastrear uma transação de negócios de ponta a ponta em robôs, agentes, seres humanos e sistemas externos
  • Reconstruir como e por que um processo seguiu um caminho de execução específico
  • Oferecer suporte a auditorias internas e externas sem persistir em dados desnecessários do cliente
  • Habilitar as equipes de operações a investigar falhas, NovasTentativas e problemas de desempenho

O Maestro registra metadados de execução no nível de orquestração em vez de cargas de negócios completas. Esse design equilibra requisitos de auditoria, desempenho e minimização de dados.

O que o Maestro grava durante a execução do processo

Para cada instância de processo, o Maestro registra metadados de execução que descrevem o que foi executado, quando foi executado e quem ou o que o executou.

O Maestro registra:

  • Etapas do processo e etapas do subprocesso executadas
  • Carimbos de data/hora de execução, incluindo hora de início, hora da conclusão e duração
  • Status da execução, como status em execução, concluído, com falha ou pausado
  • Informações de identidade de execução para cada etapa
  • Valores de variáveis capturados na conclusão da etapa

O Maestro registra esses dados para oferecer suporte ao monitoramento operacional, solução de problemas e reconstrução de auditoria do comportamento do processo.

Identidade do ator e contexto da execução

O Maestro registra informações de identidade de execução que permitem que você determine quem ou o que executou cada etapa.

Para cada etapa executada, o Maestro registra:

  • RobotUserName para automação executada por robôs
  • Links diretos com a entidade de execução dentro da UiPath Platform

O Maestro não armazena um campo dedicado ao tipo de ator, como humano, robô ou agente. Você pode inferir o tipo de ator a partir da identidade gravada e do contexto da execução.

Essa abordagem preserva a rastreabilidade sem duplicar modelos de identidade em serviços de plataforma.

Decisões e caminhos de execução

O Maestro registra caminhos de execução em vez de rótulos de decisão abstratos.

O Maestro não registra campos de decisão explícitos ou resultados de regras. Em vez disso, o Maestro registra o caminho seguido por meio de gateways, subprocessos e fluxos condicionais.

Você pode reconstruir decisões revisando:

  • O modelo BPMN
  • O caminho executado exibido na trilha de execução da instância
  • A sequência e o tempo das etapas concluídas

Este design permite que auditores e operadores entendam por que um processo seguiu uma rota específica sem introduzir artefatos de decisão redundantes.

Entradas, saídas e tratamento de dados do cliente

O Maestro limita a persistência dos dados para reduzir a exposição de informações confidenciais.

Por padrão, o Maestro não registra:

  • Cargas de negócios completas
  • Conteúdo do Documento
  • Dados do cliente trocados com sistemas externos

O Maestro registra instantâneos de estado variável na conclusão da etapa para oferecer suporte à rastreabilidade e à depuração.

Quando um processo usa arquivos, o Maestro os trata como anexos de trabalho que estão limitados a uma única instância de processo. As permissões e políticas de retenção da plataforma controlam o acesso a esses arquivos.

Onde você pode visualização dados de execução e auditoria

A UiPath revela dados de execução do Maestro por meio de diversas visualizações operacionais e de auditoria.

Você pode usar:

  • Visualização de Todas as instâncias para rastrear uma execução de processo individual de ponta a ponta, incluindo progressão de etapas, momento e duração
  • Visualização de Todos os incidentes para investigar falhas, novas tentativas e ações de recuperação
  • Logs do Orchestrator para analisar detalhes de execução no nível do robô
  • Insights para analisar dados de execução ao longo do tempo usando painéis pré-criados e personalizados

Visualização da instância

O Insights ingere eventos de execução do Maestro, incluindo execuções de processos, execuções de elementos e incidentes. A UiPath expõe esses dados por meio do painel de modelos do Maestro, que é compatível com revisões de auditoria, relatórios operacionais e análises de tendências.

Juntas, essas visualizações oferecem suporte a análises detalhadas, desde monitoramento de alto nível até etapas de execução individuais.

Logs de auditoria, ingestão e retenção do Insights

O UiPath Automation Cloud gerencia o registro de auditoria e retenção para execuções do Maestro.

Por padrão:

  • Automation Cloud audit logs are retained for up to 2 years. Check About logs – Retention periods for more information.
  • Robot execution logs and backups are retained for 30 days.
  • Os traces de execução do Maestro ingeridos no Insights são retidos por:
    • 2 years on the Standard platform tier.
    • 5 years on the Advanced platform tier.

Retention periods depend on platform tier and service configuration. You can export audit and Insights data to meet longer retention or regulatory requirements. Check Exporting logs for more information.

Exportação de logs e apoiao à conformidade

Você pode exportar logs de auditoria e metadados de execução relacionados ao Maestro para oferecer suporte à conformidade, investigações e arquivamento de longo prazo. A UiPath é compatível com a exportação de CSV de logs de auditoria do Automation Cloud. Você pode armazenar dados exportados em sistemas gerenciados pelo cliente ou ingerí-los em fluxos de trabalho de governança, risco e conformidade.

Etapas baseadas em IA e a AI Trust Layer

Quando um processo usa etapas baseadas em IA roteadas por meio da AI Trust Layer, a UiPath registra metadados de auditoria sobre o uso da IA.

Esses metadados incluem:

  • Identificador de modelo
  • Contexto do produto e do tenant
  • Metadados de invocação

Por padrão, a UiPath exclui solicitações do cliente e conteúdo gerado por IA dos logs de auditoria. Você pode configurar políticas de governança de IA para controlar o comportamento do registro quando necessário.

A disponibilidade de detalhes de auditoria de IA depende da configuração de funcionalidades e do status de versão.

Correlação de dados do Maestro com sistemas externos

Você pode correlacionar dados de execução do Maestro com logs de sistemas externos, como Salesforce, ServiceNow ou AWS.

Para oferecer suporte à rastreabilidade de ponta a ponta, você pode usar:

  • Identificadores de negócios compartilhados
  • Identificadores de instâncias
  • Carimbos de data e hora de execução

Você pode exportar dados de auditoria do Maestro e ingerí-los em registros gerenciados pelo cliente ou plataformas SIEM para oferecer suporte a monitoramento centralizado e fluxos de trabalho de auditoria.

O que o Maestro não registra por padrão

O Maestro segue princípios de minimização de dados e evita a persistência de informações desnecessáras.

Por padrão, o Maestro não registra:

  • Cargas ou documentos de negócios completos
  • Solicitações ou respostas de IA que contêm conteúdo do cliente
  • Campos de decisão explícita ou resultado de regras

Esse design é compatível com operações seguras enquanto preserva a capacidade de reconstruir o comportamento da execução do processo para fins de auditoria e conformidade.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades