Terminology

MONITORING PACKS:

A Monitoring Pack is a model or configuration profile of WOCU, which performs a certain monitoring function. They are created and designed according to the most actually technologies.

CATEGORY:

The Categories are a group of classes or attributes that allow group and filtered of Monitoring Packs according to technical and functional aspects. The Categories are not fixed, their creation is continuous and will depend on the appearance of new technological needs.

SERVICE:

A Service is each one of the checks that WOCU makes in a host, to associate an availability state after the check of each of them.

MACRO:

Macros are configurable elements through Packs, that WOCU uses internally to store properties and information of the monitored assets. There are two types:

  • Simple Macro: stores a single value.

  • Complex Macro: stores a multitude of values into a table.

CHECK COMMAND:

Commands launched to check the state of a specific parameter, that you want to know of a host (CPU, hard disk space, RAM used, etc.).

DISCOVER:

WOCU functionality to automatically set values for specific macros.

Introduction

WOCU is a monitoring system and network supervision, that provide detailed information about the status and availability of monitored assets, integrated into reduced or extended technological infrastructures. It can manage and monitor discovered assets automatically, running a fast process without failures, and most importantly without interaction by the user.

For that, the configuration and start-up of two elements is essential:

Import Tasks


These are automatic import systems, that trace and discover assets operating in the network, obtaining its most outstanding properties. They are configured through a few simple steps for the high massive and / or automatic asset updating from multiple sources.

The newly imported assets pass first and provisionally to the list of Pending Assets. Already integrated in WOCU they will not be monitored until their transfer to list of Active Assets or temporarily sent to Blacklisted Assets list, where they will be isolated and out of the monitoring. This process is manual and requires the supervision of a user.

Hosted in Pending Assets, or in Operative Assets, it is possible to configure the monitoring profile of the assets, assignment Monitoring Packs.

../../_images/wocupacks.png

This independent process is important because it is the basis of our inventory of monitoring, and will be used in the next phase to give intelligence to the rest of the system.

Monitoring Packs


A Monitoring Pack is a model or configuration profile of WOCU, which performs a certain monitoring function. They are created and designed according to the most actually technologies.

When a host is imported through a Task, WOCU determines its typology or function and assigns it a Monitoring Packs. For this reason the configuration is simple, agile, fast and without having to resort to other external tools. Positioning WOCU as a totally self-sufficient and proactive tool.

The user can use the suggested Monitoring Packs, edit or complete their configuration, or choose other different packs that adapt to their needs.

There are Monitoring Packs designed for technologies or manufacturers (Cisco, Palo Alto, Linux, Windows, etc.), oriented at certain configurations of the hosts (MySQL-Server, http-Proxy, Hsrp-Cisco, etc.), for certain technical aspects (QOS, Networkdevice-Mem), or generic packs that are adapt to different types of hosts (Networkdevice-Traffic, Snmp-Generic, etc.).

Configuration

Each pack has a set of macros, configuration variables that WOCU applies internally to store properties of the monitored assets. These variables are associated with services, which according to the configuration of the macro, will change its behavior. For example, the macro _MEMORY_CRIT, which defines the critical percentage threshold of the physical memory used, affects the Memory service, which measures the memory of a host.

To obtain values, the services launch a Check_Command, to identify the appropriate commands for the request and return the results. In the previous example, the command should collect the percentage of memory used.

In conclusion, services and commands are preserved, but depending of the associated pack and configured macros, different results will be obtained for each monitored host.

Important

The documentation of this chapter is self-generated from the information stored in the own pack definitions. For this reason, it may contain some inconsistencies or missing information that will be completed and updated over time. Along with the rest of the documentation, this chapter is also written in english because all packs are registered and documented this way. The creation of packs is continuous and will depend on the appearance of new functional and technological requirements, so the packs catalog will grow.

Pack categories

Security

Alienvault-aio

DESCRIPTION


Specific checks for Alienvault All in One devices

../../_images/alienvault-aio.png

Checks Alienvault All in One metrics and processes. NRPE Agent must be installed in Alienvault device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Alienvault-aio Monit

Checks if monit process is running

check_av_aio_monit

Alienvault-aio Rsyslog

Checks if rsyslogd is running

check_av_aio_rsyslog

Alienvault-aio Framework

Checks if ossim-framework is running

check_av_aio_framework

Alienvault-aio Server

Checks if ossim-server is running

check_av_aio_server

Alienvault-aio RabbitMQ Server

Checks if rabbitmq-server is running

check_av_aio_rabbitmq_server

Alienvault-aio Sandas

Checks if sandas is running

check_av_aio_sandas

Alienvault-aio Redis Server

Checks if redis-server is running

check_av_aio_redis_server

Alienvault-aio Mongodb

Checks if mongod is running

check_av_aio_mongodb

Alienvault-aio Agent

Checks if ossim-agent is running

check_av_aio_agent

_HOSTAGENT_WARNING

_HOSTAGENT_CRITICAL

Alienvault-aio Size

Checks the logger size

check_av_aio_size

Alienvault-aio Procs

Checks the number of processes

check_av_aio_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Alienvault-aio Mysqld

Checks if mysqld is running

check_av_aio_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-aio Apache

Checks if apache2 is running

check_av_aio_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_APACHE_WARNING

Running Apache processes warning range threshold (Ex: 1:12)

string

_APACHE_CRITICAL

Running Apache processes critical range threshold (Ex: 1:20)

string

_AGENT_WARNING

Running Ossim-agent processes warning range threshold (Ex: 1:40)

string

_AGENT_CRITICAL

Running Ossim-agent processes critical range threshold (Ex: 1:50)

string

_PROCS_WARNING

Number of running processes warning threshold

string

_PROCS_CRITICAL

Number of running processes critical threshold

string

_MYSQL_WARNING

Number of MySQL running processes warning threshold

string

_MYSQL_CRITICAL

Number of MySQL running processes critical threshold

string

Alienvault-logger

DESCRIPTION


Specific checks for Alienvault Logger devices

../../_images/alienvault-logger.png

Checks Alienvault Logger metrics and processes. NRPE Agent must be installed in Alienvault device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Alienvault-Logger Redis Server

Checks if redis-server is running

check_av_logger_redis_server

Alienvault-Logger Mongodb

Checks if mongod is running

check_av_logger_mongodb

Alienvault-Logger Size

Checks the logger size

check_av_logger_size

Alienvault-Logger RabbitMQ Server

Checks if rabbitmq-server is running

check_av_logger_rabbitmq_server

Alienvault-Logger Mysqld

Checks if mysqld is running

check_av_logger_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-Logger Server

Checks if ossim-server is running

check_av_logger_server

Alienvault-Logger Apache

Checks if apache2 is running

check_av_logger_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

Alienvault-Logger Framework

Checks if ossim-framework is running

check_av_logger_framework

Alienvault-Logger Monit

Checks if monit process is running

check_av_logger_monit

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_APACHE_WARNING

Running Apache processes warning range threshold (Ex: 1:12)

string

_APACHE_CRITICAL

Running Apache processes critical range threshold (Ex: 1:20)

string

_MYSQL_WARNING

Number of MySQL running processes warning threshold

string

_MYSQL_CRITICAL

Number of MySQL running processes critical threshold

string

Alienvault-sensor

DESCRIPTION


Specific checks for Alienvault sensor devices

../../_images/alienvault-sensor.png

Checks Alienvault Sensor metrics and processes. NRPE Agent must be installed in Alienvault device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Alienvault-sensor Rsyslog

Checks if rsyslogd is running

check_av_sensor_rsyslog

Alienvault-sensor Agent

Checks if ossim-agent is running

check_av_sensor_agent

_HOSTAGENT_WARNING

_HOSTAGENT_CRITICAL

Alienvault-sensor Procs

Checks the number of processes

check_av_sensor_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Alienvault-sensor Monit

Checks if monit process is running

check_av_sensor_monit

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_AGENT_WARNING

Running Ossim-agent processes warning range threshold (Ex: 1:40)

string

_AGENT_CRITICAL

Running Ossim-agent processes critical range threshold (Ex: 1:50)

string

_PROCS_WARNING

Number of running processes warning threshold

string

_PROCS_CRITICAL

Number of running processes critical threshold

string

Alienvault-siem

DESCRIPTION


Specific checks for Alienvault siem devices

../../_images/alienvault-siem.png

Checks Alienvault Siem metrics and processes. NRPE Agent must be installed in Alienvault device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Alienvault-siem Monit

Checks if monit process is running

check_av_siem_monit

Alienvault-siem Redis Server

Checks if redis-server is running

check_av_siem_redis_server

Alienvault-siem Mysqld

Checks if mysqld is running

check_av_siem_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-siem Framework

Checks if ossim-framework is running

check_av_siem_framework

Alienvault-siem Sandas

Checks if sandas is running

check_av_siem_sandas

Alienvault-siem Server

Checks if ossim-server is running

check_av_siem_server

Alienvault-siem Mongodb

Checks if mongod is running

check_av_siem_mongodb

Alienvault-siem Apache

Checks if apache2 is running

check_av_siem_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

Alienvault-siem RabbitMQ Server

Checks if rabbitmq-server is running

check_av_siem_rabbitmq_server

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_APACHE_WARNING

Running Apache processes warning range threshold (Ex: 1:12)

string

_APACHE_CRITICAL

Running Apache processes critical range threshold (Ex: 1:20)

string

_MYSQL_WARNING

Number of MySQL running processes warning threshold

string

_MYSQL_CRITICAL

Number of MySQL running processes critical threshold

string

Arcsight

DESCRIPTION


Generic checks for Arcsight devices

../../_images/arcsight.png

Checks metrics and processes using SNMP and NRPE. NRPE Agent must be installed in Arcsight device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Partition $KEY$

Checks the storage usage percent

check_unix_nrpe_disk

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_PARTITIONS

interfaces_status

Checks the interfaces status

check_interfaces_status

_HOSTSNMPCOMMUNITY

procs_ssh

Checks if sshd is running

check_procs_ssh

_HOSTSSH_PROCS_WARNING

_HOSTSSH_PROCS_CRITICAL

zombie_procs

Checks the number of zombie processes

check_unix_zombie_procs

_HOSTZOMBIE_PROCS_WARNING

_HOSTZOMBIE_PROCS_CRITICAL

mem

Checks the memory usage

check_unix_nrpe_memory

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

procs

Checks the number of processes

check_unix_nrpe_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

load

Checks the system load

check_unix_nrpe_load

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

uptime_so

Checks the system uptime

check_uptime_so

_HOSTSNMPCOMMUNITY

swap

Checks the swap usage percent

check_unix_nrpe_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_PROCS_WARNING

Total processes warning threshold

integer

_PROCS_CRITICAL

Total processes critical threshold

integer

_SSH_PROCS_WARNING

SSH processes warning threshold. Example 1:20

string

_SSH_PROCS_CRITICAL

SSH processes critical threshold. Example 1:40

string

_LOAD_WARNING

CPU load warning threshold

string

_LOAD_CRITICAL

CPU load critical threshold

string

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_SWAP_WARNING

Swap usage warning threshold

percent

_SWAP_CRITICAL

Swap usage critical threshold

percent

_STORAGE_WARNING

Storage warning threshold

percent

_STORAGE_CRITICAL

Storage critical threshold

percent

_PARTITIONS

Filesystem partitions to monitor, for example /,/var

string

_ZOMBIE_PROCS_WARNING

Zombie processes warning threshold, for example 1:20

string

_ZOMBIE_PROCS_CRITICAL

Zombie processes critical threshold, for example 1:40

string

Arcsight-express

DESCRIPTION


Performance and availability checks for Arcsight devices

../../_images/arcsight-express.png

Checks metrics and processes using SNMP, NRPE and SSH. NRPE Agent must be installed in Arcsight device. SSH credentials are needed

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Procs

Checks the number of processes

check_ssh_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Java

Checks if java is running

check_nrpe_java

Uptime

Checks the system uptime

check_ssh_uptime

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Disk_usage /

Checks the storage usage

check_ssh_disk

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

Load_average

Checks the system load average

check_ssh_load

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

Oracle

Checks if Oracle listener is running

check_nrpe_esm_oracle

Web_service

Checks if Arcsight wrapper is running

check_nrpe_esm_web

web_access

Checks if port TCP/8443 is listening

check_tcp_web_access

_HOSTRESPONSE_WARNING

_HOSTRESPONSE_CRITICAL

Mem_usage

Checks memory usage

check_ssh_mem

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Swap_usage

Checks the swap usage

check_ssh_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_RESPONSE_WARNING

Response time warning threshold (in seconds)

integer

_RESPONSE_CRITICAL

Response time critical threshold (in seconds)

integer

_PROCS_WARNING

Total processes warning threshold

integer

_PROCS_CRITICAL

Total processes critical threshold

integer

_LOAD_WARNING

CPU load warning threshold

string

_LOAD_CRITICAL

CPU load critical threshold

string

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_SWAP_WARNING

Swap usage warning threshold

percent

_SWAP_CRITICAL

Swap usage critical threshold

percent

_STORAGE_WARNING

Storage warning threshold

percent

_STORAGE_CRITICAL

Storage critical threshold

percent

_UPTIME_WARNING

Uptime warning threshold (in seconds)

integer

_UPTIME_CRITICAL

Uptime critical threshold (in seconds)

integer

_PARTITIONS

Filesystem partions to monitor, for example /,/var

string

Arcsight-logger

DESCRIPTION


Performance and availability checks for Arcsight logger devices

../../_images/arcsight-logger.png

Checks metrics and processes. NRPE Agent must be installed in Arcsight device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Zombie procs

Checks the number of zombie processes

check_unix_zombie_procs

_HOSTZOMBIE_PROCS_WARNING

_HOSTZOMBIE_PROCS_CRITICAL

Partition_logger $KEY$

Checks the storage usage

check_nrpe_disk

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_PARTITIONS

Raid status

Checks the RAID status

check_nrpe_raid_status

Logger

Checks if arcsight processors is running

check_nrpe_logger

Receivers

Checks if arcsight receivers is running

check_nrpe_receivers

Server

Checks if arcsight servers process is running

check_nrpe_server

LinuxWrapper

Checks if linux wrapper process is running

check_nrpe_linuxwrapper

SSH Procs

Checks if sshd process is running

check_nrpe_ssh_procs

_HOSTSSH_PROCS_WARNING

_HOSTSSH_PROCS_CRITICAL

Swap Usage

Checks swap usage percent

check_unix_nrpe_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

Load

Checks the system load

check_unix_nrpe_load

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

Memory Usage

Checks the memory usage

check_unix_nrpe_memory

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

PostgreSQL

Checks if PostgreSql postmaster process is running

check_nrpe_postgresql

Mysql Listener

Checks if TCP/3306 port is listening

check_mysql_listener

_HOSTRESPONSE_WARNING

_HOSTRESPONSE_CRITICAL

Connectors

Checks if ArcSightSmartConnectors is running

check_nrpe_connectors

Web

Checks if arcsight web process is running

check_nrpe_web

Procs

Checks the number of processes

check_nrpe_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

ReportEngine

Checks if arcsight reportengine process is running

check_nrpe_reportengine

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_RESPONSE_WARNING

Response time warning threshold (in seconds)

integer

_RESPONSE_CRITICAL

Response time critical threshold (in seconds)

integer

_PROCS_WARNING

Total processes warning threshold

integer

_PROCS_CRITICAL

Total processes critical threshold

integer

_SSH_PROCS_WARNING

SSH processes warning threshold. Example 1:20

string

_SSH_PROCS_CRITICAL

SSH processes critical threshold. Example 1:40

string

_LOAD_WARNING

CPU load warning threshold

string

_LOAD_CRITICAL

CPU load critical threshold

string

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_UPTIME_WARNING

Uptime warning threshold

integer

_UPTIME_CRITICAL

Uptime critical threshold

integer

_SWAP_WARNING

Swap usage warning threshold

percent

_SWAP_CRITICAL

Swap usage critical threshold

percent

_STORAGE_WARNING

Storage warning threshold

percent

_STORAGE_CRITICAL

Storage critical threshold

percent

_PARTITIONS

Filesystem partitions to monitor, for example /,/var

string

_ZOMBIE_PROCS_WARNING

Zombie processes warning threshold, for example 1:20

string

_ZOMBIE_PROCS_CRITICAL

Zombie processes critical threshold, for example 1:40

string

Bluecoat

DESCRIPTION


Health and performance checks for Bluecoat proxy SG devices. Now Symantec Secure Web Gateway

../../_images/bluecoat.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

ssh

Checks if TCP/22 port is up and accepting connections

check_bluecoat_ssh

_HOSTSSH_PORT

bluecoat_median_request_time

Checks the median for all request time

check_bluecoat_median_request_time

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat_upstream_status_$KEY$

Checks BlueCoat upstream server status.

check_bluecoat_upstream_server_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_UPSTREAMSERVER_LIST

bluecoat_sensor_status

Checks the sensor status of all device units

check_bluecoat_sensor_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

client_connections

Checks the ammount of client connections

check_bluecoat_client_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_TOTAL_CONN_WARNING

_HOSTCLIENT_TOTAL_CONN_CRITICAL

_HOSTCLIENT_MINIMUM_TOTAL_CONN_CRITICAL

_HOSTCLIENT_ACTIVE_CONN_WARNING

_HOSTCLIENT_ACTIVE_CONN_CRITICAL

_HOSTCLIENT_IDLE_CONN_WARNING

_HOSTCLIENT_IDLE_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat_icap_conn_$KEY$

Checks the ammount of ICAP connections

check_bluecoat_icap_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

bluecoat_icap_traffic_$KEY$

Checks the ammount of ICAP network traffic

check_bluecoat_icap_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

bluecoat_icap_req_$KEY$

Checks the ammount of ICAP requests

check_bluecoat_icap_req

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

mem_usage

Checks the memory usage

check_bluecoat_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

gui

Checks if TCP/8082 port is up and accepting connections

check_bluecoat_gui

_HOSTGUI_PORT

bluecoat_icap_queued_req_$KEY$

Checks the ammount of ICAP queued requests

check_bluecoat_icap_queued_req

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTICAP_QUEUED_REQ_WARNING

_HOSTICAP_QUEUED_REQ_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

request_rate

Shows the average rate per second of HTTP requests.

check_bluecoat_request_rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

disk_usage

Checks the disk usage

check_bluecoat_disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

disk_status

Checks the disk status

check_bluecoat_disk_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

hit_rate

Shows the percentage HTTP hit rate (by objects)

check_bluecoat_hit_rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat_icap_deferred_req_$KEY$

Checks the ammount of ICAP deferred requests

check_bluecoat_icap_deferred_req

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTICAP_DEFERRED_REQ_WARNING

_HOSTICAP_DEFERRED_REQ_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

uptime

Checks the device uptime

check_bluecoat_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

cpu_usage

Checks the CPU usage

check_bluecoat_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat_icap_req_status_$KEY$

Checks the ammount of ICAP requests status

check_bluecoat_icap_req_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_ICAPSERVICE_LIST

server_connections

Checks the ammount of server connections

check_bluecoat_server_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSERVER_TOTAL_CONN_WARNING

_HOSTSERVER_TOTAL_CONN_CRITICAL

_HOSTSERVER_ACTIVE_CONN_WARNING

_HOSTSERVER_ACTIVE_CONN_CRITICAL

_HOSTSERVER_IDLE_CONN_WARNING

_HOSTSERVER_IDLE_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_UPSTREAMSERVER_LIST:

wocu-discover-bluecoat-upstream.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_ICAPSERVICE_LIST:

wocu-discover-bluecoat-icap-services.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_STORAGE_WARNING

Storage utilization warning threshold

percent

_STORAGE_CRITICAL

Storage utilization critical threshold

percent

_CLIENT_TOTAL_CONN_WARNING

Client total connections warning threshold

integer

_CLIENT_TOTAL_CONN_CRITICAL

Client total connections critical threshold

integer

_CLIENT_MINIMUM_TOTAL_CONN_CRITICAL

Total client minimum connections critical threshold

integer

_CLIENT_ACTIVE_CONN_WARNING

Client active connections warning threshold

integer

_CLIENT_ACTIVE_CONN_CRITICAL

Client active connections critical threshold

integer

_CLIENT_IDLE_CONN_WARNING

Client idle connections warning threshold

integer

_CLIENT_IDLE_CONN_CRITICAL

Client idle connections critical threshold

integer

_SERVER_TOTAL_CONN_WARNING

Server total connections warning threshold

integer

_SERVER_TOTAL_CONN_CRITICAL

Server total connections critical threshold

integer

_SERVER_ACTIVE_CONN_WARNING

Server active connections warning threshold

integer

_SERVER_ACTIVE_CONN_CRITICAL

Server active connections critical threshold

integer

_SERVER_IDLE_CONN_WARNING

Server idle connections warning threshold

integer

_SERVER_IDLE_CONN_CRITICAL

Server idle connections critical threshold

integer

_UPTIME_WARN

Uptime warning threshold in seconds

integer

_UPTIME_CRIT

Uptime critical threshold in seconds

integer

_ICAP_DEFERRED_REQ_WARNING

ICAP deferred request warning threshold

integer

_ICAP_DEFERRED_REQ_CRITICAL

ICAP deferred request critical threshold

integer

_ICAP_QUEUED_REQ_WARNING

ICAP queued request warning threshold

integer

_ICAP_QUEUED_REQ_CRITICAL

ICAP queued request critical threshold

integer

_ICAP_REQ_STATUS_WARNING

ICAP request status warning threshold

integer

_ICAP_REQ_STATUS_CRITICAL

ICAP request status critical threshold

integer

_GUI_PORT

GUI TCP port. Default: 8082

integer

_SSH_PORT

SSH TCP Port. Default: 22

integer

COMPLEX MACROS

  • _UPSTREAMSERVER_LIST

    • Description: List of upstream servers

    • Discover: wocu-discover-bluecoat-upstream.py


Fields

Description

Type

display_name

Upstream server name

string

oid_suffix

Upstream server suffix name

string

  • _ICAPSERVICE_LIST

    • Description: List of ICAP services

    • Discover: wocu-discover-bluecoat-icap-services.py


Fields

Description

Type

display_name

Upstream server name

string

oid_suffix

ICAP service server suffix name

string

Bluecoat-cas

DESCRIPTION


Health and performance checks for Bluecoat CAS proxy devices

../../_images/bluecoat-cas.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

bluecoat-cas-mem

Checks the memory usage information

check_bluecoat_cas_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat-cas-cpu

Checks the CPU usage information

check_bluecoat_cas_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat-cas-disk_usage

Checks the disk usage information

check_bluecoat_cas_disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

bluecoat-cas-sensor_status

Checks the sensor status of all device units

check_bluecoat_cas_sensor_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_STORAGE_WARNING

Storage utilization warning threshold

percent

_STORAGE_CRITICAL

Storage utilization critical threshold

percent

Checkpoint

DESCRIPTION


Info and connection checks for Checkpoint devices

../../_images/checkpoint.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Info

Shows status info

check_checkpoint_info

_HOSTSNMPCOMMUNITY

Connections

Checks the number of connections

check_checkpoint_connections

_HOSTSNMPCOMMUNITY

_HOSTCONN_WARNING

_HOSTCONN_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_CONN_WARNING

Total connections warning threshold

integer

_CONN_CRITICAL

Total connections critical threshold

integer

Checkpoint-gw-r7720-gaia

DESCRIPTION


Checks for Checkpoint GW R77.20 Gaia

../../_images/checkpoint-gw-r7720-gaia.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

CKP_Gaia_Swap

Checks the Swap usage

check_checkpoint_gaia_swap

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

CKP_Gaia_FW_State

Shows FW Module status

check_checkpoint_gaia_fw_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

CKP_Gaia_Partition $KEY$

Checks the Disk usage

check_checkpoint_gaia_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_PARTITIONS

CKP_Gaia_CPU_Usage

Checks the CPU usage

check_checkpoint_gaia_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU Usage critical threshold

percent

_PARTITIONS

Partition name to check usage.

string

_STORAGE_WARNING

Partition usage percent warning threshold

percent

_STORAGE_CRITICAL

Partition usage percent critical threshold

percent

_SWAP_WARNING

Swap usage percent warning threshold

percent

_SWAP_CRITICAL

Swap usage percent critical threshold

percent

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

Checkpoint-ipso

DESCRIPTION


Checks for Checkpoint IPSO Devices via snmp

../../_images/checkpoint-ipso.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

checkpoint-ipso-process_$KEY$

Checks Checkpoint IPSO processes.

check_checkpoint_ipso_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

checkpoint-ipso-users

Checks Checkpoint IPSO logged users information.

check_checkpoint_ipso_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUSERS_WARNING

_HOSTUSERS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-cpu

Checks Checkpoint IPSO CPU usage information.

check_checkpoint_ipso_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-mem

Checks Checkpoint IPSO memory usage information.

check_checkpoint_ipso_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-uptime

Checks Checkpoint IPSO uptime information.

check_checkpoint_ipso_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-partition_$KEY$

Checks Checkpoint IPSO partitions.

check_checkpoint_ipso_partition_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING_THRESHOLD

_HOSTSTORAGE_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PARTITIONS

checkpoint-ipso-conn

Checks Checkpoint current connections usage information.

check_checkpoint_ipso_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONN_WARNING

_HOSTCONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-tcp-active-sessions

Checks Checkpoint IPSO TCP total active sessions usage information.

check_checkpoint_ipso_tcp_active_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

checkpoint-ipso-tcp-established-sessions

Checks Checkpoint IPSO TCP established sessions usage information.

check_checkpoint_ipso_tcp_established_sessions

_HOSTSNMPCOMMUNITY

_HOSTCURR_ESTABLISHED_SESSION_WARNING

_HOSTCURR_ESTABLISHED_SESSION_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_PARTITIONS:

wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_PROCESSES:

wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU Usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_UPTIME_WARNING

Time warning threshold

integer

_UPTIME_CRITICAL

Time critical threshold

integer

_STORAGE_WARNING_THRESHOLD

Storage warning threshold

percent

_STORAGE_CRITICAL_THRESHOLD

Storage critical threshold

percent

_USERS_WARNING

Warning threshold for logged users

integer

_USERS_CRITICAL

Critical threshold for logged users

integer

_CONN_WARNING

Warning threshold for the amount connections

integer

_CONN_CRITICAL

Critical threshold for the amount connections

integer

_CURR_ESTABLISHED_SESSION_WARNING

Current established TCP sessions warning threshold

integer

_CURR_ESTABLISHED_SESSION_CRITICAL

Current established TCP sessions critical threshold

integer

COMPLEX MACROS

  • _PARTITIONS

    • Description: Disk partitions

    • Discover: wocu-discover-os-resources-partitions.py


Fields

Description

Type

unit

Letter unit or path

string

index

Partition index

integer

label

Partition label

string

  • _PROCESSES

    • Description: Processes

    • Discover: wocu-discover-os-resources-processes.py


Fields

Description

Type

ProcName

Process label

string

ProcIndex

Process index

integer

Checkpoint-licenses

DESCRIPTION


Checks License/Contract expiration on Checkpoint devices

../../_images/checkpoint-licenses.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Checkpoint_$KEY$

check_checkpoint_licenses_exp

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASS

_CHECKPOINT_LICENSE_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_CHECKPOINT_LICENSE_LIST:

wocu-discover-checkpoint-licenses.py -H $HOSTADDRESS$ -P $_SSH_PORT$ –ssh_user $_SSH_USER$ –ssh_pass $_SSH_PASS$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

SSH User

string

_SSH_PASS

SSH Password

string

_SSH_PORT

SSH Port. Default: 22

integer

COMPLEX MACROS

  • _CHECKPOINT_LICENSE_LIST

    • Description: List of Licenses/Contracts

    • Discover: wocu-discover-checkpoint-licenses.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

type

License or Contract

string

id

License/Contract ID

string

warning

Time period to expiration date warning threshold (in days)

string

critical

Time period to expiration date critical threshold (in days)

string

expiration

License/Contract expiration date

string

host

Host where license is applied

string

Checkpoint-mgmt-r7720-gaia

DESCRIPTION


Checks for Checkpoint Management R77.20 Gaia

../../_images/checkpoint-mgmt-r7720-gaia.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

CKP_MGMT_Gaia_Swap

Checks the Swap usage

check_checkpoint_gaia_swap

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

CKP_MGMT_Gaia_Partition $KEY$

Checks the Disk usage

check_checkpoint_gaia_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_PARTITIONS

CKP_MGMT_Gaia_CPU_Usage

Checks the CPU usage

check_checkpoint_gaia_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU Usage critical threshold

percent

_PARTITIONS

Partition name to check usage.

string

_STORAGE_WARNING

Partition usage percent warning threshold

percent

_STORAGE_CRITICAL

Partition usage percent critical threshold

percent

_SWAP_WARNING

Swap usage percent warning threshold

percent

_SWAP_CRITICAL

Swap usage percent critical threshold

percent

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

Checkpoint-r8010-gaia

DESCRIPTION


Checks for Checkpoint Management R80.10 Gaia

../../_images/checkpoint-r8010-gaia.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

checkpoint_r8010_gaia_traffic

Checks Checkpoint r8010 gaia devices traffic information.

checkpoint_r8010_gaia_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_cluster_iface_info

Checks Checkpoint r8010 gaia devices cluster interface information.

checkpoint_r8010_gaia_cluster_iface_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_conn

Checks Checkpoint r8010 gaia devices connection usage.

checkpoint_r8010_gaia_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONN_WARNING

_HOSTCONN_CRITICAL

checkpoint_r8010_gaia_disk_usage

Checks Checkpoint r8010 gaia devices disk usage.

checkpoint_r8010_gaia_disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

checkpoint_r8010_kmem_failed_alloc

Checks System Kernel memory (SMEM) allocation failures.

checkpoint_r8010_gaia_kmem_failed_alloc

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_cpu

Checks Checkpoint r8010 gaia devices CPU usage.

checkpoint_r8010_gaia_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

checkpoint_r8010_gaia_mem

Checks Checkpoint r8010 gaia devices memory usage.

checkpoint_r8010_gaia_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

checkpoint_r8010_log_status_info

Checks Checkpoint r8010 gaia devices log status information.

checkpoint_r8010_gaia_log_status_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_pnotes_status

Checks Checkpoint r8010 gaia devices Pnotes status information.

checkpoint_r8010_gaia_pnotes_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_hmem_failed_alloc

Checks Hash memory allocation failures.

checkpoint_r8010_gaia_hmem_failed_alloc

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHMEM_WARNING

_HOSTHMEM_CRITICAL

checkpoint_r8010_gaia_cluster_status

Checks Checkpoint r8010 gaia devices cluster status information.

checkpoint_r8010_gaia_cluster_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_TRAFFIC_ALL_IFACES:

wocu-discover-checkpoint-gaia-ifaces.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU Usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_CONN_WARNING

Current connection usage warning threshold

integer

_CONN_CRITICAL

Current connection usage critical threshold

integer

_STORAGE_WARNING

Partition usage percent warning threshold

percent

_STORAGE_CRITICAL

Partition usage percent critical threshold

percent

_HMEM_WARNING

Number of memory allocation failures warning threshold

integer

_HMEM_CRITICAL

Number of memory allocation failures critical threshold

integer

COMPLEX MACROS

  • _TRAFFIC_ALL_IFACES

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-checkpoint-gaia-ifaces.py


Fields

Description

Type

display_name

Interface name to be shown as part of the service description

string

index

Interface index (unique)

integer

Checkpoint-vpn

DESCRIPTION


Checks the Checkpoint VPN Tunnels state.

../../_images/checkpoint-vpn.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Checkpoint_VPN_Tunnel_State_$KEY$

Checks VPN Tunnel state.

check_checkpoint-vpn_tunnel_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHECKPOINT_VPN_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_CHECKPOINT_VPN_LIST:

wocu-discover-checkpoint-vpn.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _CHECKPOINT_VPN_LIST

    • Description: List of VPN Tunnels

    • Discover: wocu-discover-checkpoint-vpn.py


Fields

Description

Type

display_name

Tunnel name

string

peer_ip

Tunnel peer IP address

string

Citrix-netscaler

DESCRIPTION


Specific checks for Citrix Netscaler via snmp

../../_images/citrix-netscaler.jpg

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Citrix Netscaler - CPU Usage

Checks device CPU usage

check_citrix_netscaler_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Citrix Netscaler - HTTP Stats

Shows HTTP statistics

check_citrix_netscaler_http_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - DNS Queries

Checks DNS queries rate

check_citrix_netscaler_dns

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - Service State - $KEY$

Shows service state

check_citrix_netscaler_service_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVICE_LIST

Citrix Netscaler - Disk Usage

Checks device Disk usage

check_citrix_netscaler_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

Citrix Netscaler - Memory Usage

Checks device Memory usage

check_citrix_netscaler_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Citrix Netscaler - Service Info - $KEY$

Shows service information

check_citrix_netscaler_service_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVICE_LIST

Citrix Netscaler - Info

Shows device info

check_citrix_netscaler_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - VServer State - $KEY$

Shows virtual server state

check_citrix_netscaler_server_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVER_LIST

Citrix Netscaler - HTTP traffic

Checks HTTP traffic

check_citrix_netscaler_http_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTHTTP_TRAFFIC_WARNING

_HOSTHTTP_TRAFFIC_WARNING

Citrix Netscaler - SSL Stats

Shows SSL statistics

check_citrix_netscaler_ssl_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - HA Info

Shows device High Availability info

check_citrix_netscaler_ha_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - RNAT Stats

Shows RNAT statistics

check_citrix_netscaler_rnat_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - VServer Stats - $KEY$

Shows virtual server statistics

check_citrix_netscaler_server_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVER_LIST

Citrix Netscaler - Global Connections

Shows device global connections rate

