Magento
Módulo para Magento 2.4 y Adobe Commerce
El módulo oficial DockRay para Magento 2 integra tu tienda con la plataforma de monitorización de errores DockRay y envía automáticamente excepciones PHP y errores registrados por Magento en los logs. Los informes de controladores, API REST y GraphQL, integraciones de pago y envío, y tareas cron llegan directamente al panel de DockRay, lo que facilita el diagnóstico de problemas en Magento Open Source y Adobe Commerce.
Monitorización de errores y excepciones PHP
DockRay recopila información sobre los errores que se producen durante el funcionamiento de la tienda, incluidas las excepciones gestionadas por los mecanismos de errores de Magento y los eventos registrados como errores en los logs. Esto te permite detectar con mayor rapidez problemas en la aplicación, las integraciones externas y los procesos en segundo plano.
Monitorización del rendimiento y de errores JavaScript
La monitorización opcional de los tiempos de respuesta de las rutas de Magento ayuda a identificar las partes de la aplicación que funcionan lentamente. Las mediciones se agrupan por nombre de ruta, no por las URL específicas de los productos. Esto facilita el análisis del rendimiento sin dividir los resultados entre numerosas URL similares.
El módulo también puede recopilar errores JavaScript que se producen en la tienda. El mecanismo funciona incluso cuando la caché de páginas está activada, por lo que puedes supervisar los problemas del lado del navegador sin renunciar a las optimizaciones de rendimiento de la tienda.
Detección de vulnerabilidades conocidas en Magento
DockRay analiza la información del software de la tienda, incluida la versión de Magento, los paquetes de Composer y las extensiones ubicadas en el directorio app/code, para detectar vulnerabilidades conocidas. Los resultados están disponibles en el panel de DockRay y ayudan a identificar los componentes que pueden necesitar una actualización o una revisión de seguridad adicional.
Configuración sencilla y almacenamiento seguro de claves
Puedes configurar la conexión en Stores → Configuration → DockRay → Monitoring, introduciendo el token del proyecto y la clave privada. Para evitar almacenar las credenciales en la base de datos de Magento, puedes guardar la clave privada en el archivo app/etc/env.php o proporcionarla mediante una variable de entorno.
DockRay para Magento te ayuda a supervisar los errores de la aplicación, analizar el rendimiento de las rutas y detectar vulnerabilidades conocidas en extensiones desde un único panel, sin tener que revisar manualmente todos los logs de la tienda.
Instalación
Requisitos
El módulo DockRay está diseñado para Magento Open Source y Adobe Commerce 2.4.4 o posterior, así como para Mage-OS. Requiere PHP 8.1 o posterior.
Instalación mediante Composer
Instala el módulo DockRay con Composer desde el directorio raíz de tu proyecto Magento:
composer require dockcodes/dock-ray-magento
bin/magento module:enable DockCodes_DockRay
bin/magento setup:upgrade
# En producción, ejecuta también:
bin/magento setup:di:compile
bin/magento setup:static-content:deployConfiguración de la conexión con DockRay
En el panel de administración de Magento, ve a Stores → Configuration → DockRay → Monitoring. Introduce el token del proyecto y la clave privada disponibles en el panel de DockRay y guarda la configuración.
Si prefieres no almacenar la clave privada en la base de datos de Magento, puedes configurar las credenciales mediante comandos CLI:
bin/magento config:set --lock-env dockray/connection/token TU_TOKEN_DE_PROYECTO
bin/magento config:set --lock-env dockray/connection/private_key TU_CLAVE_PRIVADA
La opción --lock-env guarda la configuración en el ámbito del entorno. Los valores definidos de este modo quedan bloqueados en el panel de administración y proceden de la configuración del entorno.
Almacenamiento de la clave privada fuera de la base de datos
Puedes guardar la clave privada en el archivo app/etc/env.php o proporcionarla mediante una variable de entorno:
'dockray' => [
'connection' => [
'private_key' => 'TU_CLAVE_PRIVADA',
],
],
Como alternativa, utiliza la variable de entorno CONFIG__DEFAULT__DOCKRAY__CONNECTION__PRIVATE_KEY. Evitar almacenar secretos en la base de datos ayuda a controlar mejor el acceso a las credenciales.
Verificación de la instalación
Después de guardar la configuración, envía un evento de prueba para comprobar la conexión con tu proyecto DockRay. Puedes ejecutar la prueba desde el terminal:
bin/magento dockray:testA continuación, abre tu proyecto DockRay y comprueba si ha recibido el nuevo evento. Los informes sobre vulnerabilidades conocidas se envían periódicamente mediante el cron de Magento. También puedes iniciar el envío manualmente:
bin/magento dockray:inventory:send