> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-es/agente/observability.md).

# Monitoreo y depuración

Supervisa tus Agentes de IA, RAG y flujos de trabajo en tiempo real.

El [Inspector](https://inspector.dev/) el equipo diseñó Neuron con funciones de observabilidad integradas, para que puedas supervisar la ejecución de agentes de IA, ayudándote a mantener implementaciones de nivel de producción con confianza.

### Suscripción de listeners

Los listeners se indexan por clase con coincidencia instanceof: suscríbete a una clase de evento específica, o a `ObservabilityEvent::class` para recibir todo:

```php
use NeuronAI\Observability\Events\InferenceStop;
use NeuronAI\Observability\ObservabilityEvent;

// Reacciona a un tipo de evento
$agent->subscribe(InferenceStop::class, function (InferenceStop $event): void {
    // haz algo...
});

// Eventos genéricos
$agent->subscribe(ObservabilityEvent::class, function (ObservabilityEvent $event): void {
    echo "Evento: {$event->name()}\n";
    echo "Origen: " . ($event->source !== null ? $event->source::class : 'n/a') . "\n";
});
```

#### Eventos personalizados

Emite tus propios eventos desde los nodos con `Node::emit()` — el objeto del evento es la carga útil. Extiende `ObservabilityEvent` :

```php
use NeuronAI\Observability\ObservabilityEvent;

class DocumentScored extends ObservabilityEvent
{
    public function __construct(public string $documentId, public float $score)
    {
    }
}

// Dentro de un nodo
$this->emit(new DocumentScored($doc->id, $score));

// En cualquier parte
$workflow->subscribe(DocumentScored::class, fn (DocumentScored $e) => $metrics->gauge('score', $e->score));
```

#### Integración con un framework anfitrión

Reenvía cada evento a un dispatcher PSR-14 de toda la aplicación (Symfony, el puente PSR de Laravel, League\Event) — los eventos de Neuron se convierten en eventos normales de la aplicación:

```php
$agent->setEventDispatcher($appEventDispatcher);
```

### Instala Inspector <a href="#install-inspector" id="install-inspector"></a>

Conecta tus agentes de IA de Neuron, RAG o workflows al panel de monitorización de Inspector:

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}

Después de conectar tu aplicación a Inspector, cuando se ejecuten tus agentes, podrás explorar los detalles de sus pasos de inferencia, llamadas a herramientas y más.

<figure><img src="https://content.gitbook.com/content/GHx4l2LknIex7vFIUg1R/blobs/c3hAqFgQsCv0wAgHHHVS/inspector-neuron-monitoring-timeline.png" alt=""><figcaption></figcaption></figure>

Si quieres monitorizar toda la aplicación, puedes instalar el paquete Inspector según tu entorno de desarrollo. Proporcionamos paquetes de integración para [PHP](https://github.com/inspector-apm/inspector-php), [Laravel](https://github.com/inspector-apm/inspector-laravel), [Symfony](https://github.com/inspector-apm/inspector-symfony), [CodeIgniter](https://github.com/inspector-apm/inspector-codeigniter), [Drupal](https://docs.inspector.dev/guides/drupal). Consúltalos en nuestra [organización de GitHub](https://github.com/inspector-apm).

### Crear una clave de ingesta

Para crear una clave de ingesta, ve al [**panel de Inspector**](https://app.inspector.dev/register) y crea una nueva app.

{% hint style="success" %}
Para cualquier soporte adicional, entra al chat en vivo del panel. Estaremos encantados de escuchar tu experiencia, encontrar posibles mejoras nuevas y hacer que la herramienta mejore con el tiempo.
{% endhint %}

### Registra el listener de Inspector

Si tu aplicación no tiene una integración específica con variables de entorno de PHP, puedes inyectar el `InspectorListener` componente en el agente de forma programática, pasando la clave de ingesta generada en el panel:

```php
use NeuronAI\Observability\InspctorObserver;

/*
 * Inyectar en tiempo de ejecución
 */
$message = MyAgent::make()
    ->subscribe(
        ObservabilityEvent::class, 
        InspctorObserver::instance('INSPECTOR_INGESTION_KEY')
    )
    ->chat(...)
    ->getMessage();
    
/*
 * Configura el listener una sola vez en el constructor del agente
 */
class MyAgent extends Agent
{
    public function __construct()
    {
        parent::__construct();
        
        $this->subscribe(
            ObservabilityEvent::class, 
            InspctorObserver::instance('INSPECTOR_INGESTION_KEY')
        );
    }
}
```

## Registro

Si quieres registrar la actividad del agente en tu sistema de logs, puedes adjuntar el integrado `LogListener` a tu agente pasando una instancia de un PSR `LoggerInterface` registrador compatible, como Monolog por ejemplo:

```php
use NeuronAI\Observability\LogListener;
use NeuronAI\Observability\ObservabilityEvent;

$message = MyAgent::make()
    ->subscribe(ObservabilityEvent::class, new LogListener($logger))
    ->chat(...)
    ->getMessage();
```

Todos los eventos internos con su carga útil se registrarán.
