discord-uptime

Discord Uptime is a Discord bot that allows you to monitor the uptime of services using ICMP ping, tcp and http requests. There are also commands avaliable to make manual requests. Built using discord.py, ping3 and aiohttp.

Installation

Requires Python 3.6+

Install dependencies:

pip install -r requirements.txt

Bot setup (Rename config.example.json and edit the default values):

token - Discord bot token
prefix - Discord bot prefix
activity_type - Activity type for bot status (must be one of playing, streaming, listening, watching)
activity_name - Text for bot status
disable_help - If true, the default help command will be disabled
hide_ips - If true, any IP addresses in notifications or the status command will be hidden
notification_channel - Channel ID where down/up notifications will be sent
retries - How many retries to complete before flagging a server with down status
role_to_mention - Role ID which will be tagged in down/up notifications
secs_between_ping - How many seconds between each uptime check
timeout - How many seconds before a ping or HTTP request should timeout

No privileged intents are currently needed to run the bot.

Servers Configuration

Servers should be setup similar to the examples already in server.json:

There are three supported types: http, tcp and ping

[
    {
      "name": "Google",
      "type": "http",
      "address": "google.com"
    },
    {
      "name": "Gmail SMTP",
      "type": "tcp",
      "address": "smtp.gmail.com:465",
    },
    {
      "name": "Cloudflare",
      "type": "ping",
      "address": "1.1.1.1"
    }
]

Commands

Default Prefix: >

ping <address> [pings] - Pings an address once, or for the amount specified via pings and returns the delay in ms
http <address> - Performs a HTTP request to the specified address and returns the response code
status - Displays the status of all servers setup in servers.json

Screenshots

Status Command

Uptime & Downtime Notifications

Hide IP addresses

Contributing