Instalación - Symfony

Antes de empezar, crea un proyecto en el panel de DockRay. En sus ajustes encontrarás el token del proyecto - el identificador público que forma parte de la URL de ingesta - y en la pestaña Claves de API generarás una clave privada. La clave se muestra una sola vez, al generarla: DockRay guarda únicamente su hash. Si todavía no tienes un proyecto, empieza por Primeros pasos.

Requisitos

• Symfony 6.4 o posterior,
• PHP 8.2 o posterior,
• Composer 2.

Instalar el paquete

composer require dockcodes/dock-ray-symfony

Con Symfony Flex el bundle se registra solo. Sin Flex, añádelo a mano en config/bundles.php:

return [
    // ...
    Dock\Ray\Symfony\RayBundle::class => ['all' => true],
];

Configuración

Crea config/packages/ray.yaml. Todas las claves son opcionales; sin token ni clave privada el bundle se carga y no envía nada.

ray:
    token: '%env(RAY_TOKEN)%'
    private_key: '%env(RAY_PRIVATE_KEY)%'
    traces_sample_rate: 0.2
    ignore_exceptions:
        - Symfony\Component\HttpKernel\Exception\NotFoundHttpException

Guarda las credenciales en .env.local o en los secretos de Symfony, no en el archivo de configuración:

RAY_TOKEN=token-del-proyecto
RAY_PRIVATE_KEY=clave-privada-del-proyecto

Añade NotFoundHttpException desde el principio

En Symfony una respuesta 404 es una excepción, así que sin esa única entrada en ignore_exceptions la monitorización se llena de informes de escáneres y direcciones mal escritas. Es el paso que más se olvida en una primera configuración.

La primera prueba

El hub es un servicio público, así que la consola es la vía más sencilla: la llamada recorre el mismo camino que el envío desde la aplicación.

php bin/console debug:container ray.hub

Si el servicio existe, llama a captureMessage() desde cualquier comando o controlador y revisa el panel.