Instalación - Drupal

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

• Drupal 10.2 o posterior, o Drupal 11,
• PHP 8.2 o posterior,
• conexiones HTTPS salientes permitidas desde el servidor.

Instalación

composer require drupal/dockray
drush en dock_ray

El nombre de máquina del módulo es dock_ray: así aparece en Drush, en las claves de settings.php, en el nombre del servicio dock_ray.hub y en las rutas /dock-ray/*.

También puedes activarlo desde la interfaz: Extender (/admin/modules) → marca DockRay → Instalar.

Credenciales en settings.php

La clave privada es un secreto y la configuración exportada de Drupal suele acabar en el repositorio, así que guarda las credenciales en settings.php y no en la configuración del módulo:

$settings['dock_ray'] = [
  'token' => 'token-del-proyecto',
  'private_key' => 'clave-privada-del-proyecto',
  'url' => 'https://dockray.io',
];

La misma estructura sirve para todos los entornos: cada uno tiene su settings.local.php o su propio archivo de ajustes, de modo que producción y preproducción informan a proyectos distintos sin que la configuración exportada se desincronice.

La primera prueba

1. Ve a Configuración → Desarrollo → DockRay (/admin/config/development/dock-ray).
2. Revisa el área de estado: debería mostrar las credenciales completas.
3. Pulsa Enviar evento de prueba.

Activar el módulo sin credenciales es seguro: sin token ni clave no sale ni una petición.

Después de la instalación

Pasa a la configuración: ahí defines el nivel mínimo de registro que se convierte en eventos, el muestreo de transacciones y, opcionalmente, la recogida de errores de JavaScript en las páginas no administrativas.