Skip to content

gsonntag/discord-health-check-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Discord Health Check Bot

A Rust-based Discord bot that monitors website health and sends real-time alerts via Discord slash commands and DMs.

Features

  • 🔍 Automated Health Checks - Periodic HTTP monitoring of configured services
  • 📊 Slash Commands - Modern Discord interaction with /subscribe, /status, /ping, /interval
  • 🔔 Smart Notifications - Alerts on status changes (up/down/degraded)
  • ⚙️ Configurable - Adjust check intervals and service endpoints via TOML

Quick Start

Prerequisites

  • Rust 1.70+
  • Discord Bot Token
  • Discord Application ID

Installation

  1. Clone and build:

    cargo build --release
  2. Configure environment (.env):

    DISCORD_TOKEN=your_bot_token
    APPLICATION_ID=your_application_id
    TARGET_USER_ID=your_user_id
    FALLBACK_CHANNEL_ID=fallback_channel_id
  3. Configure services (services.toml):

    [[service]]
    name = "Example API"
    url = "https://api.example.com/health"
  4. Run:

    ./target/release/discord-health-check-bot

Slash Commands

  • /subscribe - Subscribe to health check alerts
  • /status - View current status of all services
  • /ping - Check if bot is responsive
  • /interval [seconds] - View or set check interval (60-3600s)

Tech Stack

  • Rust - Performance and reliability
  • Serenity - Discord API client
  • Tokio - Async runtime
  • Reqwest - HTTP health checks

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors