Verificación y problemas habituales - WordPress
El evento de prueba
No hace falta romper el sitio para comprobar la conexión. En Ajustes → DockRay pulsa Enviar evento de prueba: el plugin envía un evento de forma sincrónica y muestra el resultado junto con su identificador, sin recargar la página. Una prueba correcta espera la respuesta 200 {"success": true}, y su resultado y su fecha quedan en la pantalla como indicador de estado.
El evento debería aparecer en el panel, en la sección Errores del proyecto al que apunta el token. Aprovecha para revisar tres cosas: el entorno, la hora y el contexto de la petición. Un entorno vacío significa que el plugin no recibió ni un valor de la pantalla ni el tipo de entorno de WordPress.
Verificación con un error real
La prueba de la pantalla confirma la conexión, pero no la captura automática. Para comprobar también eso, provoca una excepción no gestionada en un entorno de pruebas - desde un shortcode temporal o desde un hook init en una única dirección - y mira si el evento llega. Borra ese código cuando la prueba salga bien: cada llamada adicional incrementa el contador de un error artificial y consume el cupo mensual.
Problemas habituales
No llega nada al panel
Comprueba en orden: si las credenciales están completas (el indicador de estado lo responde directamente), si el token y la clave pertenecen al mismo proyecto, si la clave ha sido revocada en el panel y si el alojamiento permite conexiones HTTPS salientes. El plugin no sigue redirecciones, así que la dirección de una instancia propia de DockRay debe ser la definitiva y no una que redirija.
He puesto un token en la pantalla pero el plugin usa otro
Normalmente significa que en wp-config.php hay un DOCK_RAY_TOKEN o un DOCK_RAY_PRIVATE_KEY mientras el origen de la configuración está en Auto: entonces gana la constante. El área de estado indica qué constantes están activas. Cambia el origen a Solo esta pantalla si este sitio debe informar a un proyecto distinto del de la configuración compartida del servidor.
Llegan eventos, pero sin pila de llamadas o sin contexto de petición
Un evento de un hook lanzado por WP-CLI o por cron no tiene petición HTTP, así que tampoco tendrá contexto de petición, y así debe ser. En cambio, la falta de pila en un error de PHP significa que el evento surgió de un error y no de una excepción; ahí el lugar del fallo lo señalan el archivo y la línea.
Demasiados notices y deprecaciones
Una instalación con una docena de plugins puede generar cientos al día y expulsar de la lista lo importante. Estrecha DOCK_RAY_ERROR_TYPES en wp-config.php a los niveles a los que vuestro equipo reacciona de verdad.
Los errores de JavaScript no llegan
El recolector está desactivado por defecto: activa Recoger errores de JavaScript en la pantalla de ajustes. Si aun así no llega nada, recuerda las tres barreras del receptor: el nonce, el límite de 16 kB por informe y 20 informes por dirección IP y minuto. El receptor responde 202 incluso cuando rechaza el informe, así que el estado de la respuesta en la consola del navegador no aclara nada.
Un mismo error ocupa toda la lista
Suele ser una única excepción en un bucle o en cron. El panel agrupa los errores por la huella sha256(token del proyecto + tipo + mensaje) y guarda una fila por error y por día, así que ese caso se ve como una fila con un contador alto. Si aun así se parte en muchas filas, el mensaje contiene una parte variable - un identificador de pedido o una marca de tiempo - y es justo eso lo que hay que sacar del texto de la excepción.
El panel responde 200 pero no aparece el evento
Una respuesta 200 {"success": false} significa que la cuenta ha agotado su cupo mensual de errores. La integración no lo trata como una avería, y hace bien. El cupo se ve en el panel de la cuenta; hasta fin de mes se calcula a partir del consumo registrado, así que borrar errores no lo reinicia.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.