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

# Observabilidad - Eventos de Nodo

> Configura eventos de seguimiento en tus nodos para alimentar tus métricas y paneles de rendimiento

La **observabilidad** en Brain Studio te permite registrar eventos de seguimiento directamente desde la configuración de tus nodos, para entender cómo interactúan los usuarios en cada punto de tu workflow. Estos eventos alimentan tus métricas y paneles de rendimiento.

## ¿Cómo funciona?

Los paneles de configuración de nodos como **HTTP, SOAP, Código, Tool, Condicional, Skill y AI Agent**, entre otros, incluyen una pestaña **Eventos**. Desde ahí puedes registrar hasta **10 eventos por nodo**, cada uno con su propio nombre, condición de emisión y propiedades personalizadas.

Cuando un nodo tiene eventos configurados, verás una insignia debajo de él en el canvas con un resumen de los eventos activos. Si no has configurado ninguno, la insignia muestra **"Sin eventos activos"**.

## Configurar un evento

<Steps>
  <Step title="Abre la pestaña Eventos">
    Selecciona el nodo que quieres instrumentar y entra a su panel de configuración. Junto a la pestaña **General** encontrarás la pestaña **Eventos**, con el título **"Configuración de evento"**.
  </Step>

  <Step title="Agrega un evento">
    Haz clic en **"Agregar evento"** y completa el campo **"Nombre del evento"**. El nombre debe estar en **snake\_case** (por ejemplo, `payment_attempted` o `cita_agendada`); si no cumple el formato, verás el error **"Debe ser snake\_case"**.
  </Step>

  <Step title="Agrega propiedades (opcional)">
    En **"Propiedades del evento"**, usa **"Agregar campo"** para incluir hasta 5 pares de clave/valor. El valor puede ser una variable dinámica, como `{{$context.amount}}` o `{{$memory.nombre_cliente}}`.

    <Tip>
      Consulta las [Variables de Contexto](/guides/variables/context) disponibles para saber qué datos puedes incluir en el payload de tus eventos.
    </Tip>
  </Step>
</Steps>

<Note>
  Límites por nodo: máximo **10 eventos**, cada uno con hasta **5 propiedades**. Los nombres de evento y de propiedad deben escribirse en snake\_case.
</Note>

## Ejemplo práctico

<AccordionGroup>
  <Accordion title="Evento de pago exitoso en un nodo Tool">
    Tienes un nodo Tool llamado **"Cobrar Pago"** que procesa un cobro. Configuras un evento así:

    * **Nombre del evento**: `payment_attempted`
    * **Cuándo registrar el evento**: Éxito
    * **Propiedades del evento**:
      * `monto`: `{{$context.amount}}`
      * `metodo`: `{{$context.payment_method}}`

    Cada vez que el nodo complete un cobro exitosamente, se registrará este evento con el monto y el método de pago usados, listos para analizarse en tus métricas.
  </Accordion>

  <Accordion title="Evento de error en un nodo API">
    Tienes un nodo API que consulta un sistema externo. Configuras un evento para detectar fallas:

    * **Nombre del evento**: `consulta_externa_fallida`
    * **Cuándo registrar el evento**: Error
    * **Propiedades del evento**:
      * `codigo_error`: `{{$context.statusCode}}`

    Esto te permite identificar rápidamente cuántas veces y por qué falla esa integración.
  </Accordion>
</AccordionGroup>

<Note>
  Esta funcionalidad se está habilitando progresivamente para las empresas en Brain Studio.
</Note>

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Nodos de Brain Studio" icon="sitemap" href="/guides/nodos/introduction">
    Conoce todos los tipos de nodos disponibles y cómo configurarlos.
  </Card>

  <Card title="Variables de Contexto" icon="code" href="/guides/variables/context">
    Aprende a usar `$context` y otras variables disponibles durante la ejecución.
  </Card>

  <Card title="Tu Primer Workflow" icon="comments" href="/guides/getting-started/tu-primer-workflow">
    Aprende a crear tu primer workflow desde cero.
  </Card>
</CardGroup>