Zabbix loadable module for monitoring System V IPC facilities

This module tries to mimic ipcs utility. It can read various information about shared memory segments, message queues and semaphore sets given IPC object identifier. On Linux it additionally supports low level discovery.

1. Download Zabbix source or check it out from Git repository: git clone https://git.zabbix.com/scm/zbx/zabbix.git --depth 1 /path/to/zabbix/source

Any version higher than 2.2 (when loadable module support was added) will do. But you need to compile module using sources of the version you will be using it with!

2. Configure Zabbix sources:

cd /path/to/zabbix/source
./bootstrap.sh
./configure

3. Get module sources, point them to Zabbix source directory and run make to build, it should produce zaipcs.so shared library.

cd /path/to/zaipcs/source
export ZABBIX_SOURCE=/path/to/zabbix/source
make

Copy zaipcs.so to a desired location, set up necessary permissions.

Set LoadModulePath and LoadModule parameters in Zabbix agent / proxy / server configuration file.

Restart Zabbix agent / proxy / server.

Configure checks:

• use item type Simple check if the module is loaded by server or proxy;
• use item type Zabbix agent or Zabbix agent (active) if the module is loaded by agent.

This key mimics ipcs --shmems --id .... id is a shared memory segment identifier. Possible combinations of mode and option with their resulting value are given in the table below.

This key mimics ipcs --queues --id .... id is a message queue identifier. Possible combinations of mode and option with their resulting value are given in the table below.

This key mimics ipcs --semaphores --id .... id is a semaphore array identifier. Possible combinations of mode and option with their resulting value are given in the table below.

These keys use non-standard Linux-specific calls and may not be universally supported

These keys can accept parameters, but ignore them. This way you can set up several discoveries on the same template or host without many troubles. Low level discovery provides the following macros:

• "invalid resource identifier" - failed to read IPC resource id, it should be a nonnegative integer number

• "incorrect number of parameters" - misconfiguration, either too few or too many parameters (depends on mode)

• "invalid 'mode' parameter" - misconfiguration, mode parameter is not recognized

• "invalid 'option' parameter" - misconfiguration, please refer to the tables of supported option and mode combinations

• "not supported on this platform" - author does not know yet how to implement feature on your platform, you can assist by providing documentation and/or testing

• various errors from system...

Zabbix agent / proxy / server needs at least read permissions to discover and obtain details of IPC resources!

Coming later...

Author is too lazy and too arrogant to test the module properly. Therefore the best thing you can do to help is to compile and test the module in your environment. Feedback, both positive and negative, will be highly appreciated.

Module comes without configure script. Makefile is very primitive. Installation and configuration process is 100% manual. Luckily there is only one file and no dependencies, therefore, it should compile easily on on any Unix-like platform. Mind that author earns his money being C developer and finds compiling really easy. If you encounter any problems or simply disagree with his opinion, feel free to provide information about compilation errors, warnings and other issues on your platform.

Development was done on Linux, but is based on standard System V IPC functionality. Only low level discovery and a couple of mode/option combinations depend on non-standard Linux features. If you see "not supported on this platform" for the feature you desperately need, if the module is working incorrectly or if it is crashing (unlikely but not impossible) - please provide the output of man shmctl, man msgctl, man semctl and other relevant information for investigation.

One more thing you need to know about the author - he does not use Zabbix more than he is obliged to, he has very little monitoring experience and he is an absolute zero in system administration. If you find module configuration too difficult, supported item keys useless or default parameter value choice illogical, feel free to throw your opinion at him.