Instalación - Nuxt

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

• Nuxt 3 o 4,
• Node.js 18 o posterior,
• npm.

Instalar el módulo

npm install @dockcodes/dock-ray-nuxt

Registro y credenciales

En nuxt.config.ts:

export default defineNuxtConfig({
    modules: ['@dockcodes/dock-ray-nuxt'],

    ray: {
        tracesSampleRate: 0.2,
        browser: { enabled: false },
    },
});

En las variables de entorno:

NUXT_RAY_TOKEN=token-del-proyecto
NUXT_RAY_PRIVATE_KEY=clave-privada-del-proyecto

Nuxt mapea por sí mismo las variables NUXT_RAY_* a runtimeConfig.ray - es su propia convención integrada, que mantiene las credenciales fuera de nuxt.config.ts y fuera de git. El módulo las guarda únicamente en la mitad privada de la configuración de runtime: todo lo que está bajo runtimeConfig.public se serializa en el paquete de cliente, y una clave de proyecto ahí sería una clave publicada. Sin token ni clave el módulo se carga y no envía nada.

Qué registra el módulo por su cuenta

Añadir el módulo a modules ya basta para notificar errores de servidor y transacciones - conecta un plugin de Nitro al arrancar la aplicación por sí mismo, sin ningún archivo adicional de tu parte. Recoger errores de Vue y de JavaScript del navegador es una decisión aparte y deliberada (browser.enabled), que se explica en el artículo de configuración - por defecto el módulo solo se ocupa de lo que pasa en el servidor.

La primera prueba

Añade una ruta de servidor temporal, por ejemplo server/api/ray-test.ts:

export default defineEventHandler(() => {
    throw createError({ statusCode: 500, statusMessage: 'Error de control DockRay' });
});

Visítala una vez y bórrala en cuanto la prueba funcione: es un 500 real, así que las llamadas siguientes consumen el cupo mensual. La entrada debería aparecer en el panel, en la sección Errores del proyecto al que apunta el token.