Instalación de Healthchecks.io

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son la clave para la fiabilidad de cualquier sistema. Healthchecks.io no es una excepción. En esta sección, veremos qué exactamente necesita ser respaldado, cómo automatizar el proceso y cómo mantener el sistema actualizado.

1. Qué respaldar

Para una recuperación completa de Healthchecks.io, necesitará guardar tres tipos principales de datos:

• Base de datos PostgreSQL: Contiene todas sus comprobaciones, pings, configuraciones de usuario, historial de eventos y notificaciones. Este es el componente más crítico.
• Archivo de configuración .env: Contiene la clave secreta, la configuración SMTP, las claves API y otros parámetros importantes.
• Configuración de Caddyfile: Aunque es fácil de recrear, guardar la versión actual puede ahorrar tiempo durante la recuperación.

2. Script simple de copia de seguridad automática

Crearemos un script simple que realizará un volcado de la base de datos y copiará los archivos de configuración.

# Creación del directorio para los scripts de copia de seguridad
mkdir -p ~/backups
nano ~/backups/backup_healthchecks.sh

Añada el siguiente contenido al archivo backup_healthchecks.sh. Reemplace /path/to/healthchecks con la ruta real a su directorio de Healthchecks.io (por ejemplo, /home/newuser/healthchecks).

#!/bin/bash

# Directorio donde se encuentran los archivos de Healthchecks.io
HEALTHCHECKS_DIR="/home/newuser/healthchecks"
# Directorio para almacenar las copias de seguridad
BACKUP_DIR="/home/newuser/backups/healthchecks_data"
# Nombre del archivo de volcado de la base de datos
DB_DUMP_FILE="healthchecks_db_$(date +%Y%m%d_%H%M%S).sql.gz"
# Número de días para almacenar las copias de seguridad locales
RETENTION_DAYS=7

# Creación del directorio de copias de seguridad, si no existe
mkdir -p "${BACKUP_DIR}"

echo "--- Iniciando el proceso de copia de seguridad de Healthchecks.io ---"

# 1. Copia de seguridad de la base de datos PostgreSQL
echo "Volcando la base de datos PostgreSQL..."
docker compose -f "${HEALTHCHECKS_DIR}/docker-compose.yml" exec -T db pg_dumpall -U hc | gzip > "${BACKUP_DIR}/${DB_DUMP_FILE}"

if [ $? -eq 0 ]; then
    echo "Base de datos guardada exitosamente en ${BACKUP_DIR}/${DB_DUMP_FILE}"
else
    echo "ERROR: No se pudo guardar la base de datos."
    exit 1
fi

# 2. Copia del archivo .env
echo "Copiando el archivo .env..."
cp "${HEALTHCHECKS_DIR}/.env" "${BACKUP_DIR}/.env_$(date +%Y%m%d_%H%M%S)"

if [ $? -eq 0 ]; then
    echo "Archivo .env copiado exitosamente."
else
    echo "ERROR: No se pudo copiar el archivo .env."
fi

# 3. Copia de Caddyfile
echo "Copiando Caddyfile..."
sudo cp /etc/caddy/Caddyfile "${BACKUP_DIR}/Caddyfile_$(date +%Y%m%d_%H%M%S)"

if [ $? -eq 0 ]; then
    echo "Caddyfile copiado exitosamente."
else
    echo "ERROR: No se pudo copiar Caddyfile."
fi

# 4. Eliminación de copias de seguridad antiguas (más de RETENTION_DAYS días)
echo "Eliminando copias de seguridad antiguas (más de ${RETENTION_DAYS} días)..."
find "${BACKUP_DIR}" -type f -name "healthchecks_db_*.sql.gz" -mtime +"${RETENTION_DAYS}" -delete
find "${BACKUP_DIR}" -type f -name ".env_*" -mtime +"${RETENTION_DAYS}" -delete
find "${BACKUP_DIR}" -type f -name "Caddyfile_*" -mtime +"${RETENTION_DAYS}" -delete
echo "Copias de seguridad antiguas eliminadas."

echo "--- Proceso de copia de seguridad completado ---"

Haga el script ejecutable:

chmod +x ~/backups/backup_healthchecks.sh

3. Dónde almacenar las copias de seguridad (almacenamiento externo)

Almacenar las copias de seguridad en el mismo servidor que los datos originales es extremadamente arriesgado. En caso de fallo del servidor o pérdida de datos, también perderá las copias de seguridad. Asegúrese de configurar la copia de las copias de seguridad a un almacenamiento externo, geográficamente remoto:

• Almacenamiento compatible con S3 (AWS S3, DigitalOcean Spaces, Backblaze B2): La opción más fiable y escalable. Utilice awscli o rclone para la sincronización automática.
• VPS separado: Puede configurar un segundo VPS, más económico, y usar rsync o scp para copiar las copias de seguridad a través de SSH.
• Compartir NFS/SMB: Si tiene un almacenamiento en red, puede montarlo y copiar los archivos allí.

Ejemplo de cómo añadir la sincronización con S3 usando awscli (se asume que awscli está instalado y configurado):

# Añada esto a su script backup_healthchecks.sh después de la sección "Eliminación de copias de seguridad antiguas":
echo "Sincronizando copias de seguridad con S3..."
/usr/local/bin/aws s3 sync "${BACKUP_DIR}" s3://your-s3-bucket-name/healthchecks/
if [ $? -eq 0 ]; then
    echo "Copias de seguridad sincronizadas exitosamente con S3."
else
    echo "ERROR: No se pudieron sincronizar las copias de seguridad con S3."
fi

No olvide configurar awscli en el servidor con las credenciales y permisos de acceso adecuados para su bucket S3.

4. Automatización con Cron

Añada el script de copia de seguridad a Cron para su ejecución automática. Por ejemplo, para una copia de seguridad diaria a las 03:00 de la mañana:

# Abrir crontab para el usuario actual
crontab -e

Añada la siguiente línea al final del archivo:

0 3 * * * /home/newuser/backups/backup_healthchecks.sh >> /home/newuser/backups/backup.log 2>&1

Esta línea ejecuta el script cada día a las 03:00 y redirige toda la salida (incluidos los errores) al archivo backup.log para su posterior revisión.

5. Actualizaciones: Rolling vs. Ventana de mantenimiento

Las actualizaciones regulares son cruciales para la seguridad y para obtener nuevas funciones.

• Actualización del SO: Se recomienda realizarla una vez al mes.

  
  sudo apt update && sudo apt upgrade -y
  sudo apt autoremove -y && sudo apt clean
  

• Actualización de contenedores Docker (Healthchecks.io, PostgreSQL, Redis):

  Healthchecks.io se actualiza obteniendo nuevas imágenes Docker. Esto se puede hacer sin un tiempo de inactividad significativo (actualización continua) si utiliza varias instancias, pero para un solo VPS se requerirá una breve ventana de mantenimiento.

  
  cd ~/healthchecks
  # Detener servicios
  docker compose down
  
  # Obtener las últimas imágenes
  docker compose pull
  
  # Iniciar servicios con las nuevas imágenes
  docker compose up -d
  
  # Eliminar imágenes y volúmenes antiguos no utilizados
  docker system prune -f
  docker volume prune -f
  

  Se recomienda realizar estos pasos en una ventana de mantenimiento predefinida para minimizar el impacto en los usuarios. Antes de actualizar, siempre revise la documentación oficial de Healthchecks.io para detectar cambios en la configuración o migraciones de la base de datos que puedan requerir pasos adicionales.

Recuerde que probar regularmente el proceso de recuperación a partir de las copias de seguridad es tan importante como la creación de las copias de seguridad en sí. Esto garantiza que, en caso de fallo, podrá restaurar rápidamente su sistema.

Solución de problemas + Preguntas frecuentes

Incluso con la configuración más cuidadosa, pueden surgir problemas. Esta sección le ayudará a diagnosticar y resolver los problemas más comunes, así como a responder a las preguntas frecuentes.

No puedo acceder a Healthchecks.io a través del navegador. ¿Qué debo verificar?