check_citrix_netscaler_global_conns

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCLIENT_CONNS_WARNING

_HOSTCLIENT_CONNS_CRITICAL

_HOSTSERVER_CONNS_WARNING

_HOSTSERVER_CONNS_CRITICAL

Citrix Netscaler - VServer Info - $KEY$

Shows virtual server information

check_citrix_netscaler_server_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVER_LIST

Citrix Netscaler - Service Stats - $KEY$

Shows service statistics

check_citrix_netscaler_service_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_NETSCALER_SERVICE_LIST

Citrix Netscaler - Compression Stats

Shows compression statistics

check_citrix_netscaler_compression_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - Cache Stats

Shows Cache statistics

check_citrix_netscaler_cache_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_NETSCALER_SERVICE_LIST:

wocu-discover-citrix-netscaler-services.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_NETSCALER_SERVER_LIST:

wocu-discover-citrix-netscaler-servers.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_DISK_WARNING

Disk usage warning threshold (percent)

percent

_DISK_CRITICAL

Disk usage critical threshold (percent)

percent

_CLIENT_CONNS_WARNING

Client connections warning threshold

integer

_CLIENT_CONNS_CRITICAL

Client connections critical threshold

integer

_SERVER_CONNS_WARNING

Server connections warning threshold

integer

_SERVER_CONNS_CRITICAL

Server connections critical threshold

integer

_HTTP_TRAFFIC_WARNING

HTTP traffic warning threshold (in Bytes)

integer

_HTTP_TRAFFIC_CRITICAL

HTTP traffic critical threshold (in Bytes)

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

COMPLEX MACROS

  • _NETSCALER_SERVICE_LIST

    • Description: List of services

    • Discover: wocu-discover-citrix-netscaler-services.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

OID suffix used in snmp queries

string

  • _NETSCALER_SERVER_LIST

    • Description: List of virtual servers

    • Discover: wocu-discover-citrix-netscaler-servers.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

OID suffix used in snmp queries

string

Fortianalyzer

DESCRIPTION


Checks for Fortianalyzer-Fortimanager devices

../../_images/fortianalyzer.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortianalyzer CPU Usage

Checks CPU usage

check_fortianalyzer_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortianalyzer Disk

Checks disk usage

check_fortianalyzer_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

Fortianalyzer SSH

Checks SSH availability

check_fortianalyzer_ssh

Fortianalyzer Uptime

Checks uptime

check_fortianalyzer_uptime

_HOSTSNMPCOMMUNITY

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Fortianalyzer HTTPS

Checks GUI availability

check_fortianalyzer_https

Fortianalyzer Memory Usage

check_fortianalyzer_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_DISK_WARNING

Disk usage warning threshold (percent)

percent

_DISK_CRITICAL

Disk usage critical threshold (percent)

percent

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_UPTIME_WARNING

CPU usage warning threshold (percent)

integer

_UPTIME_CRITICAL

CPU usage critical threshold (percent)

integer

Fortigate

DESCRIPTION


Checks for Fortigate devices

../../_images/fortigate.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortigate_cpu_node2

Checks Node2 CPU usage

check_fortigate_cpu_node2

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_GUI

Checks GUI availability

check_fortigate_gui

_HOSTGUI_PORT

Fortigate_sessions_node2

Checks the number of sessions in Node2

check_fortigate_sessions_node2

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSESSION_WARNING

_HOSTSESSION_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_cpu_node1

Checks Node1 CPU usage

check_fortigate_cpu_node1

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_sessions_node1

Checks the number of sessions in Node1

check_fortigate_sessions_node1

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSESSION_WARNING

_HOSTSESSION_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_SSH

Checks SSH availability

check_fortigate_ssh

_HOSTSSH_PORT

Fortigate_mem_usage_node2

Checks Node2 memory usage

check_fortigate_mem_usage_node2

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_Uptime

Checks uptime

check_fortigate_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_HA

Detects High Availability changes

check_fortigate_ha_load_balancing

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_mem_usage_node1

Checks Node1 memory usage

check_fortigate_mem_usage_node1

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_SESSION_WARNING

Session number warning threshold

integer

_SESSION_CRITICAL

Session number critical threshold

integer

_UPTIME_CRITICAL

Minimum uptime critical threshold (in seconds)

integer

_GUI_PORT

TCP Port number for GUI access (default 443)

integer

_SSH_PORT

TCP Port number for SSH access (default 22)

integer

_HA_ALARM_PERSISTANCE

High Availability changes alarm persistance time in seconds (default 1 hour)

integer

Fortigate-sdwan-health

DESCRIPTION


Checks for Fortigate SD-WAN health link statistics.

../../_images/fortigate-sdwan-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortigate_sdwan_health_link_$KEY$

SD-WAN Links health check statistics

check_fortigate-sdwan-health_link

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FORTIGATE_SDWAN_LINKS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_FORTIGATE_SDWAN_LINKS:

wocu-discover-fortigate-sdwan-health.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _FORTIGATE_SDWAN_LINKS

    • Description: List of SDWAN health check links

    • Discover: wocu-discover-fortigate-sdwan-health.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

index

SDWAN health check link index (ID)

integer

jitter_warning

Jitter warning threshold in ms

integer

jitter_critical

Jitter critical threshold in ms

integer

packet_lost_warning

Packet lost percent warning threshold

percent

packet_lost_critical

Packet lost percent critical threshold

percent

latency_warning

Latency warning threshold in ms

integer

latency_critical

Latency critical threshold in ms

integer

Fortigate-standalone

DESCRIPTION


Checks for Fortigate devices working in standalone mode

../../_images/fortigate-standalone.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortigate_cpu

Checks CPU usage

check_fortigate_standalone_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_sessions

Checks the number of sessions

check_fortigate_standalone_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSESSION_WARNING

_HOSTSESSION_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate Uptime

Checks the uptime

check_fortigate_standalone_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_mem_usage

Checks Memory usage

check_fortigate_standalone_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Fortigate_serial

Shows the serial number

check_fortigate_standalone_serial

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_SESSION_WARNING

Session number warning threshold

integer

_SESSION_CRITICAL

Session number critical threshold

integer

_UPTIME_CRITICAL

Minimum uptime critical threshold (in seconds)

integer

_GUI_PORT

TCP Port number for HTTPS access (default 443)

integer

_SSH_PORT

TCP Port number for SSH access (default 22)

integer

Fortimail

DESCRIPTION


Checks for Fortimail devices. For non-clustered installations, use fortimail-standalone pack

../../_images/fortimail.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortimail HA

Detects High Availability changes

fortimail_ha

_HOSTSNMPCOMMUNITY

_HOSTHA_ALARM_PERSISTANCE

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_FORTIMAIL_QUEUE_LIST:

wocu-discover-fortimail-queues.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_DEFERRED_WARNING

Deferred mails number warning threshold

integer

_DEFERRED_CRITICAL

Deferred mails number critical threshold

integer

_UPTIME_WARNING

Uptime warning threshold (seconds)

integer

_UPTIME_CRITICAL

Uptime critical threshold (seconds)

integer

_MAIL_DISK_WARNING

Mail disk usage warning threshold (percent)

percent

_MAIL_DISK_CRITICAL

Mail disk usage critical threshold (percent)

percent

_LOG_DISK_WARNING

Log disk usage warning threshold (percent)

percent

_LOG_DISK_CRITICAL

Log disk usage critical threshold (percent)

percent

_GUI_PORT

TCP Port number for GUI access (default 443)

integer

_SSH_PORT

TCP Port number for SSH access (default 22)

integer

_HA_ALARM_PERSISTANCE

High Availability changes alarm persistance time in seconds (default 1 hour)

integer

COMPLEX MACROS

  • _FORTIMAIL_QUEUE_LIST

    • Description: List of mail queues to check

    • Discover: wocu-discover-fortimail-queues.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

index

Queue index

integer

warning_threshold

Mail number warning threshold

integer

critical_threshold

Mail number critical threshold

integer

Fortimail-standalone

DESCRIPTION


Checks for Fortimail devices. For non-clustered installations, use fortimail-standalone pack

../../_images/fortimail-standalone.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortimail Log Disk

Checks log disk usage

fortimail_log_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLOG_DISK_WARNING

_HOSTLOG_DISK_CRITICAL

Fortimail CPU

Checks Fortimail CPU usage

fortimail_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortimail GUI

Checks GUI availability

fortimail_gui

_HOSTGUI_PORT

Fortimail Mem

Checks memory usage

fortimail_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Fortimail Queue - $KEY$

Checks the mail queues

fortimail_queue

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_FORTIMAIL_QUEUE_LIST

Fortimail Deferred

Checks deferred queue

fortimail_deferred

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEFERRED_WARNING

_HOSTDEFERRED_CRITICAL

Fortimail Mail Disk

Checks mail disk usage

fortimail_mail_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMAIL_DISK_WARNING

_HOSTMAIL_DISK_CRITICAL

Fortimail Uptime

Checks uptime

fortimail_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Fortimail SSH

Checks SSH availability

fortimail_ssh

_HOSTSSH_PORT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_FORTIMAIL_QUEUE_LIST:

wocu-discover-fortimail-queues.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_DEFERRED_WARNING

Deferred mails number warning threshold

integer

_DEFERRED_CRITICAL

Deferred mails number critical threshold

integer

_UPTIME_WARNING

Uptime warning threshold (seconds)

integer

_UPTIME_CRITICAL

Uptime critical threshold (seconds)

integer

_MAIL_DISK_WARNING

Mail disk usage warning threshold (percent)

percent

_MAIL_DISK_CRITICAL

Mail disk usage critical threshold (percent)

percent

_LOG_DISK_WARNING

Log disk usage warning threshold (percent)

percent

_LOG_DISK_CRITICAL

Log disk usage critical threshold (percent)

percent

_GUI_PORT

TCP Port number for GUI access (default 443)

integer

_SSH_PORT

TCP Port number for SSH access (default 22)

integer

COMPLEX MACROS

  • _FORTIMAIL_QUEUE_LIST

    • Description: List of mail queues to check

    • Discover: wocu-discover-fortimail-queues.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

index

Queue index

integer

warning_threshold

Mail number warning threshold

integer

critical_threshold

Mail number critical threshold

integer

Fortinet-licenses

DESCRIPTION


Checks License expiration on Fortinet devices

../../_images/fortinet-licenses.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortinet_license_$KEY$

check_fortinet_licenses_exp

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASS

_FORTINET_LICENSE_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_FORTINET_LICENSE_LIST:

wocu-discover-fortinet-licenses.py -H $HOSTADDRESS$ -P $_SSH_PORT$ –ssh_user $_SSH_USER$ –ssh_pass $_SSH_PASS$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

SSH User

string

_SSH_PASS

SSH Password

string

_SSH_PORT

SSH Port. Default: 22

integer

COMPLEX MACROS

  • _FORTINET_LICENSE_LIST

    • Description: List of Licenses

    • Discover: wocu-discover-fortinet-licenses.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

name

License

string

warning

Time period to expiration date warning threshold (in days)

string

critical

Time period to expiration date critical threshold (in days)

string

Fortiswitch

DESCRIPTION


Checks for Fortiswitch devices.

../../_images/fortiswitch.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortiswitch cpu ussage

Checks Fortiswitch CPU usage usage.

check_fortiswitch_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortiswitch memory ussage

Checks Fortiswitch physical memory space usage.

check_fortiswitch_memory

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Fortiswitch ssh tcp connection

Checks SSH availability

check_fortiswitch_ssh

_HOSTSSH_PORT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_SSH_PORT

TCP port for SSH service

integer

Fortiweb

DESCRIPTION


Checks for Fortiweb devices

../../_images/fortiweb.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortiweb CPU Usage

Checks the CPU usage

check_fortiweb_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortiweb SSH

Checks SSH availability

check_fortiweb_ssh

Fortiweb Uptime

Checks the uptime

check_fortiweb_uptime

_HOSTSNMPCOMMUNITY

Fortiweb HTTPS

Checks the GUI availability

check_fortiweb_https

Fortiweb Mem

Checks Memory usage

check_fortiweb_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_MEM_WARNING

Mem usage warning threshold (percent)

percent

_MEM_CRITICAL

Mem usage critical threshold (percent)

percent

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

Ironport-cisco

DESCRIPTION


Specific checks for Cisco Ironport devices

../../_images/ironport-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Ironport Files/Sockets

Checks Ironport open Files/Sockets

check_ironport_cisco_sockets

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSOCKETS_WARNING

_HOSTSOCKETS_CRITICAL

Ironport Queue count

Checks Ironport mail Queue message count

check_ironport_cisco_queue_count

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTQUEUE_COUNT_WARNING

_HOSTQUEUE_COUNT_CRITICAL

Ironport Oldest message

Checks Ironport oldest queued message

check_ironport_cisco_oldest_message

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTOLDEST_WARNING

_HOSTOLDEST_CRITICAL

Ironport Licenses

Checks Ironport installed Licenses

check_ironport_cisco_license

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTLICENSE_WARNING

_HOSTLICENSE_CRITICAL

Ironport Queue status

Checks Ironport mail Queue status

check_ironport_cisco_queue_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Queue usage percent

Checks Ironport mail Queue usage percent

check_ironport_cisco_queue_percent

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTQUEUE_PERCENT_WARNING

_HOSTQUEUE_PERCENT_CRITICAL

Ironport CPU

Checks Ironport CPU usage

check_ironport_cisco_cpu

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Ironport Power Supply

Checks Ironport Power supply status and redundancy

check_ironport_cisco_powersupply

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Memory

Checks Ironport Memory usage

check_ironport_cisco_mem

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Ironport mail related Threads

Checks Ironport mail related threads

check_ironport_cisco_mail_threads

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTTHREADS_WARNING

_HOSTTHREADS_CRITICAL

Ironport Conservation reason

Checks Ironport Conservation mode reason

check_ironport_cisco_conservation_reason

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Memory Status

Checks Ironport Memory status

check_ironport_cisco_mem_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Temperature

Checks Ironport temperature sensors

check_ironport_cisco_temp

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Ironport Raid Status

Checks Ironport Raid Drives status and errors

check_ironport_cisco_raid_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CPU_WARNING

CPU usage percent warning threshold

percent

_CPU_CRITICAL

CPU usage percent critical threshold

percent

_MEM_WARNING

Memory usage percent warning threshold

percent

_MEM_CRITICAL

Memory usage percent critical threshold

percent

_SOCKETS_WARNING

Open Files/Sockets warning threshold

integer

_SOCKETS_CRITICAL

Open Files/Sockets critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in celsius)

integer

_LICENSE_WARNING

License expiration warning threshold (in days)

integer

_LICENSE_CRITICAL

License expiration critical threshold (in days)

integer

_QUEUE_COUNT_WARNING

Message number in work queue warning threshold

integer

_QUEUE_COUNT_CRITICAL

Message number in work queue critical threshold

integer

_QUEUE_PERCENT_WARNING

Mail queue usage percent warning threshold

percent

_QUEUE_PERCENT_CRITICAL

Mail queue usage percent critical threshold

percent

_OLDEST_WARNING

Oldest message queued time warning threshold (in seconds)

integer

_OLDEST_CRITICAL

Oldest message queued time critical threshold (in seconds)

integer

_THREADS_WARNING

Mail related threads number warning threshold

integer

_THREADS_CRITICAL

Mail related threads number critical threshold

integer

Maltiverse

DESCRIPTION


Maltiverse Open IOC Search Engine

../../_images/maltiverse.png

Maltiverse is an open and collaborative platform for indexing and searching Indicators of Compromise (IoCs) and is easily integrated by other applications like Splunk.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Maltiverse_url_$KEY$

Checks url compromise via Maltiverse Open IOC Search Engine

check_maltiverse_url

_HOSTMALTIVERSE_AUTH_TOKEN

_MALTIVERSE_URLS

Maltiverse_host

Checks host or address compromise via Maltiverse Open IOC Search Engine

check_maltiverse_host

_HOSTMALTIVERSE_AUTH_TOKEN

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_MALTIVERSE_AUTH_TOKEN

Autentication token for the Maltiverse API REST

string

COMPLEX MACROS

  • _MALTIVERSE_URLS

    • Description: List of URLs to monitor


Fields

Description

Type

name

URL name

string

url

URL to monitor

string

Mcafee-atd

DESCRIPTION


Checks for Mcafee ATD via snmp

../../_images/mcafee-atd.jpg

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

McAfee-ATD - Traffic $KEY$

Checks TX and RX traffic

check_mcafee_atd_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTTX_WARNING

_HOSTTX_CRITICAL

_HOSTRX_WARNING

_HOSTRX_CRITICAL

_IFACES_LIST

McAfee-ATD - System Disk Usage

Checks System Disk Usage

check_mcafee_atd_system_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSYSTEM_DISK_WARNING

_HOSTSYSTEM_DISK_CRITICAL

McAfee-ATD - License Status

Checks License Status (Valid, Invalid, Expired)

check_mcafee_atd_license

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

McAfee-ATD - CPU Usage

Checks CPU Usage

check_mcafee_atd_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

McAfee-ATD - Memory Usage

Checks Memory Usage

check_mcafee_atd_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

McAfee-ATD - Data Disk Usage

Checks Data Disk Usage

check_mcafee_atd_data_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTDATA_DISK_WARNING

_HOSTDATA_DISK_CRITICAL

McAfee-ATD - System Health

Checks System Health (Good, Bad)

check_mcafee_atd_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

McAfee-ATD - Temperature

Checks Temperature

check_mcafee_atd_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_IFACES_LIST:

wocu-discover-mcafee-atd-ifaces.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ -v $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_MEM_WARNING

Memory usage warning threshold (percent)

percent

_MEM_CRITICAL

Memory usage critical threshold (percent)

percent

_TEMP_WARNING

