How to monitor your worker machine through check_mk

Check mk is a powerful system monitoring tool. It allows you to monitor and health check any operative system that you could think of. Even the most exotic distributions.

This is a tutorial to show you how you can monitor the NIC of the docker interface and your physical NIC in order to minimize unresponsive time of your worker. It supports alerts… and even push notifications.

I’ve chosen this monitoring tool to test because it is very user-friendly and doesn’t require too much of technical configuration, but just basic knowledge of linux commands.


Having a separate Ubuntu 21.10 deployed and ready (or any of the supported distros for check-mk).

Let’s get started:

I will use Ubuntu 21.10 in our scenario.

From the server side

  1. Download check mk from the link below and choose a the version depending on your Linux OS:

We are going to use the free edition.

The downloaded deb should be something like: check-mk-free-2.0.0p0_0.impish.amd64.deb

  1. Once you have succesfully downloaded your check-mk, move it to the /opt folder.

  2. Next run this command: sudo apt install -f ./check-mk-free-2.0.0p0_0.impish.amd64.deb

  • all the dependencies will be installed.
  1. To test that the installation went through on the server, run this command:

omd version

  1. At this point, we will need to deploy what we call a “site”. This is going to be our web-based interface from where we are going to monitor our miner instance (which will be our target(client) machine.

  2. Issue this command: omd create phala_miner

  • On the terminal, you will see that a user called cmkadmin is created with a random password. Copy the password to the clipboard.
  1. Start the site with the command: omd start phala_miner

  2. At this point, we have created our server machine with the web-based site that will be used to administrate and monitor our target machine.

To find out the IP of the created site, open a new terminal on another tab and issue the command ip a

usually it should be something like: depending on the allocated ip address allocated by your virtual NIC from VM Ware.

  1. GIven that is the local ip address of the server, go to a browser and type in the address: (in this case phala_miner)

  2. You will be prompted to use your username, which is cmkadmin and the password is the one generated at step 6.

  3. You will land in the GUI interface of the monitoring tool:

  1. First thing that you should do, is change the default password of the cmkadmin user.

  2. Next, download the agent by going on Setup > Agents > and clicking on the deb package icon.

  3. Download the agent package in the client (target) which is our miner

You can achieve this by doing: scp check-mk-agent_2.0.0p23-f4ee9eaf2030da18_all:/tmp [email protected]

  • Enter the password of both the server machine and then the miner machine.
  1. On the target machine, you will see check-mk-agent_2.0.0p23-f4ee9eaf2030da18_all has been added.

  2. Same as we installed the server, run a ** apt install ./check-mk-agent_2.0.0p23-f4ee9eaf2030da18_all.deb**

  3. Back to the monitoring website, go to Steup > Hosts > Add host:

On the ipv4 address field, enter the target machine where you installed the agent.

  1. Click on “Save & go to connection test” and make sure that ping, agent and traceroute tests are green. SNMP is not important, we are using an agent to extract our data, so SNMP is irrelevant here.

Here is an exemple output of the succesfully installed agent:

Version: 2.0.0p23
AgentOS: linux
Hostname: phala-miner
AgentDirectory: /etc/check_mk
DataDirectory: /var/lib/check_mk_agent
SpoolDirectory: /var/lib/check_mk_agent/spool
PluginsDirectory: /usr/lib/check_mk_agent/plugins
LocalDirectory: /usr/lib/check_mk_agent/local
  1. Run a full service scan.

  1. Finally you can see the state of the CPU, NIC interfaces of docker and your physical ethernet:



(!) Note:

If your target host fails to connect to the check_mk server, then you probably need to open default ports on the miner machine.

To maximize security, i strongly suggest you only open the ports to the server local IP and nothing else.

To do this:

On the miner host, issue these commands (where is your miner host ip address):

**sudo ufw enable**
**allow from to port 6556 proto TCP**

Posted by illyrianw#6065

1 Like

Checkmk is software developed in Python and C++ for IT Infrastructure monitoring**. It is used for the monitoring of servers, applications, networks, cloud infrastructures (public, private, hybrid), 192.168.l.254 containers, storage, databases and environment sensors. The Checkmk agent. To monitor a server or workstation you need a small program, the Checkmk agent, which must be installed on the host. The agent is **a simple shell script that is minimalistic, secure, and easily extensible . Since Checkmk version 2.1. 0, there is a new agent that extends the shell script.