Skip to content

Latest commit

 

History

History
255 lines (150 loc) · 7.05 KB

README.md

File metadata and controls

255 lines (150 loc) · 7.05 KB

NAME

Zabbix::Check - System and service checks for Zabbix

VERSION

version 1.12

SYNOPSIS

System and service checks for Zabbix

    UserParameter=cpan.zabbix.check.installed,/usr/bin/env bash -c "/usr/bin/env perl -MZabbix::Check 2>/dev/null; if [ \$? -eq 0 ]; then echo 1; else echo 0; fi"
    UserParameter=cpan.zabbix.check.version,/usr/bin/env perl -MZabbix::Check -e_version
    # Disk
    UserParameter=cpan.zabbix.check.disk.discovery,/usr/bin/env perl -MZabbix::Check::Disk -e_discovery
    UserParameter=cpan.zabbix.check.disk.bps[*],/usr/bin/env perl -MZabbix::Check::Disk -e_bps -- $1 $2
    UserParameter=cpan.zabbix.check.disk.iops[*],/usr/bin/env perl -MZabbix::Check::Disk -e_iops -- $1 $2
    UserParameter=cpan.zabbix.check.disk.ioutil[*],/usr/bin/env perl -MZabbix::Check::Disk -e_ioutil -- $1
    # Supervisor
    UserParameter=cpan.zabbix.check.supervisor.installed,/usr/bin/env perl -MZabbix::Check::Supervisor -e_installed
    UserParameter=cpan.zabbix.check.supervisor.running,/usr/bin/env perl -MZabbix::Check::Supervisor -e_running
    UserParameter=cpan.zabbix.check.supervisor.worker_discovery,/usr/bin/env perl -MZabbix::Check::Supervisor -e_worker_discovery
    UserParameter=cpan.zabbix.check.supervisor.worker_status[*],/usr/bin/env perl -MZabbix::Check::Supervisor -e_worker_status -- $1
    # RabbitMQ
    UserParameter=cpan.zabbix.check.rabbitmq.installed,/usr/bin/env perl -MZabbix::Check::RabbitMQ -e_installed
    UserParameter=cpan.zabbix.check.rabbitmq.running,/usr/bin/env perl -MZabbix::Check::RabbitMQ -e_running
    UserParameter=cpan.zabbix.check.rabbitmq.vhost_discovery[*],/usr/bin/env perl -MZabbix::Check::RabbitMQ -e_vhost_discovery -- $1
    UserParameter=cpan.zabbix.check.rabbitmq.queue_discovery[*],/usr/bin/env perl -MZabbix::Check::RabbitMQ -e_queue_discovery -- $1
    UserParameter=cpan.zabbix.check.rabbitmq.queue_status[*],/usr/bin/env perl -MZabbix::Check::RabbitMQ -e_queue_status -- $1 $2 $3
    # Systemd
    UserParameter=cpan.zabbix.check.systemd.installed,/usr/bin/env perl -MZabbix::Check::Systemd -e_installed
    UserParameter=cpan.zabbix.check.systemd.system_status,/usr/bin/env perl -MZabbix::Check::Systemd -e_system_status
    UserParameter=cpan.zabbix.check.systemd.service_discovery[*],/usr/bin/env perl -MZabbix::Check::Systemd -e_service_discovery -- $1
    UserParameter=cpan.zabbix.check.systemd.service_status[*],/usr/bin/env perl -MZabbix::Check::Systemd -e_service_status -- $1
    # Time
    UserParameter=cpan.zabbix.check.time.epoch,/usr/bin/env perl -MZabbix::Check::Time -e_epoch
    UserParameter=cpan.zabbix.check.time.zone,/usr/bin/env perl -MZabbix::Check::Time -e_zone
    UserParameter=cpan.zabbix.check.time.ntp_offset[*],/usr/bin/env perl -MZabbix::Check::Time -e_ntp_offset -- $1 $2
    # Redis
    UserParameter=cpan.zabbix.check.redis.installed,/usr/bin/env perl -MZabbix::Check::Redis -e_installed
    UserParameter=cpan.zabbix.check.redis.discovery,/usr/bin/env perl -MZabbix::Check::Redis -e_discovery
    UserParameter=cpan.zabbix.check.redis.running[*],/usr/bin/env perl -MZabbix::Check::Redis -e_running -- $1
    UserParameter=cpan.zabbix.check.redis.info[*],/usr/bin/env perl -MZabbix::Check::Redis -e_info -- $1 $2
    UserParameter=cpan.zabbix.check.redis.resptime[*],/usr/bin/env perl -MZabbix::Check::Redis -e_resptime -- $1

DISK

Zabbix check for disk

discovery

discovers disks

bps $1 $2

gets disk I/O traffic in bytes per second

$1: device name, eg: sda, sdb1, dm-3, ...

$2: type: read|write|total

iops $1 $2

gets disk I/O transaction speed in transactions per second

$1: device name, eg: sda, sdb1, dm-3, ...

$2: type: read|write|total

ioutil $1

gets disk I/O utilization in percentage

$1: device name, eg: sda, sdb1, dm-3, ...

SUPERVISOR

Zabbix check for Supervisor service

installed

checks Supervisor is installed: 0 | 1

running

checks Supervisor is installed and running: 0 | 1 | 2 = not installed

worker_discovery

discovers Supervisor workers

worker_status $1

gets Supervisor worker status: RUNNING | STOPPED | ...

$1: worker name

RABBITMQ

Zabbix check for RabbitMQ service

installed

checks RabbitMQ is installed: 0 | 1

running

checks RabbitMQ is installed and running: 0 | 1 | 2 = not installed

vhost_discovery $1

discovers RabbitMQ vhosts

$1: cache expiry in seconds, by default 0

queue_discovery $1

discovers RabbitMQ queues

$1: cache expiry in seconds, by default 0

queue_status $1 $2 $3

gets RabbitMQ queue status using queue discovery cache

$1: vhost name

$2: queue name

$3: type: ready|unacked|total

SYSTEMD

Zabbix check for Systemd services

installed

checks Systemd is installed: 0 | 1

system_status

gets Systemd system status: initializing | starting | running | degraded | maintenance | stopping | offline | unknown

service_discovery

discovers Systemd enabled services

$1: regex of service name, by default undefined

service_status $1

gets Systemd enabled service status: active | inactive | failed | unknown | ...

$1: service name

TIME

Zabbix check for system time

epoch

gets system time epoch in seconds

zone

gets system time zone, eg: +0200

ntp_offset $1 $2

gets system time difference by NTP server

$1: server, by defaut pool.ntp.org

$2: port, by default 123

REDIS

Zabbix check for Redis service

installed

checks Redis is installed: 0 | 1

discovery

discovers Redis instances

running $1

checks Redis is installed and instance is running: 0 | 1 | 2 = not installed

$1: bind, by defaut 127.0.0.1:6379

info $1 $2

gets info

$1: key

$2: bind, by defaut 127.0.0.1:6379

resptime $1

gets single GET command response time from Redis

$1: bind, by defaut 127.0.0.1:6379

INSTALLATION

To install this module type the following

    perl Makefile.PL
    make
    make test
    make install

from CPAN

    cpan -i Zabbix::Check

DEPENDENCIES

This module requires these other modules and libraries:

  • JSON
  • Net::NTP
  • Lazy::Utils

REPOSITORY

GitHub https://github.com/orkunkaraduman/Zabbix-Check

CPAN https://metacpan.org/release/Zabbix-Check

AUTHOR

Orkun Karaduman (ORKUN) <orkun@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2017 Orkun Karaduman <orkunkaraduman@gmail.com>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.