WordPress Security How To

Solución de problemas de las notificaciones por correo electrónico de WP Cerber


English version: Troubleshooting WP Cerber Email Notifications


Si no recibes una notificación de WP Cerber, el diagnóstico de correo electrónico puede ayudarte a averiguar qué sucedió cuando el plugin intentó enviarla. Esto es especialmente útil cuando llegan los correos electrónicos de prueba, pero no las alertas de seguridad ni los informes programados.

El diagnóstico de correo electrónico registra los intentos de envío de correos de WP Cerber. No rastrea los mensajes de otros plugins de WordPress ni confirma que un mensaje haya llegado a la bandeja de entrada del destinatario. Activar el diagnóstico tampoco modifica la configuración de entrega de correo electrónico ni elimina los límites de notificaciones.

Antes de empezar

Consulta la notificación afectada.

Confirme que la notificación esté habilitada y que los destinatarios sean correctos. Para las alertas de actividad, verifique sus condiciones, canal de correo electrónico, fecha de vencimiento y límite de notificaciones. Para las notificaciones de bloqueo, verifique el umbral de bloqueo configurado y el límite de alertas por hora. Un evento de seguridad registrado no siempre requiere el envío de un correo electrónico.

Comprueba si un plugin modifica tu carpeta de subidas.

Primero, comprueba si algún plugin, tema o personalización controla tu carpeta de subidas locales. Si existe una opción que te permita elegir dicha carpeta, es recomendable verificar la compatibilidad. Algunas configuraciones pueden provocar que WP Cerber pierda el registro de diagnóstico y ponga los archivos en cuarentena, dejando archivos en el disco pero inaccesibles desde el panel de control. Si utilizas este tipo de configuración o no estás seguro, desactiva el diagnóstico por correo electrónico.

Una ubicación fija ya configurada mediante la opción UPLOADS en wp-config.php o la opción upload_path de WordPress no causa este problema por sí sola. Otro plugin aún puede sobrescribirla.

1. Habilitar el diagnóstico de correo electrónico

Después de completar la comprobación de la carpeta de subidas anterior, guarda una copia del archivo wp-config.php de tu sitio. Añade esta línea dentro de su sección PHP existente, encima de la línea que carga wp-settings.php :

 define ( 'CERBER_MAIL_DEBUG' , true );

Si el archivo ya define CERBER_MAIL_DEBUG , cambie su valor a true en lugar de agregar otra definición.

2. Enviar una notificación de prueba

Abre la configuración de notificaciones de WP Cerber y usa la opción "Enviar prueba" junto a "Notificación de bloqueo" . Anota la hora y si el correo electrónico de prueba llegó. Si no llegó, revisa la bandeja de entrada, incluyendo la carpeta de spam, y anota cualquier error que muestre WP Cerber.

A continuación, recopile los registros de la notificación que realmente falta. Una prueba exitosa del panel de control no confirma que una alerta de actividad cumpliera sus condiciones, que se ejecutara un informe programado o que una notificación creada anteriormente en una solicitud siguiera la misma ruta de envío.

Para alertas intermitentes, mantenga el diagnóstico activado solo el tiempo necesario para observar el siguiente evento relevante. Registre la hora y su zona horaria para poder encontrar las entradas correspondientes. Evite cambiar la configuración de correo electrónico entre la prueba y la notificación afectada, ya que esto dificulta la comparación de los resultados.

No es necesario atacar tu sitio web ni bloquearte el acceso deliberadamente para generar un registro. Si no hay una forma segura de reproducir el evento, espera a que ocurra de forma natural.

3. Revise el registro de diagnóstico.

Ve a WP Cerber → Herramientas → Registro de diagnóstico y busca las entradas marcadas con [MAIL] en torno a las horas que registraste para la prueba y la notificación afectada. Usa Descargar registro si necesitas un archivo, o copia las entradas relevantes como texto. El texto conserva el registro completo y es más fácil de revisar que una captura de pantalla de una línea larga.

Cada entrada comienza con explain , un resumen de una sola frase del intento de envío en lenguaje sencillo. Los campos técnicos que siguen son los que utiliza el servicio de asistencia para investigar.

Los ejemplos que aparecen a continuación son ilustrativos. Muestran la parte [MAIL] de cada entrada, sin el prefijo de fecha y hora añadido por el registro de diagnóstico.

