> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/volumetria.md).

# Volumetria

### 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**.

<figure><img src="/files/fveqwSRDbAvKgmrF9fwz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bXDIUb9K22uig101mv3E" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NBgy5bhMDilXYtdxkfUT" alt=""><figcaption></figcaption></figure>

<p align="center">Visão geral do fluxo de volumetria: Genesis → Orquestrador → HUB</p>

***

### 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:

<figure><img src="/files/63gIU7y06EqiNG4TH6N3" alt=""><figcaption></figcaption></figure>

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**

<figure><img src="/files/bPe8ck9HL126UShH8IS9" alt=""><figcaption></figcaption></figure>

<p align="center">Menu de ações da tarefa com as opções <strong>Detalhes</strong>, <strong>Eliminar</strong> e <strong>Reprocessar</strong></p>

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

<figure><img src="/files/XqFypbZqDxdGVdgpRkro" alt=""><figcaption></figcaption></figure>

<p align="center">Painel <strong>Detalhes</strong> da execução com Volumetria e Resultado</p>

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**

<figure><img src="/files/3IYVBOhOoij7XtrOlWef" alt=""><figcaption></figcaption></figure>

<p align="center">Tooltip de volumetria na coluna <strong>Documentos Processados</strong> no HUB</p>

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.