No description
Find a file
2024-02-20 12:04:52 -06:00
.vscode Fix running updog from any location, fix and update docs 2024-02-05 10:15:44 -06:00
docs Add current dir keyword 2024-02-20 12:04:52 -06:00
.gitignore Flesh out basic structure of the program, finish initial extension docs 2024-01-31 17:58:26 -06:00
helpers.py Add default extensions 2024-02-06 12:37:19 -06:00
LICENSE Fix the loicense 2024-01-29 11:35:39 -06:00
README.md Add current dir keyword 2024-02-20 12:04:52 -06:00
services-example.json Add current dir keyword 2024-02-20 12:04:52 -06:00
updog.py Add current dir keyword 2024-02-20 12:04:52 -06:00

Updog

What's updog?

Not much, you?

(it's a simple, extensible uptime monitor)

Warning

Extensions will be executed with no safety checks! Make sure an extension isn't malicious before adding it.

Docs

Docs are in the ./docs/ folder, but here's a quick overview on how to use this:

  1. Clone this repository - git clone --depth 1 https://git.askiiart.net/askiiart/updog
  2. Install your extensions in the appropriate folders: ./extensions/checkers, ./extensions/alerts (optional), and ./extensions/logging
  3. Create your services.json file, example below.
{
    "global-args": {
        "default-checker": "CheckerTemplate",
        "default-alerts": "AlertsTemplate",
        "default-logging": "LoggingTemplate"
    },
    "site": {
        "name": "A Website",
        "checker": "HttpChecker",
        "checker-args": {
            "url": "https://example.com"
        },
        "rate": 1,
        "alerts-args": {
            "url": "https://example.com/webhook-url-or-whatever-goes-here",
            "lol": "irrelevant, AlertsTemplate ignores these options lol"
        },
        "logging-args": {
            "file": "/home/askiiart/Documents/updog/logs/site-log"
        }
    }
}

To-do

  • Add maintenance windows (optionally recurring)
  • Add groups
  • Add ability for checkers to have preferred alerts and logging extensions - will print a warning if the preferred extension(s) are not used
  • Add "keywords" to be replaced in the config (for current directory, service name, maybe some others)
    • Current directory done - %dir%

All specs are still a work-in-progress, breaking changes are likely!