Temperature warning threshold (Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (Celsius)

integer

_SYSTEM_DISK_WARNING

System Disk usage warning threshold (percent)

percent

_SYSTEM_DISK_CRITICAL

System Disk usage critical threshold (percent)

percent

_DATA_DISK_WARNING

Data Disk usage warning threshold (percent)

percent

_DATA_DISK_CRITICAL

Data Disk usage critical threshold (percent)

percent

_TX_WARNING

TX traffic warning threshold (pkt/s)

integer

_TX_CRITICAL

TX traffic critical threshold (pkt/s)

integer

_RX_WARNING

RX traffic warning threshold (pkt/s)

integer

_RX_CRITICAL

RX traffic critical threshold (pkt/s)

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

COMPLEX MACROS

  • _IFACES_LIST

    • Description: List of interfaces

    • Discover: wocu-discover-mcafee-atd-ifaces.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

index

Interface index

integer

Mcafee-nsp

DESCRIPTION


Checks for a McAfee NSP device. Checks are done by SSH.

../../_images/mcafee-nsp.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Mcafee MEM Usage

Checks Memory usage

check_ssh_mem_usage

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Mcafee CPU Usage

Checks CPU usage

check_ssh_cpu_usage

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Mcafee Failover Status

Checks High Availability status

check_ssh_failover_status

_HOSTSSH_USER

_HOSTSSH_KEY

Mcafee Interface Status $KEY$

Checks Interfaces status

check_ssh_interface_status

_HOSTSSH_USER

_HOSTSSH_KEY

_INTERFACES

Mcafee Sensor Uptime

Obtain the system uptime

check_ssh_sensor_uptime

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTUPTIME_CRITICAL

_HOSTUPTIME_WARNING

Mcafee Traffic IN interface $KEY$

Obtain the interface input traffic

check_ssh_interface_traffic_in

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTTRAFFIC_IN_WARNING

_HOSTTRAFFIC_IN_CRITICAL

_INTERFACES

Mcafee Traffic OUT interface $KEY$

Obtain the interface output traffic

check_ssh_interface_traffic_out

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTTRAFFIC_OUT_WARNING

_HOSTTRAFFIC_OUT_CRITICAL

_INTERFACES

Mcafee Power Supply Status

Checks Power Supply status

check_ssh_powersupply_status

_HOSTSSH_USER

_HOSTSSH_KEY

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

Remote user for the SSH service (key interchange with Shinken user must be done )

string

_SSH_KEY

SSH key (Shinken user)

string

_CPU_WARNING

CPU usage warning threshold (percentage)

percent

_CPU_CRITICAL

CPU usage critical threshold (percentage)

percent

_MEM_WARNING

Physical memory warning threshold (percentage)

percent

_MEM_CRITICAL

Physical memory critical threshold (percentage)

percent

_UPTIME_WARNING

Uptime warning threshold

integer

_UPTIME_CRITICAL

Uptime critical threshold

integer

_TRAFFIC_IN_WARNING

Input traffic packets warning threshold

integer

_TRAFFIC_IN_CRITICAL

Input traffic packets critical threshold

integer

_TRAFFIC_OUT_WARNING

Output traffic packets warning threshold

integer

_TRAFFIC_OUT_CRITICAL

Output traffic packets critical threshold

integer

_INTERFACES

List of interfaces to check. Values separated by comma

comma-separated string

Palo-alto

DESCRIPTION


Checks for Palo Alto Devices (Uptime, NTP, Sessions, Info) via snmp

../../_images/palo-alto.png

Checks for Palo Alto Devices (Uptime, NTP, HA, Sessions, Info) via snmp. Tested on PA-3020/PA-500

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Palo Alto - HA State

Checks the HA state

check_paloalto_ha

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSESSIONS_WARN

_HOSTSESSIONS_CRIT

_HOSTHA_LOCAL_STATE

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Palo Alto - Sessions Info

Checks the number of active sessions (TCP, UDP and ICMP)

check_paloalto_sessions_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSESSIONS_WARN

_HOSTSESSIONS_CRIT

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Palo Alto - Info

Shows system information

check_paloalto_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Palo Alto - Uptime

Checks the system uptime

check_paloalto_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

Palo Alto - VPN Active Tunnels

Checks the number of active VPN tunnels

check_paloalto_active_tunnels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTACTIVE_TUNNELS_WARNING_MIN

_HOSTACTIVE_TUNNELS_WARNING

_HOSTACTIVE_TUNNELS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_HA_LOCAL_STATE:

wocu-discover-ha-paloalto.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SESSIONS_WARN

Current Sessions warning threshold

integer

_SESSIONS_CRIT

Current Sessions critical threshold

integer

_HA_LOCAL_STATE

Current device status HA State

string

_NTP_WARN

NTP timings warning level (in seconds)

integer

_NTP_CRIT

NTP timings critical level (in seconds)

integer

_ACTIVE_TUNNELS_WARNING_MIN

Minimum number of VPN Active Tunnels warning threshold

integer

_ACTIVE_TUNNELS_WARNING

Maximum number of VPN Active Tunnels warning threshold

integer

_ACTIVE_TUNNELS_CRITICAL

Maximum number of VPN Active Tunnels critical threshold

integer

_UPTIME_WARN

Uptime warning threshold (in seconds)

integer

_UPTIME_CRIT

Uptime critical threshold (in seconds)

integer

Palo-alto-7000-health

DESCRIPTION


Hardware checks for Palo Alto 7000 series Devices (Fans, Temperature and Power supply) via snmp

../../_images/palo-alto-7000-health.png

Hardware checks for Palo Alto 7000 series Devices (Fan, temperature and Power Supply) via snmp. This pack inherites fan and temp services from pack palo-alto-health

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Paloalto 7000 Power Supply

Checks the power supply status

check_paloalto_7000_health_powersupply

_HOSTSNMPCOMMUNITY

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

Palo-alto-health

DESCRIPTION


Hardware checks for Palo Alto Devices (Fans, Temperature) via snmp

../../_images/palo-alto-health.png

Hardware checks for Palo Alto Devices (Fan and temperature sensors) via snmp

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Paloalto temp sensor

Checks the temperature

check_paloalto_health_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Paloalto fan sensor

Checks the fan velocity

check_paloalto_health_fan

_HOSTSNMPCOMMUNITY

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

Palo-alto-licenses

DESCRIPTION


Palo Alto licenses expiration checks

../../_images/palo-alto-licenses.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

PaloAlto_license_$KEY$

check_paloalto_licenses_exp

_HOSTAPI_KEY

_PALOALTO_LICENSE_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_PALOALTO_LICENSE_LIST:

wocu-discover-paloalto-licenses.py -H $HOSTADDRESS$ –api_key $_API_KEY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_API_KEY

Customer API key

string

COMPLEX MACROS

  • _PALOALTO_LICENSE_LIST

    • Description: List of Licenses

    • Discover: wocu-discover-paloalto-licenses.py


Fields

Description

Type

name

Name to be shown in the web interface

string

description

License description

string

warning

Time period to expiration date warning threshold (in days)

string

critical

Time period to expiration date critical threshold (in days)

string

Pulse-secure

DESCRIPTION


Specific checks for Pulse Secure devices via snmp

../../_images/pulse-secure.jpg

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Pulse Secure - Disk Usage

It shows the Disk usage

check_pulse_secure_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - Node Concurrent Users

It shows the concurrent users in this node

check_pulse_secure_node_users

_HOSTSNMPCOMMUNITY

_HOSTNODE_USERS_WARNING

_HOSTNODE_USERS_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - CPU Usage

It shows the CPU usage

check_pulse_secure_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - Concurrent Users

It shows the total number of concurrent user licenses used for the Cluster

check_pulse_secure_concurrent_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCONCURRENT_USERS_WARNING

_HOSTCONCURRENT_USERS_CRITICAL

Pulse Secure - SWAP Usage

It shows the SWAP usage

check_pulse_secure_swap

_HOSTSNMPCOMMUNITY

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - Web Users

It shows the concurrent web users

check_pulse_secure_web_users

_HOSTSNMPCOMMUNITY

_HOSTWEB_USERS_WARNING

_HOSTWEB_USERS_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - Memory Usage

It shows the Memory usage

check_pulse_secure_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Pulse Secure - Concurrent Users License

It shows the total licensed concurrent users capacity

check_pulse_secure_concurrent_users_license

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCONCURRENT_USERS_LICENSE_WARNING

_HOSTCONCURRENT_USERS_LICENSE_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CONCURRENT_USERS_WARNING

Concurrent users warning threshold

integer

_CONCURRENT_USERS_CRITICAL

Concurrent users critical threshold

integer

_CONCURRENT_USERS_LICENSE_WARNING

Concurrent users license capacity warning threshold

integer

_CONCURRENT_USERS_LICENSE_CRITICAL

Concurrent users license capacity critical threshold

integer

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_DISK_WARNING

Disk usage warning threshold (percent)

percent

_DISK_CRITICAL

Disk usage critical threshold (percent)

percent

_MEM_WARNING

Mem usage warning threshold (percent)

percent

_MEM_CRITICAL

Mem usage critical threshold (percent)

percent

_SWAP_WARNING

Swap usage warning threshold (percent)

percent

_SWAP_CRITICAL

Swap usage critical threshold (percent)

percent

_NODE_USERS_WARNING

Node users warning threshold

integer

_NODE_USERS_CRITICAL

Node users critical threshold

integer

_WEB_USERS_WARNING

Web users warning threshold

integer

_WEB_USERS_CRITICAL

Web users critical threshold

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

Qradar

DESCRIPTION


Generic checks for QRadar devices

../../_images/qradar.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Partition $KEY$

Checks the partitions storage usage

check_qradar_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

_PARTITIONS

CPU Usage

Checks the CPU usage

check_qradar_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Hostname

Shows system hostname

check_qradar_hostname

_HOSTSNMPCOMMUNITY

Swap

Checks the swap memory usage

check_qradar_swap

_HOSTSNMPCOMMUNITY

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

SNMP version (allowed 1 and 2c)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_DISK_WARNING

Disk usage warning threshold (percent)

percent

_DISK_CRITICAL

Disk usage critical threshold (percent)

percent

_SWAP_WARNING

Swap usage warning threshold (percent)

percent

_SWAP_CRITICAL

Swap usage critical threshold (percent)

percent

_PARTITIONS

Filesystem partitions to monitor, for example /,/var

string

Sourcefire

DESCRIPTION


Checks for Sourcefire devices

../../_images/sourcefire.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Sourcefire SSH

Checks the SSH port availability

check_sourcefire_ssh

Sourcefire NTP sync

Checks the time difference between monitored server and local server

check_sourcefire_ntp_sync

_HOSTSNMPCOMMUNITY

_HOSTOFFSET_WARNING

_HOSTOFFSET_CRITICAL

Sourcefire Load

Checks the system load

check_sourcefire_load

_HOSTSNMPCOMMUNITY

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

Sourcefire Storage

Checks the storage usage

check_sourcefire_storage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

Sourcefire Established TCP sessions

Checks the TCP established connections number

check_sourcefire_tcp_sessions

_HOSTSNMPCOMMUNITY

_HOSTSESSION_WARNING

_HOSTSESSION_CRITICAL

Sourcefire HTTPS

Checks the HTTPS port availability

check_sourcefire_https

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_OFFSET_WARNING

Date offset warning threshold (seconds)

integer

_OFFSET_CRITICAL

Date offset critical threshold (seconds)

integer

_SESSION_WARNING

Session number warning threshold

integer

_SESSION_CRITICAL

Session number critical threshold

integer

_STORAGE_WARN

Disk usage warning threshold (percent)

percent

_STORAGE_CRIT

Disk usage critical threshold (percent)

percent

_LOAD_WARNING

Load warning threshold:. Ex: 10,10,10

string

_LOAD_CRITICAL

Load critical threshold. Ex: 7,7,7

string

Stonegate

DESCRIPTION


Generic checks for Stonegate devices

../../_images/stonegate.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Uptime

Shows the system uptime

check_stonegate_uptime

_HOSTSNMPCOMMUNITY

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

CPU_usage

Checks the CPU usage

check_stonegate_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Stonegate - Interface_status $KEY$

Checks the interface status

check_stonegate_interface_status

_HOSTSNMPCOMMUNITY

_INTERFACES

Stonegate - Software version

Shows the software version

check_stonegate_sw_version

_HOSTSNMPCOMMUNITY

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_UPTIME_WARNING

Uptime warning threshold

integer

_UPTIME_CRITICAL

Uptime critical threshold

integer

_INTERFACES

List of interfaces

string

Stonegate-fw

DESCRIPTION


Generic checks for Stonegate firewall devices

../../_images/stonegate-fw.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Stonegate-fw Connections

Shows the actual connections number

check_stonegate_fw_conn

_HOSTSNMPCOMMUNITY

_HOSTCONN_WARNING

_HOSTCONN_CRITICAL

Stonegate-fw Uptime

Shows the system uptime

check_stonegate_fw_uptime

_HOSTSNMPCOMMUNITY

Stonegate-fw Rejected Packets

Checks the rejected packets number

check_stonegate_rejected_packets

_HOSTSNMPCOMMUNITY

_HOSTREJECTED_WARNING

_HOSTREJECTED_CRITICAL

Stonegate-fw CPU_usage

Shows the CPU usage

check_stonegate_fw_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Stonegate-fw Dropped Packets

Checks the dropped packets number

check_stonegate_fw_dropped_packets

_HOSTSNMPCOMMUNITY

_HOSTDROPPED_WARNING

_HOSTDROPPED_CRITICAL

Stonegate-fw Node state

Checks the node operative (Clustering) state

check_stonegate_fw_node_state

_HOSTSNMPCOMMUNITY

_HOSTNODE_STATE

_HOSTALARM_PERSISTENCE

Stonegate-fw Accepted Packets

Shows the accepted packets metrics

check_stonegate_fw_accepted_packets

_HOSTSNMPCOMMUNITY

_HOSTACCEPTED_WARNING

_HOSTACCEPTED_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

_CONN_WARNING

Connections warning threshold

integer

_CONN_CRITICAL

Connections critical threshold

integer

_ACCEPTED_WARNING

Accepted packets warning threshold

integer

_ACCEPTED_CRITICAL

Accepted packets critical threshold

integer

_DROPPED_WARNING

Dropped packets warning threshold

integer

_DROPPED_CRITICAL

Dropped packets critical threshold

integer

_REJECTED_WARNING

Rejected packets warning threshold

integer

_REJECTED_CRITICAL

Rejected packets critical threshold

integer

_NODE_STATE

Configured cluster oper state in node

string

_ALARM_PERSISTENCE

Time for Non-OK service state persistence in minutes. Used in node cluster state service. Default 0 (No persistence)

integer

Network

Allot_nms

DESCRIPTION


Gets metrics in Allot Network Management System devices using SNMP

../../_images/allot-nms.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Board Temperature Range

Checks the board temperature

board_temperature_range

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPU Average

Checks the average use of CPU

cpu_avg

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

FANs status

Checks the status of fans

fans_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Virtual channels

Checks the number of virtual channels

virtual_channels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVIRTUAL_CHANNELS_DEFAULT_WARNING

_HOSTVIRTUAL_CHANNELS_DEFAULT_CRITICAL

Software status

Checks the software status

software_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Active lines

Checks the number of active lines

active_lines

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLINES_WARNING

_HOSTLINES_CRITICAL

Hardware status

Checks the hardware status

hardware_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Disk Usage

Checks the storage usage

disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

Protocol update licence

Checks the expiration date of Allot protocol update

protocol_update

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROTOCOL_UPDATE_WARNING

allot_uptime

Checks the device uptime

uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Connection establishment rate

Checks the connection establishment rate

connection_est

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONNECTION_WARNING

_HOSTCONNECTION_CRITICAL

Pipes

Checks the number of pipes

pipes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPIPES_WARNING

_HOSTPIPES_CRITICAL

PowerSupply status

Checks the status of power supplies

powersupply_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Sensors Temperature

Checks the temperature obtained from sensors

sensor_temperature

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSENSOR_TEMP_WARNING

_HOSTSENSOR_TEMP_CRITICAL

RAM Usage

Checks the main memory usage

mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRAM_WARNING

_HOSTRAM_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1 and 2c

string

_CPU_WARNING

CPU warning threshold (percentage)

percent

_CPU_CRITICAL

CPU critical threshold (percentage)

percent

_RAM_WARNING

RAM warning threshold (percentage)

percent

_RAM_CRITICAL

RAM critical threshold (percentage)

percent

_DISK_WARNING

Disk warning threshold (percentage)

percent

_DISK_CRITICAL

Disk critical threshold (percentage)

percent

_SENSOR_TEMP_WARNING

Temperature(celsius) warning threshold

integer

_SENSOR_TEMP_CRITICAL

Temperature(celsius) critical threshold

integer

_UPTIME_WARNING

Time (seconds) warning threshold

integer

_UPTIME_CRITICAL

Time (seconds) critical threshold

integer

_CONNECTION_WARNING

Connection establishment rate warning threshold

integer

_CONNECTION_CRITICAL

Connection establishment rate critical threshold

integer

_LINES_WARNING

Active lines warning threshold

integer

_LINES_CRITICAL

Active lines critical threshold

integer

_PIPES_WARNING

Total number of pipes warning threshold

integer

_PIPES_CRITICAL

Total number of pipes critical threshold

integer

_VIRTUAL_CHANNELS_DEFAULT_WARNING

Total number of vc’s warning threshold

integer

_VIRTUAL_CHANNELS_DEFAULT_CRITICAL

Total number of vc’s critical threshold

integer

_PROTOCOL_UPDATE_WARNING

Days to expire the license of Allot protocol update

integer

Aruba-alcatel-wifi-controller

DESCRIPTION


Checks for Aruba/Alcatel Controllers and its associated APs

../../_images/aruba-alcatel-wifi-controller.png

Supported devices: Aruba Mobility Controllers (7000 Series)

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Controller_memory

Checks the controller memory usage

check_aruba_alcatel_controller_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

Channel_utilization $KEY$

Checks the channel utilization

check_aruba_alcatel_channel_utilization

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_UTIL_WARNING_THRESHOLD

_HOSTCHANNEL_UTIL_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_CHLIST

Controller_Fans

Checks the fans status from the controller

check_aruba_alcatel_controller_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Channel_inteference $KEY$

Checks the radio channel inteference

check_aruba_alcatel_channel_interference

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_INTERF_WARNING_THRESHOLD

_HOSTCHANNEL_INTERF_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_CHLIST

AP_uptime $KEY$

Checks the Access Point uptime

check_aruba_alcatel_ap_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_MIN_UPTIME

_APLIST

Controller_disks

Checks the controller storage usage

check_disks_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTDISKS_WARNING_THRESHOLD

_HOSTDISKS_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

Channel_bandwidth $KEY$

Checks the bandwidth per radio channel

check_aruba_alcatel_channel_bandwidth

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_BW_WARNING_THRESHOLD

_HOSTCHANNEL_BW_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_CHLIST

WLAN_ESSIDs

Shows the WLAN essids running in the controller

check_aruba_alcatel_essid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Controller_ap_count

Checks the number of Access Points connected to the controller

check_ap_count_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Radio_Bytes $KEY$

Checks the bytes per radio channel

check_aruba_alcatel_controller_radio_bytes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CHLIST

Radio_TX_Bytes $KEY$

Checks the TX bytes per radio channel

check_aruba_alcatel_controller_radio_bytes_tx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CHLIST

Controller_Power_Supply

Checks the status of controller power supplies

check_aruba_alcatel_controller_power_supply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Radio_Info $KEY$

Shows radio channel info

check_aruba_alcatel_ap_radio_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CHLIST

AP_Info $KEY$

Shows Access Point info

check_aruba_alcatel_ap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_APLIST

AP_Clients $KEY$

Checks the number of clients per Access Point

check_aruba_alcatel_ap_clients

_HOSTSNMPCOMMUNITY

_HOSTAP_CLIENTS_WARNING_THRESHOLD

_HOSTAP_CLIENTS_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_APLIST

AP_status $KEY$

Checks the Access Point status

check_aruba_alcatel_ap_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_APLIST

WLAN_Clients

Checks the clients connected per WLAN

check_aruba_alcatel_controller_wlan_clients

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_WARNING

_HOSTWLAN_CLIENTS_CRITICAL

Channel_clients $KEY$

Checks the number of clients per radio channel

check_aruba_alcatel_channel_clients

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_CLIENTS_WARNING_THRESHOLD

_HOSTCHANNEL_CLIENTS_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_CHLIST

Radio_non_unicast $KEY$

Checks the non unicast packets per radio channel

check_aruba_alcatel_controller_radio_non_unicast

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTNON_UNICAST_WARNING

_HOSTNON_UNICAST_CRITICAL

_CHLIST

Radio_TX_Throughput $KEY$

Checks the TX throughput per radio channel

check_aruba_alcatel_controller_radio_tx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRADIO_TX_WARNING

_HOSTRADIO_TX_CRITICAL

_CHLIST

Controller_cpu

Checks the controller cpu usage

check_cpu_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

Radio_RX_Bytes $KEY$

Checks the RX bytes per radio channel

check_aruba_alcatel_controller_radio_bytes_rx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CHLIST

AP_bandwidth $KEY$

Checks the bandwidth per Access Point

check_aruba_alcatel_ap_bandwidth

_HOSTSNMPCOMMUNITY

_HOSTAP_BW_WARNING_THRESHOLD

_HOSTAP_BW_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_APLIST

Controller_Temp

Checks the controller temperature

check_aruba_alcatel_controller_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING_THRESHOLD

_HOSTTEMP_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

Radio_RX_Throughput $KEY$

Checks the RX throughput per radio channel

check_aruba_alcatel_controller_radio_rx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRADIO_RX_WARNING

_HOSTRADIO_RX_CRITICAL

_CHLIST

Client_SNR_avg

Checks the average of client Signal to Noise Ratio (SNR)

check_aruba_alcatel_client_snr_average

_HOSTSNMPCOMMUNITY

_HOSTCLIENT_SNR_WARNING_THRESHOLD

_HOSTCLIENT_SNR_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

WLAN_Throughput

Checks the throughput per WLAN

check_aruba_alcatel_controller_wlan_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_THROUGHPUT_WARNING

_HOSTWLAN_THROUGHPUT_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_APLIST:

wocu-discover-aruba-alcatel-wifi-aps.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_CHLIST:

wocu-discover-aruba-wifi-controller-channels.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_CPU_WARNING_THRESHOLD

CPU warning threshold (percent)

percent

_CPU_CRITICAL_THRESHOLD

CPU critical threshold (percent)

percent

_MEM_WARNING_THRESHOLD

Memory warning threshold (percent)

percent

_MEM_CRITICAL_THRESHOLD

Memory critical threshold (percent)

percent

_DISKS_WARNING_THRESHOLD

Disks ocupation warning threshold (percent)

percent

_DISKS_CRITICAL_THRESHOLD

Disks ocupation critical threshold (percent)

percent

_AP_MIN_UPTIME

AP Critical below this number of second after boot time

integer

_CHANNEL_UTIL_WARNING_THRESHOLD

Channel utilization warning threshold (percent)

percent

_CHANNEL_UTIL_CRITICAL_THRESHOLD

Channel utilization critical threshold (percent)

percent

_CHANNEL_INTERF_WARNING_THRESHOLD

Channel interference warning threshold

integer

_CHANNEL_INTERF_CRITICAL_THRESHOLD

Channel interference critical threshold

integer

_CHANNEL_CLIENTS_WARNING_THRESHOLD

Channel clients warning threshold

integer

_CHANNEL_CLIENTS_CRITICAL_THRESHOLD

Channel clients critical threshold

integer

_AP_CLIENTS_WARNING_THRESHOLD

AP clients warning threshold

integer

_AP_CLIENTS_CRITICAL_THRESHOLD

AP clients critical threshold

integer

_CHANNEL_BW_WARNING_THRESHOLD

Channel bandwidth warning threshold (in kbps)

integer

_CHANNEL_BW_CRITICAL_THRESHOLD

Channel bandwidth critical threshold (in kbps)

integer

_AP_BW_WARNING_THRESHOLD

AP bandwidth warning threshold (in kbps)

integer

_AP_BW_CRITICAL_THRESHOLD

AP bandwidth critical threshold (in kbps)

integer

_CLIENT_SNR_WARNING_THRESHOLD

Client average SNR warning threshold

integer

_CLIENT_SNR_CRITICAL_THRESHOLD

Client average SNR critical threshold

integer

_TEMP_WARNING_THRESHOLD

Controller Temp warning threshold in Celsius

integer

_TEMP_CRITICAL_THRESHOLD

Controller Temp critical threshold in Celsius

integer

_WLAN_CLIENTS_WARNING

Client count warning threshold per WLAN

integer

_WLAN_CLIENTS_CRITICAL

Client count critical threshold per WLAN

integer

_WLAN_THROUGHPUT_WARNING

WLAN throughput warning threshold

integer

_WLAN_THROUGHPUT_CRITICAL

WLAN throughput critical threshold

integer

_NON_UNICAST_WARNING

Non unicast packets percent warning threshold

percent

_NON_UNICAST_CRITICAL

Non unicast packets percent critical threshold

percent

_RADIO_RX_WARNING

Radio RX throughput warning threshold

integer

_RADIO_RX_CRITICAL

Radio RX throughput critical threshold

integer

_RADIO_TX_WARNING

Radio TX throughput warning threshold

integer

_RADIO_TX_CRITICAL

Radio TX throughput critical threshold

integer

COMPLEX MACROS

  • _APLIST

    • Description: List of connected APs. If there are no connected APs, discover script does nothing

    • Discover: wocu-discover-aruba-alcatel-wifi-aps.py


Fields

Description

Type

display name

Custom Name appearing in the AP services

string

index

AP snmp real index (obtained via snmp)

string

name

AP device name (obtained via snmp)

string

address

AP device ip address (obtained via snmp)

string

  • _CHLIST

    • Description: List of active channels in connected APs. If there are no connected APs, discover script does nothing

    • Discover: wocu-discover-aruba-wifi-controller-channels.py


Fields

Description

Type

display name

Custom Name appearing in the AP services

string

index

AP snmp real index (obtained via snmp)

string

name

AP device name (obtained via snmp)

string

channel_index

Wifi channel index used in snmp queries

string

channel

Wifi channel (obtained via snmp)

string

Aruba-alcatel-wifi-iap

DESCRIPTION


Checks for Alcatel Wifi iAPs and its connected APs

../../_images/aruba-alcatel-wifi-iap.png

Supported devices: IAP-134, IAP-135, IAP-105, IAP-92 and IAP-93

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

AP_Uptime $KEY$

Checks Access Point uptime

check_aruba_alcatel_iap_ap_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_UPTIME_WARNING

_HOSTAP_UPTIME_CRITICAL

_APLIST

AP_ap_count_up

Checks the number of connected Access Points with status UP

check_aruba_alcatel_iap_ap_count_up

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_COUNT_UP_WARNING

_HOSTAP_COUNT_UP_CRITICAL

AP_ap_count

Checks the number of connected Access Points

check_aruba_alcatel_iap_ap_count

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_COUNT_WARNING

_HOSTAP_COUNT_CRITICAL

WLAN_Clients

Checks the number of clients per WLAN

check_aruba_alcatel_iap_wlan_clients

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_WARNING

_HOSTWLAN_CLIENTS_CRITICAL

AP_MEM $KEY$

Checks the Access Point memory usage

check_aruba_alcatel_iap_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_APLIST

Channel_util $KEY$

Checks the radio channel utilization

check_aruba_alcatel_iap_channel_util

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCHANNEL_UTIL_WARNING

_HOSTCHANNEL_UTIL_CRITICAL

_CHLIST

WLAN_ESSIDs

Shows the WLAN essids published by the controller

check_aruba_alcatel_iap_essid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

AP_Status $KEY$

Checks the Access Point status

check_aruba_alcatel_iap_ap_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_APLIST

AP_Info $KEY$

Shows Access Point info

check_aruba_alcatel_iap_ap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_APLIST

Channel_status $KEY$

Checks the radio channel status

check_aruba_alcatel_iap_channel_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CHLIST

WLAN_TX_Throughput

Checks the TX throughput per WLAN

check_aruba_alcatel_iap_wlan_tx_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTX_THROUGHPUT_WARNING

_HOSTTX_THROUGHPUT_CRITICAL

Client_count

Checks the number of clients

check_aruba_alcatel_iap_client_count

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_COUNT_WARNING

_HOSTCLIENT_COUNT_CRITICAL

WLAN_RX_Throughput

Checks the RX throughput per WLAN

check_aruba_alcatel_iap_wlan_rx_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRX_THROUGHPUT_WARNING

_HOSTRX_THROUGHPUT_CRITICAL

AP_CPU $KEY$

Checks the Access Point CPU usage

check_aruba_alcatel_iap_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_APLIST

AP_Channel_snr_avg

Checks the average client Signal to Noise Ratio (SNR)

check_aruba_alcatel_iap_client_snr_avg

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_SNR_WARNING

_HOSTCLIENT_SNR_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_APLIST:

wocu-discover-alcatel-wifi-aps.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_CHLIST:

wocu-discover-aruba-wifi-iap-channels.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_AP_COUNT_WARNING

Warning counter for the number of aps connected to the virtual controller

integer

_AP_COUNT_CRITICAL

Critical counter for the number of aps connected to the virtual controller

integer

_AP_COUNT_UP_WARNING

Warning counter for the number of aps connected to the virtual controller and with status UP

integer

_AP_COUNT_UP_CRITICAL

Critical counter for the number of aps connected to the virtual controller and with status UP

integer

_CHANNEL_UTIL_WARNING

Channel utilization warning threshold

percent

_CHANNEL_UTIL_CRITICAL

Channel utilization critical threshold

percent

_CLIENT_SNR_WARNING

Average client Signal to Noise Ratio warning threshold

integer

_CLIENT_SNR_CRITICAL

Average client Signal to Noise Ratio critical threshold

integer

_CLIENT_COUNT_WARNING

Total connected client number warning threshold

integer

_CLIENT_COUNT_CRITICAL

Total connected client number critical threshold

integer

_WLAN_CLIENTS_WARNING

WLAN client number warning threshold

integer

_WLAN_CLIENTS_CRITICAL

WLAN client number critical threshold

integer

_TX_THROUGHPUT_WARNING

WLAN TX throughput warning threshold (in bps)

integer

_TX_THROUGHPUT_CRITICAL

WLAN TX throughput critical threshold (in bps)

integer

_RX_THROUGHPUT_WARNING

WLAN RX throughput warning threshold (in bps)

integer

_RX_THROUGHPUT_CRITICAL

WLAN RX throughput critical threshold (in bps)

integer

_AP_UPTIME_WARNING

AP Uptime warning threshold (in seconds)

integer

_AP_UPTIME_CRITICAL

AP Uptime critical threshold (in seconds)

integer

COMPLEX MACROS

  • _APLIST

    • Description: List of Access Points (APs) connected to the Wifi virtual Controller

    • Discover: wocu-discover-alcatel-wifi-aps.py


Fields

Description

Type

display name

Name to be shown in the web interface

string

index

Index for snmp queries

string

name

AP name

string

  • _CHLIST

    • Description: List of used Channels from Access Points (APs) connected to the Wifi virtual Controller

    • Discover: wocu-discover-aruba-wifi-iap-channels.py


Fields

Description

Type

display name

Name to be shown in the web interface

string

index

Index for snmp queries

string

name

AP name

string

channel

Channel index for snmp queries

string

Aruba-oscx-health

DESCRIPTION


Hardware checks for Aruba OSCX switches (Fans, Temperature and Power supply) via snmp

../../_images/aruba-oscx-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Aruba OSCX - Power Supply

aruba-oscx-powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Aruba OSCX - Temperature

aruba-oscx-temperature

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Aruba OSCX - Fans

aruba-oscx-fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

Bchannel-cisco

DESCRIPTION


Checks PRI/BRI B-Channel usage on Cisco gateways

../../_images/bchannel-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Bchannels Active_Calls

It shows the number of used, free and total ISDN B-channels

check_bchannels_cisco

_HOSTSNMPCOMMUNITY

_HOSTBCHANNEL_WARNING_THRESHOLD

_HOSTBCHANNEL_CRITICAL_THRESHOLD

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_BCHANNEL_WARNING_THRESHOLD

<Number of free channels> : Below this number, raise a Warning status

integer

_BCHANNEL_CRITICAL_THRESHOLD

<Number of free channels> : Below this number, raise a Critical status

integer

Bgp-cisco

DESCRIPTION


Checks BGP peer availability and session state in Cisco devices

../../_images/bgp-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

BGP_State

Checks BGP peer and sessions state

check_bgp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

Bgp-juniper

DESCRIPTION


Checks BGP peer state in Juniper devices

../../_images/bgp-juniper.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

BGP Juniper - $KEY$

Checks the Juniper BGP Peer state

check_bgp_juniper

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_BGP_JUNIPER_PEER_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_BGP_JUNIPER_PEER_LIST:

wocu-discover-juniper-bgp.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

COMPLEX MACROS

  • _BGP_JUNIPER_PEER_LIST

    • Description: List of BGP peers list

    • Discover: wocu-discover-juniper-bgp.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

local_ip

Local IP Address

string

peer_ip

Peer IP Address

string

routing_instance

Routing instance

integer

peer_state

Peer state. Service will alert when peer is not in the configured state

string

Cisco-acs

DESCRIPTION


Hardware checks for Cisco ACS Devices via snmp

../../_images/cisco-acs.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

cisco-acs-processes_$KEY$

Checks Cisco ACS process information.

cisco_acs_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

cisco-acs-mem-buffer

Checks Cisco ACS Memory Buffer usage information.

cisco_acs_mem_buffer

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEMORY_BUFFER_DEFAULT_WARNING

_HOSTMEMORY_BUFFER_DEFAULT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

cisco-acs-partition_$KEY$

Checks Cisco ACS partitions.

cisco_acs_partition_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING_THRESHOLD

_HOSTSTORAGE_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PARTITIONS

cisco-acs-uptime

Checks Cisco ACS uptime information.

cisco_acs_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

cisco-acs-vm

Checks Cisco ACS Virtual Memory usage information.

cisco_acs_vm_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVM_WARNING_THRESHOLD

_HOSTVM_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

cisco-acs-cpu

Checks Cisco ACS CPU usage information.

cisco_acs_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

cisco-acs-mem

Checks Cisco ACS Memory usage information.

cisco_acs_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_PARTITIONS:

wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_PROCESSES:

wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU Usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_UPTIME_WARNING

Time (seconds) warning threshold

integer

_UPTIME_CRITICAL

Time (seconds) critical threshold

integer

_STORAGE_WARNING_THRESHOLD

Storage warning threshold

percent

_STORAGE_CRITICAL_THRESHOLD

Storage critical threshold

percent

_VM_WARNING_THRESHOLD

Virtual memory warning threshold

percent

_VM_CRITICAL_THRESHOLD

Virtual memory critical threshold

percent

_MEMORY_BUFFER_DEFAULT_WARNING

Percent of memory buffer used warning threshold

integer

_MEMORY_BUFFER_DEFAULT_CRITICAL

Percent of memory buffer used critical threshold

integer

COMPLEX MACROS

  • _PARTITIONS

    • Description: Disk partitions

    • Discover: wocu-discover-os-resources-partitions.py


Fields

Description

Type

unit

Letter unit or path

string

index

Partition index

integer

label

Partition label

string

  • _PROCESSES

    • Description: Processes

    • Discover: wocu-discover-os-resources-processes.py


Fields

Description

Type

ProcName

Process label

string

ProcIndex

Process index

integer

Cisco-asr-health

DESCRIPTION


Hardware checks for Cisco ASR Devices (Fans, Temperature and Powersupply) via snmp

../../_images/cisco-asr-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Cisco ASR fan sensors

Checks the Fans health

check_cisco_asr_health_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco ASR powersupply

Checks the Powersupply status

check_cisco_asr_health_powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco ASR Temp sensors

Checks the temp sensors

check_cisco_asr_health_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

Cisco-interfaces-advanced-health

DESCRIPTION


Checks for the interface health on Cisco devices (Overrun/CRC/Giants/Collisions/Drops)

../../_images/cisco-interfaces-advanced-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

CISCO_HEALTH_$KEY$

Checks the interface health parameters

check_cisco_interfaces_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTOVERRUN_IN_WARNING_THRESHOLD

_HOSTOVERRUN_IN_CRITICAL_THRESHOLD

_HOSTCRC_IN_WARNING_THRESHOLD

_HOSTCRC_IN_CRITICAL_THRESHOLD

_HOSTGIANTS_IN_WARNING_THRESHOLD

_HOSTGIANTS_IN_CRITICAL_THRESHOLD

_HOSTCOLLISIONS_OUT_WARNING_THRESHOLD

_HOSTCOLLISIONS_OUT_CRITICAL_THRESHOLD

_HOSTDROPS_IN_WARNING_THRESHOLD

_HOSTDROPS_IN_CRITICAL_THRESHOLD

_HOSTDROPS_OUT_WARNING_THRESHOLD

_HOSTDROPS_OUT_CRITICAL_THRESHOLD

_CISCO_HEALTH_INTERFACE_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_CISCO_HEALTH_INTERFACE_LIST:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –exclude_nophysical_ifaces –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_OVERRUN_IN_WARNING_THRESHOLD

Overrun input packets warning threshold value

integer

_OVERRUN_IN_CRITICAL_THRESHOLD

Overrun input packets critical threshold value

integer

_CRC_IN_WARNING_THRESHOLD

CRC error input packets warning threshold value

integer

_CRC_IN_CRITICAL_THRESHOLD

CRC error input packets critical threshold value

integer

_GIANTS_IN_WARNING_THRESHOLD

Giant input packets warning threshold value

integer

_GIANTS_IN_CRITICAL_THRESHOLD

Giant input packets critical threshold value

integer

_COLLISIONS_OUT_WARNING_THRESHOLD

Output collisions warning threshold value

integer

_COLLISIONS_OUT_CRITICAL_THRESHOLD

Output collisions critical threshold value

integer

_DROPS_IN_WARNING_THRESHOLD

Input dropped packets warning threshold value

integer

_DROPS_IN_CRITICAL_THRESHOLD

Input dropped packets critical threshold value

integer

_DROPS_OUT_WARNING_THRESHOLD

Output dropped packets warning threshold value

integer

_DROPS_OUT_CRITICAL_THRESHOLD

Output dropped packets critical threshold value

integer

COMPLEX MACROS

  • _CISCO_HEALTH_INTERFACE_LIST

    • Description: List of interfaces to be health checked

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

descr

Custom Name appearing in the service (default ifDescr)

string

index

Device interface snmp index (obtained via snmp)

integer

type

Interface type (obtained via snmp)

string

Cisco-wifi-controller

DESCRIPTION


Checks for the Cisco Airespace/Aironet controller and its asociated APs

../../_images/cisco-wifi-controller.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Controller_power_supply

Checks the controller powersupply status

check_power_supply_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

AP_count

Checks the number of connected Access Points

check_ap_count_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CONNECTED_WARNING_THRESHOLD

_HOSTAPS_CONNECTED_CRITICAL_THRESHOLD

AP_radio_clients $KEY$

Checks the clients per Radio Channel

check_ap_radio_clients_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_RADIO_CLIENTS_DEFAULT_WARNING

_HOSTAP_RADIO_CLIENTS_DEFAULT_CRITICAL

_CISCO_CHLIST

Controller_cpu

Checks the controller CPU usage

check_cpu_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

Channel_interference $KEY$

Checks the Radio Channel interference

check_channel_interf_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CHANNEL_INTERFERENCE_WARNING_THRESHOLD

_HOSTAPS_CHANNEL_INTERFERENCE_CRITICAL_THRESHOLD

_CISCO_CHLIST

Channel_utilization $KEY$

Checks the Radio Channel utilization

check_channel_util_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCHANNEL_UTIL_WARNING_THRESHOLD

_HOSTCHANNEL_UTIL_CRITICAL_THRESHOLD

_CISCO_CHLIST

AP_status $KEY$

Checks the Access Point status

check_ap_status_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_APLIST

Controller_info

Shows controller info

check_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

AP_info $KEY$

Shows info from Access Point

check_ap_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_APLIST

WLAN_Clients

Checks the number of clients per WLAN

check_wlan_clients_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_DEFAULT_WARNING

_HOSTWLAN_CLIENTS_DEFAULT_CRITICAL

Controller_memory

Checks the controller memory usage

check_mem_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

AP_radio_info $KEY$

Shows info of the Radio Channels

check_ap_radio_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_CHLIST

Controller_temp

Checks the controller temperature

check_temp_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTTEMP_DEFAULT_HIGH

_HOSTTEMP_DEFAULT_LOW

_HOSTSNMPVERSION

Client_count

Checks the total number of clients

check_client_count_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_COUNT_DEFAULT_WARNING

_HOSTCLIENT_COUNT_DEFAULT_CRITICAL

AP_clients $KEY$

Checks the clients per Access Point

check_ap_clients_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_CLIENTS_WARNING_THRESHOLD

_HOSTAP_CLIENTS_CRITICAL_THRESHOLD

_CISCO_APLIST

Controller_essid

Shows the WLAN ESSIDs published in the controller

check_essid_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

AP_noise_power $KEY$

Checks the average noise power in dBm on each channel per AP

check_ap_noise_power_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CHANNEL_NOISE_POWER_WARNING_THRESHOLD

_HOSTAPS_CHANNEL_NOISE_POWER_CRITICAL_THRESHOLD

_CISCO_APLIST

Client_SNR_avg $KEY$

Checks the average Signal to Noise Ratio per Radio Channel

check_client_snr_avg_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_SNR_AVG_WARNING_THRESHOLD

_HOSTCLIENT_SNR_AVG_CRITICAL_THRESHOLD

_CISCO_CHLIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_CISCO_APLIST:

wocu-discover-cisco-wifi-aps.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_CISCO_CHLIST:

wocu-discover-cisco-wifi-channels.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_CPU_WARNING_THRESHOLD

CPU warning threshold

percent

_CPU_CRITICAL_THRESHOLD

CPU critical threshold

percent

_MEM_WARNING_THRESHOLD

Memory warning threshold (percent)

percent

_MEM_CRITICAL_THRESHOLD

Memory critical threshold (percent)

percent

_APS_CONNECTED_WARNING_THRESHOLD

APs connected warning threshold

integer

_APS_CONNECTED_CRITICAL_THRESHOLD

APs connected critical threshold

integer

_AP_CLIENTS_WARNING_THRESHOLD

Connected clients warning threshold

integer

_AP_CLIENTS_CRITICAL_THRESHOLD

Connected clients critical threshold

integer

_CHANNEL_UTIL_WARNING_THRESHOLD

Channel utilization warning threshold

percent

_CHANNEL_UTIL_CRITICAL_THRESHOLD

Channel utilization critical threshold

percent

_CLIENT_SNR_AVG_WARNING_THRESHOLD

Average client SNR warning threshold

integer

_CLIENT_SNR_AVG_CRITICAL_THRESHOLD

Average client SNR critical threshold

integer

_APS_CHANNEL_NOISE_POWER_CRITICAL_THRESHOLD

APs channel noise power

integer

_APS_CHANNEL_NOISE_POWER_WARNING_THRESHOLD

APs channel interference

integer

_APS_CHANNEL_INTERFERENCE_WARNING_THRESHOLD

APs channel interference

integer

_APS_CHANNEL_INTERFERENCE_CRITICAL_THRESHOLD

APs channel interference

integer

_TEMP_DEFAULT_HIGH

Controller temperature high threshold (Celsius)

integer

_TEMP_DEFAULT_LOW

Controller temperature low threshold (Celsius)

integer

_CLIENT_COUNT_DEFAULT_WARNING

Controller client count warning threshold

integer

_CLIENT_COUNT_DEFAULT_CRITICAL

Controller client count critical threshold

integer

_WLAN_CLIENTS_DEFAULT_WARNING

WLAN client count warning threshold

integer

_WLAN_CLIENTS_DEFAULT_CRITICAL

WLAN client count critical threshold

integer

_AP_RADIO_CLIENTS_DEFAULT_WARNING

WLAN client count warning threshold

integer

_AP_RADIO_CLIENTS_DEFAULT_CRITICAL

WLAN client count critical threshold

integer

COMPLEX MACROS

  • _CISCO_APLIST

    • Description: List of connected/registered APs to the controller

    • Discover: wocu-discover-cisco-wifi-aps.py


Fields

Description

Type

display name

Custom Name appearing in the AP services

string

index

AP snmp real index (obtained via snmp)

string

name

AP device name (obtained via snmp)

string

address

AP device ip address (obtained via snmp)

string

  • _CISCO_CHLIST

    • Description: List of radio slots from connected/registered APs

    • Discover: wocu-discover-cisco-wifi-channels.py


Fields

Description

Type

display name

Custom Name appearing in the channel services

string

index

AP snmp real index (obtained via snmp)

string

name

AP and slot device name (obtained via snmp)

string

slot_index

Radio band slot index: 0 for Slot 0 or 1 for Slot1. Used for snmp queries

string

F5-bigip

DESCRIPTION


Custom checks for F5 BIG-IP devices.

../../_images/f5-bigip.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

f5_virtual_server_status_$KEY$

Checks F5 BIG-IP virtual server status.

check_f5_virtual_server_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUALSERVER_LIST

f5_mem_usage

Checks F5 BIG-IP memory usage.

check_f5_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_http_warning_response_codes

Checks F5 BIG-IP HTTP warning response codes percents and rates.

check_f5_http_warning_responses

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHTTP_4XX_WARNING

_HOSTHTTP_4XX_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_http_error_response_codes

Checks F5 BIG-IP HTTP error responses codes percents and rates.

check_f5_http_error_responses

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHTTP_5XX_WARNING

_HOSTHTTP_5XX_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_ssl_transactions

Checks F5 BIG-IP SSL transactions.

check_f5_ssl_transactions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_server_traffic_rate

Checks F5 BIG-IP server traffic rate.

check_f5_server_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_client_conn

Checks the number of F5 BIG-IP client connections.

check_f5_client_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_CONN_WARNING

_HOSTCLIENT_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_server_connections

Checks the number of F5 BIG-IP server connections.

check_f5_server_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSERVER_CONN_WARNING

_HOSTSERVER_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_http_response_buckets

Checks F5 BIG-IP HTTP buckets by response size.

check_f5_http_response_buckets

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_cpu_usage

Checks F5 BIG-IP CPU usage.

check_f5_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_pool_member_traffic_$KEY$

Checks F5 BIG-IP pool member traffic.

check_f5_pool_member_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_POOLMEMBER_LIST

f5_failover_status

Checks F5 BIG-IP failover status (HA).

check_f5_failover_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_pool_member_status_$KEY$

Checks F5 BIG-IP pool member status.

check_f5_pool_member_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_POOLMEMBER_LIST

f5_tmm_conn

Checks the number of F5 BIG-IP TMM connections.

check_f5_tmm_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTMM_CONN_WARNING

_HOSTTMM_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

F5 BIG-IP - SSL connections

Checks the number of SSL connections

f5-bigip-ssl-conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSSL_CONN_WARNING

_HOSTSSL_CONN_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_http_protocol_version_usage

Checks F5 BIG-IP HTTP protocol version usage.

check_f5_http_version

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_virtual_server_traffic_$KEY$

Checks F5 BIG-IP virtual server traffic.

check_f5_virtual_server_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUALSERVER_LIST

f5_virtual_server_connections_$KEY$

Checks F5 BIG-IP virtual server connections.

check_f5_virtual_server_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUALSERVER_LIST

f5_ram_cache_usage

Checks F5 BIG-IP ram cache usage.

check_f5_ram_cache

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5_tmm_traffic

Shows TMM traffic statistics

check_f5_tmm_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

f5 http response codes

Checks F5 BIG-IP HTTP response code percents and rates.

check_f5_http_response_code

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_VIRTUALSERVER_LIST:

wocu-discover-f5-virtualserver.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_POOLMEMBER_LIST:

wocu-discover-f5-pool-members.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU warning threshold (percentage)

percent

_CPU_CRITICAL

CPU critical threshold (percentage)

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_CLIENT_CONN_WARNING

Current client connection usage warning threshold

integer

_CLIENT_CONN_CRITICAL

Current client connection usage critical threshold

integer

_SERVER_CONN_WARNING

Current server connection usage warning threshold

integer

_SERVER_CONN_CRITICAL

Current server connection usage critical threshold

integer

_VIRTUAL_SERVER_CONN_WARNING

Current Virtual Server connection usage warning threshold

integer

_VIRTUAL_SERVER_CONN_CRITICAL

Current Virtual Server connection usage critical threshold

integer

_HTTP_4XX_WARNING

Current http warning (4XX) responses warning threshold

percent

_HTTP_4XX_CRITICAL

Current http warning (4XX) responses critical threshold

percent

_HTTP_5XX_WARNING

Current http error (5XX) responses warning threshold

percent

_HTTP_5XX_CRITICAL

Current http error (5XX) responses critical threshold

percent

_RAM_CACHE_MISS_WARNING

Current ram cache miss warning threshold

percent

_RAM_CACHE_MISS_CRITICAL

Current ram cache miss critical threshold

percent

_SSL_CONN_WARNING

SSL connections warning threshold

integer

_SSL_CONN_CRITICAL

SSL connections critical threshold

integer

_TMM_CONN_WARNING

Current TMM client/server connection usage warning threshold

integer

_TMM_CONN_CRITICAL

Current TMM client/server connection usage critical threshold

integer

COMPLEX MACROS

  • _VIRTUALSERVER_LIST

    • Description: List of Virtual Servers

    • Discover: wocu-discover-f5-virtualserver.py


Fields

Description

Type

display_name

Virtual Server name

string

oid_suffix

Virtual Server suffix name

string

vs_server_conn_warnning

Virtual Server connection warnning threshold

integer

vs_server_conn_critical

Virtual Server connection critical threshold

integer

  • _POOLMEMBER_LIST

    • Description: List of Pool Members

    • Discover: wocu-discover-f5-pool-members.py


Fields

Description

Type

display_name

Pool member name

string

oid_suffix

Pool member suffix name

string

F5-health

DESCRIPTION


Hardware checks for F5 BIGIP Devices (Fans, Temperature and PowerSupply) via snmp

../../_images/f5-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

F5 PowerSupply

Checks PowerSupply(s) status

check_f5_health_powersupply

_HOSTSNMPCOMMUNITY

F5 Fan

Checks Fan(s) status

check_f5_health_fan

_HOSTSNMPCOMMUNITY

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

F5 Temp

Checks hardware temperature(s)

check_f5_health_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

Fortigate-health

DESCRIPTION


Hardware checks for Fortigate (Fans, Temperature and PowerSupply) via snmp. Small models are not supported

../../_images/fortigate-health.jpg

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Fortigate Health - Temp

Checks hardware temperature(s)

check_fortigate_health_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Fortigate Health - Fan

Checks Fan(s) status

check_fortigate_health_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

Fortigate Health - PowerSupply

Checks PowerSupply(s) status

check_fortigate_health_powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_RPM_WARNING

Fan RPM warning threshold

integer

_RPM_CRITICAL

Fan RPM critical threshold

integer

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

Haproxy

DESCRIPTION


Custom checks for HAProxy services

../../_images/haproxy.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

haproxy-version

Checks HAProxy version information.

haproxy_version

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

haproxy-backend-status

Checks HAProxy Backend Service information.

haproxy_backend_status

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

TCP_$KEY$

Checks HAProxy host port.

check_haproxy_tcp

_TCP_PORTS

haproxy-process-info

Checks HAProxy process information.

haproxy_process_info

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

haproxy-frontend-status

Checks HAProxy Frontend Service information.

haproxy_frontend_status

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

haproxy-uptime

Checks HAProxy uptime information.

haproxy_uptime

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

haproxy-server-status

Checks HAProxy Servers information.

haproxy_server_status

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_TCP_PORTS:

wocu-discover-tcp-ports.py $HOSTADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_DPA_USERNAME

Username for API auth

string

_DPA_PASSWORD

Password for API auth

string

_DPA_PORT

Api port for HTTP requests

string

_UPTIME_WARNING

Uptime warning threshold

string

_UPTIME_CRITICAL

Uptime critical threshold

string

COMPLEX MACROS

  • _TCP_PORTS

    • Description: List of TCP ports to overwatch

    • Discover: wocu-discover-tcp-ports.py


Fields

Description

Type

name

Display name to be shown as part of the service description

string

port

TCP port to monitor

integer

Health-cisco

DESCRIPTION


Check hardware health status of cisco devices

../../_images/health-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Health_$KEY$

Checks the status of hardware sensors

check-cisco-health

_HOSTSNMPCOMMUNITY

_HEALTHCHECKS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

COMPLEX MACROS

  • _HEALTHCHECKS

    • Description: List of health checks for Cisco devices. Must enter 2 fields: Name (Service Display Name) + Check (type of Health Check)


Fields

Description

Type

name

Custom service display name

string

check

Checks available: temp / fan / ps / freeint / module

string

warning

Warning threshold. Leave it blank except for temp and freeint

integer

critical

Critical threshold. Leave it blank except for temp and freeint

integer

Hsrp-cisco

DESCRIPTION


Monitors Cisco HSRP via snmp protocol

../../_images/hsrp-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

HSRP_State_$KEY$

Checks Cisco HSRP status

check_hsrp_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTHSRP_STATE

_HSRP_STATE

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_HSRP_STATE

-s, –state=master|backup|num,% Nokia ipso clustering : number of members, max % assigned to nodes. Other : check HSRP interface to be master or backup

string

Hsrp-cisco-ifaces

DESCRIPTION


Check for the HSRP configured interfaces on Cisco routers

../../_images/hsrp-cisco-ifaces.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

HSRP - $KEY$

Checks HSRP (Hot Standby Router Protocol) interface state

check_hsrp_interface

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HSRP_INTERFACES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_HSRP_INTERFACES:

wocu-discover-hsrp-interfaces.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community (only snmp v2)

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPVERSION

Device SNMP version, supported 1 and 2c

string

COMPLEX MACROS

  • _HSRP_INTERFACES

    • Description: HSRP interfaces (list)

    • Discover: wocu-discover-hsrp-interfaces.py


Fields

Description

Type

Display Name

Custom Name appearing in the service: HSRP_<Virtual IP>

string

Virtual IP

HSRP Virtual IP (configured on remote device)

string

ifIndex

HSRP interface index (ifindex configured on remote device)

integer

Group

HSRP group (configured on remote device)

integer

State

HSRP state (to be checked on remote device)

string

Infinera-edu

DESCRIPTION


Checks for Infinera EDU devices using SNMP

../../_images/infinera-edu.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Layer2_rate_$KEY$

Checks the Layer 2 traffic rate

check_infinera_edu_l2_rate

_HOSTSNMPCOMMUNITY

_HOSTLAYER2_RATE_WARNING

_HOSTLAYER2_RATE_CRITICAL

_INFINERA_PORTS_LIST

Port_drops_$KEY$

Checks dropped packets

check_infinera_edu_port_drops

_HOSTSNMPCOMMUNITY

_HOSTDROPS_WARNING

_HOSTDROPS_CRITICAL

_INFINERA_PORTS_LIST

Infinera-edu temp

Checks hardware temperature

check_infinera_edu_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Layer1_rate_$KEY$

Checks the Layer 1 traffic rate

check_infinera_edu_l1_rate

_HOSTSNMPCOMMUNITY

_HOSTLAYER1_RATE_WARNING

_HOSTLAYER1_RATE_CRITICAL

_INFINERA_PORTS_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_INFINERA_PORTS_LIST:

wocu-discover-infinera-ports.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

SNMP version

string

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

_DROPS_WARNING

Packet drops increase warning threshold

integer

_DROPS_CRITICAL

Packet drops increase critical threshold

integer

_LAYER1_RATE_WARNING

Layer1 rate warning threshold (in Bps)

integer

_LAYER1_RATE_CRITICAL

Layer1 rate critical threshold (in Bps)

integer

_LAYER2_RATE_WARNING

Layer2 rate warning threshold (in Bps)

integer

_LAYER2_RATE_CRITICAL

Layer2 rate critical threshold (in Bps)

integer

COMPLEX MACROS

  • _INFINERA_PORTS_LIST

    • Description: List of ports to be checked

    • Discover: wocu-discover-infinera-ports.py


Fields

Description

Type

display_name

Name to be shown as Service Description in the web interface

string

index

Infinera port index (integer)

integer

name

Port name

string

Infinera-xtm

DESCRIPTION


Checks for Infinera XTM interface drop statistics via SNMP

../../_images/infinera-xtm.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Interface_drops_$KEY$

Checks dropped packets

check_infinera_xtm_ifaces_drops

_HOSTSNMPCOMMUNITY

_HOSTDROPPED_BYTES_WARNING

_HOSTDROPPED_BYTES_CRITICAL

_HOSTDROPPED_FRAMES_WARNING

_HOSTDROPPED_FRAMES_CRITICAL

_INFINERA_IFACES_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_INFINERA_IFACES_LIST:

wocu-discover-infinera-ifaces.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

SNMP version

string

_DROPPED_BYTES_WARNING

Dropped byte increase warning threshold

integer

_DROPPED_BYTES_CRITICAL

Dropped byte increase critical threshold

integer

_DROPPED_FRAMES_WARNING

Dropped frame increase warning threshold

integer

_DROPPED_FRAMES_CRITICAL

Dropped frame increase critical threshold

integer

COMPLEX MACROS

  • _INFINERA_IFACES_LIST

    • Description: List of interfaces to be checked

    • Discover: wocu-discover-infinera-ifaces.py


Fields

Description

Type

display_name

Name to be shown as Service Description in the web interface

string

index

Index of Infinera interface (integer)

integer

name

Name of interface

string

Infoblox

DESCRIPTION


Health and performance checks for Infoblox devices via snmp

../../_images/infoblox.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Infoblox - IP Addresses

Shows configured ip addresses of this appliance

check_infoblox_ip

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - HA State

Checks High Availability (HA) status

check_infoblox_ha

_HOSTSNMPVERSION

_HOSTHA_LOCAL_STATE

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - Temperature

Checks the temperature of the appliance

check_infoblox_temp

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - Replication

Checks if replication between Infoblox appliances is working

check_infoblox_replication

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - Memory Usage

Checks memory usage

check_infoblox_mem

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - Info

Shows general information about this appliance

check_infoblox_info

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - DNS Performance

Shows DNS responses last 5 minutes average latency

check_infoblox_dnslatency

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - DNS Invalids

Shows DNS responses to invalid ports and TXID

check_infoblox_dnsinvalid

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - DNS Updates

Shows DNS dynamic update statistics

check_infoblox_dnsupdates

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - DHCP Stats

Shows DHCP statistics

check_infoblox_dhcpstats

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - DNS Stats

Shows DNS statistics

check_infoblox_dnsstats

_HOSTSNMPVERSION

_HOSTDOMAIN

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Infoblox - CPU

Checks CPU usage

check_infoblox_cpu

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_CPU_WARNING

CPU warning threshold (percentage)

percent

_CPU_CRITICAL

CPU critical threshold (percentage)

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_TEMP_WARNING

Temperature warning threshold (Celsius degrees)

integer

_TEMP_CRITICAL

Temperature critical threshold (Celsius degrees)

integer

_HA_LOCAL_STATE

HA configured state

string

_DOMAIN

DNS Domain to obtain stats from

string

Ipsla-cisco

DESCRIPTION


Check IPSLA rules (Jitter/RTT/Packets) in Cisco devices

../../_images/ipsla-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

IPSLA_$KEY$

Checks the status and metrics of IPSLA sessions

check_cisco_ipsla

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_IPSLA_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IPSLA_LIST:

wocu-discover-cisco-ipsla.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _IPSLA_LIST

    • Description: List of IPSLA rules to be checked

    • Discover: wocu-discover-cisco-ipsla.py


Fields

Description

Type

display name

Name to be shown in the web interface

string

index

Index for snmp queries

integer

jitter_critical

Critical threshold for the average of positive and negative jitter values in SD and DS direction for latest operation

integer

jitter_warning

Warning threshold for the average of positive and negative jitter values in SD and DS direction for latest operation

integer

percent_loss_critical

Critical threshold for percent packet loss (SD + DS)

float.percent

name

Name to be shown in the web interface

string

percent_loss_warning

Warning threshold for percent packet loss (SD + DS)

float.percent

rtt_critical

Critical threshold for completion time of the latest RTT operation successfully completed

integer

rtt_warning

Warning threshold for completion time of the latest RTT operation successfully completed

integer

mos_critical

Critical threshold for Mean Opinion Scores (MOS)

integer

mos_warning

Warning threshold for Mean Opinion Scores (MOS)

integer

Meraki-device

DESCRIPTION


Pack for checking Meraki devices using Dashboard API

../../_images/meraki-device.png

Get the performance data of the Meraki devices using the Meraki Dashboard API. This pack needs the Organization API Key, the Organization ID, the Network ID and the device serial number.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Meraki_device_USB_Status

Checks the USB port status

check_meraki_device_usb_status

_HOSTAPIKEY

_HOSTORGID

_HOSTNETWORKID

_HOSTSERIAL

Meraki_device_CPU

Checks the CPU usage

check_meraki_device_cpu

_HOSTAPIKEY

_HOSTORGID

_HOSTNETWORKID

_HOSTSERIAL

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_APIKEY

Organization API Key

string

_ORGID

Organization ID

string

_NETWORKID

Network ID that includes the target device

string

_SERIAL

Device serial number

string

_CPU_WARNING_THRESHOLD

CPU warning threshold

integer

_CPU_CRITICAL_THRESHOLD

CPU critical threshold

integer

Mikrotik

DESCRIPTION


Checks for Mikrotik Devices via snmp

../../_images/mikrotik.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Mikrotik mem usage

Checks Memory usage percent

check_mikrotik_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

Mikrotik temperature

Checks hardware temperature

check_mikrotik_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_TEMP_WARNING

Temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

Temperature critical threshold (in Celsius)

integer

_MEM_USAGE_WARNING

Memory usage warning threshold (percent)

percent

_MEM_USAGE_CRITICAL

Memory usage critical threshold (percent)

percent

Networkdevice-adsl-metrics

DESCRIPTION


Checks metrics in ADSL interfaces from routers using SNMP

../../_images/networkdevice-adsl-metrics.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

ADSL_Channels_TX_Rates_$KEY$

Checks ATU-C and ATU-R TX rates in ADSL interfaces

check_adsl_metrics_rates

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_ADSL_METRICS_LIST

ADSL_Traffic_$KEY$

Checks Line usage percent in ADSL associated interfaces

check_adsl_metrics_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTADSL_TRAFFIC_WARNING

_HOSTADSL_TRAFFIC_CRITICAL

_ADSL_METRICS_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_ADSL_METRICS_LIST:

wocu-discover-adsl-ifaces.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community configured on remote device

string

_SNMPVERSION

The snmp version on remote device

string

_ADSL_TRAFFIC_WARNING

Traffic warning threshold (percentage)

percent

_ADSL_TRAFFIC_CRITICAL

Traffic critical threshold (percentage)

percent

COMPLEX MACROS

  • _ADSL_METRICS_LIST

    • Description: List of ADSL Interfaces

    • Discover: wocu-discover-adsl-ifaces.py


Fields

Description

Type

name

Display name to be shown as part of the service description

string

index

ADSL interface index

integer

atuc_rate_warn

ATU-C Channel TX rate Warning threshold

integer

atuc_rate_crit

ATU-C Channel TX rate Critical threshold

integer

atur_rate_warn

ATU-R Channel TX rate Warning threshold

integer

atur_rate_crit

ATU-R Channel TX rate Critical threshold

integer

units

Thresholds and output units

string

index_traffic

Index for traffic associated ADSL iface

string

Networkdevice-available-ports

DESCRIPTION


Check the available ports in a network device

../../_images/networkdevice-available-ports.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Available Ports

Checks the number and percent of not used physical ports

wocu-check-available-ports

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAVAILABLE_PORTS_WARNING_THRESHOLD

_HOSTAVAILABLE_PORTS_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_AVAILABLE_PORTS_WARNING_THRESHOLD

warning threshold of available ports in the device (percentage)

percent

_AVAILABLE_PORTS_CRITICAL_THRESHOLD

critical threshold of available ports in the device (percentage)

percent

Networkdevice-cpu

DESCRIPTION


Network device cpu checks

../../_images/networkdevice-cpu.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

CPU

Checks the CPU usage

wocu-check-cpu

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

_CPU_WARNING_THRESHOLD

CPU warning threshold

percent

_CPU_CRITICAL_THRESHOLD

CPU critical threshold

percent

Networkdevice-cpu-1m

DESCRIPTION


Network device cpu checks (forced to 1 minute)

../../_images/networkdevice-cpu-1m.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

CPU_1m

Checks the CPU usage. 1 minute check interval

wocu-check-cpu-1m

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTCPU_1M_WARNING_THRESHOLD

_HOSTCPU_1M_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

_CPU_1M_WARNING_THRESHOLD

CPU warning threshold (percentage)

percent

_CPU_1M_CRITICAL_THRESHOLD

CPU critical threshold (percentage)

percent

Networkdevice-hardware-health

DESCRIPTION


Hardware Health checks for network devices (Fans, Temperature and PowerSupply) via snmp

../../_images/networkdevice-hardware-health.png

Hardware Health checks for network devices (Fans, Temperature, PowerSupply and Cards) via snmp

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Hardware Health

Checks the status of all sensors detected in the hardware (temp, fan, powersupply, etc.)

check_networkdevice_hardware_health

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

Networkdevice-mem

DESCRIPTION


Network device memory checks

../../_images/networkdevice-mem.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Memory

Checks the memory usage

wocu-check-mem

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTMEMFREE_WARNING_THRESHOLD

_HOSTMEMFREE_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_DEVICEVENDOR

Device vendor

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_MEMFREE_WARNING_THRESHOLD

Memory Free warning threshold (percentage)

percent

_MEMFREE_CRITICAL_THRESHOLD

Memory Free critical threshold (percentage)

percent

Networkdevice-mem-1m

DESCRIPTION


Network device memory checks (forced to 1m)

../../_images/networkdevice-mem-1m.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Memory_1m

Checks the memory usage. 1 minute check interval

wocu-check-mem-1m

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTMEMFREE_1M_WARNING_THRESHOLD

_HOSTMEMFREE_1M_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_DEVICEVENDOR

Device vendor

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_MEMFREE_1M_WARNING_THRESHOLD

Memory warning threshold (percentage)

percent

_MEMFREE_1M_CRITICAL_THRESHOLD

Memory critical threshold (percentage)

percent

Networkdevice-mobile-signal

DESCRIPTION


Checks mobile signal strength/quality metrics in 3G/4G routers

../../_images/networkdevice-mobile-signal.png

Checks mobile signal strength/quality metrics in 3G/4G routers via snmp. Also shows info about mobile band and APN (Access Point Name)

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Mobile_signal_info_$KEY$

Shows mobile (3G, 4G) communications information

check_mobile_signal_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_MOBILE_SIGNAL_LIST

Mobile_signal_health_$KEY$

Checks the health metrics from mobile (3G, 4G) communications

check_mobile_signal_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_MOBILE_SIGNAL_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_MOBILE_SIGNAL_LIST:

wocu-discover-mobile-signal.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ -V $_DEVICEVENDOR$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor. Support for Cisco and Teldat

string

COMPLEX MACROS

  • _MOBILE_SIGNAL_LIST

    • Description: List of 3G/4G cellular mobile router instances. Apply _VENDOR and _SNMPVERSION changes before discover mobile signals

    • Discover: wocu-discover-mobile-signal.py


Fields

Description

Type

name

Display name to be shown as part of the service description

string

index

Cellular mobile index

integer

tech_warn

Technology warning threshold: From 1 (worst) to 13 (best)

integer

tech_crit

Technology critical threshold: From 1 (worst) to 13 (best)

integer

rssi_warn

RSSI warning threshold (in dBm)

integer

rssi_crit

RSSI critical threshold (in dBm)

integer

ecio_warn

EC/IO warning threshold

integer

ecio_crit

EC/IO critical threshold

integer

rsrp_warn

RSRP warning threshold (in dBm)

integer

rsrp_crit

RSRP critical threshold (in dBm)

integer

rsrq_warn

RSRQ warning threshold (in dB)

integer

rsrq_crit

RSRQ critical threshold (in dB)

integer

rscp_warn

RSCP warning threshold (in dBm)

integer

rscp_crit

RSCP critical threshold (in dBm)

integer

sinr_warn

SINR warning threshold (in dB)

integer

sinr_crit

SINR critical threshold (in dB)

integer

Networkdevice-ping

DESCRIPTION


Network device ping check

../../_images/networkdevice-ping.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Ping

Checks connectivity using ICMP protocol

wocu-check-ping

_HOSTRTA_WARNING_THRESHOLD

_HOSTPL_WARNING_THRESHOLD

_HOSTRTA_CRITICAL_THRESHOLD

_HOSTPL_CRITICAL_THRESHOLD

_HOSTICMP_PACKETS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_ICMP_PACKETS

Number of packets to launch

integer

_RTA_WARNING_THRESHOLD

Round trip average warning threshold (miliseconds)

integer

_RTA_CRITICAL_THRESHOLD

Round trip average critical threshold (miliseconds)

integer

_PL_WARNING_THRESHOLD

Packet lost warning threshold (percentage)

percent

_PL_CRITICAL_THRESHOLD

Packet lost critical threshold (percentage)

percent

Networkdevice-ping-1m

DESCRIPTION


Network device ping check (forced to 1 minute)

../../_images/networkdevice-ping-1m.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Ping-1m

Checks connectivity using ICMP protocol. 1 minute check interval

wocu-check-ping-1m

_HOSTRTA_WARNING_THRESHOLD

_HOSTPL_WARNING_THRESHOLD

_HOSTRTA_CRITICAL_THRESHOLD

_HOSTPL_CRITICAL_THRESHOLD

_HOSTICMP_PACKETS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_ICMP_PACKETS

Number of packets to launch

integer

_RTA_WARNING_THRESHOLD

Round trip average warning threshold (miliseconds)

integer

_RTA_CRITICAL_THRESHOLD

Round trip average critical threshold (miliseconds)

integer

_PL_WARNING_THRESHOLD

Packet lost warning threshold (percentage)

percent

_PL_CRITICAL_THRESHOLD

Packet lost critical threshold (percentage)

percent

Networkdevice-route-count

DESCRIPTION


Get the number of valid routes using SNMP

../../_images/networkdevice-route-count.png

The check gets the value from several OID to calculate the amount of current routes configured on the device: inetCidrRouteNumber, inetCidrRouteDiscards and inetCidrRouteTable

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Valid_CIDR_routes

Checks the number of routes configured in the host

check_networkdevice_route_count_number

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTROUTES_WARNING

_HOSTROUTES_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_ROUTES_WARNING

Warning threshold for minimum number of valid routes

integer

_ROUTES_CRITICAL

Critical threshold for minimum number of valid routes

integer

Networkdevice-traffic

DESCRIPTION


Network device traffic checks. Supports thresholds in range mode (nagios format)

../../_images/networkdevice-traffic.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Traffic_$KEY$

Checks the input and output traffic from an interface

wocu-check-traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRAFFIC_WARNING_THRESHOLD

_HOSTTRAFFIC_CRITICAL_THRESHOLD

_HOSTSNMPPORT

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_IFACES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IFACES:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPPORT

Device SNMP UDP Port (Default is 161)

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_TRAFFIC_WARNING_THRESHOLD

Traffic percent usage warning threshold in nagios format. Ex: 20:80

percent

_TRAFFIC_CRITICAL_THRESHOLD

Traffic percent usage critical threshold in nagios format. Ex: 10:90

percent

COMPLEX MACROS

  • _IFACES

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

descr

Interface name (ifDescr) to be shown as part of the service description

string

index

Interface index (unique)

integer

max speed in

Interface maximum speed in {units} per second. Applied to IN traffic. (Values of 0 mean no limit)

integer

max speed out

Interface maximum speed in {units} per second. Applied to OUT traffic. (Values of 0 mean no limit)

integer

units

Speed units (g=gigabits/s, m=megabits/s, k=kilobits/s ,b=bits/s)

string

alias

Interface alias (ifAlias) to be shown as alternative display name

string

warning

Traffic percent usage warning threshold. Leave it blank to use the generic one

percent

critical

Traffic percent usage critical threshold. Leave it blank to use the generic one

percent

Networkdevice-traffic-1m

DESCRIPTION


Network device traffic checks

../../_images/networkdevice-traffic-1m.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Traffic_1m_$KEY$

Checks the input and output traffic from an interface. 1 minute check interval

wocu-check-traffic-1m

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRAFFIC_1M_WARNING_THRESHOLD

_HOSTTRAFFIC_1M_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_IFACES_1M

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IFACES_1M:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_TRAFFIC_1M_WARNING_THRESHOLD

Traffic percent usage warning threshold in nagios format. Ex: 20:80

percent

_TRAFFIC_1M_CRITICAL_THRESHOLD

Traffic percent usage critical threshold in nagios format. Ex: 10:90

percent

COMPLEX MACROS

  • _IFACES_1M

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

descr

Interface name (ifDescr) to be shown as part of the service description

string

index

Interface index

integer

max speed in

Interface maximum speed in {units} per second. Applied to IN traffic. (Values of 0 mean no limit)

integer

max speed out

Interface maximum speed in {units} per second. Applied to OUT traffic. (Values of 0 mean no limit)

integer

units

Speed units (g=gigabits/s, m=megabits/s, k=kilobits/s ,b=bits/s)

string

alias

Interface alias (ifAlias) to be shown as alternative display name

string

warning

Traffic percent usage warning threshold. Leave it blank to use the generic one

percent

critical

Traffic percent usage critical threshold. Leave it blank to use the generic one

percent

Networkdevice-traffic-all

DESCRIPTION


Network device traffic and health checks

../../_images/networkdevice-traffic-all.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Interface_Errors_$KEY$

Checks the number of packets with errors from an interface

networkdevice-traffic-all-errors

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_TRAFFIC_ALL_IFACES

Traffic_$KEY$

Checks the input and output traffic from an interface

networkdevice-traffic-all-traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRAFFIC_WARNING_THRESHOLD

_HOSTTRAFFIC_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_TRAFFIC_ALL_IFACES

Interface_Discards_$KEY$

Checks the discarded packets from an interface

networkdevice-traffic-all-discards

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISCARD_WARNING_THRESHOLD

_HOSTDISCARD_CRITICAL_THRESHOLD

_TRAFFIC_ALL_IFACES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_TRAFFIC_ALL_IFACES:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1,2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_TRAFFIC_WARNING_THRESHOLD

Traffic percent usage warning threshold in nagios format. Ex: 20:80

percent

_TRAFFIC_CRITICAL_THRESHOLD

Traffic percent usage critical threshold in nagios format. Ex: 10:90

percent

_DISCARD_WARNING_THRESHOLD

Interface discards warning threshold (packets/s)

integer

_DISCARD_CRITICAL_THRESHOLD

Interface discards critical threshold (packets/s)

integer

_ERROR_WARNING_THRESHOLD

Interface errors warning threshold (packets/s)

integer

_ERROR_CRITICAL_THRESHOLD

Interface errors critical threshold (packets/s)

integer

COMPLEX MACROS

  • _TRAFFIC_ALL_IFACES

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

descr

Interface name (ifDescr) to be shown as part of the service description

string

index

Interface index (unique)

integer

max speed in

Interface maximum speed in {units} per second. Applied to IN traffic. (Values of 0 mean no limit)

integer

max speed out

Interface maximum speed in {units} per second. Applied to OUT traffic. (Values of 0 mean no limit)

integer

units

Speed units (g=gigabits/s, m=megabits/s, k=kilobits/s ,b=bits/s)

string

alias

Interface alias (ifAlias) to be shown as alternative display name

string

warning

Traffic percent usage warning threshold. Leave it blank to use the generic one

percent

critical

Traffic percent usage critical threshold. Leave it blank to use the generic one

percent

Networkdevice-traffic-all-1m

DESCRIPTION


Network device traffic and health checks. Check interval 1 minute

../../_images/networkdevice-traffic-all-1m.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Interface_Errors_1m_$KEY$

Checks the number of packets with errors from an interface. 1 minute check interval

networkdevice-traffic-all-errors-1m

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_TRAFFIC_ALL_IFACES_1M

Traffic_1m_$KEY$

Checks the input and output traffic from an interface. 1 minute check interval

networkdevice-traffic-all-traffic-1m

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRAFFIC_WARNING_THRESHOLD

_HOSTTRAFFIC_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_TRAFFIC_ALL_IFACES_1M

Interface_Discards_1m_$KEY$

Checks the discarded packets from an interface. 1 minute check interval

networkdevice-traffic-all-discards-1m

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISCARD_WARNING_THRESHOLD

_HOSTDISCARD_CRITICAL_THRESHOLD

_TRAFFIC_ALL_IFACES_1M

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_TRAFFIC_ALL_IFACES_1M:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_TRAFFIC_WARNING_THRESHOLD

Traffic percent usage warning threshold in nagios format. Ex: 20:80

percent

_TRAFFIC_CRITICAL_THRESHOLD

Traffic percent usage critical threshold in nagios format. Ex: 10:90

percent

_DISCARD_WARNING_THRESHOLD

Interface discards warning threshold (packets/s)

integer

_DISCARD_CRITICAL_THRESHOLD

Interface discards critical threshold (packets/s)

integer

_ERROR_WARNING_THRESHOLD

Interface errors warning threshold (packets/s)

integer

_ERROR_CRITICAL_THRESHOLD

Interface errors critical threshold (packets/s)

integer

COMPLEX MACROS

  • _TRAFFIC_ALL_IFACES_1M

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

descr

Interface name (ifDescr) to be shown as part of the service description

string

index

Interface index (unique)

integer

max speed in

Interface maximum speed in {units} per second. Applied to IN traffic. (Values of 0 mean no limit)

integer

max speed out

Interface maximum speed in {units} per second. Applied to OUT traffic. (Values of 0 mean no limit)

integer

units

Speed units (g=gigabits/s, m=megabits/s, k=kilobits/s ,b=bits/s)

string

alias

Interface alias (ifAlias) to be shown as alternative display name

string

warning

Traffic percent usage warning threshold. Leave it blank to use the generic one

percent

critical

Traffic percent usage critical threshold. Leave it blank to use the generic one

percent

Networkdevice-traffic-byname

DESCRIPTION


Network device traffic checks using the interface name

../../_images/networkdevice-traffic-byname.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Traffic_$KEY$_byname

Checks the input and output traffic from an interface identified by its name

wocu-check-traffic-byname

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRAFFIC_WARNING_THRESHOLD

_HOSTTRAFFIC_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_IFACES_BYNAME

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IFACES_BYNAME:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_TRAFFIC_WARNING_THRESHOLD

Traffic percent usage warning threshold in nagios format. Ex: 20:80

percent

_TRAFFIC_CRITICAL_THRESHOLD

Traffic percent usage critical threshold in nagios format. Ex: 10:90

percent

COMPLEX MACROS

  • _IFACES_BYNAME

    • Description: List of interfaces to be checked, indexed by ifName instead of by ifIndex

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

name

Display name to be shown as part of the service description

string

descr

Interface name (unique)

string

max speed in

Interface maximum speed in {units} per second. Applied to IN traffic. (Values of 0 mean no limit)

integer

max speed out

Interface maximum speed in {units} per second. Applied to OUT traffic. (Values of 0 mean no limit)

integer

units

Speed units (g=gigabits/s, m=megabits/s, k=kilobits/s ,b=bits/s)

string

warning

Traffic percent usage warning threshold. Leave it blank to use the generic one

percent

critical

Traffic percent usage critical threshold. Leave it blank to use the generic one

percent

Networkdevice-traffic-cumulative

DESCRIPTION


Adds up the traffic that passed through a selected interface during current day, week, month or year. NOTE: networkdevice-traffic pack must be configured as well

../../_images/networkdevice-traffic-cumulative.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Traffic_cum_$KEY$

Adds up the I/O traffic from an interface during current day/week/month/year

wocu-check-traffic-cum

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_IFACES_CUM

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IFACES_CUM:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -s $_SNMPVERSION$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_INFLUXDB_HOST

InfluxDB IP Address. Default: localhost

string

_INFLUXDB_PORT

InfluxDB Port. Default: 8086

integer

_INFLUXDB_USER

InfluxDB username

string

_INFLUXDB_PASS

InfluxDB password

string

_INFLUXDB_SERIES

InfluxDB data series. Should be the WOCU realm name where the monitorized host belongs

string

COMPLEX MACROS

  • _IFACES_CUM

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

display_name

Display name to be shown as part of the service description. Must be unique

string

index

Interface index (unique)

integer

time_period

Adds up traffic from current day, week, month or year

string

units

Threshold units

string

warning

Cumulated traffic warning threshold

integer

critical

Cumulated traffic critical threshold

integer

check_interval

Check interval used by pack/service that is generating the traffic metric (in minutes). Default: 5 minutes

integer

Networkdevice-traffic-health

DESCRIPTION


Network device interfaces health. Subinterfaces not supported in Cisco devices

../../_images/networkdevice-traffic-health.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Interface_Errors_$KEY$

Checks the number of packets with errors from an interface

check_traffic_health_errors

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_IFACES_HEALTH

Interface_Discards_$KEY$

Checks the discarded packets from an interface

check_traffic_health_discards

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISCARD_WARNING_THRESHOLD

_HOSTDISCARD_CRITICAL_THRESHOLD

_IFACES_HEALTH

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_IFACES_HEALTH:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –short –exclude_nophysical_ifaces –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_DEVICEVENDOR

Device vendor

string

_DISCARD_WARNING_THRESHOLD

Interface discards warning threshold (packets/s)

integer

_DISCARD_CRITICAL_THRESHOLD

Interface discards critical threshold (packets/s)

integer

_ERROR_WARNING_THRESHOLD

Interface errors warning threshold (packets/s)

integer

_ERROR_CRITICAL_THRESHOLD

Interface errors critical threshold (packets/s)

integer

COMPLEX MACROS

  • _IFACES_HEALTH

    • Description: List of interfaces to be checked (Errors/Discards) (indexed by ifName). Don’t include subinterfaces

    • Discover: wocu-discover-ifaces-ng.py


Fields

Description

Type

display name

Display name to be shown as part of the service description

string

descr

Interface name (Ifdescr) (unique)

string

index

Interface index (unique)

integer

Networkdevice-traffic-sum

DESCRIPTION


This pack shows the summarized traffic (in/out) from all (or selected) interfaces

../../_images/networkdevice-traffic-sum.png

This pack allows you to calculate the addition of traffic from selected interfaces. You can filter interfaces via regexp

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Traffic_Interfaces_Sum

Summarized traffic in/out

check_interface_usage_sum

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPCONTEXT

_HOSTTRAFFIC_SUM_IFACES_REGEXP

_HOSTTRAFFIC_SUM_WARNING

_HOSTTRAFFIC_SUM_CRITICAL

_HOSTTRAFFIC_UNIT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_TRAFFIC_SUM_IFACES_REGEXP

Regular expression to match selected interface names, e.g. Ethernet. Leave blank if you want all interfaces. You must double $ characters in your regexp

string

_TRAFFIC_SUM_WARNING

Input/Output summarized traffic warning threshold

integer

_TRAFFIC_SUM_CRITICAL

Input/Output summarized traffic critical threshold

integer

_TRAFFIC_UNIT

Traffic unit (per second)

string

Nqa-huawei

DESCRIPTION


Check for the NQA values (Jitter/RTT/PacketLoss) in Huawei devices

../../_images/nqa-huawei.png

Check for NQA values (Jitter/RTT/Packet Loss) in Huawei devices using SNMP

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

NQA_RTT_$KEY$

Checks the RTT (Round Trip Time) from a Huawei NQA (Network Quality Analysis). It shows the max from last 5 values

check_huawei_nqa_rtt

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST

NQA_Jitter_$KEY$

Checks the quality metrics from a Huawei NQA (Network Quality Analysis). It shows the max from last 5 values

check_huawei_nqa_jitter

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST

NQA_Packet_loss_$KEY$

Checks the packet loss metric from a Huawei NQA (Network Quality Analysis). It shows the max from last 5 values

check_huawei_nqa_packet_loss

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_NQA_LIST:

wocu-discover-huawei-nqa.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _NQA_LIST

    • Description: List of NQA rules to be checked

    • Discover: wocu-discover-huawei-nqa.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

NQA Session OID suffix used in snmp querys

string

name

Name of NQA Session

string

jitter_warning

Jitter warning threshold for the NQA Session (milliseconds)

integer

jitter_critical

Jitter critical threshold for the NQA Session (milliseconds)

integer

packet_loss_warning

Packet Loss warning threshold for the NQA Session (percentage)

percent

packet_loss_critical

Packet Loss critical threshold for the NQA Session (percentage)

percent

rtt_warning

RTT warning threshold for the NQA Session (milliseconds)

integer

rtt_critical

RTT critical threshold for the NQA Session (milliseconds)

integer

Nqa-huawei-1m

DESCRIPTION


Check for the NQA values (Jitter/RTT/PacketLoss) in Huawei devices. Check interval: 1 minute

../../_images/nqa-huawei-1m.png

Check for NQA values (Jitter/RTT/Packet Loss) in Huawei devices using SNMP. Check interval: 1 minute

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

NQA_RTT_1m_$KEY$

Checks the RTT (Round Trip Time) from a Huawei NQA (Network Quality Analysis). 1 minute check interval

check_huawei_nqa_rtt

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST_1M

NQA_Jitter_1m_$KEY$

Checks the quality metrics from a Huawei NQA (Network Quality Analysis). 1 minute check interval

check_huawei_nqa_jitter

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST_1M

NQA_Packet_loss_1m_$KEY$

Checks the packet loss metric from a Huawei NQA (Network Quality Analysis). 1 minute check interval

check_huawei_nqa_packet_loss

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_LIST_1M

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_NQA_LIST_1M:

wocu-discover-huawei-nqa.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _NQA_LIST_1M

    • Description: List of NQA rules to be checked every minute

    • Discover: wocu-discover-huawei-nqa.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

NQA Session OID suffix used in snmp querys

string

name

Name of NQA Session

string

jitter_warning

Jitter warning threshold for the NQA Session (milliseconds)

integer

jitter_critical

Jitter critical threshold for the NQA Session (milliseconds)

integer

packet_loss_warning

Packet Loss warning threshold for the NQA Session (percentage)

percent

packet_loss_critical

Packet Loss critical threshold for the NQA Session (percentage)

percent

rtt_warning

RTT warning threshold for the NQA Session (milliseconds)

integer

rtt_critical

RTT critical threshold for the NQA Session (milliseconds)

integer

Nqa-huawei-icmp

DESCRIPTION


Check for NQA ICMP type tests metrics (RTT/PacketLoss) in Huawei devices

../../_images/nqa-huawei-icmp.png

Check for NQA ICMP type test stats (RTT/Packet Loss) in Huawei devices using SNMP

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

NQA_ICMP_RTT_$KEY$

Checks the RTT (Round Trip Time) from an ICMP type Huawei NQA (Network Quality Analysis)

check_huawei_nqa_icmp_rtt

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_ICMP_LIST

NQA_ICMP_Packet_loss_$KEY$

Checks the packet loss metric from an ICMP type Huawei NQA (Network Quality Analysis)

check_huawei_nqa_icmp_packet_loss

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_NQA_ICMP_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_NQA_ICMP_LIST:

wocu-discover-huawei-nqa-icmp.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _NQA_ICMP_LIST

    • Description: List of NQA ICMP rules to be checked

    • Discover: wocu-discover-huawei-nqa-icmp.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

owner

NQA Test Owner name

string

name

NQA Test name

string

type

NQA Test type

string

oid_suffix

NQA Test identification OID suffix

string

packet_loss_warning

Packet Loss warning threshold for the NQA Session (percentage)

float.percent

packet_loss_critical

Packet Loss critical threshold for the NQA Session (percentage)

float.percent

rtt_warning

RTT warning threshold for the NQA Session (milliseconds)

integer

rtt_critical

RTT critical threshold for the NQA Session (milliseconds)

integer

Nsm-teldat

DESCRIPTION


Check for the NSM values (Jitter/RTT/PacketLoss) in Teldat devices

../../_images/nsm-teldat.png

Check for the NSM values (Jitter/RTT/PacketLoss) in Teldat devices

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

NSM_$KEY$

Checks the quality metrics from a Teldat NSM (Network Service Monitor)

check_nsm_teldat

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_NSM_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_NSM_LIST:

wocu-discover-teldat-nsm.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP version, supported 1 and 2c

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _NSM_LIST

    • Description: List of NSM rules to be checked

    • Discover: wocu-discover-teldat-nsm.py


Fields

Description

Type

display name

Display name to be shown as part of the service description

string

index

Index for snmp queries

integer

jitter_critical

Critical threshold for the NSM jitter (milliseconds)

integer

jitter_warning

Warning threshold for the NSM jitter (milliseconds)

integer

percent_loss_critical

Critical threshold for the NSM packet_loss (percentage)

percent

name

Name to be shown in the web interface

string

percent_loss_warning

Warning threshold for the NSM packet_loss (percentage)

percent

rtt_critical

Critical threshold for NSM rtt (milliseconds)

integer

rtt_warning

Warning threshold for NSM rtt (milliseconds)

integer

Ppa-oneaccess

DESCRIPTION


Check for the PPA session values (Jitter/RTT/PacketLoss) in OneAccess devices

../../_images/ppa-oneaccess.png

Check for PPA session stats (Jitter/RTT/Packet Loss) in OneAccess devices using SNMP

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

PPA_Jitter_$KEY$

Checks the quality metrics from a OneAccess PPA session

check_oneaccess_ppa_jitter

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_PPA_LIST

PPA_Packet_loss_$KEY$

Checks the packet loss from a OneAccess PPA session

check_oneaccess_ppa_packet_loss

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_PPA_LIST

PPA_RTT_$KEY$

Checks the RTT from a OneAccess PPA session

check_oneaccess_ppa_rtt

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_PPA_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_PPA_LIST:

wocu-discover-oneaccess-ppa.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _PPA_LIST

    • Description: List of PPA sessions to be checked

    • Discover: wocu-discover-oneaccess-ppa.py


Fields

Description

Type

display_name

Name to be shown as Service Description in the web interface

string

index

Index of PPA Session (integer)

integer

jitter_warning

Jitter warning threshold for the PPA Session (milliseconds)

integer

jitter_critical

Jitter critical threshold for the PPA Session (milliseconds)

integer

packet_loss_warning

Packet Loss warning threshold for the PPA Session (percentage)

percent

packet_loss_critical

Packet Loss critical threshold for the PPA Session (percentage)

percent

rtt_warning

RTT warning threshold for the PPA Session (milliseconds)

integer

rtt_critical

RTT critical threshold for the PPA Session (milliseconds)

integer

Qos

DESCRIPTION


Checks the QoS classes configured on a network device. Support for Cisco, Juniper, Teldat and OneAccess devices. _DEVICEVENDOR must be configured and applied before discovering QoS classes

../../_images/qos.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

$KEY$

Checks the QoS class traffic and drop packets

check_qos

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_QOSLIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_QOSLIST:

wocu-discover-qos.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –vendor $_DEVICEVENDOR$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor. Must be configured and applied before discovering QoS classes

string

COMPLEX MACROS

  • _QOSLIST

    • Description: List of QoS configured on the network devices. _DEVICEVENDOR must be configured and applied before discovering QoS classes

    • Discover: wocu-discover-qos.py


Fields

Description

Type

Display Name

Display name to be shown as part of the service description

string

ifName

ifName for snmp queries

string

ifIndex

ifIndex for snmp queries

integer

Queue Number

Numeric value of the QoS Queue (ex: 2 instead of Silver)

integer

TX Warning

TX Warning Threshold (bps)

integer

TX Critical

TX Critical Threshold (bps)

integer

Drops Warning

Drops Warning Threshold (bps)

integer

Drops Critical

Drops Critical Threshold (bps)

integer

Qos-cisco

DESCRIPTION


Checks for the QOS status configured on Cisco routers

../../_images/qos-cisco.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

QOS_$KEY$

Checks the QoS class traffic and drop packets for Cisco Devices

check_qos_cisco

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTQOS_WARNING_THRESHOLD

_HOSTQOS_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_QOS_CLASSES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_QOS_CLASSES:

wocu-discover-qos-cisco.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_QOS_WARNING_THRESHOLD

QOS warning limits

integer

_QOS_CRITICAL_THRESHOLD

QOS critical limits

integer

COMPLEX MACROS

  • _QOS_CLASSES

    • Description: QOS classes(cisco)

    • Discover: wocu-discover-qos-cisco.py


Fields

Description

Type

Display Name

Custom Name appearing in the service: QOS_<Display Name>

string

QOS Name

QOS snmp class name (configured on remote device)

string

Qos-huawei

DESCRIPTION


Checks QoS Classes rates in Huawei devices

../../_images/qos-huawei.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

QoS - $KEY$

Checks the traffic, discards and drops rates in Huawei QoS Classes

qos-huawei-rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_QOS_HUAWEI_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_QOS_HUAWEI_LIST:

wocu-discover-huawei-qos.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _QOS_HUAWEI_LIST

    • Description: List of QoS Classes

    • Discover: wocu-discover-huawei-qos.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

OID Suffix used in snmp queries

string

qos_index

QoS class index used in snmp queries

string

tx_warning

QoS Class TX warning threshold (bps)

integer

tx_critical

QoS Class TX rate critical threshold (bps)

integer

drops_warning

QoS Class Drops rate warning threshold (bps)

integer

drops_critical

QoS Class Drops rate critical threshold (bps)

integer

discards_warning

QoS Class enqueue discards rate warning threshold (bps)

integer

discards_critical

QoS Class enqueue discards rate critical threshold (bps)

integer

Rpm-juniper

DESCRIPTION


Check for RPM tests metrics (RTT/Jitter/PacketLoss) in Juniper devices

../../_images/rpm-juniper.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

RPM_RTT_$KEY$

Checks Juniper RPM (Real-Time Performance Monitoring) probe Round Trip Time

check_juniper_rpm_rtt

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_RPM_LIST

RPM_Jitter_$KEY$

Checks Juniper RPM (Real-Time Performance Monitoring) probe jitter

check_juniper_rpm_jitter

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_RPM_LIST

RPM_Lost_Percent_$KEY$

Checks Juniper RPM (Real-Time Performance Monitoring) probe lost packets percent

check_juniper_rpm_loss_percent

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_RPM_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_RPM_LIST:

wocu-discover-juniper-rpm.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _RPM_LIST

    • Description: List of RPM probes to be checked

    • Discover: wocu-discover-juniper-rpm.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

owner

RPM Test Owner name

string

name

RPM Test name

string

oid_suffix

RPM Test identification OID suffix

string

loss_percent_warning

Loss warning threshold for the RPM Session (percentage)

percent

loss_percent_critical

Loss critical threshold for the RPM Session (percentage)

percent

rtt_warning

RTT warning threshold for the RPM Session (milliseconds)

integer

rtt_critical

RTT critical threshold for the RPM Session (milliseconds)

integer

jitter_warning

Jitter warning threshold for the RPM Session in milliseconds. Will compare with Jitter absolute value

integer

jitter_critical

Jitter critical threshold for the RPM Session in milliseconds. Will compare with Jitter absolute value

integer

Snmp-diff-inventory

DESCRIPTION


Checks for changes in sysName, serials, etc.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Snmp Diff Inventory - sysName

Checks for changes in sysName

check_diff_inventory_sysname

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Snmp Diff Inventory - $KEY$

Checks for changes in specific OID

check_diff_inventory_oid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_DIFF_INVENTORY_OID_LIST

Snmp Diff Inventory - serial

Checks for changes in chassis and backplane serial numbers

check_diff_inventory_serial

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _DIFF_INVENTORY_OID_LIST

    • Description: List of custom OIDs to check


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid

OID to check

string

Snmp-generic

DESCRIPTION


Nagios official pack to check user defined SNMP oids

../../_images/snmp-generic.png

Generic pack to check OIDs not included in any other pack. This pack is related to snmp-oid pack

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SNMP_$KEY$

Checks the custom configured OID

check_snmp_generic_oid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPPORT

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SNMP_OIDS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPPORT

Device SNMP UDP Port (Default is 161)

integer

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _SNMP_OIDS

    • Description: List of SNMP oids to overwatch


Fields

Description

Type

name

Display name to be shown as part of the service description

string

oid

SNMP oid to monitor

string

warning

SNMP oid warning threshold. Please note that it will alarm above the threshold fixed. Examples: 10, 10:, :10, 10:20, @10:20

string

critical

SNMP oid critical threshold. Please note that it will alarm above the threshold fixed. Examples: 10, 10:, :10, 10:20, @10:20

string

Snmp-generic-1m

DESCRIPTION


Nagios official pack to check user defined SNMP oids. Check interval: 1 minute

../../_images/snmp-generic-1m.png

Generic pack to check OIDs not included in any other pack. This pack is related to snmp-oid-1m pack

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SNMP_1m_$KEY$

Checks the custom configured OID with 1 minute check interval

check_snmp_generic_1m_oid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SNMP_OIDS_1M

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _SNMP_OIDS_1M

    • Description: List of SNMP oids to overwatch


Fields

Description

Type

name

Display name to be shown as part of the service description

string

oid

SNMP oid to monitor

string

warning

SNMP oid warning threshold

string

critical

SNMP oid critical threshold

string

Snmp-generic-advanced

DESCRIPTION


Improved Nagios pack to check user defined SNMP oids. Supported OID types: counter, rate, string and regex

../../_images/snmp-generic-advanced.png

More info about thresholds and ranges in: https://nagios-plugins.org/doc/guidelines.html#THRESHOLDFORMAT

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SNMP_Advanced_$KEY$

Compare configured snmp OID reply with thresholds, string or regex

check_snmp_generic_advanced_oid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SNMP_OIDS_ADVANCED

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The snmp community read configured on remote device

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _SNMP_OIDS_ADVANCED

    • Description: List of SNMP oids to check


Fields

Description

Type

name

Display name to be shown as part of the service description

string

oid

SNMP oid to monitor

string

type

OID type

string

warning

Warning threshold. Format: [@]start:end. Examples: 10, 10:, :10, 10:20, @10:20

string

critical

Critical threshold. Format: [@]start:end. Examples: 10, 10:, :10, 10:20, @10:20

string

string/regex

String or regex to compare with snmp reply

string

unit

Units label for output and perfdata

string

label

Label for output and perfdata. Must be unique

string

Snmp-oid

DESCRIPTION


Custom pack to check user defined SNMP oids

../../_images/snmp-oid.png

Generic pack to check OIDs not included in any other pack. This pack is related to snmp-generic pack

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SNMP_$KEY$

Checks the custom configured OID

check_snmp_oid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_SNMP_OID_OIDS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

SNMP version of the server (allowed 1, 2c and 3)

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

COMPLEX MACROS

  • _SNMP_OID_OIDS

    • Description: List of SNMP oids to overwatch


Fields

Description

Type

name

Display name to be shown as part of the service description

string

oid

SNMP oid to monitor

string

min_warning

Bottom warning threshold

integer

min_critical

Bottom critical threshold

integer

max_warning

Top warning threshold

integer

max_critical

Top critical threshold

integer

Snmp-oid-1m

DESCRIPTION


Custom pack to check user defined SNMP oids. Check interval: 1 minute

../../_images/snmp-oid-1m.png

Generic pack to check OIDs not included in any other pack. This pack is related to snmp-generic-1m pack

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SNMP_1m_$KEY$

Checks the custom configured OID with 1 minute check interval

check_snmp_oid_1m

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_SNMP_OID_OIDS_1M

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

SNMP version of the server (allowed 1 and 2c)

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

COMPLEX MACROS

  • _SNMP_OID_OIDS_1M

    • Description: List of SNMP oids to overwatch


Fields

Description

Type

name

Display name to be shown as part of the service description

string

oid

SNMP oid to monitor

string

min_warning

Bottom warning threshold

integer

min_critical

Bottom critical threshold

integer

max_warning

Top warning threshold

integer

max_critical

Top critical threshold

integer

Squid

DESCRIPTION


Checks metrics from Squid proxy servers. Tested on Squid 3.3

../../_images/squid.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Squid Cache Stats

Shows Cache stats and checks memory and swap usage

check_squid_cache

_HOSTSQUID_PORT

_HOSTSTORAGE_SWAP_USED_WARNING

_HOSTSTORAGE_SWAP_USED_CRITICAL

_HOSTSTORAGE_MEM_USED_WARNING

_HOSTSTORAGE_MEM_USED_CRITICAL

Squid Memory

Checks Squid Memory usage

check_squid_mem

_HOSTSQUID_PORT

_HOSTSQUID_MEM_WARNING

_HOSTSQUID_MEM_CRITICAL

Squid ICP Stats

Shows ICP stats and checks queued messages

check_squid_icp

_HOSTSQUID_PORT

_HOSTICP_QUEUED_WARNING

_HOSTICP_QUEUED_CRITICAL

Squid HTTP Stats

Shows HTTP stats and checks failure ratio

check_squid_http

_HOSTSQUID_PORT

_HOSTHTTP_FAILURE_RATIO_WARNING

_HOSTHTTP_FAILURE_RATIO_CRITICAL

Squid Median service times

Shows median services times

check_squid_median

_HOSTSQUID_PORT

Squid Uptime

Checks Squid uptime

check_squid_uptime

_HOSTSQUID_PORT

_HOSTSQUID_UPTIME_WARNING

_HOSTSQUID_UPTIME_CRITICAL

Squid CPU

Checks Squid CPU usage

check_squid_cpu

_HOSTSQUID_PORT

_HOSTSQUID_CPU_WARNING

_HOSTSQUID_CPU_CRITICAL

Squid Clients

Checks connected clients

check_squid_clients

_HOSTSQUID_PORT

_HOSTCLIENTS_WARNING

_HOSTCLIENTS_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SQUID_PORT

TCP port where Squid is listening to (default 3128)

integer

_CLIENTS_WARNING

Connected clients warning threshold

integer

_CLIENTS_CRITICAL

Connected clients critical threshold

integer

_HTTP_FAILURE_RATIO_WARNING

Http requests failure ratio warning threshold

integer

_HTTP_FAILURE_RATIO_CRITICAL

Http requests failure ratio critical threshold

integer

_ICP_QUEUED_WARNING

Queued ICP messages warning threshold

integer

_ICP_QUEUED_CRITICAL

Queued ICP messages critical threshold

integer

_STORAGE_SWAP_USED_WARNING

Storage SWAP used percent warning threshold (percent)

percent

_STORAGE_SWAP_USED_CRITICAL

Storage SWAP used percent critical threshold (percent)

percent

_STORAGE_MEM_USED_WARNING

Storage Memory used percent warning threshold (percent)

percent

_STORAGE_MEM_USED_CRITICAL

Storage Memory used percent critical threshold (percent)

percent

_SQUID_UPTIME_WARNING

Squid Uptime warning threshold (seconds)

integer

_SQUID_UPTIME_CRITICAL

Squid uptime critical threshold (seconds)

integer

_SQUID_CPU_WARNING

Squid CPU usage warning threshold (percent)

percent

_SQUID_CPU_CRITICAL

Squid CPU usage critical threshold (percent)

percent

_SQUID_MEM_WARNING

Squid Memory usage warning threshold (percent)

percent

_SQUID_MEM_CRITICAL

Squid Memory usage critical threshold (percent)

percent

Tcp-generic

DESCRIPTION


List of TCP ports to check

../../_images/tcp-generic.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

TCP_$KEY$

Checks TCP port connectivity

check_tcp

_TCP_PORTS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_TCP_PORTS:

wocu-discover-tcp-ports.py $HOSTADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

COMPLEX MACROS

  • _TCP_PORTS

    • Description: List of TCP ports to overwatch

    • Discover: wocu-discover-tcp-ports.py


Fields

Description

Type

name

Display name to be shown as part of the service description

string

port

TCP port to monitor

integer

Traps-snmp

DESCRIPTION


Checks for the received traps via NSCA module

../../_images/traps-snmp.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

TRAPs

check_dummy_traps

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

Umts-generic

DESCRIPTION


Health and info checks for 3G/4G routers. WARNING: Obsoleted by networkdevice-mobile-signal

../../_images/umts-generic.png

Health and info checks for 3G/4G routers. WARNING: Obsoleted by networkdevice-mobile-signal. Supported vendors: Cisco and Teldat

Use instructions:

  • Fill the macro fields manually for every router instance
    • Critical and Warning BAND thresholds must be an integer from 1 to 12: unknown(1),invalid(2),none(3),gsm850(4),gsm900(5),gsm1800(6),gsm1900(7),

wcdma800(8),wcdma850(9),wcdma1900(10),twcdma2100(11),lteband(12)

-Critical and Warning RSSI(Coverage Area Quality) thresholds must be an integer from - 65535 to 0 dBm: Excellent(-10 to - 70), Good(-71 to - 80), Fair(-81 to - 85), Weak(-86 to - 95), Very Weak(-96 to - 110),Negligible(-111 and lower), No Signal(-125 or - 65535 or 0) -Critical and Warning EC / IO or RSRQ(Signal Quality) thresholds must be an integer from - 65535 to 0 dB: EC / IO Excellent(0 to - 1), Good(-1 to - 6), Marginal(-6 to - 9),Poor / Unacceptable(-9 + ).RSRQ >= -10 dB(Excellent), -10 dB to - 15 dB(Good), -15 dB to - 20 dB(Fair to poor), <= -20 dB(No signal)

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

3G_info$KEY$

Shows 3G/4G connection information

3g-info

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_3GLIST

3G_health$KEY$

Checks the quality metrics from a 3G/4G connection

3g-health

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_3GLIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _3GLIST

    • Description: List of parameters and thresholds for router instances


Fields

Description

Type

display name

Name to be shown in the web interface

string

index

Index for snmp queries

integer

critical band

GPRS/UMTS/LTE band to which the modem is attached critical threshold (1 to 12). See pack extended description for details

integer

warning band

GPRS/UMTS/LTE band to which the modem is attached warning threshold (1 to 12). See pack extended description for details

integer

critical rssi

RSSI (Coverage Area Quality) Critical threshold

integer

warning rssi

RSSI (Coverage Area Quality) Warning threshold

integer

critical EcIo

EC/IO (3G) or RSRQ (4G) - Signal Quality Critical threshold

integer

warning EcIo

EC/IO (3G) or RSRQ (4G) - Signal Quality Warning threshold

integer

Vrrp-generic

DESCRIPTION


Check for the VRRP configured interfaces on Generic routers

../../_images/vrrp-generic.png

VRRP interfaces checks per Device

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

VRRP - $KEY$

Checks VRRP (Virtual Router Redundancy Protocol) interface state

check_vrrp_interface

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_VRRP_INTERFACES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_VRRP_INTERFACES:

wocu-discover-vrrp-interfaces.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community (only snmp v2)

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPVERSION

Device SNMP version, supported 1 and 2c

string

COMPLEX MACROS

  • _VRRP_INTERFACES

    • Description: VRRP interfaces (list)

    • Discover: wocu-discover-vrrp-interfaces.py


Fields

Description

Type

Display Name

Custom Name appearing in the service: VRRP_<Virtual IP>

string

Virtual IP

VRRP Virtual IP (configured on remote device)

string

ifIndex

VRRP interface index (ifindex configured on remote device)

integer

Group

VRRP group (configured on remote device)

integer

State

VRRP state (to be checked on remote device)

string

Storage

3par

DESCRIPTION


Health checks for HP 3PAR devices

../../_images/3par.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

3par-nl-capacity

Checks 3Par near line capacity information.

check_3par_nl_capacity

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCAPACITY_WARNING

_HOSTCAPACITY_CRITICAL

3PAR - Physical Disks

Checks the Physical Disks state

check_3par_physical_disks

_HOSTUSER

_HOSTPASSWORD

3par-volume-status-$KEY$

Checks 3Par volume status information.

check_3par_volume_status

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_VOLUME_LIST

3par-volume-info-$KEY$

Checks 3Par volume information.

check_3par_volume_info

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_VOLUME_LIST

3par-volume-performance-$KEY$

Checks 3Par volume performance information.

check_3par_volume_performance

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTWLAT_CRIT

_HOSTWLAT_WARN

_HOSTRLAT_CRIT

_HOSTRLAT_WARN

_HOSTWBW_CRIT

_HOSTWBW_WARN

_HOSTRBW_CRIT

_HOSTRBW_WARN

_HOSTWIOPS_CRIT

_HOSTWIOPS_WARN

_HOSTRIOPS_CRIT

_HOSTRIOPS_WARN

_VOLUME_LIST

3PAR - Virtual Volumes

Checks the Virtual Volumes state

check_3par_virtual_volumes

_HOSTUSER

_HOSTPASSWORD

3par-overall-capacity

Checks 3Par overall capacity information.

check_3par_overall_capacity

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCAPACITY_WARNING

_HOSTCAPACITY_CRITICAL

3par-ssd-capacity

Checks 3Par solid state disk capacity information.

check_3par_ssd_capacity

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCAPACITY_WARNING

_HOSTCAPACITY_CRITICAL

3par-fc-capacity

Checks 3Par fiber channel capacity information.

check_3par_fc_capacity

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCAPACITY_WARNING

_HOSTCAPACITY_CRITICAL

3PAR - Nodes

Checks the Nodes state

check_3par_nodes

_HOSTUSER

_HOSTPASSWORD

3par-cpu

Checks 3Par CPU info.

check_3par_cpu

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

3PAR - Alerts

Checks the Alerts

check_3par_alerts

_HOSTUSER

_HOSTPASSWORD

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_VOLUME_LIST:

wocu-discover-3par.py -H $HOSTADDRESS$ -P $_3PAR_API_PORT$ -u $_USER$ -p $_PASSWORD$ –protocol $_3PAR_API_PROTOCOL$ –api-version $_3PAR_API_VERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER

User to use in the check

string

_PASSWORD

Password to use in the check

string

_3PAR_API_PORT

3Par API port

string

_3PAR_API_PROTOCOL

3Par API protocol connection

string

_3PAR_API_VERSION

3Par API version

string

_CAPACITY_WARNING

Volume capacity warning threshold

percent

_CAPACITY_CRITICAL

Volume capacity critical threshold

percent

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_WLAT_CRIT

Write Latency critical threshold (in microseconds)

integer

_WLAT_WARN

Write Latency warning threshold (in microseconds)

integer

_RLAT_CRIT

Read Latency critical threshold (in microseconds)

integer

_RLAT_WARN

Read Latency warning threshold (in microseconds)

integer

_WBW_CRIT

Write bandwidth critical threshold (in Bps)

integer

_WBW_WARN

Write bandwidth warning threshold (in Bps)

integer

_RBW_CRIT

Read bandwidth critical threshold (in Bps)

integer

_RBW_WARN

Read bandwidth warning threshold (in Bps)

integer

_WIOPS_CRIT

Write IOPS critical threshold (in IOPS/s)

integer

_WIOPS_WARN

Write IOPS warning threshold (in IOPS/s)

integer

_RIOPS_CRIT

Read IOPS critical threshold (in IOPS/s)

integer

_RIOPS_WARN

Read IOPS warning threshold (in IOPS/s)

integer

COMPLEX MACROS

  • _VOLUME_LIST

    • Description: List of interfaces to be checked, indexed by ifIndex instead of ifName

    • Discover: wocu-discover-3par.py


Fields

Description

Type

display_name

Interface name to be shown as part of the service description

string

index

Volume index (unique)

integer

capacity_warning_threshold

Capacity warning threshold

percent

capacity_critical_threshold

Capacity critical threshold

percent

Nas-iomega

DESCRIPTION


Check Iomega NAS system, disks, raid and storages

../../_images/nas-iomega.png

Pack for checking the state of Lenovo IOmega NAS devices through snmp v3

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Partition_$KEY$

check_iomega_partition_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSTORAGE_USAGE_WARNING

_HOSTSTORAGE_USAGE_CRITICAL

_PARTITIONS

Info

check_iomega_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

CPU_usage

check_iomega_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCPU_USAGE_WARNING

_HOSTCPU_USAGE_CRITICAL

Raid_status

check_iomega_raid_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Disks_status

check_iomega_disks_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Memory_usage

check_iomega_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_PARTITIONS:

wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_STORAGE_USAGE_WARNING

Warning threshold for each storage usage

percent

_STORAGE_USAGE_CRITICAL

Critical threshold for each storage usage

percent

_CPU_USAGE_WARNING

Warning threshold for CPU usage as percentage

percent

_CPU_USAGE_CRITICAL

Critical threshold for CPU usage as percentage

percent

_MEM_USAGE_WARNING

Warning threshold for Memory usage as percentage

percent

_MEM_USAGE_CRITICAL

Critical threshold for Memory usage as percentage

percent

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

Device SNMP version, supported 1, 2c and 3

string

COMPLEX MACROS

  • _PARTITIONS

    • Description: Disk partitions

    • Discover: wocu-discover-os-resources-partitions.py


Fields

Description

Type

index

Partition index

integer

label

Partition label

string

unit

Letter unit or path

string

Nas-synology

DESCRIPTION


Check Synology NAS system, disks, raid and storages

../../_images/nas-synology.png

Checks for NAS Synology devices.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Upgrade Available

Checks if there is an available upgrade

check_synology_upgrade_available

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

System Fan Status

Checks the status from system fan

check_synology_system_fan_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Info

Shows system information

check_synology_info

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Disks Temperatures

Checks the temperature from disks

check_synology_disks_temperatures

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTDISK_TEMPERATURE_WARNING

_HOSTDISK_TEMPERATURE_CRITICAL

CPU Usage

Checks the CPU usage

check_synology_cpu_usage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTCPU_USAGE_WARNING

_HOSTCPU_USAGE_CRITICAL

CPU Fan Status

Checks the status of CPU fan

check_synology_cpu_fan_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

PowerSupplies Status

Checks the status from power supplies

check_synology_power_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Storage Usage

Checks the storage usage

check_synology_storage_usage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSTORAGE_USAGE_WARNING

_HOSTSTORAGE_USAGE_CRITICAL

Raid Status

Checks the raid status

check_synology_raid_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

System Status

Checks the system status

check_synology_system_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Load Average

Checks the system load average

check_synology_load

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

System Temperature

Checks the temperature from system

check_synology_system_temperature

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSYSTEM_TEMPERATURE_WARNING

_HOSTSYSTEM_TEMPERATURE_CRITICAL

Disks Status

Checks the disks status

check_synology_disks_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Memory Usage

Checks the memory usage

check_synology_mem_usage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

SNMP version

string

_SYSTEM_TEMPERATURE_WARNING

Warning threshold for system temperature (in Celsius degrees)

integer

_SYSTEM_TEMPERATURE_CRITICAL

Critical threshold for system temperature (in Celsius degrees)

integer

_STORAGE_USAGE_WARNING

Global Warning threshold for storage usage

percent

_STORAGE_USAGE_CRITICAL

Global Critical threshold for storage usage

percent

_DISK_TEMPERATURE_WARNING

Warning threshold for all disks temperatures (in Celsius degrees)

integer

_DISK_TEMPERATURE_CRITICAL

Critical threshold for all disks temperatures (in Celsius degrees)

integer

_CPU_USAGE_WARNING

Warning threshold for CPU usage (percentage)

percent

_CPU_USAGE_CRITICAL

Critical threshold for CPU usage (percentage)

percent

_MEM_USAGE_WARNING

Warning threshold for Memory usage as (percentage)

percent

_MEM_USAGE_CRITICAL

Critical threshold for Memory usage as (percentage)

percent

_LOAD_WARNING

Warning threshold for load average in last 15 minutes

integer

_LOAD_CRITICAL

Critical threshold for load average in last 15 minutes

integer

Purestorage

DESCRIPTION


PureStorage specific health and performance checks

../../_images/purestorage.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

PureStorage - Info

Checks PureStorage FlashArray model and Purity version info

check_purestorage_info

_HOSTAPI_TOKEN

PureStorage - Occupancy - FA

Checks PureStorage FlashArray occupancy

check_purestorage_occupancy_fa

_HOSTAPI_TOKEN

PureStorage - Load - FA

Checks PureStorage FlashArray load average percent

check_purestorage_load_fa

_HOSTAPI_TOKEN

_HOSTPRIV_KEYPASS

_HOSTPURE1_API_KEY

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

PureStorage - Performance - Volume $KEY$

Checks PureStorage FlashArray Volume performance

check_purestorage_perf_volume

_HOSTAPI_TOKEN

_HOSTWLAT_CRIT

_HOSTWLAT_WARN

_HOSTRLAT_CRIT

_HOSTRLAT_WARN

_HOSTWBW_CRIT

_HOSTWBW_WARN

_HOSTRBW_CRIT

_HOSTRBW_WARN

_HOSTWIOPS_CRIT

_HOSTWIOPS_WARN

_HOSTRIOPS_CRIT

_HOSTRIOPS_WARN

_PURESTORAGE_VOLUME_LIST

PureStorage - Open Alerts

Checks Open Alerts in PureStorage FlashArray

check_purestorage_alerts

_HOSTAPI_TOKEN

PureStorage - Occupancy - Volume $KEY$

Checks PureStorage FlashArray Volume occupancy

check_purestorage_occupancy_volume

_HOSTAPI_TOKEN

_PURESTORAGE_VOLUME_LIST

PureStorage - Status - $KEY$

Checks status of PureStorage FlashArray HW components

check_purestorage_hw_status

_HOSTAPI_TOKEN

_PURESTORAGE_HW_LIST

PureStorage - Performance - FA

Checks PureStorage FlashArray performance

check_purestorage_perf_fa

_HOSTAPI_TOKEN

_HOSTWLAT_CRIT

_HOSTWLAT_WARN

_HOSTRLAT_CRIT

_HOSTRLAT_WARN

_HOSTWBW_CRIT

_HOSTWBW_WARN

_HOSTRBW_CRIT

_HOSTRBW_WARN

_HOSTWIOPS_CRIT

_HOSTWIOPS_WARN

_HOSTRIOPS_CRIT

_HOSTRIOPS_WARN

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_PURESTORAGE_VOLUME_LIST:

wocu-discover-purestorage-volumes.py -H $HOSTADDRESS$ -at $_API_TOKEN$ –remote $_POLLER_TAG_ADDRESS$

_PURESTORAGE_HW_LIST:

wocu-discover-purestorage-hw.py -H $HOSTADDRESS$ -at $_API_TOKEN$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_API_TOKEN

Autentication token for the API REST call session

string

_PRIV_KEYPASS

Private key passphrase installed in Pure1

string

_PURE1_API_KEY

API key installed in Pure1. Must start with: pure1:apikey:

string

_WLAT_CRIT

Write Latency critical threshold (in milliseconds)

integer

_WLAT_WARN

Write Latency warning threshold (in milliseconds)

integer

_RLAT_CRIT

Read Latency critical threshold (in milliseconds)

integer

_RLAT_WARN

Read Latency warning threshold (in milliseconds)

integer

_WBW_CRIT

Write bandwidth critical threshold (in Bps)

integer

_WBW_WARN

Write bandwidth warning threshold (in Bps)

integer

_RBW_CRIT

Read bandwidth critical threshold (in Bps)

integer

_RBW_WARN

Read bandwidth warning threshold (in Bps)

integer

_WIOPS_CRIT

Write IOPS critical threshold (in IOPS/s)

integer

_WIOPS_WARN

Write IOPS warning threshold (in IOPS/s)

integer

_RIOPS_CRIT

Read IOPS critical threshold (in IOPS/s)

integer

_RIOPS_WARN

Read IOPS warning threshold (in IOPS/s)

integer

_LOAD_CRIT

Array 5 minute avg load percent critical threshold

percent

_LOAD_WARN

Array 5 minute avg load percent warning threshold

percent

COMPLEX MACROS

  • _PURESTORAGE_VOLUME_LIST

    • Description: List of Volumes to be checked

    • Discover: wocu-discover-purestorage-volumes.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

name

Volume name

string

  • _PURESTORAGE_HW_LIST

    • Description: List of Hardware components to be checked

    • Discover: wocu-discover-purestorage-hw.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

name

Hardware component name

string

Qnap

DESCRIPTION


Checks for the QNAP NAS devices

../../_images/qnap.png

Checks for the QNAP NAS devices

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Qnap_cache_disk_status

Checks the status from cache disk

check_qnap_cachediskstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_fans

Checks the fans speed

check_qnap_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTFAN_SPEED_WARNING

_HOSTFAN_SPEED_CRITICAL

Qnap_info

Shows system information

check_qnap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_Temp

Checks the system temperature

check_qnap_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Qnap_lunstatus

Checks the LUN (Logical Unit Number) status

check_qnap_lunstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_power_supply

Checks the power supply status

check_qnap_powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_hdstatus

Checks the hard drive status

check_qnap_hdstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_CPU

Checks the CPU usage

check_qnap_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Qnap_volusage

Checks the volumes usage

check_qnap_volusage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVOL_USAGE_WARNING

_HOSTVOL_USAGE_CRITICAL

Qnap_hdtemp

Checks the hard disk temperature

check_qnap_hdtemp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHDTEMP_WARNING

_HOSTHDTEMP_CRITICAL

Qnap_MEM

Checks the memory usage

check_qnap_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Qnap_volstatus

Checks the status from volumes

check_qnap_volstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_raid_status

Checks the status from raid

check_qnap_raidstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_TEMP_WARNING

System temperature warning threshold (in Celsius)

integer

_TEMP_CRITICAL

System temperature critical threshold (in Celsius)

integer

_HDTEMP_WARNING

HD temperature warning threshold (in Celsius)

integer

_HDTEMP_CRITICAL

HD temperature critical threshold (in Celsius)

integer

_VOL_USAGE_WARNING

Volume usage warning threshold

percent

_VOL_USAGE_CRITICAL

Volume usage critical threshold

percent

_FAN_SPEED_WARNING

Fan speed warning threshold (rpm)

integer

_FAN_SPEED_CRITICAL

Fan speed critical threshold (rpm)

integer

Api

Kibana-node

DESCRIPTION


Custom checks for Kibana services

../../_images/kibana-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

kibana-node-plugins-info

Checks Kibana plugins status information.

check_kibana_node_plugins_info

_HOSTKIBANA_PORT

_HOSTKIBANA_USERNAME

_HOSTKIBANA_PASSWORD

_HOSTKIBANA_HTTP_PROTOCOL

_HOSTKIBANA_APIURL

kibana-node-tcp-port

Checks Kibana host port.

check_kibana_node_tcp_port

_HOSTKIBANA_PORT

kibana-node-version

Checks Kibana version information.

check_kibana_node_version

_HOSTKIBANA_PORT

_HOSTKIBANA_USERNAME

_HOSTKIBANA_PASSWORD

_HOSTKIBANA_HTTP_PROTOCOL

_HOSTKIBANA_APIURL

kibana-node-uptime

Checks Kibana uptime information.

check_kibana_node_uptime

_HOSTKIBANA_PORT

_HOSTKIBANA_USERNAME

_HOSTKIBANA_PASSWORD

_HOSTKIBANA_HTTP_PROTOCOL

_HOSTKIBANA_UPTIME_WARNING

_HOSTKIBANA_UPTIME_CRITICAL

_HOSTKIBANA_APIURL

kibana-node-memory-heap

Checks Kibana Heap Memory information.

check_kibana_node_memory_heap

_HOSTKIBANA_PORT

_HOSTKIBANA_USERNAME

_HOSTKIBANA_PASSWORD

_HOSTKIBANA_HTTP_PROTOCOL

_HOSTKIBANA_MEMHEAP_WARNING

_HOSTKIBANA_MEMHEAP_CRITICAL

_HOSTKIBANA_APIURL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_KIBANA_USERNAME

Username for API auth

string

_KIBANA_PASSWORD

Password for API auth

string

_KIBANA_PORT

Api port for HTTP requests

string

_KIBANA_APIURL

Api url for HTTP requests, usually starts with a / and ends without a /

string

_KIBANA_UPTIME_WARNING

Uptime warning threshold

string

_KIBANA_UPTIME_CRITICAL

Uptime critical threshold

string

_KIBANA_MEMHEAP_WARNING

Heap memory warning threshold

string

_KIBANA_MEMHEAP_CRITICAL

Heap memory critical threshold

string

_KIBANA_HTTP_PROTOCOL

HTTP protocol choice with or without ssl

string

Logstash-node

DESCRIPTION


Custom checks for Logstash services

../../_images/logstash-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

logstash-node-tcp-port

Checks Logstash host port.

check_logstash_node_tcp_port

_HOSTLOGSTASH_PORT

logstash-node-uptime

Checks Logstash uptime information.

check_logstash_node_uptime

_HOSTLOGSTASH_PORT

_HOSTLOGSTASH_USERNAME

_HOSTLOGSTASH_PASSWORD

_HOSTLOGSTASH_HTTP_PROTOCOL

_HOSTLOGSTASH_UPTIME_WARNING

_HOSTLOGSTASH_UPTIME_CRITICAL

logstash-node-status-info

Checks Logstash node status information.

check_logstash_node_status_info

_HOSTLOGSTASH_PORT

_HOSTLOGSTASH_USERNAME

_HOSTLOGSTASH_PASSWORD

_HOSTLOGSTASH_HTTP_PROTOCOL

logstash-node-version

Checks Logstash version information.

check_logstash_node_version

_HOSTLOGSTASH_PORT

_HOSTLOGSTASH_USERNAME

_HOSTLOGSTASH_PASSWORD

_HOSTLOGSTASH_HTTP_PROTOCOL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_LOGSTASH_USERNAME

Username for API auth

string

_LOGSTASH_PASSWORD

Password for API auth

string

_LOGSTASH_PORT

Api port for HTTP requests

string

_LOGSTASH_UPTIME_WARNING

Uptime warning threshold

string

_LOGSTASH_UPTIME_CRITICAL

Uptime critical threshold

string

_LOGSTASH_HTTP_PROTOCOL

HTTP protocol choice with or without ssl

string

Printing

Generic-printer

DESCRIPTION


Checks for the printer status (also consumibles and trays)

../../_images/generic-printer.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

$KEY$

Checks the consumables state

check_printer_consum

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CONSUMLIST

Printer_Pagecount

Checks the page count number

check_printer_pagecount

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

$KEY$

Checks the printer trays status

check_printer_tray

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_TRAYLIST

Printer_Description

Shows the printer description

check_printer_description

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_DEVICEVENDOR:

wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_TRAYLIST:

wocu-discover-printers.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ -t trays –remote $_POLLER_TAG_ADDRESS$

_CONSUMLIST:

wocu-discover-printers.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ -t consum –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_DEVICEVENDOR

Device vendor

string

COMPLEX MACROS

  • _TRAYLIST

    • Description: List of Printer Trays (internal/external/paper)

    • Discover: wocu-discover-printers.py


Fields

Description

Type

Display Name

Name to be shown in the service (web interface)

string

Index

ifIndex for snmp queries (integer)

integer

Name

Real name of the Tray (on device)

string

Warning

Warning percentage for the printer Tray

percent

Critical

Critical percentage for the printer Tray

percent

  • _CONSUMLIST

    • Description: List of Printer supply list (Drum/Toner/etc)

    • Discover: wocu-discover-printers.py


Fields

Description

Type

Display Name

Name to be shown in the service (web interface)

string

Index

ifName for snmp queries

integer

Name

Real name of the Supply (on device)

string

Warning

Warning percentage for the printer Consumable

percent

Critical

Critical percentage for the printer Consumable

percent

Operating System

Docker

DESCRIPTION


Standard Docker checks

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Container_$KEY$_status

Checks Docker container status

check_docker_container_status

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

Container_$KEY$_blkio

Checks Docker container Block I/O Bytes

check_docker_container_blkio

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

Container_$KEY$_network

Checks Docker container Network Usage

check_docker_container_network

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

Container_$KEY$_memory

Checks Docker container Memory usage

check_docker_container_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

dockerd

Checks the Docker daemon

check_docker_daemon

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Container_$KEY$_CPU

Checks Docker container CPU

check_docker_container_cpu

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_CONTAINERS:

wocu-discover-docker-containers.py -H $HOSTADDRESS$ -P $_SSH_PORT$ -u $_SSH_USER$ -p $_SSH_PASSWORD$ -i $_SSH_KEY$ -S $_SSH_KEY_PASSPHRASE$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

Remote user for the SSH service (key interchange with Shinken user must be done )

string

_SSH_PASSWORD

Remote password for the SSH service

string

_SSH_KEY

SSH key

string

_SSH_KEY_PASSPHRASE

SSH passphrase

string

_SSH_PORT

Remote port for the SSH service

integer

COMPLEX MACROS

  • _CONTAINERS

    • Description: List of containers to be checked.

    • Discover: wocu-discover-docker-containers.py


Fields

Description

Type

container_id

Container ID

string

container_name

Container Name

string

container_image

Docker Image

string

Linux-nrpe

DESCRIPTION


Linux host monitoring via NRPE (Nagios remote plugin execution)

../../_images/linux-nrpe.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Zombie procs

Checks the number of Zombie processes

check_nrpe_zombie_procs

_HOSTZOMBIEPROCS_WARN

_HOSTZOMBIEPROCS_CRIT

Total procs

Checks the total number of processes

check_nrpe_total_procs

_HOSTTOTALPROCS_WARN

_HOSTTOTALPROCS_CRIT

Users

Checks the number of users

check_nrpe_users

_HOSTUSERS_WARN

_HOSTUSERS_CRIT

Partition $KEY$

Checks the disk usage

check_nrpe_disk

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_PARTITIONS

Swap

Checks the SWAP usage

check_nrpe_swap

_HOSTSWAP_WARN

_HOSTSWAP_CRIT

Load

Checks the CPU load

check_nrpe_load

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_LOAD_WARN

CPU load warning threshold

string

_LOAD_CRIT

CPU load critical threshold

string

_STORAGE_WARN

Storage warning threshold

string

_STORAGE_CRIT

Storage critical threshold

string

_PARTITIONS

Filesystem partions to monitor, for example /,/var

string

_USERS_WARN

Current users logged warning threshold

integer

_USERS_CRIT

Current users logged critical threshold

integer

_ZOMBIEPROCS_WARN

Zombie processes warning threshold

integer

_ZOMBIEPROCS_CRIT

Zombie processes critical threshold

integer

_TOTALPROCS_WARN

Total processes warning threshold

integer

_TOTALPROCS_CRIT

Total processes critical threshold

integer

_SWAP_WARN

Swap usage warning threshold

string

_SWAP_CRIT

Swap usage critical threshold

string

Linux-snmp

DESCRIPTION


Standard linux checks, like CPU, RAM and disk space. Checks are done by SNMP.

../../_images/linux-snmp.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Cpu

Detect abnormal CPU usage

check_linux_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARN

_HOSTCPU_CRIT

_HOSTSNMPVERSION

TimeSync

Compare system time with time where shinken operate. Both must be synchronized with a ntp source.

check_linux_time

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTNTP_WARN

_HOSTNTP_CRIT

Memory

Check about physical memory space usage.

check_linux_memory

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_HOSTSNMPCOMMUNITY

Linux SNMP - Swap

Check about swap space usage. Too many use of swap space means lacks of memory or memory leaks.

check_linux_snmp_swap

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Linux SNMP - SysDescr

Shows system description

check_linux_snmp_sysdescr

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Linux SNMP - TCP Connections

Check TCP connections table

check_linux_snmp_tcpconn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTCP_CONN_WARN

_HOSTTCP_CONN_CRIT

Disks

Overall disks usage

check_linux_disks

_HOSTSNMPCOMMUNITY

_HOSTSTORAGE_PATH

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSNMP_MSG_MAX_SIZE

_HOSTSNMPVERSION

Load

Detect abnormal CPU usage

check_linux_load

_HOSTSNMPCOMMUNITY

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

_HOSTSNMPVERSION

_HOSTLOAD_THRESHOLD_TYPE

Linux SNMP - Uptime

Check about system uptime

check_linux_snmp_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The read snmp community allowed on the linux server

string

_SNMP_MSG_MAX_SIZE

Maximum size of the snmp messages (in bytes)

integer

_LOAD_WARN

Value for starting warning state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_THRESHOLD_TYPE

Load average threshold type: Choose from absolute number or relative percentage of use. Relative use is based on CPUs number. Formula: % = (load / CPUs number) * 100. Ex: An absolute load of 3 in a system with 3 cores, has a realtive load of 100%

string

_STORAGE_WARN

Warning level threshold for used disk space (percentage)

percent

_STORAGE_CRIT

Critical level threshold for used disk space (percentage)

percent

_CPU_WARN

Warning level for the CPU usage (percentage)

percent

_CPU_CRIT

Critical level for the CPU usage (percentage)

percent

_MEMORY_WARN

Physical memory and swap warning level (percentage)

percent

_MEMORY_CRIT

Physical memory and swap critical level (percentage)

percent

_NTP_WARN

NTP timings warning level (in seconds)

integer

_NTP_CRIT

NTP timings critical level (in seconds)

integer

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_CHKLOG_CONF

absolute path to checklog conf file. Default: /usr/local/shinken/libexec/logFiles_linux.conf

absolute path

_STORAGE_PATH

Absolute path to check its storage

absolute path

_UPTIME_WARN

System uptime warning threshold (in seconds)

integer

_UPTIME_CRIT

System uptime critical threshold (in seconds)

integer

_TCP_CONN_WARN

TCP connections warning threshold (total number)

integer

_TCP_CONN_CRIT

TCP connections critical threshold (total number)

integer

Linux-snmp3

DESCRIPTION


Standard linux checks, like CPU, RAM and disk space. Checks are done by SNMP3.

../../_images/linux-snmp3.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Memory

Check about physical memory space usage.

check_linux_memory_v3

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Disks

Overall disks usage

check_linux_disks_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSTORAGE_PATH

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSNMP_MSG_MAX_SIZE

_HOSTSNMPCONTEXT

TimeSync

Compare system time with time where shinken operate. Both must be synchronized with a ntp source.

check_linux_time_v3

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTNTP_WARN

_HOSTNTP_CRIT

Cpu

Detect abnormal CPU usage

check_linux_cpu_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTCPU_WARN

_HOSTCPU_CRIT

_HOSTSNMPCONTEXT

Load

Detect abnormal CPU usage

check_linux_load_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

_HOSTSNMPCONTEXT

Linux SNMP3 - Swap

Check about swap space usage. Too many use of swap space means lacks of memory or memory leaks.

check_linux_snmp_swap_v3

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Linux SNMP3 - SysDescr

Shows system description

check_linux_snmp_sysdescr_v3

_HOSTSNMPVERSION

_HOSTSNMPCONTEXT

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

Linux SNMP3 - TCP Connections

Check TCP connections table

check_linux_snmp_tcpconn_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTTCP_CONN_WARN

_HOSTTCP_CONN_CRIT

Linux SNMP3 - Uptime

Check about system uptime

check_linux_snmp_uptime_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_SNMP_MSG_MAX_SIZE

Maximum size of the snmp messages (in bytes)

integer

_LOAD_WARN

Value for starting warning state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m,5m,15m

3 comma-separated integer

_STORAGE_WARN

Warning level threshold for used disk space (percentage)

percent

_STORAGE_CRIT

Critical level threshold for used disk space (percentage)

percent

_CPU_WARN

Warning level for the CPU usage (percentage)

percent

_CPU_CRIT

Critical level for the CPU usage (percentage)

percent

_MEMORY_WARN

Physical memory and swap warning level (percentage)

percent

_MEMORY_CRIT

Physical memory and swap critical level (percentage)

percent

_NTP_WARN

NTP timings warning level (in seconds)

integer

_NTP_CRIT

NTP timings critical level (in seconds)

integer

_SNMPVERSION

Device SNMP versions supported are: 3

string

_CHKLOG_CONF

absolute path to checklog conf file. Default: /usr/local/shinken/libexec/logFiles_linux.conf

absolute path

_STORAGE_PATH

Absolute path to check its storage

absolute path

_UPTIME_WARN

System uptime warning threshold (in seconds)

integer

_UPTIME_CRIT

System uptime critical threshold (in seconds)

integer

_TCP_CONN_WARN

TCP connections warning threshold (total number)

integer

_TCP_CONN_CRIT

TCP connections critical threshold (total number)

integer

Linux-ssh

DESCRIPTION


Standard linux checks, like CPU, RAM and disk space. Checks are done by SSH.

../../_images/linux-ssh.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Memory

Checks the memory usage

check_ssh_linux_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

NFS Stats

Checks the NFS (Network File System) statistics

check_ssh_linux_nfs_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

NET Stats

Checks the network statistics

check_ssh_linux_net_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Load Average

Checks the system load average

check_ssh_linux_load_average

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

Disks

Checks the disk usage

check_ssh_linux_disks

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTSTORAGE_UNIT

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSTORAGE_MOUNTS

Kernel Stats

Checks the Kernel statistics

check_ssh_linux_kernel_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

TCP States

Checks the states from TCP connection table

check_ssh_linux_tcp_states

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

SSH Connexion

Checks the SSH connexion

check_ssh_connexion

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Reboot

Checks the system uptime

check_ssh_linux_uptime

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Read-only Filesystems

Checks if there are Read-only filesystems

check_ssh_ro_filesystem

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

CPU Stats

Checks the CPU load statistics

check_ssh_linux_cpu_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Disks Stats

Checks the disk statistics

check_ssh_linux_disks_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

Remote user for the SSH service (key interchange with Shinken user must be done )

string

_SSH_PORT

Remote port for the SSH service

integer

_SSH_KEY

SSH key (Shinken user)

string

_SSH_KEY_PASSPHRASE

SSH passphrase (Shinken user)

string

_LOAD_WARN

Value for starting warning state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m,5m,15m

3 comma-separated integer

_STORAGE_WARN

Warning level for used disk space (percentage)

percent

_STORAGE_CRIT

Critical level for used disk space (percentage)

percent

_STORAGE_UNIT

Unit of disk space : B, KB, MB, GB or TB

string

_STORAGE_MOUNTS

List of mount points to monitor

comma-separated absolute path

_CPU_WARN

Warning level for the CPU usage (percentage)

percent

_CPU_CRIT

Critical level for the CPU usage (percentage)

percent

_MEMORY_WARN

Physical memory warning threshold (percentage)

percent

_MEMORY_CRIT

Physical memory critical threshold (percentage)

percent

Linux-ssh-aggregated

DESCRIPTION


Standard linux checks, like CPU, RAM and disk space. Checks are done by SSH.

../../_images/linux-ssh-aggregated.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Memory

Checks the memory usage

check_ssh_linux_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

NFS Stats

Checks the NFS (Network File System) statistics

check_ssh_linux_nfs_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

NET Stats

Checks the network statistics

check_ssh_linux_net_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Load Average

Checks the system load average

check_ssh_linux_load_average

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

Disks

Checks the disk usage

check_ssh_linux_disks

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTSTORAGE_UNIT

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSTORAGE_MOUNTS

Kernel Stats

Checks the Kernel statistics

check_ssh_linux_kernel_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

TCP States

Checks the states from TCP connection table

check_ssh_linux_tcp_states

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

SSH Connexion

Checks the SSH connexion

check_ssh_connexion

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

CPU Stats

Checks the CPU load statistics. Returns only aggregated metrics

check_ssh_linux_cpu_stats_aggregated

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Reboot

Checks the system uptime

check_ssh_linux_uptime

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Read-only Filesystems

Checks if there are Read-only filesystems

check_ssh_ro_filesystem

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Disks Stats

Checks the disk statistics

check_ssh_linux_disks_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_USER

Remote user for the SSH service (key interchange with Shinken user must be done )

string

_SSH_PORT

Remote port for the SSH service

integer

_SSH_KEY

SSH key (Shinken user)

string

_SSH_KEY_PASSPHRASE

SSH passphrase (Shinken user)

string

_LOAD_WARN

Value for starting warning state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m,5m,15m

3 comma-separated integer

_STORAGE_WARN

Warning level for used disk space (percentage)

percent

_STORAGE_CRIT

Critical level for used disk space (percentage)

percent

_STORAGE_UNIT

Unit of disk space : B, KB, MB, GB or TB

string

_STORAGE_MOUNTS

List of mount points to monitor

comma-separated absolute path

_CPU_WARN

Warning level for the CPU usage (percentage)

percent

_CPU_CRIT

Critical level for the CPU usage (percentage)

percent

_MEMORY_WARN

Physical memory warning threshold (percentage)

percent

_MEMORY_CRIT

Physical memory critical threshold (percentage)

percent

Nginx-node

DESCRIPTION


Custom checks for Nginx services

../../_images/nginx-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

nginx-node-status

Checks nginx status service detailed .

check_nginx_node_status

_HOSTNGINX_PORT

_HOSTNGINX_PROTOCOL

_HOSTNGINX_DOMAIN

_HOSTNGINX_ACTIVE_CONN_WARNING

_HOSTNGINX_ACTIVE_CONN_CRITICAL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_NGINX_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_NGINX_DOMAIN

Used for Nginx checks if value is not default

string

_NGINX_ACTIVE_CONN_WARNING

Active connections warning threshold

integer

_NGINX_ACTIVE_CONN_CRITICAL

Active connections critical threshold

integer

_NGINX_PORT

NGINX port (default 22).

integer

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_SSH_PORT

SSH port (default 22).

integer

Os_resources

DESCRIPTION


Monitoring Windows an Linux Servers, via snmp

../../_images/os-resources.png

Script to check the state of Windows an Linux servers, through snmp

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Processes_$KEY$

Checks the state of a process

os_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

Partition_$KEY$

Checks the partitions storage usage

os_partition_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING_THRESHOLD

_HOSTSTORAGE_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PARTITIONS

Users

Checks the number of users sessions

os_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUSERS_WARNING_THRESHOLD

_HOSTUSERS_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

CPU usage 1m

Checks the last minute average CPU usage

os_cpu_1m_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Memory buffer usage

Checks the memory buffer usage

os_mem_buffer

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEMORY_BUFFER_DEFAULT_WARNING

_HOSTMEMORY_BUFFER_DEFAULT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

RAM usage

Checks the memory usage

os_ram_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRAM_WARNING_THRESHOLD

_HOSTRAM_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Number of processes

Checks the number of processes

os_count_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCOUNT_PROCESSES_WARNING_THRESHOLD

_HOSTCOUNT_PROCESSES_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Virtual memory usage

Checks the virtual memory usage

os_vm_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVM_WARNING_THRESHOLD

_HOSTVM_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Uptime

Checks the server uptime

os_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_CRITICAL_THRESHOLD

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_PARTITIONS:

wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

_PROCESSES:

wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

_CPU_WARNING_THRESHOLD

CPU warning threshold

percent

_CPU_CRITICAL_THRESHOLD

CPU critical threshold

percent

_RAM_WARNING_THRESHOLD

RAM warning threshold

percent

_RAM_CRITICAL_THRESHOLD

RAM critical threshold

percent

_VM_WARNING_THRESHOLD

Virtual memory warning threshold

percent

_VM_CRITICAL_THRESHOLD

Virtual memory critical threshold

percent

_STORAGE_WARNING_THRESHOLD

Storage warning threshold

percent

_STORAGE_CRITICAL_THRESHOLD

Storage critical threshold

percent

_UPTIME_CRITICAL_THRESHOLD

Uptime critical threshold

integer

_USERS_WARNING_THRESHOLD

Users warning threshold

integer

_USERS_CRITICAL_THRESHOLD

Users critical threshold

integer

_COUNT_PROCESSES_WARNING_THRESHOLD

Number of processes running warning threshold

integer

_COUNT_PROCESSES_CRITICAL_THRESHOLD

Number of processes running critical threshold

integer

_MEMORY_BUFFER_DEFAULT_WARNING

Percent of memory buffer used warning threshold

integer

_MEMORY_BUFFER_DEFAULT_CRITICAL

Percent of memory buffer used critical threshold

integer

COMPLEX MACROS

  • _PARTITIONS

    • Description: Disk partitions

    • Discover: wocu-discover-os-resources-partitions.py


Fields

Description

Type

index

Partition index

integer

label

Partition label

string

unit

Letter unit or path

string

  • _PROCESSES

    • Description: Processes

    • Discover: wocu-discover-os-resources-processes.py


Fields

Description

Type

ProcName

Process label

string

ProcParameters

Process parameters

string

Processes_snmp

DESCRIPTION


Monitoring Windows an Linux processes, via snmp

Script to check the processes of Windows an Linux servers, through snmp

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Processes_$KEY$

Checks the state of a process

os_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_PROCESSES:

wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c and 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource

string

COMPLEX MACROS

  • _PROCESSES

    • Description: Processes

    • Discover: wocu-discover-os-resources-processes.py


Fields

Description

Type

ProcName

Process label

string

ProcParameters

Process parameters

string

Unix-files-ssh

DESCRIPTION


Checks last modification day for a file via ssh protocol

../../_images/unix-files-ssh.png

Checks last modification day for a file via ssh protocol

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

File $KEY$

Connects to a server via SSH and checks if a file exists

check_unix-files-ssh

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY_FILE

_FILES

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SSH_PORT

SSH port (default 22)

integer

_SSH_USER

SSH User

string

_SSH_PASSWORD

SSH Password. If default (SSH_PASSWORD), SSH_KEY_FILE will be used

string

_SSH_KEY_FILE

SSH Key File (default ~/.ssh/id_rsa)

string

COMPLEX MACROS

  • _FILES

    • Description: File details


Fields

Description

Type

Display name

File id (unique)

string

File name prefix

File name without date suffix. Wildcards (*, ?, etc.) are supported

string

Path

File path

string

Time period

If Time Period Unit is days, 1 means today, 2 means yesterday and today, etc.

integer

Time period Unit

Time period unit

string

Windows

DESCRIPTION


Standard windows checks, like CPU, RAM and disk space. Checks are done by WMI.

../../_images/windows.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Reboot

Checks last reboot

check_windows_reboot

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_REBOOT_WARN

_HOSTWINDOWS_REBOOT_CRIT

InactiveSessions

Detect inactive sessions

check_windows_inactive_ts_sessions

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_MIN_INACTIVE_SESSIONS

_HOSTWINDOWS_MAX_INACTIVE_SESSIONS

ShareSpace-$KEY$

Checks windows share free space.

check_windows_share

_HOSTDOMAINUSERSHORT

_HOSTDOMAINPASSWORD

_HOSTDOMAIN

_HOSTWINDOWS_SHARE_WARN

_HOSTWINDOWS_SHARE_CRIT

_shares

Windows - BigProcesses

Obtain processes using high CPU resources

check_windows_big_processes

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_BIG_PROCESSES_WARN

Services

Check the services running in the server

check_windows_auto_services

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_EXCLUDED_AUTO_SERVICES

_HOSTWINDOWS_AUTO_SERVICES_WARN

_HOSTWINDOWS_AUTO_SERVICES_CRIT

EventLogSystem

Detect abnormal system events

check_windows_eventlogs

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_EVENT_LOG_WARN

_HOSTWINDOWS_EVENT_LOG_CRIT

LoadAverage

Detect abnormal CPU usage

check_windows_loadaverage

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_LOAD_WARN

_HOSTWINDOWS_LOAD_CRIT

Network Interface

Detect abnormal Network usage

check_windows_network

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_NET_WARN

_HOSTWINDOWS_NET_CRIT

_HOSTWINDOWS_NET_WARN

_HOSTWINDOWS_NET_CRIT

Memory

Check about memory usage.

check_windows_physical_memory

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_MEM_WARN

_HOSTWINDOWS_MEM_CRIT

Disks

Overall disks usage

check_windows_disks

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_DISK_WARN

_HOSTWINDOWS_DISK_CRIT

EventLogApplication

Detect abnormal application events

check_windows_eventlogs

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_EVENT_LOG_WARN

_HOSTWINDOWS_EVENT_LOG_CRIT

EachCpu

Detect abnormal CPU usage

check_windows_each_cpu

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_CPU_WARN

_HOSTWINDOWS_CPU_CRIT

Swap

Check swap space usage. Too many use of swap space means lacks of memory or memory leaks.

check_windows_swap

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

DisksIO

Overall disks IO usage

check_windows_disks_io

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

Cpu

Detect abnormal CPU usage

check_windows_overall_cpu

_HOSTDOMAINUSER

_HOSTDOMAINPASSWORD

_HOSTWINDOWS_ALL_CPU_WARN

_HOSTWINDOWS_ALL_CPU_CRIT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_DOMAIN

Windows Domain of the server

string

_DOMAINUSERSHORT

Short name (without the domain) of the user to query the server. Should have rights on the WMI tables for reading.

string

_DOMAINUSER

Full name of the user launching the query (default DOMAINUSERSHORT).

string

_DOMAINPASSWORD

Password for the user launching the query.

string

_WINDOWS_SHARE_WARN

Warning level for the share disk space (percentage).

percent

_WINDOWS_SHARE_CRIT

Critical level for the share disk space (percentage).

percent

_WINDOWS_DISK_WARN

Warning threshold for disk space (percentage).

percent

_WINDOWS_DISK_CRIT

Critical threshold for disk space (percentage).

percent

_WINDOWS_EVENT_LOG_WARN

Level for event log detection

string

_WINDOWS_EVENT_LOG_CRIT

Level for event log detection

string

_WINDOWS_REBOOT_WARN

Warning Uptime of the host (expressed as 5min: / 15m:)

string

_WINDOWS_REBOOT_CRIT

Critical Uptime of the host (expressed as 5min: / 15m:)

string

_WINDOWS_MEM_WARN

Warning threshold for Windows RAM usage (percentage)

percent

_WINDOWS_MEM_CRIT

Critical threshold for Windows RAM usage (percentage)

percent

_WINDOWS_ALL_CPU_WARN

Warning threshold for Windows combined CPU usage (percentage)

percent

_WINDOWS_ALL_CPU_CRIT

Critical threshold for Windows combined CPU usage (percentage)

percent

_WINDOWS_CPU_WARN

Warning threshold for each CPU usage (percentage)

percent

_WINDOWS_CPU_CRIT

Critical threshold for each CPU usage (percentage)

percent

_WINDOWS_LOAD_WARN

Warning threshold for CPU load (absolute, single value)

string

_WINDOWS_LOAD_CRIT

Critical threshold for CPU load (absolute, single value)

string

_WINDOWS_EXCLUDED_AUTO_SERVICES

Regex to match Services to be excluded from check

string

_WINDOWS_AUTO_SERVICES_WARN

Level for auto-services not running

string

_WINDOWS_AUTO_SERVICES_CRIT

Level for auto-services not running

string

_WINDOWS_BIG_PROCESSES_WARN

Level for Big processes (percentage)

percent

_WINDOWS_NET_WARN

Warning threshold for NET usage (percentage)

percent

_WINDOWS_NET_CRIT

Critical threshold for NET usage (percentage)

percent

_WINDOWS_MIN_INACTIVE_SESSIONS

Windows min Inactive Sessions

integer

_WINDOWS_MAX_INACTIVE_SESSIONS

Windows max Inactive Sessions

integer

_WINDOWS_NETWORK_INTERFACE

Default network interface (for checking usage thresholds)

string

Windows-drive-size

DESCRIPTION


Get drive size on windows servers by WMI interface

../../_images/windows-drive-size.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

DRIVE_$KEY$_STATUS

Checks the drive size and status

check_drive_size

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_DRIVES_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER_WMI

Server WMI User

string

_PASSWORD_WMI

Server WMI Password

string

COMPLEX MACROS

  • _DRIVES_LIST

    • Description: List of drives to overwatch


Fields

Description

Type

Drive

Drive:

string

Warning

% warning value

string

Critical

% critical value

string

Windows-events

DESCRIPTION


Check event viewer id by WMI interface

../../_images/windows-events.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

EVENTS_$KEY$_STATUS

Looks for events in remote event viewer

check_events_windows_status

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_EVENTS_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER_WMI

Server WMI User

string

_PASSWORD_WMI

Server WMI Password

string

COMPLEX MACROS

  • _EVENTS_LIST

    • Description: List of Events to overwatch


Fields

Description

Type

name

Name of sample Event Viewer

string

service

Name of the log eg System or Application or any other Event log as shown in the Windows Event Viewer

string

type

Eventtype: # 1=error , 2=warning , 3=Information,4=Security Audit Success,5=Security Audit Failure Multiple Eventypes possible with coma separation

string

id

Eventid Multiple Eventids possible with coma separation

integer

minutes

Number of past min to check for events

integer

warning

Set warning if past min to check for events

integer

critical

Set critical if past min to check for events

integer

Windows-process

DESCRIPTION


Gets data usage of processes running on windows servers per WMI interface

../../_images/windows-process.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

PROCESS_$KEY$_CPU

Checks the CPU used by a process

check_process_windows_cpu

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_PROCESSES_LIST

PROCESS_$KEY$_MEM

Checks the Memory used by a process

check_process_windows_mem

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_PROCESSES_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER_WMI

Server WMI User

string

_PASSWORD_WMI

Server WMI Password

string

COMPLEX MACROS

  • _PROCESSES_LIST

    • Description: List of Process to overwatch


Fields

Description

Type

name

Custom Service Name

string

Process

Name of the Process to be displayed without extension

string

warning Memory

warning threshold use Memory

string

critical Memory

critical threshold use Memory

string

warning CPU

warning threshold use CPU

string

critical CPU

critical threshold use CPU

string

Windows-services

DESCRIPTION


Get service status on windows servers by WMI interface

../../_images/windows-services.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SERVICES_$KEY$_STATUS

Checks the status of a service

check_services_windows_status

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_SERVICES_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER_WMI

Server WMI User

string

_PASSWORD_WMI

Server WMI Password

string

COMPLEX MACROS

  • _SERVICES_LIST

    • Description: List of Services to overwatch


Fields

Description

Type

name

Custom Service Name

string

Service

Name real of the service

string

Status

Service status Running/Stopped

string

Wocu-credits

DESCRIPTION


Checks the credits used by WOCU realm

../../_images/wocu-credits.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Credits

Checks credits used by WOCU realm

check-wocu-credits

_HOSTCREDITS_USAGE_WARNING

_HOSTCREDITS_USAGE_CRITICAL

_HOSTAPI_IMPORT_TOOL_USER

_HOSTAPI_IMPORT_TOOL_PASSWORD

_HOSTAPI_TIMEOUT

_HOSTAPI_PROTOCOL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_API_IMPORT_TOOL_USER

Import-tool API User

string

_API_IMPORT_TOOL_PASSWORD

Import-tool API Password

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

_API_PROTOCOL

API protocol (http/https)

string

_CREDITS_USAGE_WARNING

Credits usage warning threshols (percent)

percent

_CREDITS_USAGE_CRITICAL

Credits usage critical threshols (percent)

percent

Wocu-health-aggregator

DESCRIPTION


Checks Wocu Aggregator daemons running on a server. Netcat must be installed in monitored server

../../_images/wocu-health-aggregator.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Health - Aggregator - $KEY$

Checks Wocu Aggregator daemons status and consumption metrics

check-wocu-aggregator-daemon

_HOSTWEB_PROTOCOL

_HOSTDOMAIN

_HOSTACTIVE_CONN_WARNING

_HOSTACTIVE_CONN_CRITICAL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

_HOSTAPI_AGGREGATOR_ENDPOINT

_HOSTAPI_AGGREGATOR_USER

_HOSTAPI_AGGREGATOR_PASSWORD

_HOSTAPI_TIMEOUT

_WOCU_DAEMONS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_WOCU_DAEMONS:

wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Aggregator -p $_WEB_PROTOCOL$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_WEB_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_DOMAIN

Used for Nginx checks if value is not default

string

_ACTIVE_CONN_WARNING

Active connections warning threshold

integer

_ACTIVE_CONN_CRITICAL

Active connections critical threshold

integer

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_API_AGGREGATOR_USER

Aggregtor API User

string

_API_AGGREGATOR_PASSWORD

Aggregtor API Password

string

_API_AGGREGATOR_ENDPOINT

Aggregtor API Query endpoint

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

COMPLEX MACROS

  • _WOCU_DAEMONS

    • Description: Wocu daemons and ports to monitorize.

    • Discover: wocu-discover-wocu-daemons.py


Fields

Description

Type

Display Name

Display name to be shown as part of the service description.

string

Daemon

Daemon (process name) to monitor.

string

Port

Daemon TCP Port to be checked.

integer

Wocu-health-generic

DESCRIPTION


Checks Wocu daemons running on a server. Netcat must be installed in monitored server

../../_images/wocu-health-generic.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Health - $KEY$

Checks Wocu daemons status and consumption metrics

check-wocu-daemon

_HOSTWEB_PROTOCOL

_HOSTDOMAIN

_HOSTACTIVE_CONN_WARNING

_HOSTACTIVE_CONN_CRITICAL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

_HOSTAPI_AGGREGATOR_ENDPOINT

_HOSTAPI_AGGREGATOR_USER

_HOSTAPI_AGGREGATOR_PASSWORD

_HOSTAPI_IMPORT_TOOL_ENDPOINT

_HOSTAPI_IMPORT_TOOL_USER

_HOSTAPI_IMPORT_TOOL_PASSWORD

_HOSTAPI_TIMEOUT

_WOCU_DAEMONS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_WOCU_DAEMONS:

wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f $_WOCU_FLAVOUR$ -p $_WEB_PROTOCOL$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_WOCU_FLAVOUR

Choose Wocu Flavour

string

_WEB_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_DOMAIN

Used for Nginx checks if value is not default

string

_ACTIVE_CONN_WARNING

Active connections warning threshold

integer

_ACTIVE_CONN_CRITICAL

Active connections critical threshold

integer

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_API_AGGREGATOR_USER

Aggregtor API User

string

_API_AGGREGATOR_PASSWORD

Aggregtor API Password

string

_API_AGGREGATOR_ENDPOINT

Aggregtor API Query endpoint

string

_API_IMPORT_TOOL_USER

Import-tool API User

string

_API_IMPORT_TOOL_PASSWORD

Import-tool API Password

string

_API_IMPORT_TOOL_ENDPOINT

Import-tool API Query endpoint

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

COMPLEX MACROS

  • _WOCU_DAEMONS

    • Description: Wocu daemons and ports to monitorize.

    • Discover: wocu-discover-wocu-daemons.py


Fields

Description

Type

Display Name

Display name to be shown as part of the service description.

string

Daemon

Daemon (process name) to monitor.

string

Port

Daemon TCP Port to be checked.

integer

Wocu-health-monitoring

DESCRIPTION


Checks Wocu Monitoring daemons running on a server. Netcat must be installed in monitored server

../../_images/wocu-health-monitoring.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Health - Monitoring - $KEY$

Checks Wocu Monitoring daemons status and consumption metrics

check-wocu-monitoring-daemon

_HOSTWEB_PROTOCOL

_HOSTDOMAIN

_HOSTACTIVE_CONN_WARNING

_HOSTACTIVE_CONN_CRITICAL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

_HOSTAPI_IMPORT_TOOL_ENDPOINT

_HOSTAPI_IMPORT_TOOL_USER

_HOSTAPI_IMPORT_TOOL_PASSWORD

_HOSTAPI_TIMEOUT

_WOCU_DAEMONS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_WOCU_DAEMONS:

wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Monitoring -p $_WEB_PROTOCOL$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_WEB_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_DOMAIN

Used for Nginx checks if value is not default

string

_ACTIVE_CONN_WARNING

Active connections warning threshold

integer

_ACTIVE_CONN_CRITICAL

Active connections critical threshold

integer

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_API_IMPORT_TOOL_USER

Import-tool API User

string

_API_IMPORT_TOOL_PASSWORD

Import-tool API Password

string

_API_IMPORT_TOOL_ENDPOINT

Import-tool API Query endpoint

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

COMPLEX MACROS

  • _WOCU_DAEMONS

    • Description: Wocu daemons and ports to monitorize.

    • Discover: wocu-discover-wocu-daemons.py


Fields

Description

Type

Display Name

Display name to be shown as part of the service description.

string

Daemon

Daemon (process name) to monitor.

string

Port

Daemon TCP Port to be checked.

integer

Wocu-health-monitoring-visor

DESCRIPTION


Checks Wocu Monitoring Visor daemons running on a server. Netcat must be installed in monitored server

../../_images/wocu-health-monitoring-visor.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Health - Monitoring Visor - $KEY$

Checks Wocu Monitoring Visor daemons status and consumption metrics

check-wocu-monitoring-visor-daemon

_HOSTWEB_PROTOCOL

_HOSTDOMAIN

_HOSTACTIVE_CONN_WARNING

_HOSTACTIVE_CONN_CRITICAL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

_HOSTAPI_IMPORT_TOOL_ENDPOINT

_HOSTAPI_IMPORT_TOOL_USER

_HOSTAPI_IMPORT_TOOL_PASSWORD

_HOSTAPI_TIMEOUT

_WOCU_DAEMONS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_WOCU_DAEMONS:

wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Monitoring-Visor -p $_WEB_PROTOCOL$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_WEB_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_DOMAIN

Used for Nginx checks if value is not default

string

_ACTIVE_CONN_WARNING

Active connections warning threshold

integer

_ACTIVE_CONN_CRITICAL

Active connections critical threshold

integer

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_API_IMPORT_TOOL_USER

Import-tool API User

string

_API_IMPORT_TOOL_PASSWORD

Import-tool API Password

string

_API_IMPORT_TOOL_ENDPOINT

Import-tool API Query endpoint

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

COMPLEX MACROS

  • _WOCU_DAEMONS

    • Description: Wocu daemons and ports to monitorize.

    • Discover: wocu-discover-wocu-daemons.py


Fields

Description

Type

Display Name

Display name to be shown as part of the service description.

string

Daemon

Daemon (process name) to monitor.

string

Port

Daemon TCP Port to be checked.

integer

Wocu-health-satellite

DESCRIPTION


Checks Wocu Satellite daemons running on a server

../../_images/wocu-health-satellite.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Health - Satellite - $KEY$

Checks Wocu Satellite daemons status and consumption metrics

check-wocu-satellite-daemon

_HOSTWEB_PROTOCOL

_HOSTSSH_USER

_HOSTSSH_KEY_PASSPHRASE

_HOSTSSH_KEY

_HOSTSSH_PORT

_WOCU_DAEMONS

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_WEB_PROTOCOL

WEB protocol: HTTP/HTTPS (HTTP by default)

string

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY_PASSPHRASE

SSH passphrase (Wocu user)

string

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

COMPLEX MACROS

  • _WOCU_DAEMONS

    • Description: Wocu daemons and ports to monitorize.


Fields

Description

Type

Display Name

Display name to be shown as part of the service description.

string

Daemon

Daemon (process name) to monitor.

string

Port

Daemon TCP Port to be checked.

integer

Wocu-realm

DESCRIPTION


Checks to obtain host/services stats per realm from Wocu-aggregator servers

../../_images/wocu-realm.png

This pack should be applied only to wocu-aggregator

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

WOCU Realm - $KEY$ - Stats

Checks hosts/services/bphost/bpservices statistics from realms

check-realm-status

_HOSTAPI_PROTOCOL

_HOSTAPI_ENDPOINT

_HOSTAPI_USER

_HOSTAPI_PASSWORD

_HOSTAPI_TIMEOUT

_HOSTDOMAIN

_HOSTHOST_WARN

_HOSTHOST_CRIT

_HOSTSERVICE_WARN

_HOSTSERVICE_CRIT

_HOSTBPHOST_WARN

_HOSTBPHOST_CRIT

_HOSTBPSERVICE_WARN

_HOSTBPSERVICE_CRIT

_WOCU_REALMS

WOCU Realm - $KEY$ - LMD Status

Checks LMD status from every realm

check-realm-lmd-status

_WOCU_REALMS

WOCU Realm - $KEY$ - Last Check

Checks the time from last check command executed

check-realm-last-check

_HOSTLAST_CHECK_WARN

_HOSTLAST_CHECK_CRIT

_WOCU_REALMS

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_WOCU_REALMS:

wocu-discover-wocu-realms.py -H $HOSTADDRESS$ -P $_API_PROTOCOL$ -u $_API_USER$ -p $_API_PASSWORD$ -d $_DOMAIN$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_API_USER

Aggregator API user

string

_API_PASSWORD

Aggregator API password

string

_API_PROTOCOL

Aggregator API protocol: HTTP/HTTPS (HTTP by default)

string

_API_ENDPOINT

API Query endpoint

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

_HOST_WARN

Not OK Hosts warning threshold (percentage)

percent

_HOST_CRIT

Not OK Hosts critical threshold (percentage)

percent

_SERVICE_WARN

Not OK Services warning threshold (percentage)

percent

_SERVICE_CRIT

Not OK Services critical threshold (percentage)

percent

_BPHOST_WARN

Not OK BPHosts warning threshold (percentage)

percent

_BPHOST_CRIT

Not OK BPHosts critical threshold (percentage)

percent

_BPSERVICE_WARN

Not OK BPServices warning threshold (percentage)

percent

_BPSERVICE_CRIT

Not OK BPServices critical threshold (percentage)

percent

_LAST_CHECK_WARN

Minutes from last executed check warning threshold

integer

_LAST_CHECK_CRIT

Minutes from last executed check critical threshold

integer

_DOMAIN

Domain hostname

string

COMPLEX MACROS

  • _WOCU_REALMS

    • Description: Wocu realms

    • Discover: wocu-discover-wocu-realms.py


Fields

Description

Type

display_name

Display name to be shown as part of the service description.

string

name

Realm name to monitor.

string

monitoring_ip

IP address to query.

string

monitoring_port

Port to query.

integer

Database

Elastic-node

DESCRIPTION


Checks the status of a single Elastic node

../../_images/elastic-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Elastic_software_indexing

Checks the indexing time

check_node_indexing

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTINDEXING_WARNING_THRESHOLD

_HOSTINDEXING_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_cluster_shards_status

Checks Shards status

check_shards_status

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTUNASSIGNED_SHARD_WARNING_THRESHOLD

_HOSTUNASSIGNED_SHARD_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_disk_used

Checks Disk usage

check_elastic_disk_space_used

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTDISK_SPACE_USED_WARNING_THRESHOLD

_HOSTDISK_SPACE_USED_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_jvm_memory

Checks used memory percentage of JVM

check_elastic_memory_jvm

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTJVM_WARNING_THRESHOLD

_HOSTJVM_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_documents

Checks the number of documents

check_elastic_documents

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_cluster_status

Checks Cluster status

check_cluster_health

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_software_uptime

Checks the Elastic node uptime

check_elastic_uptime

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTNODE_UPTIME_WARNING_THRESHOLD

_HOSTNODE_UPTIME_WARNING_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_software_version

Shows Elastic node version

check_elastic_version

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

Elastic_cluster_shards_count

Shows Shards info

check_shards_count

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

_HOSTSHARDS_TOTAL_WARNING_THRESHOLD

_HOSTSHARDS_TOTAL_CRITICAL_THRESHOLD

Elastic_software_search_query

Checks the index search query time

check_node_search_query

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTSEARCH_QUERY_WARNING_THRESHOLD

_HOSTSEARCH_QUERY_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_ELASTIC_NODENAME:

wocu-discover-elastic-node.py -H $HOSTADDRESS$ -P $_ELASTIC_PORT$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_ELASTIC_PORT

Elastic port for the queries (default 9200)

integer

_ELASTIC_NODENAME

Name of the Elastic node (as registered in the service)

string

_ELASTIC_USERNAME

Username for API auth. Leave it blank if authentication is not needed

string

_ELASTIC_PASSWORD

Password for API auth. Leave it blank if authentication is not needed

string

_JVM_WARNING_THRESHOLD

Warning threshold for the JVM Memory used by Elastic (percentage)

percent

_JVM_CRITICAL_THRESHOLD

Critical threshold for the JVM Memory used by Elastic (percentage)

percent

_DISK_SPACE_USED_WARNING_THRESHOLD

Warning threshold for the disk space used by Elastic (percentage)

percent

_DISK_SPACE_USED_CRITICAL_THRESHOLD

Critical threshold for the disk space used by Elastic (percentage)

percent

_INDEXING_WARNING_THRESHOLD

Warning threshold for the indexing time by Elastic (in milliseconds)

integer

_INDEXING_CRITICAL_THRESHOLD

Critical threshold for the indexing time by Elastic (in milliseconds)

integer

_SEARCH_QUERY_WARNING_THRESHOLD

Warning threshold for the search query time by Elastic (in milliseconds)

integer

_SEARCH_QUERY_CRITICAL_THRESHOLD

Critical threshold for the search query time by Elastic (in milliseconds)

integer

_SHARDS_TOTAL_WARNING_THRESHOLD

Warning threshold for the total shards used by Elastic in a node (percentage)

percent

_SHARDS_TOTAL_CRITICAL_THRESHOLD

Critical threshold for the total shards used by Elastic in a node (percentage)

percent

_UNASSIGNED_SHARD_WARNING_THRESHOLD

Warning threshold for unassigned shards

integer

_UNASSIGNED_SHARD_CRITICAL_THRESHOLD

Critical threshold for unassigned shards

integer

_NODE_UPTIME_WARNING_THRESHOLD

Warning threshold for software uptime (in seconds)

integer

_NODE_UPTIME_CRITICAL_THRESHOLD

Critical threshold for software uptime (in seconds)

integer

Influxdb-node

DESCRIPTION


Health and performance checks of a InfluxDB node

../../_images/influxdb-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

API ping

Checks the response time of http API

check_influxdb_api

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

_HOSTAPI_WARNING_THRESHOLD

_HOSTAPI_CRITICAL_THRESHOLD

Collectd Plugin

Shows all Collectd info

check_influxdb_collectd

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

InfluxDB Points

Checks diff of writing ok/fail/total points of Influx Node

check_influxdb_points

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

InfluxDB Diagnosis

Checks the behaviour of Influx Create/Insert/Delete

check_influxdb_operation

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

_HOSTOPERATION_WARNING_THRESHOLD

_HOSTOPERATION_CRITICAL_THRESHOLD

InfluxDB Versions

Shows all InfluxDB info

check_influxdb_info

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

InfluxDB Requests

Checks diff of Http api resquests (ping/rad/write/total)

check_influxdb_requests

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

_HOSTREQUEST_WARNING_THRESHOLD

_HOSTREQUEST_CRITICAL_THRESHOLD

InfluxDB Heap

Shows all Go heap info

check_influxdb_heap

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

_HOSTNODE_TOTAL_MEMORY

_HOSTHEAP_WARNING_THRESHOLD

_HOSTHEAP_CRITICAL_THRESHOLD

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_INFLUXDB_USER

User to launch the DB queries

string

_INFLUXDB_PASS

Password of user to launch the DB queries

string

_INFLUXDB_PORT

InfluxDB port for the queries

integer

_INFLUXDB_NODENAME

Name of the InfluxDB node (as registered in the service)

string

_HEAP_WARNING_THRESHOLD

Memory used by InfluxDB Warning threshold (percentage)

percent

_HEAP_CRITICAL_THRESHOLD

Memory used by InfluxDB Critical threshold (percentage)

percent

_NODE_TOTAL_MEMORY

Amount of total Memory of the node (in MegaBytes)

integer

_OPERATION_WARNING_THRESHOLD

Warning threshold (in miliseconds) for completing a basic diagnosis (Create/Insert/Delete)

integer

_OPERATION_CRITICAL_THRESHOLD

Critical threshold (in miliseconds) for completing a basic diagnosis (Create/Insert/Delete)

integer

_API_WARNING_THRESHOLD

Warning threshold (in miliseconds) for pinging the http api

integer

_API_CRITICAL_THRESHOLD

Critical threshold (in miliseconds) for pinging the http api

integer

_REQUEST_WARNING_THRESHOLD

Warning threshold (absolute) for the http api read-requests

integer

_REQUEST_CRITICAL_THRESHOLD

Critical threshold (absolute) for the http api read-requests

integer

Log-occurrences

DESCRIPTION


Check log occurrences in docs into logger indices. Regular expressions are Lucene type

../../_images/log-occurrences.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Search $KEY$

Looks for events in ElasticSearch logger databases

check_log_occurrences

_HOSTELASTICSEARCH_CLUSTER_IP

_HOSTELASTICSEARCH_CLUSTER_PORT

_HOSTELASTICSEARCH_USERNAME

_HOSTELASTICSEARCH_PASSWORD

_HOSTELASTICSEARCH_PREFIX_INDEX

_HOSTIDENTIFIER

_HOSTIDENTIFIER_FIELD

_HOSTTIME_RANGE

_SEARCH_CRITERIA

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_ELASTICSEARCH_CLUSTER_IP

IP of Elasticsearch cluster

string

_ELASTICSEARCH_CLUSTER_PORT

Port of Elasticsearch cluster

integer

_ELASTICSEARCH_USERNAME

Elasticsearch cluster username (optional)

string

_ELASTICSEARCH_PASSWORD

Elasticsearch cluster password (optional)

string

_ELASTICSEARCH_PREFIX_INDEX

Elasticsearch index prefix

string

_IDENTIFIER

Choose host identifier to build the query (ip/hostname)

string

_IDENTIFIER_FIELD

Host identifier field name as appears in logs (source, ip, ap_address, etc.)

string

_TIME_RANGE

The time range (in minutes) we are looking back. Limited to 24 hours

integer

COMPLEX MACROS

  • _SEARCH_CRITERIA

    • Description: Search criteria and threshold for alerts


Fields

Description

Type

Display name

Name id of criteria (unique)

string

Elasticsearch index

Index name of Elasticsearch (realm name)

string

Search field for the criteria

Main search field for the criteria

string

Regular expression

Main regular expression to match in log message. Strings must be lowercase. Use Lucene syntax

string

Warning

Occurrences warning threshold

integer

Critical

Occurrences critical threshold

integer

Secondary search field for the criteria

Secondary search field for the criteria (optional)

string

Secondary regular expression

Secondary regular expression to match in log message (optional). Strings must be lowercase. Use Lucene syntax

string

Disable pattern

Main regular expression to disable alerts (optional). Strings must be lowercase. Use Lucene syntax

string

Secondary disable pattern

Secondary regular expression to disable alerts (optional). Strings must be lowercase. Use Lucene syntax

string

Third search field

Third search field for the criteria (optional)

string

Third regular expression

Third regular expression to match in log message (optional). Strings must be lowercase. Use Lucene syntax

string

Third disable pattern

Third regular expression to disable alerts (optional). Strings must be lowercase. Use Lucene syntax

string

Mongodb-node

DESCRIPTION


Checks for the status of a single MongoDB node

../../_images/mongodb-node.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

MongoDB_total_delete_queries

Checks the total number of delete queries

check_total_delete_queries

_HOSTMONGODB_PORT

MongoDB_node_memory

Checks the memory usage

check_mongo_memory

_HOSTMONGODB_PORT

_HOSTMONGODB_MEMORY_WARNING_THRESHOLD

_HOSTMONGODB_MEMORY_CRITICAL_THRESHOLD

MongoDB_total_insert_queries

Checks the total number of insert queries

check_total_insert_queries

_HOSTMONGODB_PORT

MongoDB_reader_clients

Checks the number of reader clients

check_reader_clients

_HOSTMONGODB_PORT

MongoDB_current_connections

Checks the current connections

check_current_connections

_HOSTMONGODB_PORT

MongoDB_version

Shows the mongodb version

check_mongo_version

_HOSTMONGODB_PORT

MongoDB_software_uptime

Shows the mongodb software uptime

check_server_uptime

_HOSTMONGODB_PORT

MongoDB_writer_clients

Checks the number of writer cients

check_writer_clients

_HOSTMONGODB_PORT

MongoDB_total_update_queries

Checks the total number of update queries

check_total_update_queries

_HOSTMONGODB_PORT

MongoDB_total_queries

Checks the total number of queries

check_total_queries

_HOSTMONGODB_PORT

MongoDB_active_clients

Checks the active clients

check_active_clients

_HOSTMONGODB_PORT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_MONGODB_STORAGE_ENGINE:

wocu-discover-mongo-engine.py -H $HOSTADDRESS$ -P $_MONGODB_PORT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_MONGODB_PORT

MongoDB port for the queries (default 27017)

integer

_MONGODB_STORAGE_ENGINE

Name of the MongoDB storage engine (as registered in the service)

string

_MONGODB_MEMORY_WARNING_THRESHOLD

Threshold of memory warning to MongoDB in Bytes

integer

_MONGODB_MEMORY_CRITICAL_THRESHOLD

Threshold of memory critical to MongoDB in Bytes

integer

Mssql

DESCRIPTION


Checks for Microsoft SQL Server

../../_images/mssql.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

MSSQL - Version

Shows MSSQL server version

check_mssql_version

_HOSTSQL_USER

_HOSTSQL_PASSWORD

MSSQL - Memory pressure

Checks MSSQL database memory pressure

check_mssql_memory_pressure

_HOSTSQL_USER

_HOSTSQL_PASSWORD

MSSQL - Time to connect

Checks MSSQL database time to connect

check_mssql_time2connect

_HOSTSQL_USER

_HOSTSQL_PASSWORD

_HOSTSQL_TIME_WARNING

_HOSTSQL_TIME_CRITICAL

MSSQL - Active Transactions $KEY$

Checks active transactions in a database table

check_mssql_active_transactions

_HOSTSQL_USER

_HOSTSQL_PASSWORD

_HOSTSQL_ACT_TRANS_WARNING

_HOSTSQL_ACT_TRANS_CRITICAL

_SQL_TABLE_LIST

MSSQL - Status

Checks MSSQL server process status

check_mssql_status

_HOSTSQL_USER

_HOSTSQL_PASSWORD

MSSQL - Memory in use

Checks MSSQL database memory in use

check_mssql_memory_in_use

_HOSTSQL_USER

_HOSTSQL_PASSWORD

_HOSTSQL_MEM_USE_WARNING

_HOSTSQL_MEM_USE_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SQL_TIME_WARNING

Time to connect warning threshold (seconds)

integer

_SQL_TIME_CRITICAL

Time to connect critical threshold (seconds)

integer

_SQL_ACT_TRANS_WARNING

Table active transactions warning threshold

integer

_SQL_ACT_TRANS_CRITICAL

Table active transactions critical threshold

integer

_SQL_MEM_USE_WARNING

Memory in use warning threshold (megabytes)

integer

_SQL_MEM_USE_CRITICAL

Memory in use critical threshold (megabytes)

integer

_SQL_USER

Microsoft SQL server user

string

_SQL_PASSWORD

Microsoft SQL server password

string

COMPLEX MACROS

  • _SQL_TABLE_LIST

    • Description: List of Tables


Fields

Description

Type

display_name

Name to be shown in the web interface

string

table

Database table name

string

Mysql-server

DESCRIPTION


Mysql Database Plugin Monitoring. Uptime, Connection Time, InnoDB Hit Rates, etc

../../_images/mysql-server.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Mysql Temporary Tables created on disk -percent-

Checks the percentage of temporary tables created on disk

mysql_check_tmp_dsk_tbl

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTTMP_DISK_TBL_WARNING

_HOSTTMP_DISK_TBL_CRITICAL

Mysql Amount of Slow Processes -now-

Checks the actual number of slow processes

mysql_check_slow_process

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTSLOW_PROCS_WARNING

_HOSTSLOW_PROCS_CRITICAL

Mysql Connection Time

Checks the connection time

mysql_check_connection_time

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTCONNECTION_TIME_WARNING

_HOSTCONNECTION_TIME_CRITICAL

Mysql InnoDB Buffer Hit Rate

Checks the buffer hit rate

mysql_check_innodb_bufferpool_hitrate

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTBPHITRATE_WARNING

_HOSTBPHITRATE_CRITICAL

Mysql Threads Connected

Checks the actual number of connected threads

mysql_check_thread_connected

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTTHREAD_WARNING

_HOSTTHREAD_CRITICAL

Mysql Amount of Slow Queries

Checks the actual number of slow queries

mysql_check_slow_queries

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTSLOW_Q_WARNING

_HOSTSLOW_Q_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_MYSQLUSER

Mysql user login

string

_MYSQLPASS

Mysql password for the login user

string

_MYSQLDATABASE

Mysql database

string

_MYSQLPORT

Mysql port

integer

_THREAD_WARNING

The amount of thread connections to reach a WARNING state. Reference from the max_connections variables from mysql

integer

_THREAD_CRITICAL

The amount of thread connections to reach a CRITICAL state. Reference from the max_connections variables from mysql

integer

_CONNECTION_TIME_WARNING

The amount of time it takes to connect to the Mysql Database reaching a WARNING state.

integer

_CONNECTION_TIME_CRITICAL

The amount of time it takes to connect to the Mysql Database reaching a CRITICAL state.

integer

_BPHITRATE_WARNING

The percentage of hitrate from the InnoDB Buffer Pool to reach a WARNING state.

string

_BPHITRATE_CRITICAL

The percentage of hitrate from the InnoDB Buffer Pool to reach a CRITICAL state.

string

_TMP_DISK_TBL_WARNING

The percentage of temporary tables created in disk instead of memory to reach a WARNING state.

percent

_TMP_DISK_TBL_CRITICAL

The percentage of temporary tables created in disk instead of memory to reach a CRITICAL state.

percent

_SLOW_PROCS_WARNING

The amount of slow process running NOW to reach a WARNING state.

integer

_SLOW_PROCS_CRITICAL

The amount of slow process running NOW to reach a CRITICAL state.

integer

_SLOW_Q_WARNING

The amount of slow queries running to reach a WARNING state.

integer

_SLOW_Q_CRITICAL

The amount of slow queries running to reach a CRITICAL state.

integer

Oracle-resources

DESCRIPTION


Resource checks for Oracle databases (tablespace usage, users, sessions, etc.)

../../_images/oracle-resources.png

Resource checks for Oracle databases such as Tablespaces usage, FRA usage, sessions and processes. The Oracle Install Client is not installed by default in WOCU. You need to install it manually in both WOCU monitoring and satellite devices.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Oracle sessions

Checks the number of sessions

check_oracle_resources_sessions

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTSESSIONS_WARN

_HOSTSESSIONS_CRIT

Oracle FRA usage

Checks the FRA (Fast Recovery Area) usage

check_oracle_resources_fra

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTFRA_WARNING

_HOSTFRA_CRITICAL

Oracle Tablespace usage

Checks the tablespace usage

check_oracle_resources_tablespace

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTTABLESPACE_WARNING

_HOSTTABLESPACE_CRITICAL

Oracle processes

Checks the actual number of processes

check_oracle_resources_procs

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTPROCS_WARN

_HOSTPROCS_CRIT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_USER

Oracle user

string

_PASSWD

Oracle user password

string

_DDBB

Oracle database name

string

_PORT

Oracle TCP port. Default: 1521

integer

_TABLESPACE_WARNING

Tablespace usage warning threshold (percent)

integer

_TABLESPACE_CRITICAL

Tablespace usage critical threshold (percent)

integer

_FRA_WARNING

Flash Recovery Area usage warning threshold (percent)

integer

_FRA_CRITICAL

Flash recovery Area usage critical threshold (percent)

integer

_SESSIONS_WARN

Current Sessions warning threshold

integer

_SESSIONS_CRIT

Current Sessions critical threshold

integer

_PROCS_WARN

Current processes warning threshold

integer

_PROCS_CRIT

Current processes critical threshold

integer

Postgresql

DESCRIPTION


PostgreSQL database checks, like connected users, locks or data size

../../_images/postgresql.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

PostgreSQL-bloat

Check for table and index bloat

check_postgresql_bloat

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

PostgreSQL-hitratio

Report if the hit ratio of a database is too low

check_postgresql_hitratio

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTHITRATIO_WARN

_HOSTHITRATIO_CRIT

PostgreSQL-connection

Simple connection check

check_postgresql_connection

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

PostgreSQL-database_size

Report if a database is too big

check_postgresql_database_size

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTDBSIZE_WARN

_HOSTDBSIZE_CRIT

PostgreSQL-Locks

Checks the number of locks

check_postgresql_locks

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTLOCKS_WARN

_HOSTLOCKS_CRIT

PostgreSQL-index_size

Checks the size of indexes only

check_postgresql_index_size

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTINDEXSIZE_WARN

_HOSTINDEXSIZE_CRIT

PostgreSQL-table_size

Checks the size of tables only

check_postgresql_table_size

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTTABLESIZE_WARN

_HOSTTABLESIZE_CRIT

PostgreSQL-Txn_time

Checks the maximum open transaction time

check_postgresql_txn_time

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTTXNTIME_WARN

_HOSTTXNTIME_CRIT

PostgreSQL-Query_Time

Checks the maximum running time of current queries

check_postgresql_query_time

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTQUERYTIME_WARN

_HOSTQUERYTIME_CRIT

PostgreSQL-backends

Checks the number of connections

check_postgresql_backends

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTBACKENDS_WARN

_HOSTBACKENDS_CRIT

PostgreSQL-disabled_triggers

Check if any triggers are disabled

check_postgresql_disabled_triggers

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_POSTGRESQLUSER

PostgreSQL user login.

string

_POSTGRESQLPASSWORD

PostgreSQL user password.

string

_POSTGRESQLPORT

PostgreSQL port access.

integer

_DBSIZE_WARN

Database size warning (must include unit G/M character).

string

_DBSIZE_CRIT

Database size critical (must include unit G/M character).

string

_BACKENDS_WARN

Backends warning threshold (must include percentage character).

string

_BACKENDS_CRIT

Backends critical threshold (must include percentage character).

string

_HITRATIO_WARN

Hit ratio warning threshold (must include percentage character).

string

_HITRATIO_CRIT

Hit ratio critical threshold (must include percentage character).

string

_INDEXSIZE_WARN

Index size warning threshold (must include unit G/M character).

string

_INDEXSIZE_CRIT

Index size critical threshold (must include unit G/M character).

string

_TABLESIZE_WARN

Table size warning threshold (must include percentage character).

string

_TABLESIZE_CRIT

Table size critical threshold (must include percentage character).

string

_LOCKS_WARN

Locks warnings threshold.

integer

_LOCKS_CRIT

Locks critical threshold.

integer

_QUERYTIME_WARN

Query time warning threshold (must include min expression, ex: 1min / 5min).

string

_QUERYTIME_CRIT

Query time critical threshold (must include min expression, ex: 1min / 5min).

string

_TXNTIME_WARN

Transaction time warning threshold (must include min expression, ex: 1min / 5min).

string

_TXNTIME_CRIT

Transaction time critical threshold (must include min expression, ex: 1min / 5min).

string

Network Protocol

Bgp

DESCRIPTION


Checks BGP peer state

../../_images/bgp.png

Tested on Cisco, Juniper, Huawei, OneAccess and Teldat

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

BGP - Peer State - $KEY$

Checks the BGP Peer state

check_bgp_generic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_BGP_PEER_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_BGP_PEER_LIST:

wocu-discover-bgp.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1, 2c or 3

string

_SNMPSECURITYNAME

SNMP security name (only snmp v3)

string

_SNMPAUTHPROTOCOL

SNMP authentication type, can be either MD5 or SHA (only snmp v3)

string

_SNMPAUTHKEY

SNMP authentication key (only snmp v3)

string

_SNMPPRIVPROTOCOL

SNMP privacy type, can be either AES or DES (only snmp v3)

string

_SNMPPRIVKEY

SNMP privacy key (only snmp v3)’

string

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3)

