SENTINEL is a simple monitoring system written in Go. This application can monitor the status of various web services via HTTP and report their status periodically. It's ideal for personal use or small teams that need a lightweight and easily configurable monitoring solution.

• Monitor various web services via HTTP/HTTPS
• Simple configuration using YAML format
• Customizable check intervals and timeouts per service
• UP/DOWN status reporting with response time
• Automatic checks on configurable intervals
• Concurrency for efficient checking
• Flexible CLI with various commands
• Telegram notifications for service DOWN/RECOVERY alerts
• Discord webhook notifications with rich embeds
• Docker support with multi-stage builds (image size < 30MB)
• Environment variable support for secure credential management

• Go 1.21 or newer

# Clone repository
git clone https://github.com/0xReLogic/SENTINEL.git
cd SENTINEL

# Build application
make build

# Or use Go directly
go build -o sentinel

go install github.com/0xReLogic/SENTINEL@latest

1. Create a sentinel.yaml configuration file (see example below)
2. Run SENTINEL with one of the following commands:

# Run continuous checks
./sentinel run

# Run a single check
./sentinel once

# Validate configuration file
./sentinel validate

# Display help
./sentinel --help

# Use custom configuration file
./sentinel run --config /path/to/config.yaml

# Copy environment variables
cp .env.example .env
# Edit .env with your tokens - get these from mentioned steps 

# Start SENTINEL
docker compose up -d

# View logs
docker compose logs -f

# Stop SENTINEL
docker compose down

docker build -t sentinel .

# Run container
docker run --rm --env-file .env -v ./sentinel.yaml:/app/sentinel.yaml -p 8080:8080 sentinel

Mount your sentinel.yaml config file as a volume to customize which services to monitor.

The sentinel.yaml configuration file has the following format:

# SENTINEL Configuration File
services:
  - name: "Google"
    url: "https://www.google.com"
    interval: 30s       # optional, default is 1m
    timeout: 3s         # optional, default is 5s
  - name: "GitHub"
    url: "https://github.com"
    interval: 2m
  - name: "Example"
    url: "https://example.com"
    # No interval/timeout defined -> defaults apply

If interval or timeout are omitted, SENTINEL falls back to the defaults of 1m and 5s respectively.

SENTINEL/
├── checker/       # Package for service checking
├── cmd/           # CLI commands
├── config/        # Package for configuration management
├── notifier/      # Notification for Telegram
├── main.go        # Main program file
├── Makefile       # Makefile for easier build and test
├── go.mod         # Go module definition
├── go.sum         # Dependencies checksum
├── sentinel.yaml  # Example configuration file
├── LICENSE        # MIT License
├── README.md      # Main documentation
└── CONTRIBUTING.md # Contribution guidelines

Contributions are greatly appreciated! Please read CONTRIBUTING.md for details on the pull request submission process.

SENTINEL can send real-time alerts when a service goes down or recovers.

To receive notifications in a Telegram chat, follow these steps:

Step 1: Get Telegram Credentials

1. Bot Token:

   • Open Telegram and start a chat with the official @BotFather.
   • Send the /newbot command and follow the prompts to create your bot.
   • @BotFather will give you a unique Bot Token. This is a secret, so don't share it publicly.

2. Chat ID:

   • Start a chat with your newly created bot by finding it and sending the /start command. This is a required step.
   • Next, start a chat with the bot @userinfobot.
   • Send it a message, and it will reply with your user information, including your Chat ID.

Step 2: Configure SENTINEL

1. Create a .env file in the root directory of the project. This file will securely store your secrets. Important: Add .env to your .gitignore file to avoid committing secrets to your repository.

   # .env
   # Variables for Telegram notifications
   TELEGRAM_BOT_TOKEN="123456:ABC-DEF1234ghIkl-JAS0987-aB5-qwer"
   TELEGRAM_CHAT_ID="123456789"
   

2. Update your sentinel.yaml to enable and configure Telegram notifications. The ${VAR_NAME} syntax will securely load the values from your .env file.

   # sentinel.yaml
   
   notifications:
     telegram:
       enabled: true
       bot_token: "${TELEGRAM_BOT_TOKEN}"
       chat_id: "${TELEGRAM_CHAT_ID}"
       notify_on:
         - down
         - recovery

When a service status changes, you will receive a message in your configured chat.

Service Down

🔴 Service DOWN Name: My Failing API URL: https://api.example.com/health Error: connection timeout Time: 2025-10-12 10:10:00

Service Recovered

🟢 Service RECOVERED Name: My Failing API URL: https://api.example.com/health Downtime: 5m 30s Time: 2025-10-12 10:15:30

To receive notifications in a Discord channel via webhook:

Step 1: Get Discord Webhook URL

1. Open your Discord server and go to Server Settings → Integrations → Webhooks
2. Click "New Webhook" or "Create Webhook"
3. Give your webhook a name (e.g., "SENTINEL Monitor")
4. Select the channel where you want to receive notifications
5. Click "Copy Webhook URL" - this is your webhook URL

Step 2: Configure SENTINEL

1. Add to your .env file:

   # .env
   # Variables for Discord notifications
   DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/123456789/abcdefghijklmnop"
   

2. Update your sentinel.yaml:

   # sentinel.yaml
   
   notifications:
     telegram:
       enabled: false  # Can enable both at the same time
       bot_token: "${TELEGRAM_BOT_TOKEN}"
       chat_id: "${TELEGRAM_CHAT_ID}"
       notify_on:
         - down
         - recovery
     discord:
       enabled: true
       webhook_url: "${DISCORD_WEBHOOK_URL}"
       notify_on:
         - down
         - recovery

Discord notifications use rich embeds with color coding:

Service Down (Red embed)

• Title: 🔴 Service DOWN
• Fields:
  • Service: My Failing API
  • URL: https://api.example.com/health
  • Error: connection timeout
• Timestamp: 2025-10-12T10:10:00Z

Service Recovered (Green embed)

• Title: 🟢 Service RECOVERED
• Fields:
  • Service: My Failing API
  • URL: https://api.example.com/health
  • Downtime: 5m 30s
• Timestamp: 2025-10-12T10:15:30Z

Note: You can enable both Telegram and Discord notifications simultaneously. SENTINEL will send alerts to all enabled notification channels.

The script will automatically build binaries for all platforms (Linux, Windows, macOS) and place them in the ./dist folder.

This project is licensed under the MIT License - see the LICENSE file for details.

Thanks to all the amazing people who have contributed to SENTINEL. 🎉

• Inspiration from various monitoring systems such as Prometheus, Nagios, and Uptime Robot