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

# Monitorización y depuración

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

## Instalar Inspector

Puedes seguir esta guía paso a paso para conectar tus agentes de IA Neuron, RAG o Workflow al panel de supervisión de Inspector:

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

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

<figure><img src="/files/02f90f37b378de4f542e846b32100182ca2bf5ba" alt=""><figcaption></figcaption></figure>

Si quieres supervisar toda la aplicación, puedes instalar el paquete Inspector según tu entorno de desarrollo. Ofrecemos 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, dirígete al [**panel de Inspector**](https://app.inspector.dev/register) y crea una nueva aplicación.

{% hint style="success" %}
Si necesitas más ayuda, inicia un chat en vivo en el panel. Nos encantaría escuchar tu experiencia, encontrar nuevas posibles mejoras y hacer que la herramienta mejore con el tiempo.
{% endhint %}

### Inyectar InspectorObserver

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

```php
use Inspector\\Neuron\\InspctorObserver;

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

## Registro

Si quieres informar de la actividad del agente en tu sistema de logs, puedes adjuntar el integrado `LogObserver` a tu agente pasando una instancia de una PSR `LoggerInterface` compatible, como monolog por ejemplo:

```php
use NeuronAI\\Observability\\LogObserver;

$message = MyAgent::make()
    ->observe(new LogObserver($logger))
    ->chat(...)
    ->getMessage();
```

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