Skip to main content

Curses interface to Checkmk / Checkmk raw.

Project description

Checkmk Commander

Curses interface to Checkmk / Checkmk raw.


The goal is not to completly avoid the web interface, but to speed up common day-to-day tasks. Simple ack, downtime, reinventorize requires several clicks and mouse interaction. With this tool, it should be done in seconds.

Alpha quality, should not be used yet.


![Details v.6](/images/Screenshot v.6.png)

![Overview v.3](/images/Screenshot v.3.png)

![Ack pop-up v.3](/images/Screenshot v.3 ack.png)


From PIP:

pip3 install checkmk-commander

Run command: chkcom


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
  • list (distributed monitoring) site statuses
  • [v] 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
  • show service problem count

Medium pri features

  • Reinventorize a host
  • [v] Make actions async
  • Add logging

Low pri features

  • Ability to run remotely (without being on checkmk host)
  • Reschedule check
  • Add new host?
  • Search in alert list
  • 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


  • Installer
  • 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"

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.1.tar.gz (9.0 kB view hashes)

Uploaded source

Built Distribution

checkmk_commander-0.8.1-py3-none-any.whl (26.9 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