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

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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.roboteasy.tech/studio/geral/volumetria.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.