Giter Club home page Giter Club logo

freebsd-uptimebot's Introduction

Uptimebot

Lightweight uptime monitoring and reporting tool for FreeBSD.

If you're looking for a simple monitoring tool that can be setup in less than a minute, keep reading! uptimebot monitors IP addresses, ports, http servers, changes in DNS records and expiration date of TLS certificates. When stuff breaks, you will be notified via log or a Telegram bot.

Features

  • Extremely easy to setup and use.
  • Supports both IPv4 & IPv6.
  • Supports A, AAAA, CNAME, TXT, MX, NS, SOA and PTR records.
  • Outputs alerts to log and Telegram.
  • Uses basic shell and FreeBSD tools.
  • Automatic cronjob creation.

Installing / Getting started

You can install uptimebot with botmanager. Or manually as follows:

wget https://raw.githubusercontent.com/nozel-org/freebsd-uptimebot/master/uptimebot -O /usr/local/bin/uptimebot
chown root:wheel /usr/local/bin/uptimebot
chmod 555 /usr/local/bin/uptimebot
wget https://raw.githubusercontent.com/nozel-org/freebsd-uptimebot/master/uptimebot.conf -O /usr/local/etc/uptimebot/uptimebot.conf
chown root:wheel /usr/local/etc/uptimebot/uptimebot.conf
chmod 755 /usr/local/etc/uptimebot/uptimebot.conf
wget https://raw.githubusercontent.com/nozel-org/freebsd-uptimebot/master/targets.conf -O /usr/local/etc/uptimebot/targets.conf
chown root:wheel /usr/local/etc/uptimebot/targets.conf
chmod 755 /usr/local/etc/uptimebot/targets.conf

When installed, add a monitoring target to /usr/local/etc/uptimebot/targets.conf and fire away by running uptimebot --all --cli.

Configuration

General settings and automated tasks can be configured in /usr/local/etc/uptimebot/uptimebot.conf. Automated tasks can be effectuated with uptimebot --cron. Monitoring targets can be set in /usr/local/etc/uptimebot/targets.conf.conf.

How to use

uptimebot has features, methods and options. Options can be used standalone, but a feature always requires a method and vice versa. Some examples:"

# options
$ uptimebot --help                           # Displays help text
$ uptimebot --cron                           # Effectuates automated tasks

# features/methods
$ uptimebot --all --list                     # Shows an overview of all configured monitoring targets
$ uptimebot --ping --cli                     # Runs the ping feature and outputs to CLI and log
$ uptimebot --port --logonly                 # Runs the port feature and outputs only to log
$ uptimebot --http --telegram                # Runs the http feature and outputs to Telegram and log

For a full list of features, methods and options run uptimebot --help.

Support

If you have questions, suggestions or find bugs, please let us know via the issue tracker.

Changelog

1.4.2-RELEASE (22-08-2023)

  • Fixed incorrect indents.

1.4.1-RELEASE (01-02-2023)

  • Moved configuration files to /usr/local/etc/uptimebot.
  • Renamed uptimebot_targets.conf to targets.conf.
  • Replaced install script with botmanager.

1.4.0-RELEASE (28-04-2022)

  • Renamed method logonly to log.
  • Made method list consistent with the method cli output.
  • Fixed a bug in feature tls that would generate errors for already expired certificates.
  • Added a basic check for monitoring target validity.
  • Added requirement check for curl.
  • Added inverted functionality to feature port.

1.3.0-RELEASE (27-04-2022)

  • Added feature TLS.
  • Added emoji to method Telegram.

1.2.0-RELEASE (26-04-2022)

  • Got rid of similar pieces of code by combining functions.
  • Fixed a lot of shellcheck warnings and errors.
  • Added check for telegram configuration.

1.1.0-RELEASE (25-04-2022)

  • Added feature DNS with support for A, AAAA, CNAME, TXT, MX, NS, SOA and PTR records.
  • Delay between monitoring actions (to prevent flooding) is now configurable.
  • Logging output layout is now more consistent across all methods.
  • Made certain checks more efficient to speed up the program.
  • Feature port now supports both IPv4 and IPv6 (configurable).
  • Changed default cron values.

1.0.0-RELEASE (24-04-2022)

  • Added basic program framework.
  • Added configuration file.
  • Added configuration file for monitoring targets.
  • Added automatic cron jobs for automated tasks.
  • Added logging of monitoring results.
  • Added ping monitoring feature.
  • Added port monitoring feature.
  • Added http monitoring feature.
  • Added all monitoring feature.
  • Added method list.
  • Added method logonly.
  • Added method CLI.
  • Added method Telegram.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.