Skip to main content

Curses interface to Checkmk Raw.

Project description

Checkmk Commander

Efficient Curses interface for Checkmk Raw, https://checkmk.com/.

Logo

The goal is not to completely avoid the web interface, but to speed up common day-to-day tasks. Actions like acknowledge, downtime, reinventorize can be done in seconds, with keyboard only. Overview is clean and simple.

Beta quality. Can be used, but beware of bugs.

Project home: https://gitlab.com/larsfp/checkmk-commander

Screenshots

Acknowledge and help v.8

Details v.6

Overview v.3

Installation

From PIP:

pip3 install checkmk-commander

Run command: chkcom

Hot-keys

Press ? in app to get an overview.

Implementation details and limitations

Uses CheckMK's web API. You need an "machine" account with a secret. A normal user won't work.

High pri features

  • list service problems from several checkmk instances
  • ack service problems
    • Show popup to add comment
    • Parse time from comment
    • ack service problems on all sites, not just main host
  • ack host problems
  • downtime service problems
  • comment service problems
  • show down hosts

Medium pri features

  • list (distributed monitoring) site statuses
  • Reinventorize a host
  • Make actions async
  • Add logging
  • show service problem count

Low pri features

  • Ability to run remotely (without being on checkmk host)
  • Reschedule check
  • Add new host?
  • Search in alert list
  • Search in all host/services
  • Sort alert list
  • Act on more than one alert at a time?
  • if running locally, fetch secret from var/check_mk/web/USER/automation.secret
  • Show in overview that comments on a service exists
  • List event notifications
  • List hosts/services in downtime

TODO

  • Improve readability, colors.
  • Clean up code.
  • Find down time for down-alerts.
  • Fetch host comments for down hosts.
  • Status bar at bottom should perhaps be switched for a scrolling textview with "Host- and Service events"
  • Icon, desktop integration. https://pypi.org/project/install-freedesktop/
  • I can only assume syslog is os dependent.
  • Write unit tests

Inspirations and help

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

checkmk-commander-0.8.4.tar.gz (9.8 kB view hashes)

Uploaded source

Built Distribution

checkmk_commander-0.8.4-py3-none-any.whl (27.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page