> 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/genesis.md). # Genesis ## Incrementar Métrica de Negócio ### Visão Geral O componente **Incrementar Métrica de Negócio** registra métricas de execução do robô que são exibidas no **Orquestrador** e no **Hub**. A cada vez que o componente é executado, ele incrementa um contador do tipo de métrica escolhido — permitindo acompanhar totais de sucesso, erros e alertas ao longo das execuções.

Componente Incrementar Métrica de Negócio na rotina

*** ### Pré-requisitos * Robô publicado no Orquestrador para que as métricas sejam exibidas no Orquestrador e no Hub *** ### Como usar #### Passo 1 — Posicionar o componente na rotina Adicione o componente **Incrementar Métrica de Negócio** ao final do fluxo da rotina (ou em cada ramificação de resultado), de acordo com o desfecho esperado: * Ao final de uma execução bem-sucedida → use o tipo **Sucesso** * Ao capturar um erro técnico do robô → use o tipo **Erro de Robô** * Ao identificar uma falha de regra de negócio → use o tipo **Erro de Negócio** * Ao detectar uma situação de atenção sem falha → use o tipo **Alerta** #### Passo 2 — Configurar o componente No painel de configuração, preencha os campos: * **Título** — nome de exibição do componente na rotina * **Nome Identificador do Componente** — identificador único gerado automaticamente * **Escopo** — selecione **Projeto** ou **Rotina** conforme onde a métrica deve ser contabilizada * **Tipo de Métrica** — escolha o tipo que representa o desfecho daquele ponto do fluxo

Painel de configuração com o dropdown Tipo de Métrica aberto

#### Passo 3 — Executar o robô A cada execução do componente, o contador do tipo de métrica selecionado é incrementado em 1. Os totais acumulados ficam disponíveis no **Orquestrador** e no **Hub** para acompanhamento. *** ### Campos e opções | Campo | Descrição | Valores aceitos | | -------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------- | | Título | Nome de exibição do componente na rotina | Texto | | Nome Identificador do Componente | Identificador único do componente | Texto (gerado automaticamente) | | Escopo | Define se a métrica pertence ao projeto inteiro ou apenas à rotina | Projeto / Rotina | | Tipo de Métrica | Tipo de desfecho a ser contabilizado | Sucesso, Erro de Robô, Erro de Negócio, Alerta | #### Tipos de Métrica | Tipo | Quando usar | | --------------- | -------------------------------------------------------------------------------------------------- | | Sucesso | Execução concluída com êxito | | Erro de Robô | Falha técnica do robô (ex: elemento não encontrado, timeout, exceção) | | Erro de Negócio | Falha de regra de negócio (ex: dado inválido, registro não encontrado, condição não atendida) | | Alerta | Situação que merece atenção mas não impediu a execução (ex: dado incompleto, valor fora do padrão) | *** ### Observações e dicas * 💡 Posicione o componente **ao final de cada ramificação** do fluxo — assim você garante que toda execução (com ou sem erro) gera uma métrica, e os totais refletem com precisão o volume real processado. * 💡 Use **Erro de Robô** para exceções técnicas (problemas de automação) e **Erro de Negócio** para falhas de regra — essa separação facilita a análise de causa raiz no Orquestrador e Hub. * 💡 O escopo **Rotina** contabiliza métricas apenas da rotina onde o componente está. O escopo **Projeto** agrega as métricas em nível de projeto — útil quando várias rotinas compõem um mesmo robô. * ⚠️ As métricas só aparecem no Orquestrador e Hub se o robô estiver **publicado**. Execuções locais no modo de depuração não geram métricas visíveis nesses painéis.