Si no puede abrir la interfaz web de Healthchecks.io a través de su nombre de dominio (por ejemplo, https://monitor.yourdomain.com), verifique lo siguiente:

1. Registro DNS: Asegúrese de que el registro A de su dominio apunte correctamente a la dirección IP de su VPS. Use dig monitor.yourdomain.com o herramientas en línea.
2. Cortafuegos (UFW): Verifique si los puertos 80 (HTTP) y 443 (HTTPS) están abiertos en su VPS. Use sudo ufw status verbose.
3. Caddy: Asegúrese de que el servicio Caddy esté en ejecución (sudo systemctl status caddy) y que su archivo de configuración (/etc/caddy/Caddyfile) esté configurado correctamente y apunte al puerto correcto (127.0.0.1:8000). Revise los registros de Caddy: sudo journalctl -u caddy -f.
4. Contenedores Docker: Asegúrese de que todos los contenedores de Healthchecks.io estén en ejecución: cd ~/healthchecks && docker compose ps. Todos los contenedores (db, redis, web) deben estar en estado Up.
5. SITE_ROOT en .env: Asegúrese de que la variable SITE_ROOT en el archivo .env esté configurada con la URL HTTPS completa de su dominio (por ejemplo, https://monitor.yourdomain.com).

El contenedor de Healthchecks.io (web) no se inicia o se reinicia constantemente.

Esto generalmente indica un problema con la configuración o las dependencias. Revise los registros del contenedor:

cd ~/healthchecks
docker compose logs web

Busque mensajes de error en la salida. Las causas típicas son:

• Problemas con la base de datos: Credenciales incorrectas en .env (DB_USER, DB_PASSWORD), o el contenedor db no está en ejecución.
• SECRET_KEY incorrecta: SECRET_KEY debe ser una cadena larga y aleatoria.
• Problemas con las migraciones: Asegúrese de que python manage.py migrate se haya ejecutado correctamente.
• Problemas con Redis: El contenedor redis no está en ejecución o no es accesible.

No recibo notificaciones por correo electrónico.

Verifique los siguientes puntos:

1. Configuración SMTP en .env: Asegúrese de que todas las variables EMAIL_HOST, EMAIL_PORT, EMAIL_HOST_USER, EMAIL_HOST_PASSWORD, EMAIL_USE_TLS y DEFAULT_FROM_EMAIL en el archivo .env estén configuradas correctamente para su proveedor SMTP.
2. Correo electrónico de prueba: Intente enviar un correo electrónico de prueba desde la consola de Healthchecks.io:

   
   cd ~/healthchecks
   docker compose run --rm web python manage.py sendtestemail [email protected]
               

   Esto debería mostrar errores de envío, si los hay.

3. Cortafuegos del VPS: Asegúrese de que su VPS pueda establecer conexiones salientes al puerto SMTP de su proveedor (generalmente 587 o 465).
4. Filtros de spam: Revise la carpeta "Spam" en su buzón de correo.

Los pings no se registran en Healthchecks.io.

Si sus tareas envían pings, pero Healthchecks.io no los ve:

1. URL del ping: Asegúrese de que la URL que su tarea utiliza para enviar el ping sea absolutamente precisa (incluido el UUID de la comprobación). Debe tener el formato https://monitor.yourdomain.com/ping/YOUR_CHECK_UUID/.
2. Disponibilidad de la red: Asegúrese de que el servidor que envía el ping pueda alcanzar su instancia de Healthchecks.io. Verifique con curl -I https://monitor.yourdomain.com desde el servidor que envía el ping.
3. PING_KEY: Si ha configurado la variable PING_KEY en .env, asegúrese de que sus tareas envíen esta clave en el encabezado X-Ping-Key.
4. Zona horaria: Asegúrese de que las zonas horarias en el VPS y en Healthchecks.io estén configuradas correctamente para evitar problemas de programación.

¿Qué configuración mínima de VPS es adecuada?

Para un uso básico de Healthchecks.io, monitoreando decenas o incluso un par de cientos de tareas, un VPS con 1 vCPU, 1-2 GB de RAM y 20-40 GB de SSD será suficiente. Esto será suficiente para el sistema operativo, Docker, Healthchecks.io y su base de datos. Sin embargo, para una mayor estabilidad y posibilidad de crecimiento, se recomienda 2 vCPU, 4 GB de RAM y 60-80 GB de SSD.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de los usuarios y escenarios de monitoreo, Healthchecks.io en un VPS es la solución óptima. Es rentable, suficientemente potente y proporciona el nivel necesario de aislamiento. Los servidores dedicados solo se justifican en casos muy específicos: al monitorear cientos de miles o millones de tareas, cuando se requiere el máximo rendimiento y la ausencia total de "ruido de vecinos", o cuando existen requisitos estrictos de aislamiento físico del hardware.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado con éxito Healthchecks.io en su VPS, asegurando un monitoreo fiable para sus tareas Cron y procesos en segundo plano. Ahora tiene control total sobre su sistema de monitoreo, lo que garantiza notificaciones oportunas sobre cualquier fallo o retraso en el funcionamiento de sus tareas críticas. Esto aumentará significativamente la fiabilidad de su infraestructura y le permitirá reaccionar rápidamente ante los problemas.

Próximos pasos

1. Integración con notificaciones: Configure canales de notificación adicionales de Healthchecks.io, como Slack, Telegram, PagerDuty o webhooks personalizados, para recibir alertas de la manera más conveniente para usted.
2. Comprobaciones adicionales: Empiece a añadir todas sus tareas periódicas a Healthchecks.io. Considere monitorear no solo scripts, sino también operaciones regulares como la actualización de cachés, la verificación del espacio en disco o la limpieza de registros.
3. Monitoreo de recursos del servidor: Para una visión completa del estado de su sistema, considere instalar una herramienta adicional de monitoreo de recursos del servidor, como Netdata o Prometheus/Grafana, para rastrear la CPU, RAM, disco y red de su VPS.