string

_SNMPCONTEXT

SNMP context name (only snmp v3)

string

COMPLEX MACROS

  • _BGP_PEER_LIST

    • Description: List of BGP peers list

    • Discover: wocu-discover-bgp.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

peer_ip

Peer IP Address

string

peer_state

Peer State

string

Dns

DESCRIPTION


This plugin uses the nslookup program to obtain the IP address for the given host/domain query

../../_images/dns.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Dns

Obtain the IP address for the given host/domain

check_dns

_HOSTDNSSERVER

_HOSTDNSHOSTNAME

_HOSTDNSEXPECTEDRESULT

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_DNSSERVER

Dns server to query

string

_DNSHOSTNAME

Dns host to check

string

_DNSEXPECTEDRESULT

Dns address expected to be returned

string

Dns-advanced

DESCRIPTION


Dnslookup search to obtain the IP address for the given host/domain query. This pack deprecates the dns pack

../../_images/dns-advanced.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

DNS_$KEY$

Checks if DNS query reply is what it’s expected

check_dns_advanced

_DNS_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

COMPLEX MACROS

  • _DNS_LIST

    • Description: List of DNS names to be queried


Fields

Description

Type

descr

Query name. It will be used in the service name

string

dns_server

DNS server you want to use for the lookup

string

dns_hostname

