Heartbeats

¿Qué es un heartbeat?

Un heartbeat es una señal HTTP que tu script envía a SecuryBlack cuando termina. Si esa señal no llega en el intervalo configurado, recibes una alerta inmediata.

Es ideal para monitorizar:

• • Backups programados
• • Cronjobs críticos
• • Scripts de mantenimiento
• • Trabajos batch
• • Tareas asincrónicas

¿Cómo funciona?

1. 1.

   Creas un heartbeat en SecuryBlack

   Define el nombre, intervalo (cron expression) y acciones en caso de fallo

2. 2.

   Recibes una URL única

   Algo como: https://ping.securyblack.com/hb/abc123xyz

3. 3.

   Tu script la llama al terminar

   Añade una línea de curl al final de tu script: curl https://ping.securyblack.com/hb/abc123xyz

4. 4.

   SecuryBlack verifica que el ping llega a tiempo

   Si no llega dentro del intervalo configurado, envía una alerta

Crear un heartbeat

1. 1.

   Ve a la sección de Heartbeats

   En tu dashboard, busca "Heartbeats"

2. 2.

   Haz clic en "Nuevo Heartbeat"

   Introduce un nombre descriptivo

3. 3.

   Configura el intervalo

   Usando cron expressions o presets (cada hora, cada día, etc.)

4. 4.

   Configura alertas

   Email, Discord, Telegram, Slack, etc.

5. 5.

   Copia la URL

   Úsala en tu script

Cron Expressions

Configura cuándo esperas que tu script se ejecute usando expresiones cron estándar (UTC):

Usa crontab.guru para generar tus expresiones cron.

Ejemplos de uso

#!/bin/bash
# Backup script

# Tu lógica de backup aquí
mysqldump -u root -p mydb > /backups/mydb.sql

# Notificar a SecuryBlack que el backup completó
curl -s https://ping.securyblack.com/hb/abc123xyz

echo "Backup completado"

import subprocess
import requests

try:
    # Tu lógica aquí
    result = subprocess.run(['python', 'sync_data.py'], check=True)

    # Solo notificar si todo fue bien
    requests.get('https://ping.securyblack.com/hb/abc123xyz')

except Exception as e:
    print(f"Error: {e}")
    # No enviar ping si hay error
    # SecuryBlack detectará que no llegó el heartbeat

Opciones avanzadas