Ejemplo: una prueba de panel de control

 [MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:20:00Z rid=EXAMPLETEST01 type=lockout dispatch=direct cwd=inside_abspath pwd=none cwd_send=inside_abspath pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok

Ejemplo: una notificación de bloqueo enviada cuando finaliza una solicitud.

 [MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:25:00Z rid=EXAMPLEALERT02 type=lockout event=708 dispatch=shutdown cwd=abspath pwd=none cwd_send=root pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok

Ambas llamadas de ejemplo resultaron exitosas. Sus diferentes rutas de envío y categorías de directorio de trabajo pueden ayudar a comparar la prueba con la notificación real, pero no permiten determinar por qué no llegó un mensaje.

Utilice el campo ts al comparar horas. Siempre está en UTC, indicado por la Z final. El prefijo de fecha y hora independiente del registro de diagnóstico puede usar una zona horaria diferente.

4. Entender el resultado

result=ok no confirma la entrega al destinatario. Significa que la función de correo electrónico de WordPress devolvió éxito en esa llamada. WordPress explica esta distinción en la documentación de su función de correo electrónico . Lo mismo se aplica a "WordPress informó éxito" en el texto explain , y un intento fallido en explain no identifica la causa del fallo.

Lo que ves Lo que te dice ¿Qué hacer a continuación?
result=error Esa llamada devolvió un error. Guarda el registro y cualquier error de correo electrónico relacionado que muestre WP Cerber.
result=ok , pero falta el mensaje. El envío se realizó correctamente. La recepción en el buzón aún no se ha confirmado. Solicita al proveedor que envía los correos electrónicos de tu sitio web (tu proveedor de hosting o servicio SMTP) que revise sus registros de envío alrededor de ts (UTC). Proporciónales la dirección del destinatario previsto de forma privada y pregúntales si recibieron el intento de envío y qué sucedió después.
La prueba llega, pero la notificación afectada no. Los dos escenarios tienen resultados diferentes. Recopile ambos conjuntos de registros e identifique qué notificación falta.
No se encontró ninguna entrada [MAIL] coincidente El registro no contiene ningún resultado para el intento previsto. Confirma la versión, el tiempo de activación, las condiciones de notificación y los límites. Comprueba si la prueba del panel de control genera algún registro.
Varias entradas con el mismo rid Varias llamadas grabadas pertenecen a la misma solicitud. Mantenga las entradas juntas. No necesariamente representan entregas duplicadas.

La configuración o los límites de velocidad pueden impedir un intento de envío. También puede faltar un registro si no se pudo escribir el archivo de registro o si la ejecución se detuvo antes de que finalizara el envío del correo electrónico. La ausencia de una entrada no indica que el proveedor de alojamiento haya bloqueado el mensaje. Si una prueba conocida no genera ningún registro, comuníquese con el soporte técnico.

5. Desactive el diagnóstico después de recopilar los registros.

Una vez que haya capturado los intentos relevantes, cambie la definición existente a:

 define ( 'CERBER_MAIL_DEBUG' , false );

También puedes eliminar la línea que agregaste. No añadas una segunda definición. Si el soporte técnico te ayudó a establecer una ruta de almacenamiento fija para tu sitio, mantén esa configuración independiente.

Esto impide la creación de nuevas entradas de diagnóstico de correo electrónico. Los registros existentes permanecen en el Registro de diagnóstico. Guarde lo que necesite antes de usar Borrar registro , que elimina el registro compartido, incluidas las entradas de otras funciones de WP Cerber.

6. Comparta los detalles relevantes con el equipo de soporte.

Elige el canal para tu versión:

Incluya los siguientes detalles:

  • Tu versión de WP Cerber y la notificación que falta.
  • Cuándo se esperaba, incluyendo su zona horaria.
  • Si llegó la prueba del panel de control.
  • Las entradas [MAIL] relevantes.
  • Ya sea que utilice la configuración SMTP de WP Cerber u otro plugin de correo de WordPress.

Si WP Cerber muestra un error de correo electrónico, inclúyalo en su ticket privado. En un tema público, mencione que se produjo un error y evite publicar detalles que identifiquen a usuarios o cuentas.

Para una notificación de seguridad, una entrada relacionada en el Registro de actividad también puede ser útil. Comparta las entradas del Registro de actividad de forma privada , ya que pueden contener direcciones IP y nombres de usuario. Para encontrar la entrada, copie el rid del registro de correo, abra el Registro de actividad, haga clic en Más , introdúzcalo en ID de solicitud y haga clic en Filtrar . Consulte Qué es el RID y cómo usarlo .

Las nuevas líneas [MAIL] descritas en esta guía omiten direcciones de correo electrónico, direcciones IP, asuntos, cuerpos de mensajes, credenciales y rutas de archivo sin procesar. Puede compartir esas líneas individualmente en un tema de un foro público. Copie solo las líneas [MAIL] relevantes, sin las entradas de registro ni las capturas de pantalla que contengan otros datos.

Las exportaciones del registro de diagnóstico completo pueden contener entradas de otras funciones de WP Cerber y deben compartirse de forma privada. Si utiliza la versión gratuita y un miembro del personal le solicita una entrada del registro de actividad o una exportación completa, pregúntele cómo enviarla de forma privada antes de compartirla. No incluya contraseñas ni su archivo wp-config.php completo. Comparta las direcciones de los destinatarios únicamente a través de un canal privado cuando sea necesario.

Referencia de campo

Puedes compartir los registros con el soporte técnico sin necesidad de decodificar cada campo. Esta referencia explica el contexto adicional si deseas analizarlo con más detalle.

Campo Significado
explain Resumen de una sola frase del intento, generado a partir de los campos recipient , recipients , attempt , smtp y result . Describe lo que informó la función de correo electrónico y la decisión SMTP de WP Cerber, no si el mensaje se entregó.
ts Hora UTC capturada inmediatamente antes de que se llame a la función de correo electrónico.
rid Identificador de solicitud de WP Cerber, utilizado para conectar registros de la misma solicitud. No es un ID de mensaje de correo electrónico.
type El tipo de notificación. Los valores comunes incluyen lockout , send_alert , report , scan , generic y 2fa . Los tipos no reconocidos aparecen como other .
event El motivo del bloqueo o el código de actividad que lo originó, si está disponible. No se trata de un código de error de correo electrónico.
dispatch Cómo llegó la notificación a la función de correo electrónico. Consulte la tabla a continuación.
cwd / cwd_send Categorías para el directorio de trabajo de PHP cuando se preparó la notificación y justo antes de la llamada por correo electrónico.
pwd / pwd_send Categorías para la variable de entorno PWD del servidor en esos mismos dos puntos. Esta variable puede estar desactivada o ser diferente del directorio de trabajo real de PHP.
recipient / recipients La posición del destinatario dentro de esta notificación y el número de destinatarios de la misma. Las direcciones de correo electrónico no se registran.
attempt WP Cerber reintenta la llamada initial a un destinatario o retry si la llamada fallida se repite para el mismo destinatario. WP Cerber solo reintenta la llamada cuando su configuración SMTP está activada.
smtp Decisión SMTP propia de WP Cerber para la llamada. Véase la tabla a continuación.
result ok o error , según el valor devuelto por esa llamada de correo electrónico.

El campo event se omite cuando no se proporciona ningún código aplicable. Las pruebas del panel de control pueden omitirlo, pero la ausencia de un event no identifica por sí sola un mensaje de prueba.

Rutas de envío

dispatch Significado
direct WP Cerber envió la notificación sin posponerla a ninguna de las etapas siguientes.
plugins_loaded La notificación se preparó con antelación y se envió cuando WordPress alcanzó la fase plugins_loaded .
shutdown La notificación se preparó con antelación y se envió mediante una función de devolución de llamada una vez finalizada la solicitud PHP. Esto no significa que el servidor se haya apagado ni que la solicitud haya fallado.

Estos valores describen la ruta de envío de WP Cerber. No identifican un servidor SMTP ni describen la cola de entrega de un proveedor de correo. En particular, direct no indica si se utilizó SMTP.

Decisiones SMTP

smtp Significado
enabled WP Cerber aplica su configuración SMTP a la llamada.
disabled WP Cerber no aplica su configuración SMTP porque está desactivada o requiere WP Cerber Professional.
bypassed La configuración SMTP está activada, pero WP Cerber la omite para esta llamada tras un fallo anterior en la misma solicitud.

Este campo refleja únicamente la configuración de WP Cerber. Otro plugin puede modificar la forma en que WordPress envía el mensaje, por lo que enabled no garantiza que se haya utilizado el servidor SMTP configurado.

Categorías del directorio

El registro utiliza categorías en lugar de registrar rutas reales.

Valor Significado
root El sistema de archivos raíz / .
abspath El directorio de instalación de WordPress.
inside_abspath Un directorio dentro de la instalación de WordPress.
outside_abspath Un directorio fuera de la instalación de WordPress.
none El valor no estaba disponible o estaba vacío.

Los parámetros pwd=none y dispatch=shutdown no constituyen errores por sí solos. Un cambio como cwd=abspath seguido de cwd_send=root proporciona información útil sobre el entorno de envío, pero no demuestra un fallo en la entrega. La coincidencia de categorías tampoco garantiza la coincidencia de rutas, y la instantánea previa a la llamada no muestra los cambios realizados dentro de la función de correo electrónico ni en sus ganchos.

En servidores con la restricción open_basedir de PHP, una ruta PWD que alcanza el directorio de WordPress a través de un enlace simbólico puede clasificarse como outside_abspath . El equipo de soporte puede tener en cuenta esta limitación al revisar las entradas.

Por qué una notificación puede generar varios registros

Cada llamada registrada tiene su propio resultado. Varios destinatarios o un sistema SMTP alternativo pueden generar más de un registro para una notificación. Una sola solicitud también puede generar diferentes notificaciones.

Por ejemplo, una notificación con dos destinatarios y un servidor SMTP inaccesible puede producir estos tres registros, que se muestran aquí omitiendo los campos técnicos:

 [MAIL] explain="The email attempt for recipient 1 of 2 failed with WP Cerber SMTP enabled." ... recipient=1 recipients=2 attempt=initial smtp=enabled result=error
[MAIL] explain="WordPress reported success for the retry to recipient 1 of 2 without WP Cerber SMTP settings." ... recipient=1 recipients=2 attempt=retry smtp=bypassed result=ok
[MAIL] explain="WordPress reported success for recipient 2 of 2 without WP Cerber SMTP settings." ... recipient=2 recipients=2 attempt=initial smtp=bypassed result=ok

El intento de SMTP falló, y las dos llamadas posteriores se realizaron sin la configuración SMTP de WP Cerber. Nada indica que el servidor SMTP se haya recuperado ni que alguno de los mensajes haya llegado.

La numeración de destinatarios se reinicia con cada notificación y las direcciones de correo electrónico se omiten deliberadamente, por lo que la posición no indica qué dirección se utilizó. Conserve todas las entradas relacionadas al informar de un problema, incluso cuando un error vaya seguido de un ok .

Problema conocido: cambios en la carpeta de cargas locales

Este problema afecta a los sitios donde un plugin, tema o personalización hace que WP Cerber vea carpetas base de cargas locales diferentes durante las solicitudes iniciales y las solicitudes normales del panel de control. Por ejemplo, un plugin puede cambiar esa carpeta solo después de cargarse.

WP Cerber utiliza la ubicación de las cargas para encontrar su carpeta de almacenamiento compartido. Si no encuentra la carpeta existente en la otra ubicación, WP Cerber puede crear una nueva carpeta y perder el rastro de la anterior. Los archivos antiguos permanecen en el disco, pero los archivos en cuarentena pueden desaparecer de la página de cuarentena y quedar inaccesibles para su restauración. Los registros de diagnóstico también pueden terminar en carpetas diferentes.

Una ubicación fija configurada mediante UPLOADS en wp-config.php o la opción upload_path no causa esta inconsistencia al inicio por sí sola. Un plugin o una personalización aún pueden sobrescribirla posteriormente. Del mismo modo, la configuración de la carpeta local de un plugin es un motivo para verificar su funcionamiento, no una prueba de que el sitio se vea afectado. Estos son ejemplos de configuraciones existentes, no instrucciones para cambiar la configuración de subidas.

Si su configuración pudiera verse afectada, desactive el diagnóstico por correo electrónico y solicite ayuda . Incluya el nombre del complemento, tema o personalización que controla la ubicación de las cargas.

Mantén intactas todas las carpetas wp-cerber-* existentes y su contenido. No las muevas, renombres ni elimines, no modifiques la configuración del plugin de subidas ni intentes adivinar la ruta de almacenamiento. La configuración correcta debe conservar la carpeta que WP Cerber ya utiliza.

Si las herramientas de diagnóstico ya están activadas en el sitio afectado, desactívelas mientras se verifica la ubicación de almacenamiento. Esto no restablece la conexión de WP Cerber con la carpeta anterior. Otras funciones de WP Cerber aún pueden provocar el problema de almacenamiento.


I'm a team lead in Cerber Tech. I'm a software & database architect, WordPress - PHP - SQL - JavaScript developer. I started coding in 1993 on IBM System/370 (yeah, that was amazing days) and today software engineering at Cerber Tech is how I make my living. I've taught to have high standards for myself as well as using them in developing software solutions.

View Comments
There are currently no comments.