The name or address you want to query

string

dns_expected_result

IP-ADDRESS you expect the DNS server to return

string

Http

DESCRIPTION


Monitors HTTP response

../../_images/http.png

This plugin will attempt to open an HTTP connection with the host.

Successful connects return STATE_OK, refusals and timeouts return STATE_CRITICAL other errors return STATE_UNKNOWN.

Successful connects, but incorrect reponse messages from the host result in STATE_WARNING return values.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

HttpsCertificate - $KEY$

Checks the SSL Certificate validity

check_https_certificate

_HOSTCHECK_HTTPS_MINIMUM_DAYS

_HTTPS_PACK_LIST

Https - $KEY$

Checks the HTTP/SSL web site response time

check_https

_HOSTWARNING_TIME_RESPONSE

_HOSTCRITICAL_TIME_RESPONSE

_HOSTACTION_ON_REDIRECT

_HTTPS_PACK_LIST

Http - $KEY$

Checks the HTTP web site response time

check_http

_HOSTWARNING_TIME_RESPONSE

_HOSTCRITICAL_TIME_RESPONSE

_HOSTACTION_ON_REDIRECT

_HTTP_PACK_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CHECK_HTTPS_MINIMUM_DAYS

Minimum number of days a certificate has to be valid

integer

_WARNING_TIME_RESPONSE

