Skip to main content

Curses interface to Checkmk Raw.

Project description

Check Commander

Check Commander is an efficient curses interface for the monitoring software Checkmk.

Logo

Most day-to-day activities like time limited acknowledgement, downtime, reinventorize, look up server in a wiki, copy alert text for a ticket system and SSH in to servers can be done with a few keypresses. See screenshots to understand what it's about.

Screenshots

SSH to selected host: SSH to selected host v1.2

Acknowledge an alert and display help: Acknowledge and help v.8

Show details for an alert: Details v.6

Getting Started

Prerequisites

  • An up to date Checkmk instance.
  • Linux (not tested on other platforms yet)
  • Python 3.6 or later

Installation

From PIP:

pip3 install checkmk-commander

Run command: chkcom

Configuration

You need a "machine" account for your Checkmk instance. A normal user won't work. See Checkmk user config.

You will be asked for configuration details on first run, and a config will be created at ~/.config/check-commander.ini

Example check commander config:

host = http://omd.lxd/test/
username = automation
secret = long-random-string

How an ssh connection is opened can be changed. Suggested alternatives (put one in config file):

terminal_command = x-terminal-emulator -e ssh HOSTNAME
terminal_command = tmux split-window -v -c "$PWD" ssh HOSTNAME
terminal_command = tmux new-window -c "#{pane_current_path}" ssh HOSTNAME

These should open default terminal, split your current tmux tab and open new tmux tab respectively.

How a wiki is opened can be changed. Suggested alternative:

url_with_hostname = https://wiki.example.com/?search=HOSTNAME

Refresh delay in seconds can be set thus:

delay = 5

Hot-keys

Press ? in app to get an overview.

Support

Open a gitlab issue if you hit a bug or need help.

Implementation details

Uses CheckMK's web API.

Additional functionality like copy to clipboard or open browser requires python modules cliboard and webbrowser. You will be notified to install them.

Development

Tests can be run with tox. Static tests have been done with prospector.

Inspirations and thanks

What users say

  • "Herregud så mye bedre dette er enn å kuke i webinterface"

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

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page