fikkie 0.4.0

Lightweight monitoring tool

🔥 Fikkie

A simple lightweight watchdog which monitors external services over SSH.

Quick links

• Installation
• Config example
• Documentation
• Contributing
• Changelog

Introduction

Why use fikkie?

• Fikkie is easy to set up
• Fikkie is lightweight
• Fikkie is flexible and could be used to monitor any service
• Fikkie notifies you using your favorite messaging service (i.e. e-mail or Telegram)

Simply specify which commands should be run on which servers and what output is expected, and fikkie will let you know when something's wrong.

Installation

Install fikkie using pip and initialize fikkie:

pip install fikkie
fikkie init

Config example

The fikkie configuration file is placed at ~/.fikkie/config.yaml by default and could look something like this:

---
ssh:
  username: fikkie

servers:
  primary.foo.com:
    - description: 'MariaDB'
      command: 'sudo systemctl status mariadb | grep "Active: active" -c'
      expected: '1'
    - description: 'HTTP code foo.com'
      command: 'curl -s -o /dev/null -w "%{http_code}" foo.com'
      expected: '200'

notifiers:
  - type: telegram
    token: '1234:abcd'
    chat_id: 1234

Contributing

Contributions to fikkie are more than welcome!

Please visit the contribution guidelines for more info.