Response time to result in warning status (seconds)

float

_CRITICAL_TIME_RESPONSE

Response time to result in critical status (seconds)

float

_ACTION_ON_REDIRECT

Response time to result in critical status (seconds)

string

COMPLEX MACROS

  • _HTTP_PACK_LIST

    • Description: HTTP sites (list) to check


Fields

Description

Type

Display Name

Custom Name appearing in the service: HTTP_<Display Name>

string

Host

Host to check (IP or name)

string

Port

Port to check (default: 80)

integer

Url

url path with leading / (default: /)

string

Auth

Credentials for basic HTTP access. Format user:password

string

  • _HTTPS_PACK_LIST

    • Description: HTTPS sites (list) to check


Fields

Description

Type

Display Name

Custom Name appearing in the service: HTTPS_<Display Name>

string

Host

Host to check (IP or name)

string

Port

Port to check (default: 443)

integer

Url

url path with leading / (default: /)

string

Auth

Credentials for basic HTTPS access. Format user:password

string

Http-proxy

DESCRIPTION


Http checks through a proxy

../../_images/http-proxy.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

https_proxy_$KEY$

Checks the https web site status through a proxy

wocu_check_https_proxy

_HOSTHTTP_PROXY

_HOSTHTTP_PROXY_AUTH

_HOSTHTTP_TIMEOUT

