> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Observabilidade - Eventos de Nó

> Configure eventos de rastreamento nos seus nós para alimentar suas métricas e painéis de desempenho

A **observabilidade** no Brain Studio permite registrar eventos de rastreamento diretamente na configuração dos seus nós, para entender como os usuários interagem em cada ponto do seu workflow. Esses eventos alimentam suas métricas e painéis de desempenho.

## Como funciona?

Os painéis de configuração de nós como **HTTP, SOAP, Código, Tool, Condicional, Skill e AI Agent**, entre outros, incluem uma aba **Eventos**. A partir dela você pode registrar até **10 eventos por nó**, cada um com seu próprio nome, condição de emissão e propriedades personalizadas.

Quando um nó tem eventos configurados, você verá um selo abaixo dele no canvas com um resumo dos eventos ativos. Se nenhum estiver configurado, o selo mostra **"Sem eventos ativos"**.

## Configurar um evento

<Steps>
  <Step title="Abra a aba Eventos">
    Selecione o nó que deseja instrumentar e acesse seu painel de configuração. Ao lado da aba **Geral**, você encontrará a aba **Eventos**, com o título **"Configuração de evento"**.
  </Step>

  <Step title="Adicione um evento">
    Clique em **"Adicionar evento"** e preencha o campo **"Nome do evento"**. O nome deve estar em **snake\_case** (por exemplo, `payment_attempted` ou `consulta_agendada`); se não seguir esse formato, você verá o erro **"Deve ser snake\_case"**.
  </Step>

  <Step title="Adicione propriedades (opcional)">
    Em **"Propriedades do evento"**, use **"Adicionar campo"** para incluir até 5 pares de chave/valor. O valor pode ser uma variável dinâmica, como `{{$context.amount}}` ou `{{$memory.nome_cliente}}`.

    <Tip>
      Consulte as [Variáveis de Contexto](/pt/guias/variaveis/context) disponíveis para saber quais dados você pode incluir no payload dos seus eventos.
    </Tip>
  </Step>
</Steps>

<Note>
  Limites por nó: máximo de **10 eventos**, cada um com até **5 propriedades**. Os nomes de evento e de propriedade devem ser escritos em snake\_case.
</Note>

## Exemplo prático

<AccordionGroup>
  <Accordion title="Evento de pagamento bem-sucedido em um nó Tool">
    Você tem um nó Tool chamado **"Cobrar Pagamento"** que processa uma cobrança. Você configura um evento assim:

    * **Nome do evento**: `payment_attempted`
    * **Quando registrar o evento**: Sucesso
    * **Propriedades do evento**:
      * `valor`: `{{$context.amount}}`
      * `metodo`: `{{$context.payment_method}}`

    Toda vez que o nó concluir uma cobrança com sucesso, esse evento será registrado com o valor e o método de pagamento usados, prontos para serem analisados nas suas métricas.
  </Accordion>

  <Accordion title="Evento de erro em um nó API">
    Você tem um nó API que consulta um sistema externo. Você configura um evento para detectar falhas:

    * **Nome do evento**: `consulta_externa_falhou`
    * **Quando registrar o evento**: Erro
    * **Propriedades do evento**:
      * `codigo_erro`: `{{$context.statusCode}}`

    Isso permite identificar rapidamente quantas vezes e por que essa integração falha.
  </Accordion>
</AccordionGroup>

<Note>
  Essa funcionalidade está sendo habilitada progressivamente para as empresas no Brain Studio.
</Note>

## Artigos relacionados

<CardGroup cols={2}>
  <Card title="Nós do Brain Studio" icon="sitemap" href="/pt/guias/nodos/introducao">
    Conheça todos os tipos de nós disponíveis e como configurá-los.
  </Card>

  <Card title="Variáveis de Contexto" icon="code" href="/pt/guias/variaveis/context">
    Aprenda a usar `$context` e outras variáveis disponíveis durante a execução.
  </Card>

  <Card title="Seu Primeiro Workflow" icon="comments" href="/pt/guias/primeiros-passos/seu-primeiro-workflow">
    Aprenda a criar seu primeiro workflow do zero.
  </Card>
</CardGroup>