Linuxfabrik Monitoring Plugins - Stuck during install

Service Monitoring
1

I have a brand new Icinga 2 server running on Ubuntu 24 with Director installed.

I ran the commands to download/install the Linuxfabrik Plugins, but I’m getting stuck where they’re talking about how to integrate the plugins with Director and talking about baskets, etc. They talk about creating a basket without UID’s and then list:

./tools/basket-join
./tools/remove-uuids
–input-file icingaweb2-module-director-basket.json
–output-file icingaweb2-module-director-basket-no-uuids.json

But I have no idea what to do with that. Am I supposed to run those as commands? Something in the Icinga web interface?

I have the Linuxfabrik monitoring plugins installed, but I don’t know how to finish the install & integrate with Director. I’m a very early beginner in Linux, etc. So don’t assume I know how do to anything. :slight_smile:

2

Yes, this are commands in the monitoring-plugins repository that you’re supposed to run in a terminal.

3

So what do I do if I don’t have a “./tools” folder to run the “basket-join” command in?

4

It’s here in the repository: monitoring-plugins/tools at main · Linuxfabrik/monitoring-plugins · GitHub

5

I ran the download/install commands from the main page:

mkdir -p /etc/apt/keyrings
wget https://repo.linuxfabrik.ch/linuxfabrik.key --output-document=/etc/apt/keyrings/linuxfabrik.asc
source /etc/os-release
echo "deb [signed-by=/etc/apt/keyrings/linuxfabrik.asc] https://repo.linuxfabrik.ch/monitoring-plugins/ubuntu/ $VERSION_CODENAME-release main" > /etc/apt/sources.list.d/linuxfabrik-monitoring-plugins.list
apt update
apt install linuxfabrik-monitoring-plugins

Do I need to do something else to get it ready for running those other commands for Director?

I tried running the one command on that page:
icingacli director basket restore < cpu-usage.json -v
but it gave me an error that the file or directory didn’t exist.

6

What you did is the correct way to install the plugins for the targets but on one machine, you would need to clone the repository and build the baskets to import the settings for the director.

7

Where are the instructions to do that part?

I thought the “wget” part cloned the repository. Did I miss a step somewhere? Those were all of the instructions they had listed under “Ubuntu”. It’s not very intuitive on the website.

8

Download the matching source zip from the releases or clone the repository and checkout the matching tag - see first 2 code blocks from monitoring-plugins/INSTALL.md at main · Linuxfabrik/monitoring-plugins · GitHub.

Then follow the instructions at monitoring-plugins/ICINGA.md at main · Linuxfabrik/monitoring-plugins · GitHub

9

Ok. I’ll work on that in a bit and let you know how it goes.

Thank you for the help!

10

Ok, my work is blocking github, so I can’t do the clone command. I have downloaded the file: monitoring-plugins-2.4.0.tar.gz. Where should I unpack the entire file before trying the other commands?

11

Also, I already installed a linuxfabrik-monitoring-plugins file, was that for nothing or was it a pre-requisite? (see pictures)

2025-07-17_11-51-16
2025-07-17_11-51-162311×578 58.5 KB

2025-07-17_11-52-22
2025-07-17_11-52-222283×640 53 KB

12

PS - You said that what I did was the correct way to install the plugins for the targets???
I did that on the SERVER, the Icinga 2 server. Do I need to install these on the target systems as well?
Most of my target systems are going to be Windows-based. How would I install the files I need on them as well?
The main reasons I’m focusing on LinuxFabrik’s are because it seemed to have all the monitoring tools I’d want in one package and there were numerous reports that they run faster/better than other counterparts. And I want to keep the system overhead, network bandwidth, etc. to a minimum.

13
  1. the plugins are one thing
  2. the icinga config the other

You installed the plugins so #1 is taken care of.

Now you extract the sources (monitoring-plugins-2.4.0.tar.gz) somewhere (is throwaway) to generate the baskets to import into the Icinga Director to get the necessary command objects, service templates objects, and service-sets.

So:

  1. extract archive to a place of your choice
  2. follow the guide to build the basket
  3. import the basket into the director
  4. delete the extracted archive or leave it laying around

Now you’re ready to use the plugins by using the tpl-host-generic at the root of your templates to get the necessary field like Tags and Criticality. I cloned Tags and called it Custom Tags to manage the service-sets I build to monitor our bespoke applications.

@linuxfabrik I’m offline next week, so maybe, you could help @TowerMark, if he get’s stuck again.

1 Like
14

@rivad , @linuxfabrik I got the file on the server, got it extracted. I’m at #2, “follow the guide to build the basket”.

What guide??? I have the instructions page up on importing the basket into director, that’s from the ‘Director’ link on the main install page. But I don’t see any guide on how to build the basket in the first place. (I could be blind)

15

Ok, I was blind. I followed the instructions and now I think it worked (mostly) I’ve got a handful of service templates. Is this all I need for ALL the plugins??? It seems a bit small. How do I go from here to setting up things like CPU/disk checks on my Windows Servers?

image
image1074×969 41.1 KB