_HTTPS_LIST

http_proxy_$KEY$

Checks the http web site status through a proxy

wocu_check_http_proxy

_HOSTHTTP_PROXY

_HOSTHTTP_PROXY_AUTH

_HOSTHTTP_TIMEOUT

_HTTP_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_HTTP_PROXY

Preconfigured Proxy for the check (Default: $DEFAULT_PROXY$)

string

_HTTP_PROXY_AUTH

Preconfigured Proxy authentication (Default: $DEFAULT_PROXY_AUTH$)

string

_HTTP_TIMEOUT

Amount of time to wait for a connection in seconds (default: 30)

integer

COMPLEX MACROS

  • _HTTP_LIST

    • Description: HTTP sites (list)


Fields

Description

Type

Display Name

Custom Name appearing in the service: HTTP_<Display Name>

string

Host

Host to check (IP or name)

string

Port

Port to check (default: 80)

integer

Url

url path with leading / (default: /)

string

  • _HTTPS_LIST

    • Description: HTTPS sites (list)


Fields

Description

Type

Display Name

Custom Name appearing in the service: HTTPS_<Display Name>

string

Host

Host to check (IP or name)

string

Url

url path with leading / (default: /)

string

Port

Port to check (default: 443)

integer

Verify_Cert

Verify SSL Certificate? (default: True)

