Notificaciones de Proxmox en el teléfono: copias de seguridad, fencing, replicación y errores de disco

La mayoría de los hosts de Proxmox envían sus notificaciones a root@pam, es decir, a una dirección de correo que alguien escribió en el instalador hace años y entregada por un Postfix al que nunca se le configuró un relay. La copia nocturna falla, el correo se queda en una cola local y te enteras tres semanas después, cuando necesitas restaurar una VM.
La otra configuración habitual funciona, pero se ignora. Cada tarea de copia envía un correo largo cada noche, todos dicen «correcta» y el que dice «fallida» tiene el mismo aspecto que los otros treinta de la carpeta.
Desde Proxmox VE 8.3 y Proxmox Backup Server 3.3, el sistema de notificaciones tiene un destino webhook genérico. Puede llamar a cualquier API HTTP con un cuerpo que escribes tú, así que puede enviar una push directamente a tu teléfono, con una prioridad distinta para los fallos y para los éxitos. Sin scripts en el host y sin relay que mantener.
Lo que necesitas
- Proxmox VE 8.3 o posterior (cualquier 9.x sirve), o Proxmox Backup Server 3.3 o posterior. Las versiones anteriores se tratan más abajo.
- La aplicación Pocket Alert en iPhone o Android y una clave de API de Claves de API.
- Acceso a Datacenter → Notifications como
root@pamo como un usuario conMapping.Modifysobre/mapping/notifications.
Lo que Proxmox puede avisarte
Proxmox VE emite estos eventos, cada uno con un type, una severidad y algunos campos de metadatos:
| Evento | type | Severidad |
|---|---|---|
| Copia completada | vzdump | info |
| Copia fallida | vzdump | error |
| Tarea de replicación de almacenamiento fallida | replication | error |
| Nodo del clúster aislado (fenced) | fencing | error |
| Actualizaciones del sistema disponibles | package-updates | info |
| Correo para root (smartd, ZFS ZED y otros) | system-mail | unknown |
La última fila importa más de lo que parece. smartd comprueba tus discos cada 30 minutos y envía un correo a root cuando uno empieza a fallar, y el demonio de eventos de ZFS envía correos a root sobre pools degradados y errores de scrub (ZED_EMAIL_ADDR="root" es el valor por defecto). Proxmox convierte esos correos en eventos system-mail, así que el mismo webhook que informa de las copias también informa de un disco que se muere.
Configurar el destino webhook
En la interfaz web, ve a Datacenter → Notifications y, en Notification Targets, haz clic en Add → Webhook. Rellénalo así:
- Endpoint Name:
pocketalert - Method/URL:
POSTyhttps://api.pocketalert.app/v1/messages - Headers:
Content-Type=application/json, yToken={{ secrets.token }} - Secrets:
token= tu clave de API de Pocket Alert
Y el Body:
{
"title": {{ json title }},
"message": {{ json message }},
"level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}
Aquí pasan varias cosas:
{{ json title }}devuelve el valor como cadena JSON completa, con comillas incluidas. Los informes de copias son tablas de varias líneas, y poner{{ message }}entre comillas rompería el JSON en el primer salto de línea. Proxmox también tiene{{ escape message }}, que hace lo mismo sin las comillas alrededor.- La clave es un secreto. Los secretos se guardan en
/etc/pve/priv/notifications.cfg, legible solo por root, y la API nunca devuelve sus valores. Proxmox además los oculta en sus mensajes de error. - El nivel sigue a la severidad. Proxmox renderiza el cuerpo con Handlebars, que tiene
if,eqyor. Las copias fallidas, la replicación fallida, el fencing y los correos de disco llegan comohigh, que atraviesa Concentración en iPhone. Las copias correctas y los avisos de actualización llegan comolow: están en el feed si los quieres, pero no vibran.
Guarda el destino y haz clic en Test. Una notificación de prueba debería llegar en pocos segundos.
El destino no hace nada hasta que un matcher le envía eventos. En Notification Matchers, haz clic en Add, ponle el nombre pocketalert-all y, en la pestaña Targets to notify, marca pocketalert. Un matcher sin reglas coincide con todos los eventos.
Lo mismo desde la shell
Si prefieres la CLI, o gestionas varios clústeres, pvesh hace lo mismo. Los valores de las cabeceras, el cuerpo y los secretos se pasan codificados en base64:
PA_KEY='your-api-key'
BODY='{
"title": {{ json title }},
"message": {{ json message }},
"level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}'
b64() { printf '%s' "$1" | base64 -w0; }
pvesh create /cluster/notifications/endpoints/webhook \
--name pocketalert --method post \
--url https://api.pocketalert.app/v1/messages \
--header "name=Content-Type,value=$(b64 application/json)" \
--header "name=Token,value=$(b64 '{{ secrets.token }}')" \
--secret "name=token,value=$(b64 "$PA_KEY")" \
--body "$(b64 "$BODY")"
pvesh create /cluster/notifications/matchers --name pocketalert-all --target pocketalert
pvesh create /cluster/notifications/targets/pocketalert/test
El resultado se guarda en /etc/pve/notifications.cfg, que se comparte en todo el clúster, así que una sola configuración cubre todos los nodos (el cuerpo en base64 está acortado aquí):
webhook: pocketalert
method post
url https://api.pocketalert.app/v1/messages
header name=Content-Type,value=YXBwbGljYXRpb24vanNvbg==
header name=Token,value=e3sgc2VjcmV0cy50b2tlbiB9fQ==
body ewogICJ0aXRsZSI6IHt7IGpzb24gdGl0bGUgfX0s...
matcher: pocketalert-all
target pocketalert
La clave en sí está en /etc/pve/priv/notifications.cfg como secret name=token,value=<base64>.
Segundo nivel: un nodo aislado debería despertarte
Una copia fallida puede esperar hasta la mañana. Un nodo aislado significa que HA acaba de apagar un host, y eso merece una push critical que atraviese No molestar. Los matchers pueden hacerlo sin tocar la plantilla del cuerpo.
Crea un segundo destino webhook, pocketalert-critical, idéntico al primero salvo por una línea del cuerpo:
"level": "critical"
Después sustituye el matcher general por dos que se separen según el tipo de evento:
matcher: pocketalert-all
match-field exact:type=fencing
invert-match true
target pocketalert
matcher: pocketalert-fencing
match-field exact:type=fencing
target pocketalert-critical
invert-match invierte el primer matcher, así que el fencing solo va al destino crítico y no recibes dos pushes por el mismo evento. La entrega critical a través de No molestar es una función de los planes de pago; en el plan gratuito llega como high. Consulta niveles de prioridad para ver qué hace cada nivel en iOS y Android.
Más cosas para las que los matchers son útiles:
- Solo fallos. Añade
match-severity error,unknownapocketalert-ally las copias correctas dejan de enviar nada. Nosotros las mantendríamos comolow: un «copia correcta» silencioso cada noche es la forma más fácil de notar cuándo deja de llegar. - Una sola tarea.
match-field exact:job-id=backup-abc123limita un matcher a una tarea programada. Las copias iniciadas con Run now no tienenjob-id, así que no coinciden. - Horas de silencio.
match-calendar mon..fri 9-17limita un matcher a las horas laborables, yinvert-matchte da el resto.
Un botón que abre la interfaz web
Las push de Pocket Alert pueden llevar hasta tres botones de acción. Añade uno al cuerpo y una copia fallida abre la interfaz de Proxmox con un solo toque:
"actions": [
{"type": "view", "label": "Open Proxmox", "value": "https://pve1.lan:8006"}
]
El teléfono abre la URL directamente, así que una dirección local funciona siempre que estés en tu red doméstica o en la VPN.
Proxmox Backup Server
PBS 3.3 y posteriores tienen el mismo sistema de notificaciones en Configuration → Notifications, con el mismo destino webhook, el mismo cuerpo y los mismos helpers de Handlebars. Su configuración vive en notifications.cfg y notifications-priv.cfg dentro de /etc/proxmox-backup/.
Los eventos son distintos y más útiles para un servidor de copias: recolección de basura (gc), prune, sync, verification, tape-backup y tape-load, además de fallos en la renovación de certificados acme y package-updates. acme solo informa de fallos y tape-load es un notice; el resto llega en versiones info y error, así que el mismo if del cuerpo funciona sin cambios. Los eventos de almacenes (gc, prune, sync, verification, tape-backup) también llevan un campo datastore, así que match-field regex:datastore=^offsite-.*$ puede enviar los almacenes externos a otro destino.
Dos detalles de PBS que conviene revisar. Los almacenes creados antes del sistema de notificaciones pueden tener un notification-mode que siga siendo legacy-sendmail; cámbialo al sistema de notificaciones en las opciones del almacén. Y PBS solo envía notificaciones package-updates en hosts con una suscripción activa.
Límites honestos
- El host tiene que estar en línea para informar. El webhook lo envía el propio host de Proxmox, así que si ha perdido la conexión o está apagado, no sale nada. Para «todo el equipo está caído», necesitas una comprobación desde fuera, como un monitor de disponibilidad en otra máquina.
- Los informes largos de copias se cortan en la push. Una copia de veinte invitados genera una tabla larga. La push muestra aproximadamente los primeros 3 KB; el texto completo está en el historial de mensajes de la app.
system-mailes todo lo que se envía a root. Incluye smartd y ZFS, pero también la salida de cron y cualquier otra cosa que envíe correo a root en tu sistema. Si se vuelve ruidoso, dale a esos eventos su propio matcher conmatch-field exact:type=system-maily un destino más silencioso.- Sin compatibilidad con Gotify. Proxmox también tiene un destino Gotify integrado, y guías antiguas lo usan para las push al teléfono. Pocket Alert no implementa la API de Gotify, así que ese destino no puede apuntar a nosotros. Usa el destino webhook de arriba, o consulta cómo se compara Pocket Alert con Gotify.
En Proxmox VE 8.2 y anteriores
Actualizar es la mejor solución, ya que el destino webhook necesita la 8.3. Si todavía no puedes actualizar, un script de hook de vzdump cubre el caso más importante, las copias. Instala la CLI de Pocket Alert en el nodo como root, ejecuta pocketalert auth y guarda esto como /usr/local/bin/vzdump-pocketalert:
#!/bin/sh
case "$1" in
backup-abort) pocketalert send -t "Backup failed: $3 on $(hostname)" -m "Mode: $2" -l high ;;
job-end) pocketalert send -t "Backup job finished on $(hostname)" -m "Check the task log for details" -l low ;;
esac
exit 0
Hazlo ejecutable y añade script: /usr/local/bin/vzdump-pocketalert a /etc/vzdump.conf. vzdump lo llama en cada fase; para backup-abort, el segundo y el tercer argumento son el modo de copia y el ID de la VM.
Si no llega nada
- Ejecuta Test primero. Si la push de prueba llega pero los eventos reales no, el destino está bien y el problema está en el enrutamiento: comprueba que algún matcher nombre el destino y que sus reglas coincidan.
- Revisa el modo de notificación de la tarea de copia. Una tarea con una dirección de correo en su configuración de notificaciones y el modo por defecto
autousa sendmail heredado y se salta por completo el sistema de notificaciones. Borra la dirección o cambia el modo al sistema de notificaciones; en/etc/pve/jobs.cfgesnotification-mode notification-system. - Lee el journal.
journalctl --since "1 hour ago" | grep -i notifmuestra las peticiones fallidas. Un401significa que la clave es incorrecta; un400suele indicar que el cuerpo no es JSON válido: comprueba que usaste{{ json message }}y no un{{ message }}suelto. - Revisa el feed en la app. Las push
lowno suenan, así que una copia correcta puede parecer que nunca llegó. Está en el historial de mensajes.
Preguntas frecuentes
¿Necesito una suscripción de Proxmox?
No. El sistema de notificaciones y el destino webhook forman parte de los repositorios gratuitos. La única pieza que depende de la suscripción es la notificación package-updates de PBS.
¿Funciona esto para un solo nodo sin clúster?
Sí. Un nodo único lee el mismo /etc/pve/notifications.cfg. En un clúster el archivo se comparte, así que lo configuras una sola vez.
¿Puedo recibir estos avisos también por correo?
Sí. Mantén el destino por defecto mail-to-root en su matcher y añade pocketalert junto a él. Un matcher puede notificar a varios destinos, y cada destino recibe la notificación como máximo una vez.
¿Cuántas push va a consumir esto?
Una por evento. Una tarea de copia nocturna es una sola notificación para toda la tarea, no una por invitado, así que un homelab típico envía unas pocas al día. El plan gratuito cubre 50 mensajes al día en un dispositivo.
¿Y TrueNAS, los eventos de energía del SAI o Uptime Kuma?
La misma idea, con otro emisor. La página de alertas para homelab cubre las piezas habituales de un servidor doméstico, y alertas de copias de seguridad cubre herramientas de copia ajenas a Proxmox.
Crea una cuenta gratuita, pega el cuerpo en un destino webhook y deja que la próxima copia fallida te encuentre a ti en lugar de a tu bandeja de entrada.