Volumetria

Como configurar volumetria no seu Orquestrador e HUB

Visão Geral

A Volumetria é o conjunto de métricas que registra e exibe o desempenho das execuções dos robôs — totalizando Sucessos, Alertas, Erros de Negócio e Erros de Robô. Os dados são gerados no Genesis (via componente Incrementar Métrica de Negócio), armazenados pelo Orquestrador e visualizados tanto no Orquestrador quanto no HUB.

Visão geral do fluxo de volumetria: Genesis → Orquestrador → HUB

---

Pré-requisitos

• Robô desenvolvido no Genesis com o componente Incrementar Métrica de Negócio configurado

• Robô publicado no Orquestrador

• Execução realizada via Orquestrador

---

Como funciona — Fluxo completo

Etapa	Ferramenta	O que acontece
1	Genesis	O componente Incrementar Métrica de Negócio registra o tipo de desfecho a cada execução
2	Orquestrador	Armazena os registros e exibe a volumetria nos detalhes de cada tarefa
3	HUB	Consolida os dados e exibe totais e assertividade na listagem de robôs

---

Passo 1 — Configurar a Volumetria no Genesis

Adicione o componente Incrementar Métrica de Negócio ao final de cada ramificação do fluxo da rotina, escolhendo o Tipo de Métrica que representa o desfecho daquele caminho:

Componente Incrementar Métrica de Negócio configurado na rotina do Genesis

Tipo de Métrica	Quando usar
Sucesso	Execução concluída com êxito
Alerta	Situação de atenção sem falha crítica
Erro de Negócio	Falha de regra de negócio (dado inválido, condição não atendida)
Erro de Robô	Falha técnica da automação (elemento não encontrado, timeout)

💡 Posicione o componente em todas as ramificações do fluxo — assim toda execução, com ou sem erro, gera uma métrica e os totais refletem o volume real processado.

Após configurar, publique o robô no Orquestrador para que as métricas sejam registradas nas execuções.

---

Passo 2 — Visualizar Volumetria no Orquestrador

Após a execução do robô, acesse os detalhes da tarefa para visualizar a volumetria:

1. No Orquestrador, navegue até Runtime e localize a tarefa desejada

2. Clique nos três pontinhos (⋮) na linha da tarefa

3. Selecione Detalhes

Menu de ações da tarefa com as opções Detalhes, Eliminar e Reprocessar

O painel de detalhes exibirá:

• Nome — nome e versão do robô

• Id de Execução — identificador único da execução

• Início / Fim — data e hora da execução

Volumetria:

• Sucessos

• Alertas

• Erros de Negócio

• Erros de Robô

Resultado:

• Código — código de retorno (ex: RPA001)

• Mensagem — mensagem de retorno da execução

Painel Detalhes da execução com Volumetria e Resultado

No rodapé do painel estão disponíveis as ações:

Ação	Função
Reprocessar	Reexecuta a tarefa com os mesmos parâmetros
Eliminar	Remove a tarefa do histórico
Exportar Log	Exporta o log completo da execução

---

Passo 3 — Visualizar Volumetria no HUB

No HUB, a volumetria é exibida diretamente na listagem de robôs, sem necessidade de entrar em cada execução:

1. Acesse a listagem de robôs no HUB

2. Localize o robô desejado

3. Passe o mouse sobre o valor da coluna Documentos Processados

Um tooltip será exibido com o detalhamento por tipo:

• Sucesso

• Alerta

• Erro

Tooltip de volumetria na coluna Documentos Processados no HUB

As colunas relacionadas à volumetria na listagem:

Coluna	Descrição
Documentos Processados	Total de itens processados. Passe o mouse para ver o detalhamento por tipo de métrica
Assertividade no Processamento	Percentual de execuções bem-sucedidas em relação ao total processado

---

Observações e dicas

• 💡 Configure o Incrementar Métrica de Negócio em todas as ramificações da rotina — incluindo os caminhos de erro — para garantir que o total de Documentos Processados reflita o volume real.

• 💡 Separe Erro de Robô (falha técnica) de Erro de Negócio (falha de regra) — essa distinção facilita a análise de causa raiz e a priorização de correções.

• 💡 A Assertividade no Processamento no HUB é calculada automaticamente com base nos totais — quanto mais Sucessos em relação ao total, maior o percentual.

• 💡 Use Exportar Log no Orquestrador para arquivar ou compartilhar os detalhes de execuções específicas.

• ⚠️ Sem o componente Incrementar Métrica de Negócio no robô, todos os contadores de volumetria permanecerão zerados no Orquestrador e no HUB.

• ⚠️ As métricas só são registradas em execuções realizadas via Orquestrador — execuções locais no modo de depuração do Genesis não geram volumetria.

• ⚠️ Eliminar uma tarefa no Orquestrador remove permanentemente seus dados de volumetria do histórico.