string

Ntp-snmp

DESCRIPTION


Check the current time of a Host against the local time of Wocu probe via SNMP

../../_images/ntp-snmp.png

Check the current time of the selected host and compares it against the local time of the Wocu probe via SNMP.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

NTP_diff_by_snmp

Checks the time difference as received via SNMP compared to the local time

check_ntp_by_snmp

_HOSTSNMPCOMMUNITY

_HOSTTIME_WARNING

_HOSTTIME_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_TIME_WARNING

Warning threshold for time difference (secs) against NTP server

integer

_TIME_CRITICAL

Critical threshold for time difference (secs) against NTP server

integer

Voip

Call-manager-cisco

DESCRIPTION


Generic and specific checks for Cisco Call Manager devices

../../_images/call-manager-cisco.png

Supported CUCM v10 and olders

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Devices_Gateways

Checks the number and status of Gateway devices

check-cisco-ccm-devices-gateways

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROBLEM_GATEWAYS_WARNING

_HOSTPROBLEM_GATEWAYS_CRITICAL

CCM-Info

Shows info about the Cisco Call Manager device

check-cisco-ccm-info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Disks

Overall disks usage

check-cisco-ccm-disks

_HOSTSNMPCOMMUNITY

_HOSTSTORAGE_PATH

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSNMP_MSG_MAX_SIZE

Devices_Phones

Checks the number and status of Phone devices

check-cisco-ccm-devices-phones

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROBLEM_PHONES_WARNING

_HOSTPROBLEM_PHONES_CRITICAL

Devices_VoiceMails

Checks the number and status of Voicemail devices

check-cisco-ccm-devices-voicemails

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROBLEM_VOICEMAIL_WARNING

_HOSTPROBLEM_VOICEMAIL_CRITICAL

MGCP_ActiveCalls_$KEY$

Checks the number Active calls per MGCP

check-cisco-ccm-mgcp-activecalls

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTACTIVECALLS_WARNING

_HOSTACTIVECALLS_CRITICAL

_MGCP_DEVICES

TimeSync

Checks the difference between device and Wocu UTC time

check-cisco-ccm-time

_HOSTSNMPCOMMUNITY

_HOSTNTP_WARN

_HOSTNTP_CRIT

Devices_Media

Checks the number and status of Media devices

check-cisco-ccm-devices-media

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROBLEM_MEDIA_WARNING

_HOSTPROBLEM_MEDIA_CRITICAL

Devices_CTI

Checks the number and status of CTI devices

check-cisco-ccm-devices-cti

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROBLEM_CTI_WARNING

_HOSTPROBLEM_CTI_CRITICAL

SIP_ActiveCalls_$KEY$

Checks the number of active and in-progress calls per SIP

check-cisco-ccm-sip-activecalls

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTACTIVECALLS_WARNING

_HOSTACTIVECALLS_CRITICAL

_SIP_DEVICES

CPU

Checks the CPU usage

check-cisco-ccm-cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARN

_HOSTCPU_CRIT

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_SIP_DEVICES:

wocu-discover-cucm.py –server $HOSTADDRESS$ -t sip -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ –remote $_POLLER_TAG_ADDRESS$

_MGCP_DEVICES:

wocu-discover-cucm.py –server $HOSTADDRESS$ -t mgcp -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_PROBLEM_PHONES_WARNING

Unregistered + Rejected Phones warning threshold

integer

_PROBLEM_PHONES_CRITICAL

Unregistered + Rejected Phones critical threshold

integer

_PROBLEM_GATEWAYS_WARNING

Unregistered + Rejected Gateways warning threshold

integer

_PROBLEM_GATEWAYS_CRITICAL

Unregistered + Rejected Gateways critical threshold

integer

_PROBLEM_MEDIA_WARNING

Unregistered + Rejected Media warning threshold

integer

_PROBLEM_MEDIA_CRITICAL

Unregistered + Rejected Media critical threshold

integer

_PROBLEM_CTI_WARNING

Unregistered + Rejected Cti warning threshold

integer

_PROBLEM_CTI_CRITICAL

Unregistered + Rejected Cti critical threshold

integer

_PROBLEM_VOICEMAIL_WARNING

Unregistered + Rejected Voicemails warning threshold

integer

_PROBLEM_VOICEMAIL_CRITICAL

Unregistered + Rejected Voicemails critical threshold

integer

_LOAD_WARN

Value for starting warning state for the load average at 1m,5m,15m

3 comma-separated integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m,5m,15m

3 comma-separated integer

_CPU_WARN

Warning level for the CPU usage

percent

_CPU_CRIT

Critical level for the CPU usage

percent

_MEMORY_WARN

Physical memory and swap warning level

percent

_MEMORY_CRIT

Physical memory and swap critical level

percent

_STORAGE_PATH

Absolute path to check its storage

absolute path

_STORAGE_WARN

Warning level for used disk space

percent

_STORAGE_CRIT

Critical level for used disk space

percent

_SNMP_MSG_MAX_SIZE

Maximum size of the snmp messages

integer

_NTP_WARN

NTP timings warning level (in seconds)

integer

_NTP_CRIT

NTP timings critical level (in seconds)

integer

_CUCM_USER

Call Manager connecting user (SOAP checks)

string

_CUCM_PASSWORD

Password of the Call Manager connecting user(SOAP checks)

string

_ACTIVECALLS_WARNING

Warning threshold for ActiveCalls in the Call Manager

integer

_ACTIVECALLS_CRITICAL

Critical threshold for ActiveCalls in the Call Manager

integer

COMPLEX MACROS

  • _SIP_DEVICES

    • Description: SIP Devices from Call Manager

    • Discover: wocu-discover-cucm.py


Fields

Description

Type

Display Name

Custom Name appearing in the service: SIP_<Display Name>

string

Device Name

SIP Device name (configured on remote device)

string

  • _MGCP_DEVICES

    • Description: MGCP Devices from Call Manager

    • Discover: wocu-discover-cucm.py


Fields

Description

Type

Display Name

Custom Name appearing in the service: MGCP_<Display Name>

string

Device Name

MGCP Device name (configured on remote device)

string

Call-manager-cisco-snmp

DESCRIPTION


Generic and specific checks for Cisco Call Manager devices using only SNMP

../../_images/call-manager-cisco-snmp.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Call Manager Devices - Gateways

Checks the number and status of Gateway devices

call-manager-cisco-snmp-gateways

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTREGISTERED_GATEWAYS_WARNING

_HOSTREGISTERED_GATEWAYS_CRITICAL

Call Manager Devices - Media

Checks the number and status of Media devices

call-manager-cisco-snmp-media

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTREGISTERED_MEDIA_WARNING

_HOSTREGISTERED_MEDIA_CRITICAL

Call Manager CPU Usage

Checks the CPU usage

call-manager-cisco-snmp-cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARN

_HOSTCPU_CRIT

Call Manager Memory Usage

Checks the memory usage

call-manager-cisco-snmp-memory

_HOSTSNMPCOMMUNITY

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

CUCM_Process_$KEY$

Checks process status

call-manager-cisco-snmp-processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_PROCESSES

Call Manager Devices - CTI

Checks the number and status of CTI devices

call-manager-cisco-snmp-cti

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTREGISTERED_CTI_WARNING

_HOSTREGISTERED_CTI_CRITICAL

Call Manager Devices - VoiceMails

Checks the number and status of Voicemail devices

call-manager-cisco-snmp-voicemails

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTREGISTERED_VOICEMAIL_WARNING

_HOSTREGISTERED_VOICEMAIL_CRITICAL

Call Manager Status - local

Checks status from local Cisco Call Manager

call-manager-cisco-snmp-status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Call Manager Devices - Phones

Checks the number and status of Phone devices

call-manager-cisco-snmp-phones

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTREGISTERED_PHONES_WARNING

_HOSTREGISTERED_PHONES_CRITICAL

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_SNMPVERSION:

wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_PROCESSES:

wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

Device SNMP versions supported are: 1 and 2c

string

_REGISTERED_PHONES_WARNING

Registered Phones warning threshold

integer

_REGISTERED_PHONES_CRITICAL

Registered Phones critical threshold

integer

_REGISTERED_GATEWAYS_WARNING

Registered Gateways warning threshold

integer

_REGISTERED_GATEWAYS_CRITICAL

Registered Gateways critical threshold

integer

_REGISTERED_MEDIA_WARNING

Registered Media warning threshold

integer

_REGISTERED_MEDIA_CRITICAL

Registered Media critical threshold

integer

_REGISTERED_CTI_WARNING

Registered Cti warning threshold

integer

_REGISTERED_CTI_CRITICAL

Registered Cti critical threshold

integer

_REGISTERED_VOICEMAIL_WARNING

Registered Voicemails warning threshold

integer

_REGISTERED_VOICEMAIL_CRITICAL

Registered Voicemails critical threshold

integer

_CPU_WARN

CPU usage percent critical threshold

percent

_CPU_CRIT

CPU usage percent critical threshold

percent

_MEMORY_WARN

Physical memory usage percent warning threshold

percent

_MEMORY_CRIT

Physical memory usage percent critical threshold

percent

COMPLEX MACROS

  • _PROCESSES

    • Description: Processes

    • Discover: wocu-discover-os-resources-processes.py


Fields

Description

Type

ProcName

Process label

string

ProcIndex

Process index

integer

Mxone-advanced

DESCRIPTION


Additional Pack for Advanced Licensed devices. Get the operational backup status and traffic status of service nodes (LIMs) using SNMP

../../_images/mxone-advanced.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

LIM_Oper_status_$KEY$

Gets the LIM traffic state

check_mxone_advanced_oper_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_LIM_ADVANCED_LIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_LIM_ADVANCED_LIST:

wocu-discover-mxone-advanced.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

SNMP version

string

COMPLEX MACROS

  • _LIM_ADVANCED_LIST

    • Description: List of node services (LIMs) to be checked

    • Discover: wocu-discover-mxone-advanced.py


Fields

Description

Type

display_name

Name to be shown as Service Description in the web interface

string

index

Index of node service (LIM) (integer)

integer

ip_address

Management IP Address of node service (LIM). Discovered IP is the host address where the pack is applied, configure manually a LIM IP address accessible from Wocu

string

name

Name of node service (LIM)

string

Mxone-basic

DESCRIPTION


Pack for Basic Licensed devices. Get the number of active (unhandled) alarms and status of every LIM using SNMP

../../_images/mxone-basic.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

MX-ONE_Active_alarms_$KEY$

Shows the total number of active (unhandled) alarms on the node service (LIM)

check_mxone_basic_alarms

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTALARM_WARNING

_HOSTALARM_CRITICAL

_LIM_LIST

MX-ONE_Alarms_max_level_$KEY$

Shows the current alarm status in the node service (LIM).

check_mxone_basic_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSTATUS_CRITICAL

_LIM_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP Community

string

_SNMPVERSION

SNMP version

string

_ALARM_WARNING

Warning threshold for number of active (unhandled) alarms

integer

_ALARM_CRITICAL

Critical threshold for number of active (unhandled) alarms

integer

_STATUS_CRITICAL

Critical threshold for maximum severity level of active (unhandled) alarms. Must be in the 0-5 range

integer

COMPLEX MACROS

  • _LIM_LIST

    • Description: List of node services (LIMs) to be checked


Fields

Description

Type

display_name

Name to be shown as Service Description in the web interface

string

ip_address

Management IP Address of node service (LIM). Discovered IP is the host address where the pack is applied, configure manually a LIM IP address accessible from Wocu

string

Sbc-acme-packet

DESCRIPTION


Checks for AcmePacket SBC gateways via snmp

../../_images/sbc-acme-packet.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SBC Redundancy State

Checks the redundancy state of the SBC node

sbc_acme_redundancy

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

SBC AcmePacket Info

Shows system information

sbc_acme_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

SBC System Health

Check the system health expressed as percentage

sbc_acme_system_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSYSTEM_HEALTH_WARNING

_HOSTSYSTEM_HEALTH_CRITICAL

Call Rate $KEY$

Checks the inbound and outbound sessions increment

sbc_acme_call_rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_REALMLIST

SBC CPU Usage

Checks the CPU usage

sbc_acme_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_USAGE_WARNING

_HOSTCPU_USAGE_CRITICAL

SBC Call Statistics

Checks the global call statistics (concurrent sessions and call per second)

sbc_acme_call_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONCURRENT_SESSIONS_WARNING

_HOSTCONCURRENT_SESSIONS_CRITICAL

System state

Check the snmp sytem state of the SBC device

sbc_system_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

SBC Memory Usage

sbc_acme_memory_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEMORY_USAGE_WARNING

_HOSTMEMORY_USAGE_CRITICAL

Outbound Sessions $KEY$

Checks the actual outbound sessions number

sbc_acme_outbound_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_REALMLIST

SBC License Usage

Checks the percentage of SBC license in use

sbc_acme_license_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLICENSE_USAGE_WARNING

_HOSTLICENSE_USAGE_CRITICAL

Inbound Sessions $KEY$

Checks the actual inbound sessions number

sbc_acme_inbound_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_REALMLIST

DISCOVER SCRIPTS


A monitoring pack can provide discover scripts to automatically gather some macros.

Note

A discover script has the following format:

<_MACRO> : Macro discovered

<script.py> <arguments>: Script and arguments to discover _MACRO

The discover scripts provided by this pack can discover the next macros:

_REALMLIST:

wocu-discover-sbc-realms.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The read snmp community allowed on the SBC server

string

_SNMPVERSION

SNMP version of the SBC server (allowed 1 and 2c)

string

_INBOUND_SESSIONS_WARNING

Inbound sessions warning threshold

integer

_INBOUND_SESSIONS_CRITICAL

Inbound sessions critical threshold

integer

_OUTBOUND_SESSIONS_WARNING

Outbound sessions warning threshold

integer

_OUTBOUND_SESSIONS_CRITICAL

Outbound sessions critical threshold

integer

_CPU_USAGE_WARNING

CPU usage Warning threshold

integer

_CPU_USAGE_CRITICAL

CPU usage Critical threshold

integer

_MEMORY_USAGE_WARNING

Memory usage Warning threshold

integer

_MEMORY_USAGE_CRITICAL

Memory usage Critical threshold

integer

_SYSTEM_HEALTH_WARNING

System health Warning threshold

integer

_SYSTEM_HEALTH_CRITICAL

System health Critical threshold

integer

_CONCURRENT_SESSIONS_WARNING

Concurrent sessions Warning threshold

integer

_CONCURRENT_SESSIONS_CRITICAL

Concurrent sessions Critical threshold

integer

_LICENSE_USAGE_WARNING

License usage Warning threshold

integer

_LICENSE_USAGE_CRITICAL

License usage Critical threshold

integer

COMPLEX MACROS

  • _REALMLIST

    • Description: List of Realms

    • Discover: wocu-discover-sbc-realms.py


Fields

Description

Type

display_name

Realm name

string

index

snmp realm index

integer

inbound_rejected_warning

Inbound rejected sessions warning threshold

integer

inbound_rejected_critical

Inbound rejected sessions critical threshold

integer

outbound_rejected_warning

Outbound rejected sessions warning threshold

integer

outbound_rejected_critical

Outbound rejected sessions critical threshold

integer

inbound_call_rate_warning

Inbound sessions increment warning threshold

integer

outbound_call_rate_critical

Outbound sessions increment critical threshold

integer

inbound_active_warning

Inbound active sessions warning threshold

integer

inbound_active_critical

Inbound active sessions critical threshold

integer

outbound_active_warning

Outbound active sessions warning threshold

integer

outbound_active_critical

Outbound active sessions critical threshold

integer

Sbc-audiocodes

DESCRIPTION


Checks for Audiocodes SBC gateways via snmp

../../_images/sbc-audiocodes.png

Pack for checking SBC Audiocodes VoIP Gateway devices. This pack checks Audiocodes gateway devices, polled via snmp.

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

SBC PSTN channels

Check the PSTN channels utilization

sbc_audiocodes_pstn_channels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTRUNK_CHANNELS_IN_SERVICE_WARNING

_HOSTTRUNK_CHANNELS_IN_SERVICE_CRITICAL

SBC Audiocodes Info

Shows system information

sbc_audiocodes_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

SBC OffHook channels

Checks the Off Hook channels

sbc_audiocodes_offhook_channels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTOFFHOOK_CHANNELS_WARNING

_HOSTOFFHOOK_CHANNELS_CRITICAL

SBC DSP utilization

Checks the DSP (Digital Signal Processing) utilization

sbc_audiocodes_dsp_utilization

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTACTIVE_DSP_CHANNELS_WARNING

_HOSTACTIVE_DSP_CHANNELS_CRITICAL

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

The read snmp community allowed on the SBC server

string

_SNMPVERSION

SNMP version of the SBC server

string

_ACTIVE_DSP_CHANNELS_WARNING

Active DSP channels warning threshold

integer

_ACTIVE_DSP_CHANNELS_CRITICAL

Active DSP channels critical threshold

integer

_TRUNK_CHANNELS_IN_SERVICE_WARNING

Trunk channels in service warning threshold

integer

_TRUNK_CHANNELS_IN_SERVICE_CRITICAL

Trunk channels in service critical threshold

integer

_OFFHOOK_CHANNELS_WARNING

Off Hook channels Warning threshold

integer

_OFFHOOK_CHANNELS_CRITICAL

Off Hook channels Critical threshold

integer

Skype-for-business

DESCRIPTION


Skype For Business health and performance checks via nsclient

../../_images/skype-for-business.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

Skype_Memory

check_skype_for_business_mem

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Skype_Drivesize

check_skype_for_business_drivesize

_HOSTDRIVESIZE_WARNING

_HOSTDRIVESIZE_CRITICAL

Skype_CPU

check_skype_for_business_cpu

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Skype_service_$KEY$

check_skype_for_business_service

_SKYPE_SERVICES_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_CPU_WARNING

CPU usage warning threshold (percent)

integer

_CPU_CRITICAL

CPU usage critical threshold (percent)

integer

_MEM_WARNING

Memory usage warning threshold (percent)

integer

_MEM_CRITICAL

Memory usage critical threshold (percent)

integer

_DRIVESIZE_WARNING

Drive usage warning threshold (percent)

integer

_DRIVESIZE_CRITICAL

Drive usage critical threshold (percent)

integer

COMPLEX MACROS

  • _SKYPE_SERVICES_LIST

    • Description: List of Skype services to overwatch


Fields

Description

Type

name

Display name to be shown as part of the service description

string

service

Service name to monitor. Ex: RTCCLSAGT

string

Hardware

Cisco-ucs-server-hwinfo

DESCRIPTION


Hardware health checks for Cisco UCS Rack Servers, via CICM (snmp)

../../_images/cisco-ucs-server-hwinfo.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

FANs

Checks fans status

check_ucs_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPUs_temperatures

Checks the CPU temperature

check_ucs_cpu_temps

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPUTEMPWR

_HOSTCPUTEMPCR

Disks_info

Shows disk info

check_ucs_disks_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Memory_info

Shows memory info

check_ucs_mem_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPUs_info

Shows CPU info

check_ucs_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Raid_status

Checks the Raid status

check_ucs_raids_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs

Checks the Powersupply status

check_ucs_psus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Disks_states

Checks the Disk status

check_ucs_localdisks

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Storage_controller

Checks the Storage Controller status

check_ucs_storage_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs_voltage

Checks the Powersupply voltage

check_ucs_psus_voltage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUVOLTWR

_HOSTPSUVOLTCR

Server_info

Shows server info

check_ucs_server_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Memory_status

Checks the memory status

check_ucs_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPUs_status

Checks the CPU status

check_ucs_cpus_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Raid_info

Shows Raid info

check_ucs_raids_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

Snmp community

string

_SNMPVERSION

Snmp version

string

_CPUTEMPWR

CPU temperature warning (Celsius degrees)

integer

_CPUTEMPCR

CPU temperature critical (Celsius degrees)

integer

_PSUVOLTWR

PSU voltage warning

float

_PSUVOLTCR

PSU voltage critical

float

Crossbeam

DESCRIPTION


Generic checks for Crossbeam devices

../../_images/crossbeam.png

Important

The terms and concepts used in this section are explained in the Terminology section.

SERVICES


The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.

Name

Description

Check Command

Macros

XBEAM CPU Temp

Checks the CPU temperature

check_cpu_temp

_HOSTSNMPCOMMUNITY

_HOSTCPU_TEMP_WARNING

_HOSTCPU_TEMP_CRITICAL

XBEAM Failover_group_status $KEY$

Checks the failover group status

check_failover_group_status

_HOSTSNMPCOMMUNITY

_CROSSBEAM_FAILOVER_GR_STATUS

XBEAM CPU_Load $KEY$

Checks the CPU instant load

check_cpu_load

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOAD_WARNING

_HOSTCPU_LOAD_CRITICAL

_CROSSBEAM_CPU_LOAD_LIST

XBEAM CPU_Idle $KEY$

Checks the CPU Idle time

check_cpu_idle

_HOSTSNMPCOMMUNITY

_HOSTCPU_IDLE_WARNING

_HOSTCPU_IDLE_CRITICAL

_CROSSBEAM_CPU_IDLE_LIST

XBEAM CPU_Util $KEY$

Checks the CPU utilization percent

check_cpu_util

_HOSTSNMPCOMMUNITY

_HOSTCPU_UTIL_WARNING

_HOSTCPU_UTIL_CRITICAL

_CROSSBEAM_CPU_UTIL_LIST

XBEAM CPU_LoadAvg15 $KEY$

Checks the CPU 15 minute load average

check_cpu_loadavg15

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOADAVG15_WARNING

_HOSTCPU_LOADAVG15_CRITICAL

_CROSSBEAM_CPU_LOADAVG15_LIST

XBEAM Memory Usage

Checks the memory usage

check_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

XBEAM CPU_Iowait $KEY$

Checks the CPU I/O wait time

check_cpu_iowait

_HOSTSNMPCOMMUNITY

_HOSTCPU_IOWAIT_WARNING

_HOSTCPU_IOWAIT_CRITICAL

_CROSSBEAM_CPU_IOWAIT_LIST

XBEAM CPU_System $KEY$

Checks the System CPU

check_cpu_system

_HOSTSNMPCOMMUNITY

_HOSTCPU_SYSTEM_WARNING

_HOSTCPU_SYSTEM_CRITICAL

_CROSSBEAM_CPU_SYSTEM_LIST

XBEAM Interface_in_octets $KEY$

Checks the interface traffic in bytes

check_interface_in_octets

_HOSTSNMPCOMMUNITY

_HOSTIN_OCTETS_WARNING

_HOSTIN_OCTETS_CRITICAL

_CROSSBEAM_IN_OCTETS_LIST

XBEAM Uptime

Checks the system uptime

check_uptime

_HOSTSNMPCOMMUNITY

XBEAM Memory Free

Checks the free memory

check_mem_free

_HOSTSNMPCOMMUNITY

_HOSTMEM_FREE_WARNING

_HOSTMEM_FREE_CRITICAL

XBEAM Chassis Temperature

Checks XBEAM Chassis temperature

check_chassis_temp

_HOSTSNMPCOMMUNITY

_HOSTCHASSIS_TEMP_WARNING

_HOSTCHASSIS_TEMP_CRITICAL

XBEAM Swap Usage

Checks the SWAP usage

check_swap_usage

_HOSTSNMPCOMMUNITY

_HOSTSWAP_USAGE_WARNING

_HOSTSWAP_USAGE_CRITICAL

XBEAM CPU_LoadAvg5 $KEY$

Checks the CPU 5 minute load average

check_cpu_loadavg5

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOADAVG5_WARNING

_HOSTCPU_LOADAVG5_CRITICAL

_CROSSBEAM_CPU_LOADAVG5_LIST

XBEAM HA Status

Checks the HA Status

check_ha_status

_HOSTSNMPCOMMUNITY

XBEAM Vap_Status $KEY$

Checks the VAP status

check_vap_status

_HOSTSNMPCOMMUNITY

_CROSSBEAM_VAP_STATUS_LIST

XBEAM CPU_LoadAvg1 $KEY$

Checks the CPU 1 minute load average

check_cpu_loadavg1

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOADAVG1_WARNING

_HOSTCPU_LOADAVG1_CRITICAL

_CROSSBEAM_CPU_LOADAVG1_LIST

MACROS


The following macros can be configured in order to modify the pack behaviour for each host that uses it:

SIMPLE MACROS

Name

Description

Type

_SNMPCOMMUNITY

SNMP community to use in the check

string

_SNMPVERSION

SNMP version to use in the check

string

_CPU_IDLE_WARNING

CPU Idle warning threshold

percent

_CPU_IDLE_CRITICAL

CPU Idle critical threshold

percent

_CPU_IOWAIT_WARNING

CPU IOWAIT warning threshold

percent

_CPU_IOWAIT_CRITICAL

CPU IOWAIT critical threshold

percent

_CPU_LOAD_WARNING

CPU Load warning threshold