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

Network

A10

DESCRIPTION


Custom checks for A10 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

a10_virtual_server_port_connections_$KEY$

Shows A10 Virtual Server Port Connections Stats.

check_a10_virtual_server_port_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUAL_SERVER_PORTS_LIST

a10_global_system_resources

Shows A10 Global System Resources usage.

check_a10_global_system_resources

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_server_port_traffic_$KEY$

Shows A10 Server Port Traffic Stats.

check_a10_server_port_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVER_PORT_LIST

a10_server_connections_$KEY$

Shows A10 Server Connections Stats.

check_a10_server_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVER_LIST

a10_service_group_member_traffic_$KEY$

Shows A10 Service Group Member Traffic Stats.

check_a10_service_group_member_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVICE_GROUP_MEMBERS_LIST

a10_power_supply

Checks A10 Power Supply Status.

check_a10_power_supply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_disk_usage

Checks A10 Disk usage.

check_a10_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_service_group_member_connections_$KEY$

Shows A10 Service Group Member Connections Stats.

check_a10_service_group_member_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVICE_GROUP_MEMBERS_LIST

a10_server_traffic_$KEY$

Shows A10 Server Traffic Stats.

check_a10_server_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVER_LIST

a10_cpu_usage

Checks A10 CPU usage.

check_a10_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_fan

Checks A10 Fans status.

check_a10_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_virtual_server_traffic_$KEY$

Shows A10 Virtual Server Traffic Stats.

check_a10_virtual_server_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUAL_SERVERS_LIST

a10_mem_usage

Checks A10 Memory usage.

check_a10_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

a10_service_group_connections_$KEY$

Shows A10 Service Group Connections Stats.

check_a10_service_group_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVICE_GROUP_LIST

a10_server_port_connections_$KEY$

Shows A10 Server Port Connections Stats.

check_a10_server_port_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVER_PORT_LIST

a10_virtual_server_port_traffic_$KEY$

Shows A10 Virtual Server Port Traffic Stats.

check_a10_virtual_server_port_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUAL_SERVER_PORTS_LIST

a10_service_group_traffic_$KEY$

Shows A10 Service Group Traffic Stats.

check_a10_service_group_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_SERVICE_GROUP_LIST

a10_virtual_server_connections_$KEY$

Shows A10 Virtual Server Connections Stats.

check_a10_virtual_server_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_VIRTUAL_SERVERS_LIST

a10_global_sessions

Checks A10 Global sessions.

check_a10_global_sessions

_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:

_SERVER_LIST:

wocu-discover-a10-servers.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$

_SERVER_PORT_LIST:

wocu-discover-a10-server-ports.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$

_SERVICE_GROUP_LIST:

wocu-discover-a10-service-groups.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$

_SERVICE_GROUP_MEMBERS_LIST:

wocu-discover-a10-service-group-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$

_VIRTUAL_SERVERS_LIST:

wocu-discover-a10-virtual-servers.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$

_VIRTUAL_SERVER_PORTS_LIST:

wocu-discover-a10-virtual-server-ports.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

_DISK_WARNING

Disk usage warning threshold

percent

_DISK_CRITICAL

Disk usage critical threshold

percent

COMPLEX MACROS

  • _SERVER_LIST

    • Description: List of Servers

    • Discover: wocu-discover-a10-servers.py


Fields

Description

Type

display_name

Server name

string

oid_suffix

Server OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

  • _SERVER_PORT_LIST

    • Description: List of Server Ports

    • Discover: wocu-discover-a10-server-ports.py


Fields

Description

Type

display_name

Server port name

string

oid_suffix

Server OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

  • _SERVICE_GROUP_LIST

    • Description: List of Service Groups

    • Discover: wocu-discover-a10-service-groups.py


Fields

Description

Type

display_name

Service group name

string

oid_suffix

Server OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

  • _SERVICE_GROUP_MEMBERS_LIST

    • Description: List of Service Group Members

    • Discover: wocu-discover-a10-service-group-members.py


Fields

Description

Type

display_name

Service group member name

string

oid_suffix

Service group member OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

  • _VIRTUAL_SERVERS_LIST

    • Description: List of Virtual Servers

    • Discover: wocu-discover-a10-virtual-servers.py


Fields

Description

Type

display_name

Virtual Server name

string

oid_suffix

Virtual Server OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

  • _VIRTUAL_SERVER_PORTS_LIST

    • Description: List of Virtual Server Ports

    • Discover: wocu-discover-a10-virtual-server-ports.py


Fields

Description

Type

display_name

Virtual Server Port name

string

oid_suffix

Virtual Server OID suffix

string

conn_warnning

Virtual Server connection warnning threshold

integer

conn_critical

Virtual Server connection critical threshold

integer

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

Active lines

Checks the number of active lines

active_lines

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLINES_WARNING

_HOSTLINES_CRITICAL

Connection establishment rate

Checks the connection establishment rate

connection_est

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONNECTION_WARNING

_HOSTCONNECTION_CRITICAL

Software status

Checks the software status

software_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

FANs status

Checks the status of fans

fans_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Protocol update licence

Checks the expiration date of Allot protocol update

protocol_update

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPROTOCOL_UPDATE_WARNING

RAM Usage

Checks the main memory usage

mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRAM_WARNING

_HOSTRAM_CRITICAL

Disk Usage

Checks the storage usage

disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

Virtual channels

Checks the number of virtual channels

virtual_channels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVIRTUAL_CHANNELS_DEFAULT_WARNING

_HOSTVIRTUAL_CHANNELS_DEFAULT_CRITICAL

CPU Average

Checks the average use of CPU

cpu_avg

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Board Temperature Range

Checks the board temperature

board_temperature_range

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PowerSupply status

Checks the status of power supplies

powersupply_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

allot_uptime

Checks the device uptime

uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Pipes

Checks the number of pipes

pipes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPIPES_WARNING

_HOSTPIPES_CRITICAL

Hardware status

Checks the hardware status

hardware_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Sensors Temperature

Checks the temperature obtained from sensors

sensor_temperature

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSENSOR_TEMP_WARNING

_HOSTSENSOR_TEMP_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_cpu

Checks the controller cpu usage

check_cpu_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Radio_Info $KEY$

Shows radio channel info

check_aruba_alcatel_ap_radio_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

Radio_Bytes $KEY$

Checks the bytes per radio channel

check_aruba_alcatel_controller_radio_bytes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Controller_Temp

Checks the controller temperature

check_aruba_alcatel_controller_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING_THRESHOLD

_HOSTTEMP_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

WLAN_Throughput

Checks the throughput per WLAN

check_aruba_alcatel_controller_wlan_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_THROUGHPUT_WARNING

_HOSTWLAN_THROUGHPUT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_Info_$KEY$

Shows Access Point info

check_aruba_alcatel_ap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

aruba-wifi-controller_WLAN_Clients

Checks the clients connected per WLAN

check_aruba_alcatel_controller_wlan_clients

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_WARNING

_HOSTWLAN_CLIENTS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Channel_utilization $KEY$

Checks the channel utilization

check_aruba_alcatel_channel_utilization

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_UTIL_WARNING_THRESHOLD

_HOSTCHANNEL_UTIL_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Aruba-wifi-controller_WLAN_ESSIDs

Shows the WLAN essids running in the controller

check_aruba_alcatel_essid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Radio_RX_Bytes $KEY$

Checks the RX bytes per radio channel

check_aruba_alcatel_controller_radio_bytes_rx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Controller_Power_Supply

Checks the status of controller power supplies

check_aruba_alcatel_controller_power_supply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Channel_inteference $KEY$

Checks the radio channel inteference

check_aruba_alcatel_channel_interference

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_INTERF_WARNING_THRESHOLD

_HOSTCHANNEL_INTERF_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Controller_Fans

Checks the fans status from the controller

check_aruba_alcatel_controller_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Channel_bandwidth $KEY$

Checks the bandwidth per radio channel

check_aruba_alcatel_channel_bandwidth

_HOSTSNMPCOMMUNITY

_HOSTCHANNEL_BW_WARNING_THRESHOLD

_HOSTCHANNEL_BW_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Radio_TX_Bytes $KEY$

Checks the TX bytes per radio channel

check_aruba_alcatel_controller_radio_bytes_tx

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Controller_ap_count

Checks the number of Access Points connected to the controller

check_ap_count_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTAP_COUNT_WARNING_THRESHOLD

_HOSTAP_COUNT_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_uptime $KEY$

Checks the Access Point uptime

check_aruba_alcatel_ap_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_MIN_UPTIME

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

AP_status $KEY$

Checks the Access Point status

check_aruba_alcatel_ap_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

Controller_disks

Checks the controller storage usage

check_disks_aruba_alcatel_controller

_HOSTSNMPCOMMUNITY

_HOSTDISKS_WARNING_THRESHOLD

_HOSTDISKS_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Controller_memory

Checks the controller memory usage

check_aruba_alcatel_controller_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

_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:

_APLIST:

wocu-discover-aruba-alcatel-wifi-aps.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$

_CHLIST:

wocu-discover-aruba-wifi-controller-channels.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

_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

_AP_COUNT_WARNING_THRESHOLD

AP count warning threshold

integer

_AP_COUNT_CRITICAL_THRESHOLD

AP count 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

Channel_status $KEY$

Checks the radio channel status

check_aruba_alcatel_iap_channel_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

Client_count

Checks the number of clients

check_aruba_alcatel_iap_client_count

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_COUNT_WARNING

_HOSTCLIENT_COUNT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_ap_count

Checks the number of connected Access Points

check_aruba_alcatel_iap_ap_count

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_COUNT_WARNING

_HOSTAP_COUNT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

WLAN_TX_Throughput

Checks the TX throughput per WLAN

check_aruba_alcatel_iap_wlan_tx_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTX_THROUGHPUT_WARNING

_HOSTTX_THROUGHPUT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_Status $KEY$

Checks the Access Point status

check_aruba_alcatel_iap_ap_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

Channel_util $KEY$

Checks the radio channel utilization

check_aruba_alcatel_iap_channel_util

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCHANNEL_UTIL_WARNING

_HOSTCHANNEL_UTIL_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CHLIST

AP_Info $KEY$

Shows Access Point info

check_aruba_alcatel_iap_ap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

AP_Uptime $KEY$

Checks Access Point uptime

check_aruba_alcatel_iap_ap_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_UPTIME_WARNING

_HOSTAP_UPTIME_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

WLAN_Clients

Checks the number of clients per WLAN

check_aruba_alcatel_iap_wlan_clients

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_WARNING

_HOSTWLAN_CLIENTS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_MEM $KEY$

Checks the Access Point memory usage

check_aruba_alcatel_iap_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

AP_CPU $KEY$

Checks the Access Point CPU usage

check_aruba_alcatel_iap_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APLIST

WLAN_ESSIDs

Shows the WLAN essids published by the controller

check_aruba_alcatel_iap_essid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

WLAN_RX_Throughput

Checks the RX throughput per WLAN

check_aruba_alcatel_iap_wlan_rx_throughput

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRX_THROUGHPUT_WARNING

_HOSTRX_THROUGHPUT_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:

_APLIST:

wocu-discover-alcatel-wifi-aps.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$

_CHLIST:

wocu-discover-aruba-wifi-iap-channels.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

_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 - Temperature

Checks the status and value from all temperature sensors

aruba-oscx-temperature

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Aruba OSCX - Fans

Checks the fans status and speed

aruba-oscx-fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Aruba OSCX - Power Supply

Checks the power supplies status

aruba-oscx-powersupply

_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

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

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

_HOSTSNMPSECURITYLEVEL

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-9800-wifi-controller

DESCRIPTION


Checks for the Cisco 9800 series controller and its asociated APs

../../_images/cisco-9800-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_essid

Shows the WLAN ESSIDs published in the controller

check_essid_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Controller_temp

Checks the controller temperature

check_temp_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTTEMP_CRITICAL

_HOSTTEMP_WARNING

_HOSTSNMPVERSION

_HOSTSNMPSECURITYLEVEL

AP_noise_power $KEY$

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

check_ap_noise_power_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CHANNEL_NOISE_POWER_WARNING_THRESHOLD

_HOSTAPS_CHANNEL_NOISE_POWER_CRITICAL_THRESHOLD

_CISCO_APLIST

Client_count

Checks the total number of clients

check_client_count_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_COUNT_DEFAULT_WARNING

_HOSTCLIENT_COUNT_DEFAULT_CRITICAL

AP_count

Checks the number of connected Access Points

check_ap_count_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CONNECTED_WARNING_THRESHOLD

_HOSTAPS_CONNECTED_CRITICAL_THRESHOLD

Controller_cpu

Checks the controller CPU usage

check_cpu_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

Channel_interference $KEY$

Checks the Radio Channel interference

check_channel_interf_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAPS_CHANNEL_INTERFERENCE_WARNING_THRESHOLD

_HOSTAPS_CHANNEL_INTERFERENCE_CRITICAL_THRESHOLD

_CISCO_CHLIST

AP_clients $KEY$

Checks the clients per Access Point

check_ap_clients_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_CLIENTS_WARNING_THRESHOLD

_HOSTAP_CLIENTS_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_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_SNR_AVG_WARNING_THRESHOLD

_HOSTCLIENT_SNR_AVG_CRITICAL_THRESHOLD

_CISCO_CHLIST

AP_radio_clients $KEY$

Checks the clients per Radio Channel

check_ap_radio_clients_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTAP_RADIO_CLIENTS_DEFAULT_WARNING

_HOSTAP_RADIO_CLIENTS_DEFAULT_CRITICAL

_CISCO_CHLIST

Channel_utilization $KEY$

Checks the Radio Channel utilization

check_channel_util_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCHANNEL_UTIL_WARNING_THRESHOLD

_HOSTCHANNEL_UTIL_CRITICAL_THRESHOLD

_CISCO_CHLIST

WLAN_Clients

Checks the number of clients per WLAN

check_wlan_clients_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTWLAN_CLIENTS_DEFAULT_WARNING

_HOSTWLAN_CLIENTS_DEFAULT_CRITICAL

Controller_power_supply

Checks the controller powersupply status

check_power_supply_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYLEVEL

Controller_memory

Checks the controller memory usage

check_mem_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTDEVICEVENDOR

_HOSTSNMPVERSION

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

Controller_info

Shows controller info

check_info_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

AP_status $KEY$

Checks the Access Point status

check_ap_status_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_APLIST

AP_radio_info $KEY$

Shows info of the Radio Channels

check_ap_radio_info_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_CHLIST

AP_info $KEY$

Shows info from Access Point

check_ap_info_cisco_wifi_controller_9800

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CISCO_APLIST

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$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’

_CISCO_CHLIST:

wocu-discover-cisco-wifi-channels.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

_CPU_WARNING_THRESHOLD

CPU warning threshold

percent

_CPU_CRITICAL_THRESHOLD

CPU critical threshold

percent

_MEM_WARNING_THRESHOLD

Memory free warning threshold (percent)

percent

_MEM_CRITICAL_THRESHOLD

Memory free 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_WARNING

Controller temperature warning threshold (Celsius)

integer

_TEMP_CRITICAL

Controller temperature critical 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

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-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

cisco-acs-processes_$KEY$

Checks Cisco ACS process information.

cisco_acs_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

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-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-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-uptime

Checks Cisco ACS uptime information.

cisco_acs_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_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 powersupply

Checks the Powersupply status

check_cisco_asr_health_powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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 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_essid

Shows the WLAN ESSIDs published in the controller

check_essid_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Controller_temp

Checks the controller temperature

check_temp_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTTEMP_DEFAULT_HIGH

_HOSTTEMP_DEFAULT_LOW

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_APLIST

Cisco-wifi-controller-Client_count

Checks the total number of clients

check_client_count_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCLIENT_COUNT_DEFAULT_WARNING

_HOSTCLIENT_COUNT_DEFAULT_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller_cpu

Checks the controller CPU usage

check_cpu_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_CHLIST

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_CHLIST

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_CHLIST

Cisco-wifi-controller_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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Controller_power_supply

Checks the controller powersupply status

check_power_supply_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller-memory

Checks the controller memory usage

check_mem_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Controller_info

Shows controller info

check_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_status $KEY$

Checks the Access Point status

check_ap_status_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_APLIST

AP_radio_info $KEY$

Shows info of the Radio Channels

check_ap_radio_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_CHLIST

AP_info $KEY$

Shows info from Access Point

check_ap_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_APLIST

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$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$

_CISCO_CHLIST:

wocu-discover-cisco-wifi-channels.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

_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

Cisco-wifi-controller-reduced

DESCRIPTION


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

../../_images/cisco-wifi-controller-reduced.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-wifi-controller-reduced_temp

Checks the controller temperature

check_temp_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTTEMP_DEFAULT_HIGH

_HOSTTEMP_DEFAULT_LOW

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller-reduced_cpu

Checks the controller CPU usage

check_cpu_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING_THRESHOLD

_HOSTCPU_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller-reduced_power_supply

Checks the controller powersupply status

check_power_supply_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller-reduced_memory

Checks the controller memory usage

check_mem_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Cisco-wifi-controller-reduced_info

Shows controller info

check_info_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

AP_status $KEY$

Checks the Access Point status

check_ap_status_cisco_wifi_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_CISCO_APLIST

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$ –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

_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

_TEMP_DEFAULT_HIGH

Controller temperature high threshold (Celsius)

integer

_TEMP_DEFAULT_LOW

Controller temperature low threshold (Celsius)

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

Dns

DESCRIPTION


This plugin requests a DNS server and compare the result with the expected one

../../_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 or cname expected to be returned. If you want to configure several addresses, you must separate them with commas. All of them must be included in the response. When using cname and a FQDN, it ends with a dot (.)

string

Dns-advanced

DESCRIPTION


This plugin requests a DNS server and compare the result with the expected one. 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

Dns address or cname expected to be returned. If you want to configure several addresses, you must separate them with commas. All of them must be included in the response. When using cname and a FQDN, it ends with a dot (.)

string

Efficientip

DESCRIPTION


Monitoring Efficient IP devices 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

Efficientip_dns_answers_stats

Gest DNS Answers Statistics

check_efficientip_dns_answers_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Efficientip_cpu_usage

Checks the average CPU usage

check_efficientip_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_USAGE_PCT_WARNING_THRESHOLD

_HOSTCPU_USAGE_PCT_CRITICAL_THRESHOLD

Efficientip_dnssec_stats

Gest DNSSEC Statistics

check_efficientip_dns_sec_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Efficientip_cpu_load

Checks the average CPU load

check_efficientip_cpu_load

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_LOAD_WARNING_THRESHOLD

_HOSTCPU_LOAD_CRITICAL_THRESHOLD

Efficientip_mem_usage

Checks the Memory usage

check_efficientip_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEM_WARNING_THRESHOLD

_HOSTMEM_CRITICAL_THRESHOLD

Efficientip_dns_res_queries_stats

Gest DNS Resolution Queries Statistics

check_efficientip_dns_res_queries_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Efficientip_dnsstats

Gest DNS Statistics

check_efficientip_dnsstats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Efficientip_process_$KEY$

Checks the state of a given process

check_efficientip_process

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

Efficientip_dns_transfer_req_stats

Gest DNS Transfer Requests Statistics

check_efficientip_dns_transfer_req_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Efficientip_dhscpstats

Gest DHCP Statistics

check_efficientip_dhcpstats

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTDHCP_WARNING_DISCOVERS

_HOSTDHCP_CRITICAL_DISCOVERS

_HOSTDHCP_WARNING_REQUESTS

_HOST_DHCPCRITICAL_REQUESTS

_HOSTDHCP_WARNING_RELEASES

_HOSTDHCP_CRITICAL_RELEASES

_HOSTDHCP_WARNING_OFFERS

_HOSTDHCP_CRITICAL_OFFERS

_HOSTDHCP_WARNING_ACKS

_HOSTDHCP_CRITICAL_ACKS

_HOSTDHCP_WARNING_NACKS

_HOSTDHCP_CRITICAL_NACKS

_HOSTDHCP_WARNING_DECLINES

_HOSTDHCP_CRITICAL_DECLINES

_HOSTDHCP_WARNING_INFORMS

_HOSTDHCP_CRITICAL_INFORMS

Efficientip_disks_usage_$KEY$

Checks the Disks usage

check_efficientip_disks_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTDISK_WARNING_THRESHOLD

_HOSTDISK_CRITICAL_THRESHOLD

_PARTITIONS

Efficientip_swap

Checks the Swap usage

check_efficientip_swap

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSWAP_WARNING_THRESHOLD

_HOSTSWAP_CRITICAL_THRESHOLD

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_LOAD_WARNING_THRESHOLD

CPU Load warning threshold

integer

_CPU_LOAD_CRITICAL_THRESHOLD

CPU Load critical threshold

integer

_CPU_USAGE_PCT_WARNING_THRESHOLD

CPU usage percent warning threshold

percent

_CPU_USAGE_PCT_CRITICAL_THRESHOLD

CPU usage percent critical threshold

percent

_MEM_WARNING_THRESHOLD

Memory warning threshold

percent

_MEM_CRITICAL_THRESHOLD

Memory critical threshold

percent

_SWAP_WARNING_THRESHOLD

Swap memory warning threshold

percent

_SWAP_CRITICAL_THRESHOLD

Swap memory critical threshold

percent

_DISK_WARNING_THRESHOLD

Disk storage warning threshold

percent

_DISK_CRITICAL_THRESHOLD

Disk storage critical threshold

percent

_DHCP_WARNING_DISCOVERS

DHCP Discovers warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_DISCOVERS

DHCP Discovers critical threshold (Requests/s). Optional

string

_DHCP_WARNING_REQUESTS

DHCP Requests warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_REQUESTS

DHCP Requests critical threshold (Requests/s). Optional

string

_DHCP_WARNING_RELEASES

DHCP Releases warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_RELEASES

DHCP Releases critical threshold (Requests/s). Optional

string

_DHCP_WARNING_OFFERS

DHCP Offers warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_OFFERS

DHCP Offers critical threshold (Requests/s). Optional

string

_DHCP_WARNING_ACKS

DHCP Acks warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_ACKS

DHCP Acks critical threshold (Requests/s). Optional

string

_DHCP_WARNING_NACKS

DHCP NAcks warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_NACKS

DHCP NAcks critical threshold (Requests/s). Optional

string

_DHCP_WARNING_DECLINES

DHCP Declines warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_DECLINES

DHCP Declines critical threshold (Requests/s). Optional

string

_DHCP_WARNING_INFORMS

DHCP Informs warning threshold (Requests/s). Optional

string

_DHCP_CRITICAL_INFORMS

DHCP Informs critical threshold (Requests/s). Optional

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

  • _PROCESSES

    • Description: Processes

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


Fields

Description

Type

ProcName

Process label

string

ProcParameters

Process parameters

string

Extreme-networks-hw-health

DESCRIPTION


Custom checks for Extreme Networks devices. tested on VOSS

../../_images/extreme-networks-hw-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

extreme_networks_hw_health_temp

Checks Temperature from HW sensors

check_extreme_networks_hw_health_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

extreme_networks_hw_health_fan

Checks Fan status and speed

check_extreme_networks_hw_health_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTFAN_SPEED_WARNING

_HOSTFAN_SPEED_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

extreme_networks_hw_health_powersupply

Checks status from all Power Supplies

check_extreme_networks_hw_health_powersupply

_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

_FAN_SPEED_WARNING

Fan speed warning threshold in RPM

integer

_FAN_SPEED_CRITICAL

Fan speed critical threshold in RPM

integer

_TEMP_WARNING

Temperature warning threshold in Celsius

integer

_TEMP_CRITICAL

Temperature critical threshold in Celsius

integer

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_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_failover_status

Checks F5 BIG-IP failover status (HA).

check_f5_failover_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTFAILOVER_STATUS

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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_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_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_traffic

Shows TMM traffic statistics

check_f5_tmm_traffic

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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_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_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 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

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 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_server_traffic_rate

Checks F5 BIG-IP server traffic rate.

check_f5_server_traffic

_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_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_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_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_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_ssl_transactions

Checks F5 BIG-IP SSL transactions.

check_f5_ssl_transactions

_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

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

_FAILOVER_STATUS

Configured Failover Status. The service will alert if device status is different to configured one.

string

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 Temp

Checks hardware temperature(s)

check_f5_health_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

F5 Fan

Checks Fan(s) status

check_f5_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

F5-tls-certificates

DESCRIPTION


Check TLS certificates from F5 BIG-IP devices.

../../_images/f5-tls-certificates.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_tls_certificates_expiration

Checks the TLS certificates expiration date

check_f5_tls_certificates_expiration

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTEXPIRATION_WARNING

_HOSTEXPIRATION_CRITICAL

_HOSTEXCLUDE_REGEX

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

_EXPIRATION_WARNING

Days to certificates expiration warning threshold. Leave it blank to not alert with WARNING state. Default: 30 days

integer

_EXPIRATION_CRITICAL

Days to certificates expiration critical threshold. Leave it blank to not alert with CRITICAL state. Default: blank

integer

_EXCLUDE_REGEX

Regular expression to exclude certificates by name. Ex: Azure|Verisign|SSL_Cert_Custom

string

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 - Fan

Checks Fan(s) status

check_fortigate_health_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

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 - 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

Gigamon

DESCRIPTION


Health and performance for Gigamon devices

../../_images/gigamon.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

Gigamon_Inline_Network_$KEY$

Checks the Inline network status

check_gigamon_inline_network

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_INLINE_NETWORKS_LIST

Gigamon - Software Version

Checks the device version

check_gigamon_version

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Gigamon - CPU

Checks the device CPU usage

check_gigamon_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Gigamon - Memory

Checks the device memory usage

check_gigamon_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Gigamon - Power Supply

Checks the device power supplies

check_gigamon_power_supply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

Gigamon - Fans

Checks the device fans speed

check_gigamon_fan

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTFAN_WARNING

_HOSTFAN_CRITICAL

Gigamon - Temperature

Checks the device temperature sensors

check_gigamon_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Gigamon_Inline_Tool_$KEY$

Checks the Inline tool status

check_gigamon_inline_tool

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_INLINE_TOOLS_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:

_INLINE_TOOLS_LIST:

wocu-discover-gigamon.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ -t tools –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’

_INLINE_NETWORKS_LIST:

wocu-discover-gigamon.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ -t networks –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

_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

_FAN_WARNING

Fan speed warning threshold (RPM)

integer

_FAN_CRITICAL

Fan speed critical threshold (RPM)

integer

_TEMP_WARNING

Temperature warning threshold (Celsius degrees)

integer

_TEMP_CRITICAL

Temperature critical threshold (Celsius degrees)

integer

COMPLEX MACROS

  • _INLINE_TOOLS_LIST

    • Description: List of inline tools

    • Discover: wocu-discover-gigamon.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

alias

Alias name of Inline tool

string

index

Index used to complete the SNMP OIDs used in queries

integer

neg_hb_status

The negative heartbeat status of inline tool

string

  • _INLINE_NETWORKS_LIST

    • Description: List of inline networks

    • Discover: wocu-discover-gigamon.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

alias

Alias name of Inline network

string

index

Index used to complete the SNMP OIDs used in queries

integer

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-server-status

Checks HAProxy Servers information.

haproxy_server_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-frontend-status

Checks HAProxy Frontend Service information.

haproxy_frontend_status

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

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

haproxy-process-info

Checks HAProxy process information.

haproxy_process_info

_HOSTDPA_PORT

_HOSTDPA_USERNAME

_HOSTDPA_PASSWORD

HAProxy_TCP_$KEY$

Checks HAProxy host port.

check_haproxy_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:

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

_HOSTSNMPSECURITYLEVEL

_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

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

Http - $KEY$

Checks the HTTP web site response time

check_http

_HOSTWARNING_TIME_RESPONSE

_HOSTCRITICAL_TIME_RESPONSE

_HOSTACTION_ON_REDIRECT

_HTTP_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

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

IP:Port to check.

string

_HTTP_PROXY_AUTH

Proxy authentication (user:pass)

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

Unauthorized_code_bypass

Return OK whith 401 Unauthorized code? (default: False)

string

Huawei-wifi-controller

DESCRIPTION


Obtain metrics from Huawei wifi controllers. S300, S500, S1700, S2700, S5700, and S6700 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

huawei-wifi-controller-ap-state

Checks the state of all registered APs

check_huawei_wifi_controller_ap_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTAP_NOT_NORMAL_WARNING

_HOSTAP_NOT_NORMAL_CRITICAL

huawei-wifi-controller-high-dl-retrans-users

Checks the users with downlink retransmission percentage >50%

check_huawei_wifi_controller_users_dl_retrans_percent

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTHIGH_RETRANSMISSION_USERS_WARNING

_HOSTHIGH_RETRANSMISSION_USERS_CRITICAL

huawei-wifi-controller-cpu

Checks the CPU usage

check_huawei_wifi_controller_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

huawei-wifi-controller-radio-noise-dist

Shows Radio distribution based on noise strength

check_huawei_wifi_controller_radio_noise_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-users_by_ap

Shows the connected users by Access Point

check_huawei_wifi_controller_users_by_ap

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-radio-channel-util-dist

Shows Radio distribution based on channel utilization

check_huawei_wifi_controller_channel_utilization_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-low-dl-neg-users

Checks the users with downlink negotation rate <12Mbps

check_huawei_wifi_controller_users_dl_rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTLOW_DOWNLINK_NEG_USERS_WARNING

_HOSTLOW_DOWNLINK_NEG_USERS_CRITICAL

huawei-wifi-controller-high-dl-pkt_loss-users

Checks the users with downlink packet loss percentage >5%

check_huawei_wifi_controller_users_dl_packet_loss_percent

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTHIGH_DOWNLINK_PACKET_LOSS_USERS_WARNING

_HOSTHIGH_DOWNLINK_PACKET_LOSS_USERS_CRITICAL

huawei-wifi-controller-ap-sta-logout-dist

Shows AP distribution based on station logout

check_huawei_wifi_controller_ap_logout_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-users_by_ssid

Shows the connected users by SSID

check_huawei_wifi_controller_users_by_ssid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-dl-retrans-by-ssid

Shows the rdownlonk retransmissions by SSID

check_huawei_wifi_controller_dl_retrans_by_ssid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-mem

Checks the Memory usage

check_huawei_wifi_controller_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

huawei-wifi-controller-high-channel-util-radio

Checks the radios with channel utilization >70%

check_huawei_wifi_controller_channel_utilization_percent

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTHIGH_CHANNEL_UTILIZATION_WARNING

_HOSTHIGH_CHANNEL_UTILIZATION_CRITICAL

huawei-wifi-controller-ap-by-ssid

Shows the registered APs by SSID

check_huawei_wifi_controller_ap_by_ssid

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-total-users

Checks the total number of connected users

check_huawei_wifi_controller_total_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-ap-load-dist

Shows AP distribution based on load

check_huawei_wifi_controller_ap_load_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-radio-interference-dist

Shows Radio distribution based on interference percentage

check_huawei_wifi_controller_radio_interf_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-users_by_band

Shows the connected users by band (2.4Ghz and 5Ghz)

check_huawei_wifi_controller_users_by_band

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-high-noise-radio

Checks the radios with noise strength >-80dBm

check_huawei_wifi_controller_radio_noise_strength

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTLOW_NOISE_STRENGTH_RADIO_WARNING

_HOSTLOW_NOISE_STRENGTH_RADIO_CRITICAL

huawei-wifi-controller-high-interf-radio

Checks the radios with interference >40%

check_huawei_wifi_controller_channel_interference

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTHIGH_CHANNEL_INTERFERENCE_WARNING

_HOSTHIGH_CHANNEL_INTERFERENCE_CRITICAL

huawei-wifi-controller-high-load-radio

Checks the radios with load >40

check_huawei_wifi_controller_channel_load

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTHIGH_CHANNEL_LOAD_WARNING

_HOSTHIGH_CHANNEL_LOAD_CRITICAL

huawei-wifi-controller-low-snr-users

Shows the users with low SNR (signal-noise ratio)

check_huawei_wifi_controller_users_snr

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTLOW_SNR_USERS_WARNING

_HOSTLOW_SNR_USERS_CRITICAL

huawei-wifi-controller-radio-dl-pkt-loss-dist

Shows Radio distribution based on downlink packet loss rate

check_huawei_wifi_controller_radio_dl_packet_loss_dist

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

huawei-wifi-controller-ap-sta-access-fail-dist

Shows AP distribution based on station access failures

check_huawei_wifi_controller_ap_access_fail_dist

_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

_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

_LOW_SNR_USERS_WARNING

Number of users with SNR < 20dB warning threshold

integer

_LOW_SNR_USERS_CRITICAL

Number of users with SNR < 20dB critical threshold

integer

_LOW_DOWNLINK_NEG_USERS_WARNING

Number of users with downlink negotiation rate <12Mbps warning threshold

integer

_LOW_DOWNLINK_NEG_USERS_CRITICAL

Number of users with downlink negotiation rate <12Mbps critical threshold

integer

_HIGH_RETRANSMISSION_USERS_WARNING

Number of users with retransmission rate >50% warning threshold

integer

_HIGH_RETRANSMISSION_USERS_CRITICAL

Number of users with retransmission rate >50% critical threshold

integer

_HIGH_DOWNLINK_PACKET_LOSS_USERS_WARNING

Number of users with downlink packet loss rate >5% warning threshold

integer

_HIGH_DOWNLINK_PACKET_LOSS_USERS_CRITICAL

Number of users with downlink packet loss rate >5% critical threshold

integer

_LOW_NOISE_STRENGTH_RADIO_WARNING

Number of radio with noise strength >-80dBm warning threshold

integer

_LOW_NOISE_STRENGTH_RADIO_CRITICAL

Number of radio with noise strength >-80dBm critical threshold

integer

_HIGH_CHANNEL_UTILIZATION_WARNING

Number of radio channels with utilization >70% warning threshold

percent

_HIGH_CHANNEL_UTILIZATION_CRITICAL

Number of radio channels with utilization >70% critical threshold

percent

_HIGH_CHANNEL_LOAD_WARNING

Number of radio channels with load >40% warning threshold

percent

_HIGH_CHANNEL_LOAD_CRITICAL

Number of radio channels with load >40% critical threshold

percent

_HIGH_CHANNEL_INTERFERENCE_WARNING

Number of radio channels with interference >40% warning threshold

percent

_HIGH_CHANNEL_INTERFERENCE_CRITICAL

Number of radio channels with interference >40% critical threshold

percent

_AP_NOT_NORMAL_WARNING

Number of APs in not-normal state warning threshold

integer

_AP_NOT_NORMAL_CRITICAL

Number of APs in not-normal state critical threshold

integer

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

Layer1_rate_$KEY$

Checks the Layer 1 traffic rate

check_infinera_edu_l1_rate

_HOSTSNMPCOMMUNITY

_HOSTLAYER1_RATE_WARNING

_HOSTLAYER1_RATE_CRITICAL

_INFINERA_PORTS_LIST

Infinera-edu temp

Checks hardware temperature

check_infinera_edu_temp

_HOSTSNMPCOMMUNITY

_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:

_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 - Temperature

Checks the temperature of the appliance

check_infoblox_temp

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

_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 - 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 - Replication

Checks if replication between Infoblox appliances is working

check_infoblox_replication

_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 - Memory Usage

Checks memory usage

check_infoblox_mem

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_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

Infoblox - Info

Shows general information about this appliance

check_infoblox_info

_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 Updates

Shows DNS dynamic update statistics

check_infoblox_dnsupdates

_HOSTSNMPVERSION

_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

_HOSTSNMPSECURITYLEVEL

_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 temperature

Checks hardware temperature

check_mikrotik_temp

_HOSTSNMPCOMMUNITY

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Mikrotik mem usage

Checks Memory usage percent

check_mikrotik_mem

_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

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_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

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

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

Supported vendors: Cisco, HP, Juniper, Riverstone, 3Com, Alcatel, Alcatel-Lucent, Dell, F5, H3C, HH3C, Huawei, OneAccess, Palo Alto, Teldat, Aruba, Enterasys

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 check interval)

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

Supported vendors: Cisco, HP, Juniper, Riverstone, 3Com, Alcatel, Alcatel-Lucent, Dell, F5, H3C, HH3C, Huawei, OneAccess, Palo Alto, Teldat, Aruba, Enterasys

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

Supported vendors: Cisco, HP, Juniper, Riverstone, 3Com, Alcatel, Alcatel-Lucent, Dell, F5, H3C, HH3C, Huawei, OneAccess, Palo Alto, Teldat, Aruba, Enterasys

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

_HOSTSNMPPORT

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

_SNMPPORT

SNMP port used to connect (161 by default)

integer

_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 1 minute check interval)

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

Supported vendors: Cisco, HP, Juniper, Riverstone, 3Com, Alcatel, Alcatel-Lucent, Dell, F5, H3C, HH3C, Huawei, OneAccess, Palo Alto, Teldat, Aruba, Enterasys

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). Supported vendors: Cisco, Teldat and Huawei

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_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

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

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-mobile-signal-reduced

DESCRIPTION


Checks mobile signal strength/quality metrics in 3G/4G routers. Just RSRP and SINR metrics. To check all metrics, use networkdevice-mobile-signal pack

../../_images/networkdevice-mobile-signal-reduced.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_reduced_health_$KEY$

Checks the health metrics from mobile (3G, 4G) communications. Just RSRP and SINR metrics

check_mobile_signal_reduced_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_MOBILE_SIGNAL_REDUCED_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_REDUCED_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_REDUCED_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

rsrp_warn

RSRP warning threshold (in dBm)

integer

rsrp_crit

RSRP critical threshold (in dBm)

integer

sinr_warn

SINR warning threshold (in dB)

integer

sinr_crit

SINR critical threshold (in dB)

integer

Networkdevice-mping

DESCRIPTION


ICMP ping check for multiple ip addresses. Default 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

MPing_$KEY$

Checks connectivity using ICMP protocol. Default check interval: 1 minute

wocu-check-mping

_MPING_HOSTS_LIST

MACROS


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

COMPLEX MACROS

  • _MPING_HOSTS_LIST

    • Description: List of destination hosts to ping


Fields

Description

Type

name

Name description. Used in service display name

string

ip_address

IP address to ping

string

icmp_packets

Number of ICMP packets to send

integer

rta_warning_threshold

Not defined

integer

rta_critical_threshold

Not defined

integer

pl_warning_threshold

Not defined

percent

pl_critical_threshold

Not defined

percent

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

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_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$

_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

_TRAFFIC_WARNING_THRESHOLD

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

string

_TRAFFIC_CRITICAL_THRESHOLD

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

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

    • 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

string

critical

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

string

enable ADS

Enable ADS (Anomalies Detection System)

string

ADS time range

The time range (in minutes) used to establish the average value to compare with actual traffic value.

integer

ADS sensibility

ADS Sensibility factor. The traffic value must be X times higher or lower to raise an alert.

integer

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

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_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$

_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

_TRAFFIC_1M_WARNING_THRESHOLD

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

string

_TRAFFIC_1M_CRITICAL_THRESHOLD

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

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_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

string

critical

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

string

enable ADS

Enable ADS (Anomalies Detection System)

string

ADS time range

The time range (in minutes) used to establish the average value to compare with actual traffic value.

integer

ADS sensibility

ADS Sensibility factor. The traffic value must be X times higher or lower to raise an alert.

integer

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_TRAFFIC_ALL_IFACES

Interface_Discards_$KEY$

Checks the discarded packets from an interface

networkdevice-traffic-all-discards

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTDISCARD_WARNING_THRESHOLD

_HOSTDISCARD_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

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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$

_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

_TRAFFIC_WARNING_THRESHOLD

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

string

_TRAFFIC_CRITICAL_THRESHOLD

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

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

_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

  • _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

string

critical

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

string

enable ADS

Enable ADS (Anomalies Detection System)

string

ADS time range

The time range (in minutes) used to establish the average value to compare with actual traffic value.

integer

ADS sensibility

ADS Sensibility factor. The traffic value must be X times higher or lower to raise an alert.

integer

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTDISCARD_WARNING_THRESHOLD

_HOSTDISCARD_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

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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$

_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

_TRAFFIC_WARNING_THRESHOLD

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

string

_TRAFFIC_CRITICAL_THRESHOLD

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

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

_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

  • _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

string

critical

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

string

enable ADS

Enable ADS (Anomalies Detection System)

string

ADS time range

The time range (in minutes) used to establish the average value to compare with actual traffic value.

integer

ADS sensibility

ADS Sensibility factor. The traffic value must be X times higher or lower to raise an alert.

integer

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$

_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

_TRAFFIC_WARNING_THRESHOLD

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

string

_TRAFFIC_CRITICAL_THRESHOLD

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

string

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

string

critical

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

string

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTERROR_WARNING_THRESHOLD

_HOSTERROR_CRITICAL_THRESHOLD

_IFACES_HEALTH

Interface_Discards_$KEY$

Checks the discarded packets from an interface

check_traffic_health_discards

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_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$

_IFACES_HEALTH:

wocu-discover-ifaces-ng.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –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

_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_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

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_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

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_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

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_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

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_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

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

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

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_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$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$

_NSM_LIST:

wocu-discover-teldat-nsm.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

_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

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

NSM session name

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

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

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_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

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_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

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 - serial

Checks for changes in chassis and backplane serial numbers

check_diff_inventory_serial

_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

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

_HOSTSNMPSECURITYLEVEL

_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

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (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

_HOSTSNMPSECURITYLEVEL

_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

_SNMPSECURITYLEVEL

SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (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 CPU

Checks Squid CPU usage

check_squid_cpu

_HOSTSQUID_PORT

_HOSTSQUID_CPU_WARNING

_HOSTSQUID_CPU_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 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 Clients

Checks connected clients

check_squid_clients

_HOSTSQUID_PORT

_HOSTCLIENTS_WARNING

_HOSTCLIENTS_CRITICAL

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

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

Teldat-sde

DESCRIPTION


Checks for Teldat SDE 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

Teldat_SDE_Uptime

Checks device uptime

check_teldat_sde_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

Teldat_SDE_TCP_Conn

Checks TCP Connections number

check_teldat_sde_tcp_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTTCP_CONN_WARN

_HOSTTCP_CONN_CRIT

Teldat_SDE_Load

Checks CPU load

check_teldat_sde_load

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_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

_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

_LOAD_WARN

Value for starting warning state for the load average at 1m

integer

_LOAD_CRIT

Value for starting critical state for the load average at 1m

integer

_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

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

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 Framework

Checks if ossim-framework is running

check_av_aio_framework

Alienvault-aio Monit

Checks if monit process is running

check_av_aio_monit

Alienvault-aio Size

Checks the logger size

check_av_aio_size

Alienvault-aio Redis Server

Checks if redis-server is running

check_av_aio_redis_server

Alienvault-aio Agent

Checks if ossim-agent is running

check_av_aio_agent

_HOSTAGENT_WARNING

_HOSTAGENT_CRITICAL

Alienvault-aio Mysqld

Checks if mysqld is running

check_av_aio_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-aio Sandas

Checks if sandas is running

check_av_aio_sandas

Alienvault-aio Mongodb

Checks if mongod is running

check_av_aio_mongodb

Alienvault-aio Procs

Checks the number of processes

check_av_aio_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Alienvault-aio Rsyslog

Checks if rsyslogd is running

check_av_aio_rsyslog

Alienvault-aio Apache

Checks if apache2 is running

check_av_aio_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

Alienvault-aio RabbitMQ Server

Checks if rabbitmq-server is running

check_av_aio_rabbitmq_server

Alienvault-aio Server

Checks if ossim-server is running

check_av_aio_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

_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 Size

Checks the logger size

check_av_logger_size

Alienvault-Logger Server

Checks if ossim-server is running

check_av_logger_server

Alienvault-Logger Mysqld

Checks if mysqld is running

check_av_logger_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-Logger Monit

Checks if monit process is running

check_av_logger_monit

Alienvault-Logger Apache

Checks if apache2 is running

check_av_logger_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

Alienvault-Logger RabbitMQ Server

Checks if rabbitmq-server is running

check_av_logger_rabbitmq_server

Alienvault-Logger Redis Server

Checks if redis-server is running

check_av_logger_redis_server

Alienvault-Logger Framework

Checks if ossim-framework is running

check_av_logger_framework

Alienvault-Logger Mongodb

Checks if mongod is running

check_av_logger_mongodb

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 Monit

Checks if monit process is running

check_av_sensor_monit

Alienvault-sensor Procs

Checks the number of processes

check_av_sensor_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Alienvault-sensor Agent

Checks if ossim-agent is running

check_av_sensor_agent

_HOSTAGENT_WARNING

_HOSTAGENT_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

_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 Apache

Checks if apache2 is running

check_av_siem_apache

_HOSTAPACHE_WARNING

_HOSTAPACHE_CRITICAL

Alienvault-siem Monit

Checks if monit process is running

check_av_siem_monit

Alienvault-siem Framework

Checks if ossim-framework is running

check_av_siem_framework

Alienvault-siem Mysqld

Checks if mysqld is running

check_av_siem_mysqld

_HOSTMYSQL_WARNING

_HOSTMYSQL_CRITICAL

Alienvault-siem Sandas

Checks if sandas is running

check_av_siem_sandas

Alienvault-siem RabbitMQ Server

Checks if rabbitmq-server is running

check_av_siem_rabbitmq_server

Alienvault-siem Mongodb

Checks if mongod is running

check_av_siem_mongodb

Alienvault-siem Redis Server

Checks if redis-server is running

check_av_siem_redis_server

Alienvault-siem Server

Checks if ossim-server is running

check_av_siem_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

procs_ssh

Checks if sshd is running

check_procs_ssh

_HOSTSSH_PROCS_WARNING

_HOSTSSH_PROCS_CRITICAL

uptime_so

Checks the system uptime

check_uptime_so

_HOSTSNMPCOMMUNITY

ArcSight_Partition $KEY$

Checks the storage usage percent

check_unix_nrpe_disk

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_PARTITIONS

procs

Checks the number of processes

check_unix_nrpe_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

interfaces_status

Checks the interfaces status

check_interfaces_status

_HOSTSNMPCOMMUNITY

zombie_procs

Checks the number of zombie processes

check_arcsight_unix_zombie_procs

_HOSTZOMBIE_PROCS_WARNING

_HOSTZOMBIE_PROCS_CRITICAL

swap

Checks the swap usage percent

check_arcsight_unix_nrpe_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

mem

Checks the memory usage

check_arcsight_unix_nrpe_memory

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

load

Checks the system load

check_arcsight_unix_nrpe_load

_HOSTLOAD_WARNING

_HOSTLOAD_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

Swap_usage

Checks the swap usage

check_ssh_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

Disk_usage /

Checks the storage usage

check_ssh_disk

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

Java

Checks if java is running

check_nrpe_java

web_access

Checks if port TCP/8443 is listening

check_tcp_web_access

_HOSTRESPONSE_WARNING

_HOSTRESPONSE_CRITICAL

Arcsight-express-Uptime

Checks the system uptime

check_ssh_uptime

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Arcshight-express_Procs

Checks the number of processes

check_ssh_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Web_service

Checks if Arcsight wrapper is running

check_nrpe_esm_web

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

Mem_usage

Checks memory usage

check_ssh_mem

_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

_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

Raid status

Checks the RAID status

check_nrpe_raid_status

LinuxWrapper

Checks if linux wrapper process is running

check_nrpe_linuxwrapper

Arcsight_Zombie procs

Checks the number of zombie processes

check_unix_zombie_procs

_HOSTZOMBIE_PROCS_WARNING

_HOSTZOMBIE_PROCS_CRITICAL

Arcsight_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

Arcsight_Connectors

Checks if ArcSightSmartConnectors is running

check_nrpe_connectors

Web

Checks if arcsight web process is running

check_nrpe_web

Receivers

Checks if arcsight receivers is running

check_nrpe_receivers

Logger

Checks if arcsight processors is running

check_nrpe_logger

ReportEngine

Checks if arcsight reportengine process is running

check_nrpe_reportengine

Swap Usage

Checks swap usage percent

check_unix_nrpe_swap

_HOSTSWAP_WARNING

_HOSTSWAP_CRITICAL

Arcsight_Procs

Checks the number of processes

check_nrpe_procs

_HOSTPROCS_WARNING

_HOSTPROCS_CRITICAL

Arcsight_Load

Checks the system load

check_unix_nrpe_load

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

Mysql Listener

Checks if TCP/3306 port is listening

check_mysql_listener

_HOSTRESPONSE_WARNING

_HOSTRESPONSE_CRITICAL

SSH Procs

Checks if sshd process is running

check_nrpe_ssh_procs

_HOSTSSH_PROCS_WARNING

_HOSTSSH_PROCS_CRITICAL

Server

Checks if arcsight servers process is running

check_nrpe_server

Partition_logger $KEY$

Checks the storage usage

check_arcsight_logger_nrpe_disk

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_PARTITIONS

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

request_rate

Shows the average rate per second of HTTP requests.

check_bluecoat_request_rate

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

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

gui

Checks if TCP/8082 port is up and accepting connections

check_bluecoat_gui

_HOSTGUI_PORT

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

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

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

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_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

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

mem_usage

Checks the memory usage

check_bluecoat_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

uptime

Checks the device uptime

check_bluecoat_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

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

disk_usage

Checks the disk usage

check_bluecoat_disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

ssh

Checks if TCP/22 port is up and accepting connections

check_bluecoat_ssh

_HOSTSSH_PORT

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

cpu_usage

Checks the CPU usage

check_bluecoat_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_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

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

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-sensor_status

Checks the sensor status of all device units

check_bluecoat_cas_sensor_status

_HOSTSNMPCOMMUNITY

_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-cpu

Checks the CPU usage information

check_bluecoat_cas_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_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

_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

Connections

Checks the number of connections

check_checkpoint_connections

_HOSTSNMPCOMMUNITY

_HOSTCONN_WARNING

_HOSTCONN_CRITICAL

Checkpoint_Info

Shows status info

check_checkpoint_info

_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

_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_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

CKP_Gaia_FW_State

Shows FW Module status

check_checkpoint_gaia_fw_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

CKP_Gaia_Swap

Checks the Swap usage

check_checkpoint_gaia_swap

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSWAP_WARNING

_HOSTSWAP_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

_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-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-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-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

checkpoint-ipso-process_$KEY$

Checks Checkpoint IPSO processes.

check_checkpoint_ipso_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

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-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-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

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_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

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

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_cpu

Checks Checkpoint r8010 gaia devices CPU usage.

checkpoint_r8010_gaia_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

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_disk_usage

Checks Checkpoint r8010 gaia devices disk usage.

checkpoint_r8010_gaia_disk_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSTORAGE_WARNING

_HOSTSTORAGE_CRITICAL

checkpoint_r8010_gaia_conn

Checks Checkpoint r8010 gaia devices connection usage.

checkpoint_r8010_gaia_conn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCONN_WARNING

_HOSTCONN_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_cluster_iface_info

Checks Checkpoint r8010 gaia devices cluster interface information.

checkpoint_r8010_gaia_cluster_iface_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_mem

Checks Checkpoint r8010 gaia devices memory usage.

checkpoint_r8010_gaia_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

checkpoint_r8010_kmem_failed_alloc

Checks System Kernel memory (SMEM) allocation failures.

checkpoint_r8010_gaia_kmem_failed_alloc

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

checkpoint_r8010_gaia_pnotes_status

Checks Checkpoint r8010 gaia devices Pnotes status information.

checkpoint_r8010_gaia_pnotes_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

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 - 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 - 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 - 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 - SSL Stats

Shows SSL statistics

check_citrix_netscaler_ssl_stats

_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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - HA Info

Shows device High Availability info

check_citrix_netscaler_ha_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Citrix Netscaler - Compression Stats

Shows compression statistics

check_citrix_netscaler_compression_stats

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

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 - 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 SSH

Checks SSH availability

check_fortianalyzer_ssh

Fortianalyzer Memory Usage

check_fortianalyzer_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Fortianalyzer CPU Usage

Checks CPU usage

check_fortianalyzer_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortianalyzer HTTPS

Checks GUI availability

check_fortianalyzer_https

Fortianalyzer Disk

Checks disk usage

check_fortianalyzer_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

Fortianalyzer Uptime

Checks uptime

check_fortianalyzer_uptime

_HOSTSNMPCOMMUNITY

_HOSTUPTIME_WARNING

_HOSTUPTIME_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

Fortiauthenticator

DESCRIPTION


Checks for Fortiauthenticator devices

../../_images/fortiauthenticator.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

FortiAuthenticator_gui

Checks Fortiauthenticator GUI port

check_fortiauthenticator_gui

_HOSTGUI_PORT

FortiAuthenticator_mem

Checks Fortiauthenticator Memory usage

check_fortiauthenticator_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_ssh

Checks Fortiauthenticator SSH port

check_fortiauthenticator_ssh

_HOSTSSH_PORT

FortiAuthenticator_groups

Checks Fortiauthenticator groups usage

check_fortiauthenticator_groups

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTGROUPS_WARNING

_HOSTGROUPS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_sso_users

Checks Fortiauthenticator SSO users usage

check_fortiauthenticator_sso_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSSO_USERS_WARNING

_HOSTSSO_USERS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_cpu

Checks Fortiauthenticator CPU usage

check_fortiauthenticator_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_disk

Checks Fortiauthenticator Disk usage

check_fortiauthenticator_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_ha

Checks Fortiauthenticator HA state

check_fortiauthenticator_ha

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHA_STATE

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_local_users

Checks Fortiauthenticator local users usage

check_fortiauthenticator_local_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLOCAL_USERS_WARNING

_HOSTLOCAL_USERS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_tokens

Checks Fortiauthenticator tokens usage

check_fortiauthenticator_tokens

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTOKENS_WARNING

_HOSTTOKENS_CRITICAL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

FortiAuthenticator_uptime

Checks Fortiauthenticator uptime

check_fortiauthenticator_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_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_STATE:

wocu-discover-fortiauthenticator-ha-state.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_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

_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

_DISK_WARNING

Disk usage warning threshold (percent)

percent

_DISK_CRITICAL

Disk usage critical threshold (percent)

percent

_GROUPS_WARNING

Groups usage warning threshold (percent)

percent

_GROUPS_CRITICAL

Groups usage critical threshold (percent)

percent

_LOCAL_USERS_WARNING

Local users usage warning threshold (percent)

percent

_LOCAL_USERS_CRITICAL

Local users usage critical threshold (percent)

percent

_TOKENS_WARNING

Tokens usage warning threshold (percent)

percent

_TOKENS_CRITICAL

Tokens usage critical threshold (percent)

percent

_SSO_USERS_WARNING

SSO users usage warning threshold (percent)

percent

_SSO_USERS_CRITICAL

SSO users usage critical threshold (percent)

percent

_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_STATE

High Availability status (default clusterMaster)

string

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_node1

Checks Node1 CPU usage

check_fortigate_cpu_node1

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_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_GUI

Checks GUI availability

check_fortigate_gui

_HOSTGUI_PORT

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_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_node2

Checks Node2 CPU usage

check_fortigate_cpu_node2

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_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

Fortigate_Uptime

Checks uptime

check_fortigate_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_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

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_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

Fortigate Uptime

Checks the uptime

check_fortigate_standalone_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_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 HTTPS access (default 443)

integer

_SSH_PORT

TCP Port number for SSH access (default 22)

integer

Fortigate-switch-controller

DESCRIPTION


Checks for Fortigate switch controller devices

../../_images/fortigate-switch-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

Fortigate_switch_controller_sw_serial_$KEY$

Checks specific Switch serial number from Fortigate switch controller

fortigate-switch-controller_sw_serial

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FORTIGATE_SWITCH_LIST

Fortigate_switch_controller_sw_status_$KEY$

Checks specific Switch status from Fortigate switch controller

fortigate-switch-controller_sw_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FORTIGATE_SWITCH_LIST

Fortigate_switch_controller_port_status_$KEY$

Checks specific Switch Port status from Fortigate switch controller

fortigate-switch-controller_port_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FORTIGATE_PORT_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:

_FORTIGATE_SWITCH_LIST:

wocu-discover-fortigate-switch-controller.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$’ -t switch

_FORTIGATE_PORT_LIST:

wocu-discover-fortigate-switch-controller.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$’ -t ports

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

  • _FORTIGATE_SWITCH_LIST

    • Description: List of Switches

    • Discover: wocu-discover-fortigate-switch-controller.py


Fields

Description

Type

display_name

name used in service description

string

id

Switch identifier (used as index in SNMP queries)

string

  • _FORTIGATE_PORT_LIST

    • Description: List of Ports from Switches

    • Discover: wocu-discover-fortigate-switch-controller.py


Fields

Description

Type

display_name

name used in service description

string

sw_id

Switch identifier (used as index in SNMP queries)

string

number

Port number (used as index in SNMP queries)

integer

name

Port name

string

Fortigate-tunnels

DESCRIPTION


Check for VPN Tunnels state in fortigate devices

../../_images/fortigate-tunnels.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_tunnels_$KEY$

Checks VPN Tunnel state in Fortigate devices

check_fortigate_tunnels_state

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FORTIGATE_TUNNELS_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:

_FORTIGATE_TUNNELS_LIST:

wocu-discover-fortigate-tunnels.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_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

_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

  • _FORTIGATE_TUNNELS_LIST

    • Description: List of VPN tunnels to be checked

    • Discover: wocu-discover-fortigate-tunnels.py


Fields

Description

Type

display_name

Name to be shown in the web interface

string

oid_suffix

OID suffix used in SNMP queries

string

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 Queue - $KEY$

Checks the mail queues

fortimail_queue

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_FORTIMAIL_QUEUE_LIST

Fortimail CPU

Checks Fortimail CPU usage

fortimail_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Fortimail Uptime

Checks uptime

fortimail_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Fortimail Mem

Checks memory usage

fortimail_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Fortimail Mail Disk

Checks mail disk usage

fortimail_mail_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMAIL_DISK_WARNING

_HOSTMAIL_DISK_CRITICAL

Fortimail Deferred

Checks deferred queue

fortimail_deferred

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEFERRED_WARNING

_HOSTDEFERRED_CRITICAL

Fortimail Log Disk

Checks log disk usage

fortimail_log_disk

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLOG_DISK_WARNING

_HOSTLOG_DISK_CRITICAL

Fortimail GUI

Checks GUI availability

fortimail_gui

_HOSTGUI_PORT

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 ssh tcp connection

Checks SSH availability

check_fortiswitch_ssh

_HOSTSSH_PORT

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

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 Mem

Checks Memory usage

check_fortiweb_mem

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Fortiweb Uptime

Checks the uptime

check_fortiweb_uptime

_HOSTSNMPCOMMUNITY

Fortiweb HTTPS

Checks the GUI availability

check_fortiweb_https

Fortiweb SSH

Checks SSH availability

check_fortiweb_ssh

Fortiweb CPU Usage

Checks the CPU usage

check_fortiweb_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_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 Memory

Checks Ironport Memory usage

check_ironport_cisco_mem

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Ironport Conservation reason

Checks Ironport Conservation mode reason

check_ironport_cisco_conservation_reason

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Queue status

Checks Ironport mail Queue status

check_ironport_cisco_queue_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Files/Sockets

Checks Ironport open Files/Sockets

check_ironport_cisco_sockets

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSOCKETS_WARNING

_HOSTSOCKETS_CRITICAL

Ironport Queue usage percent

Checks Ironport mail Queue usage percent

check_ironport_cisco_queue_percent

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTQUEUE_PERCENT_WARNING

_HOSTQUEUE_PERCENT_CRITICAL

Ironport Power Supply

Checks Ironport Power supply status and redundancy

check_ironport_cisco_powersupply

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Memory Status

Checks Ironport Memory status

check_ironport_cisco_mem_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport Licenses

Checks Ironport installed Licenses

check_ironport_cisco_license

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTLICENSE_WARNING

_HOSTLICENSE_CRITICAL

Ironport Oldest message

Checks Ironport oldest queued message

check_ironport_cisco_oldest_message

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTOLDEST_WARNING

_HOSTOLDEST_CRITICAL

Ironport Raid Status

Checks Ironport Raid Drives status and errors

check_ironport_cisco_raid_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Ironport CPU

Checks Ironport CPU usage

check_ironport_cisco_cpu

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Ironport Queue count

Checks Ironport mail Queue message count

check_ironport_cisco_queue_count

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTQUEUE_COUNT_WARNING

_HOSTQUEUE_COUNT_CRITICAL

Ironport mail related Threads

Checks Ironport mail related threads

check_ironport_cisco_mail_threads

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTTHREADS_WARNING

_HOSTTHREADS_CRITICAL

Ironport Temperature

Checks Ironport temperature sensors

check_ironport_cisco_temp

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_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$

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_host

Checks host or address compromise via Maltiverse Open IOC Search Engine

check_maltiverse_host

_HOSTMALTIVERSE_AUTH_TOKEN

Maltiverse_url_$KEY$

Checks url compromise via Maltiverse Open IOC Search Engine

check_maltiverse_url

_HOSTMALTIVERSE_AUTH_TOKEN

_MALTIVERSE_URLS

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 - 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 - License Status

Checks License Status (Valid, Invalid, Expired)

check_mcafee_atd_license

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

McAfee-ATD - System Health

Checks System Health (Good, Bad)

check_mcafee_atd_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

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 - CPU Usage

Checks CPU Usage

check_mcafee_atd_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

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 - 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 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 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 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 Failover Status

Checks High Availability status

check_ssh_failover_status

_HOSTSSH_USER

_HOSTSSH_KEY

Mcafee MEM Usage

Checks Memory usage

check_ssh_mem_usage

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Mcafee Power Supply Status

Checks Power Supply status

check_ssh_powersupply_status

_HOSTSSH_USER

_HOSTSSH_KEY

Mcafee CPU Usage

Checks CPU usage

check_ssh_cpu_usage

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTCPU_WARNING

_HOSTCPU_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

_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 - 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

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 - Uptime

Checks the system uptime

check_paloalto_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

Palo Alto - Info

Shows system information

check_paloalto_info

_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:

_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 fan sensor

Checks the fan velocity

check_paloalto_health_fan

_HOSTSNMPCOMMUNITY

_HOSTRPM_WARNING

_HOSTRPM_CRITICAL

Paloalto temp sensor

Checks the temperature

check_paloalto_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

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

display_name

Name to be shown in the web interface

string

name

License name as shown in device configuration. Don’t modify the discovered value.

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

Palo-alto-tunnels

DESCRIPTION


Palo Alto IPSEC Tunnels state checks

../../_images/palo-alto-tunnels.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_tunnel_$KEY$

check_paloalto_tunnels_state

_HOSTAPI_KEY

_PALOALTO_TUNNELS_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_TUNNELS_LIST:

wocu-discover-paloalto-tunnels.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_TUNNELS_LIST

    • Description: List of IPSEC tunnels

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


Fields

Description

Type

display_name

Name to be shown in the web interface

string

name

Tunnel name

string

state

Tunnel state. WOCU will alert if tunnel state is different from this

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 - 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 - 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 - 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 - 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

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 - Disk Usage

It shows the Disk usage

check_pulse_secure_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_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

_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

Qradar_Partition $KEY$

Checks the partitions storage usage

check_qradar_disk

_HOSTSNMPCOMMUNITY

_HOSTDISK_WARNING

_HOSTDISK_CRITICAL

_PARTITIONS

Qradar_CPU_Usage

Checks the CPU usage

check_qradar_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Qradar_Hostname

Shows system hostname

check_qradar_hostname

_HOSTSNMPCOMMUNITY

Qradar-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 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 Load

Checks the system load

check_sourcefire_load

_HOSTSNMPCOMMUNITY

_HOSTLOAD_WARNING

_HOSTLOAD_CRITICAL

Sourcefire NTP sync

Checks the time difference between monitored server and local server

check_sourcefire_ntp_sync

_HOSTSNMPCOMMUNITY

_HOSTOFFSET_WARNING

_HOSTOFFSET_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

Stonegate - Software version

Shows the software version

check_stonegate_sw_version

_HOSTSNMPCOMMUNITY

Stonegate-Uptime

Shows the system uptime

check_stonegate_uptime

_HOSTSNMPCOMMUNITY

_HOSTUPTIME_WARNING

_HOSTUPTIME_CRITICAL

Stonegate_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

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 Node state

Checks the node operative (Clustering) state

check_stonegate_fw_node_state

_HOSTSNMPCOMMUNITY

_HOSTNODE_STATE

_HOSTALARM_PERSISTENCE

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 Uptime

Shows the system uptime

check_stonegate_fw_uptime

_HOSTSNMPCOMMUNITY

Stonegate-fw Accepted Packets

Shows the accepted packets metrics

check_stonegate_fw_accepted_packets

_HOSTSNMPCOMMUNITY

_HOSTACCEPTED_WARNING

_HOSTACCEPTED_CRITICAL

Stonegate-fw Dropped Packets

Checks the dropped packets number

check_stonegate_fw_dropped_packets

_HOSTSNMPCOMMUNITY

_HOSTDROPPED_WARNING

_HOSTDROPPED_CRITICAL

Stonegate-fw Connections

Shows the actual connections number

check_stonegate_fw_conn

_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

_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

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

UCS-Memory_status

Checks the memory status

check_ucs_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-Disks_info

Shows disk info

check_ucs_disks_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-CPUs_status

Checks the CPU status

check_ucs_cpus_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-FANs

Checks fans status

check_ucs_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-Raid_status

Checks the Raid status

check_ucs_raids_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-CPUs_info

Shows CPU info

check_ucs_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-Disks_states

Checks the Disk status

check_ucs_localdisks

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-PSUs

Checks the Powersupply status

check_ucs_psus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-PSUs_voltage

Checks the Powersupply voltage

check_ucs_psus_voltage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUVOLTWR

_HOSTPSUVOLTCR

UCS-Raid_info

Shows Raid info

check_ucs_raids_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-CPUs_temperatures

Checks the CPU temperature

check_ucs_cpu_temps

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPUTEMPWR

_HOSTCPUTEMPCR

UCS-Storage_controller

Checks the Storage Controller status

check_ucs_storage_controller

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-Memory_info

Shows memory info

check_ucs_mem_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

UCS-Server_info

Shows server info

check_ucs_server_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_Idle $KEY$

Checks the CPU Idle time

check_cpu_idle

_HOSTSNMPCOMMUNITY

_HOSTCPU_IDLE_WARNING

_HOSTCPU_IDLE_CRITICAL

_CROSSBEAM_CPU_IDLE_LIST

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_LoadAvg5 $KEY$

Checks the CPU 5 minute load average

check_cpu_loadavg5

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOADAVG5_WARNING

_HOSTCPU_LOADAVG5_CRITICAL

_CROSSBEAM_CPU_LOADAVG5_LIST

XBEAM Chassis Temperature

Checks XBEAM Chassis temperature

check_chassis_temp

_HOSTSNMPCOMMUNITY

_HOSTCHASSIS_TEMP_WARNING

_HOSTCHASSIS_TEMP_CRITICAL

XBEAM CPU_System $KEY$

Checks the System CPU

check_cpu_system

_HOSTSNMPCOMMUNITY

_HOSTCPU_SYSTEM_WARNING

_HOSTCPU_SYSTEM_CRITICAL

_CROSSBEAM_CPU_SYSTEM_LIST

XBEAM Swap Usage

Checks the SWAP usage

check_swap_usage

_HOSTSNMPCOMMUNITY

_HOSTSWAP_USAGE_WARNING

_HOSTSWAP_USAGE_CRITICAL

XBEAM Failover_group_status $KEY$

Checks the failover group status

check_failover_group_status

_HOSTSNMPCOMMUNITY

_CROSSBEAM_FAILOVER_GR_STATUS

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 CPU_LoadAvg1 $KEY$

Checks the CPU 1 minute load average

check_cpu_loadavg1

_HOSTSNMPCOMMUNITY

_HOSTCPU_LOADAVG1_WARNING

_HOSTCPU_LOADAVG1_CRITICAL

_CROSSBEAM_CPU_LOADAVG1_LIST

XBEAM CPU Temp

Checks the CPU temperature

check_cpu_temp

_HOSTSNMPCOMMUNITY

_HOSTCPU_TEMP_WARNING

_HOSTCPU_TEMP_CRITICAL

XBEAM HA Status

Checks the HA Status

check_ha_status

_HOSTSNMPCOMMUNITY

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 Memory Free

Checks the free memory

check_mem_free

_HOSTSNMPCOMMUNITY

_HOSTMEM_FREE_WARNING

_HOSTMEM_FREE_CRITICAL

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 Vap_Status $KEY$

Checks the VAP status

check_vap_status

_HOSTSNMPCOMMUNITY

_CROSSBEAM_VAP_STATUS_LIST

XBEAM Uptime

Checks the system uptime

check_uptime

_HOSTSNMPCOMMUNITY

XBEAM Memory Usage

Checks the memory usage

check_mem_usage

_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 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

integer

_CPU_LOAD_CRITICAL

CPU Load critical threshold

integer

_CPU_LOADAVG1_WARNING

CPU Load average 1 minute warning threshold

integer

_CPU_LOADAVG1_CRITICAL

CPU Load average 1 minute critical threshold

integer

_CPU_LOADAVG5_WARNING

CPU Load average 5 minute warning threshold

integer

_CPU_LOADAVG5_CRITICAL

CPU Load average 5 minute critical threshold

integer

_CPU_LOADAVG15_WARNING

CPU Load average 15 minute warning threshold

integer

_CPU_LOADAVG15_CRITICAL

CPU Load average 15 minute critical threshold

integer

_CPU_SYSTEM_WARNING

CPU System warning threshold

percent

_CPU_SYSTEM_CRITICAL

CPU System critical threshold

percent

_CPU_UTIL_WARNING

CPU Utilization warning threshold

percent

_CPU_UTIL_CRITICAL

CPU Utilization critical threshold

percent

_IN_OCTETS_WARNING

In octets warning threshold

integer

_IN_OCTETS_CRITICAL

In octets critical threshold

integer

_MEM_FREE_WARNING

Free memory warning threshold

percent

_MEM_FREE_CRITICAL

Free memory critical threshold

percent

_MEM_USAGE_WARNING

Memory usage warning threshold

percent

_MEM_USAGE_CRITICAL

Memory usage critical threshold

percent

_SWAP_USAGE_WARNING

Swap usage warning threshold

percent

_SWAP_USAGE_CRITICAL

Swap usage critical threshold

percent

_CPU_TEMP_WARNING

CPU temperature warning threshold

integer

_CPU_TEMP_CRITICAL

CPU temperature critical threshold

integer

_CHASSIS_TEMP_WARNING

Chassis temperature warning threshold

integer

_CHASSIS_TEMP_CRITICAL

Chassis temperature critical threshold

integer

COMPLEX MACROS

  • _CROSSBEAM_CPU_IDLE_LIST

    • Description: OIDs to check Core CPU idle


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU idle

string

  • _CROSSBEAM_CPU_IOWAIT_LIST

    • Description: OIDs to check Core CPU iowait


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU iowait

string

  • _CROSSBEAM_CPU_LOAD_LIST

    • Description: OIDs to check CPU load


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU load

string

  • _CROSSBEAM_CPU_LOADAVG1_LIST

    • Description: OIDs to check CPU load average 1 minute


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU load average 1 minute

string

  • _CROSSBEAM_CPU_LOADAVG5_LIST

    • Description: OIDs to check CPU load average 5 minutes


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU load average 5 minutes

string

  • _CROSSBEAM_CPU_LOADAVG15_LIST

    • Description: OIDs to check CPU load average 15 minutes


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU load average 15 minutes

string

  • _CROSSBEAM_CPU_SYSTEM_LIST

    • Description: OIDs to check Core CPU system


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check Core CPU system

string

  • _CROSSBEAM_CPU_UTIL_LIST

    • Description: OIDs to check CPU utilization


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check CPU utilization

string

  • _CROSSBEAM_IN_OCTETS_LIST

    • Description: OIDs to check interface IN octets


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check interface IN octets

string

  • _CROSSBEAM_VAP_STATUS_LIST

    • Description: OIDs to check crossbeam vap status


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check vap status

string

  • _CROSSBEAM_FAILOVER_GR_STATUS_LIST

    • Description: OIDs to check crossbeam failover group status


Fields

Description

Type

display name

Custom Name appearing in the services

string

oid

OID to check failover group status

string

Crossbeam-apm

DESCRIPTION


Specific checks for Crossbeam APM (Application Processor Module)

../../_images/crossbeam-apm.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

Log send

Checks the Log send service

check_xbeam_log_send

_HOSTSNMPCOMMUNITY

Checkpoint total memory

Checks the Checkpoint memory

check_checkpoint_total_memory

_HOSTSNMPCOMMUNITY

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Cluster State

Shows the Cluster state

check_xbeam_cluster_state

_HOSTSNMPCOMMUNITY

Log server connection

Checks the Log Server connection

check_xbeam_logserver_conn

_HOSTSNMPCOMMUNITY

Checkpoint connections and CPU

Checks the Checkpoint connections and CPU

check_checkpoint_connections_cpu

_HOSTSNMPCOMMUNITY

_HOSTCONN_CRITICAL

_HOSTCPU_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

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_CONN_CRITICAL

Connections number critical threshold

integer

_CPU_CRITICAL

CPU usage critical threshold

percent

Dell-server-hwinfo

DESCRIPTION


Hardware checks for Dell servers via snmp using iDRAC. Support for iDRAC7 and higher

../../_images/dell-server-hwinfo.png

iDRAC7 and iDRAC8 supported

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

Dell-RAID_info

Shows RAID info

check_dell_raid_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Memory status

Check memory status

check_dell_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-PSUs

Overall check for PowerSupply(s) status

check_dell_psus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Chassis_intrusion

Shows overall status of Dell PowerEdge

check_dell_overall_chassis_intrusion

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-RAID_status

Checks the RAID status

check_dell_raid_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Temperatures

Overall check for temperature sensor(s)

check_dell_temps

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTEMPWARNING

_HOSTTEMPCRITICAL

Dell-PSUs_voltage

Overall check for PowerSupply(s) voltage

check_dell_psus_volt

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUVOLTWARNING

_HOSTPSUVOLTCRITICAL

Disks_states

Overall check for Disk(s) state

check_dell_localdisks

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-CPUs_info

Shows info about CPU(s)

check_dell_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-Server_info

Shows Dell server info

check_dell_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-CPUs_status

Overall check for CPU(s) status

check_dell_cpus_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

FANs_rpm

Checks the Fan(s) speed (rpm)

check_dell_fans_rpm

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTRPMDEFAULTWARNING

_HOSTRPMDEFAULTCRITICAL

Memory information

Shows memory info

check_dell_mem_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

FANs state

Checks the Fan(s) state

check_dell_fans_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Dell-PSUs_watts

Overall check for PowerSupply(s) watts

check_dell_psus_watts

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUWATTSWARNING

_HOSTPSUWATTSCRITICAL

Dell-Disks_info

Shows overall Disk(s) state

check_dell_localdisks_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Server_status

Checks Dell server status

check_dell_server_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CMOS_battery

Shows overall status of Dell PowerEdge CMOS battery

check_dell_overall_battery

_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

_TEMPWARNING

Temperature warning threshold (Celsius degrees)

integer

_TEMPCRITICAL

Temperature critical threshold (Celsius degrees)

integer

_RPMDEFAULTWARNING

Minimum fan’s rpms warning threshold

integer

_RPMDEFAULTCRITICAL

Minimum fan’s rpms critical threshold

integer

_PSUVOLTWARNING

PSU’s voltage warning

integer

_PSUVOLTCRITICAL

PSU’s voltage critical

integer

_PSUWATTSWARNING

PSU’s watts warning

integer

_PSUWATTSCRITICAL

PSU’s watts critical

integer

Hp-blade-chassis

DESCRIPTION


Plugin for monitoring HP Blade chassis

../../_images/hp-blade-chassis.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

HP_Blade_Chassis_PSUs_watts

Checks the Power Supply power consumption in Watts

check_hp_blade_chassis_psus_watts

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPSUWATTSWARNING

_HOSTPSUWATTSCRITICAL

_HOSTPOWER_THRESHOLD_TYPE

HP_Blade_Chassis_System_info

Shows chassis info

check_hp_blade_chassis_sys_info

_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

string

_SNMPVERSION

Snmp version

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

_PSUWATTSWARNING

PSU power consumption warning threshold (in Watts if threshold type is absolute, % if threshold type is relative)

float

_PSUWATTSCRITICAL

PSU power consumption critical threshold (in Watts if threshold type is absolute, % if threshold type is relative)

float

_POWER_THRESHOLD_TYPE

PSUs power consumption threshold type: Choose from absolute number or relative percentage of use. Relative use is based on PSU capacity. Formula: % = (Watts / PSU capcity) * 100. Ex: A power consmption of 80W in a PSU with 100W of capacity, has a relative load of 80%

string

Hp-blade-hwinfo

DESCRIPTION


Plugin for monitoring HP Blades, via iLO (snmp)

../../_images/hp-blade-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

HP-Blade-FANs_status

Checks the Fans status

check_hp_ilo_fans_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

HP-Blade_Mem_status

Checks the Memory status

check_hp_ilo_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

HP-Blade_CPUs_info

Shows CPUs info

check_hp_ilo_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

HP-Blade_System_info

Shows system info

check_hp_ilo_sys_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

HP-Blade_Mem_info

Shows the Memory info

check_hp_ilo_mem_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

HP-Blade_CPUs_temperatures

Checks the CPUs temperature

check_hp_ilo_cpus_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPUTEMPWARNING

_HOSTCPUTEMPCRITICAL

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

_CPUTEMPWARNING

CPU temperature warning threshold (Celsius degrees)

integer

_CPUTEMPCRITICAL

CPU temperature critical threshold (Celsius degrees)

integer

Hp-server-hwinfo

DESCRIPTION


Plugin for monitoring HP Servers, via iLO (snmp)

../../_images/hp-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

Disks_status

Checks the Disks status

check_hp_ilo_disks_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs_watts

Checks the Power Supply power consumption in Watts

check_hp_ilo_psus_watts

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUWATTSWARNING

_HOSTPSUWATTSCRITICAL

_HOSTPOWER_THRESHOLD_TYPE

Disks_info

Shows the disks info

check_hp_ilo_disks_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Mem_info

Shows the Memory info

check_hp_ilo_mem_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

FANs_status

Checks the Fans status

check_hp_ilo_fans_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs_voltage

Checks the Power Supply voltage

check_hp_ilo_psus_volt

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTPSUVOLTAGEWARNING

_HOSTPSUVOLTAGECRITICAL

RAID_info

Shows the Raid info

check_hp_ilo_raids_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs_state

Checks the Power Supply status

check_hp_ilo_psus_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Mem_status

Checks the Memory status

check_hp_ilo_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPUs_info

Shows CPUs info

check_hp_ilo_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPUs_temperatures

Checks the CPUs temperature

check_hp_ilo_cpus_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPUTEMPWARNING

_HOSTCPUTEMPCRITICAL

RAID_status

Checks the Raid status

check_hp_ilo_raids_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

System_info

Shows server info

check_hp_ilo_sys_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

_CPUTEMPWARNING

CPU temperature warning threshold (Celsius degrees)

integer

_CPUTEMPCRITICAL

CPU temperature critical threshold (Celsius degrees)

integer

_PSUVOLTAGEWARNING

PSU voltage warning threshold (in Volts)

float

_PSUVOLTAGECRITICAL

PSU voltage critical threshold (in Volts)

float

_PSUWATTSWARNING

PSU power consumption warning threshold (in Watts if threshold type is absolute, % if threshold type is relative)

float

_PSUWATTSCRITICAL

PSU power consumption critical threshold (in Watts if threshold type is absolute, % if threshold type is relative)

float

_POWER_THRESHOLD_TYPE

PSUs power consumption threshold type: Choose from absolute number or relative percentage of use. Relative use is based on PSU capacity. Formula: % = (Watts / PSU capcity) * 100. Ex: A power consmption of 80W in a PSU with 100W of capacity, has a relative load of 80%

string

Hw-energy-cost

DESCRIPTION


Adds up the the energy (kWh) and cost in € from a HW server during a time period (current day/week/month/year)

../../_images/hw-energy-cost.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

Energy_cost

Adds up the the energy (kWh) and cost in € from a HW server during a time period (current day/week/month/year)

check-hw-energy-cost

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTINFLUXDB_HOST

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_SERIES

_HOSTDEVICEVENDOR

_HOSTTHRESHOLD_UNIT

_HOSTENERGY_WARNING_THRESHOLD

_HOSTENERGY_CRITICAL_THRESHOLD

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$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$

_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

_DEVICEVENDOR

Device vendor

string

_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

_THRESHOLD_UNIT

Threshold units

string

_ENERGY_WARNING_THRESHOLD

Energy warning threshold

integer

_ENERGY_CRITICAL_THRESHOLD

Energy critical threshold

integer

Ibm-server-hwinfo

DESCRIPTION


Pack for monitoring physical IBM Servers via IMM (using snmp)

../../_images/ibm-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

IBM-RAID_info

Shows Raid info

check_ibm_raid_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-Disks_status

Checks disks status

check_ibm_disks

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Health_status

Checks system health status or level

check_ibm_imm_health

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-RAID_status

Checks the Raid status

check_ibm_raid_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-FANs_status

Checks Fans status

check_ibm_fans_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-Memory_status

Checks Memory status

check_ibm_mem_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Disks info

Shows disks info

check_ibm_disks_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-CPUs_status

Checks the CPUs status

check_ibm_cpus_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-FANs

Checks Fans speed

check_ibm_imm_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTFAN_SPEED_PCT_WARNING

_HOSTFAN_SPEED_PCT_CRITICAL

Server_info

Shows server info

check_ibm_srv_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

PSUs

Checks Power Supply status

check_ibm_psus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

CPU_temperatures

Checks the CPUs temperature

check_ibm_imm_cpus_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_TEMP_WARNING

_HOSTCPU_TEMP_CRITICAL

CPU_info

Shows CPU info

check_ibm_cpus_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

IBM-Memory_info

Shows Memory info

check_ibm_mem_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

_CPU_TEMP_WARNING

CPU Temperature warning threshold (Celsius degrees)

integer

_CPU_TEMP_CRITICAL

CPU Temperature critical threshold (Celsius degrees)

integer

_FAN_SPEED_PCT_WARNING

Fan speed warning threshold (% of maximum rpms)

percent

_FAN_SPEED_PCT_CRITICAL

Fan speed critical threshold (% of maximum rpms)

percent

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_cluster_status

Checks Cluster status

check_cluster_health

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

_HOSTELASTIC_PROTOCOL

Elastic_documents

Checks the number of documents

check_elastic_documents

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

Elastic_software_indexing

Checks the indexing time

check_node_indexing

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTINDEXING_WARNING_THRESHOLD

_HOSTINDEXING_CRITICAL_THRESHOLD

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

Elastic_software_version

Shows Elastic node version

check_elastic_version

_HOSTELASTIC_PORT

_HOSTELASTIC_NODENAME

_HOSTELASTIC_USERNAME

_HOSTELASTIC_PASSWORD

_HOSTELASTIC_PROTOCOL

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

_HOSTELASTIC_PROTOCOL

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$ –alt_ip $_ELASTIC_NODE_IP$ -P $_ELASTIC_PORT$ –remote $_POLLER_TAG_ADDRESS$ –protocol $_ELASTIC_PROTOCOL$ -u ‘$_ELASTIC_USERNAME$’ -p ‘$_ELASTIC_PASSWORD$’

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_NODE_IP

Associated node IP (optional). If you leave it in blank, the host IP is used

string

_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

_ELASTIC_PROTOCOL

Elastic protocol (default HTTP)

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

Elastic-query-events

DESCRIPTION


Look for events stored in ElasticSearch indexes. Regular expressions are Lucene type

../../_images/elastic-query-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

Elastic query $KEY$

Looks for events in ElasticSearch indexes

check_elastic_query_events

_HOSTELASTICSEARCH_CLUSTER_IP

_HOSTELASTICSEARCH_CLUSTER_PORT

_HOSTELASTICSEARCH_PROTOCOL

_HOSTELASTICSEARCH_USERNAME

_HOSTELASTICSEARCH_PASSWORD

_HOSTELASTICSEARCH_PREFIX_INDEX

_HOSTIDENTIFIER

_HOSTIDENTIFIER_FIELD

_HOSTTIME_RANGE

_EVENT_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

_ELASTICSEARCH_CLUSTER_IP

IP of Elasticsearch cluster

string

_ELASTICSEARCH_CLUSTER_PORT

Port of Elasticsearch cluster

integer

_ELASTICSEARCH_PROTOCOL

Elasticsearch cluster connection protocol (http, https)

string

_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

  • _EVENT_LIST

    • Description: Event match conditions and threshold for alerts


Fields

Description

Type

Display name

Name id for event search (unique)

string

Elasticsearch index

Index name of Elasticsearch (realm name)

string

Search field

Main search field from elastic doc

string

Regular expression

Main regular expression to match in elastic doc. Use Lucene syntax

string

Negate regex

Negate regex? Default: False

string

Disable pattern

Main regular expression to disable alerts (optional). Use Lucene syntax

string

Negate disable regex

Negate disable regex? Default: False

string

Secondary search field

Secondary search field from elastic doc (optional)

string

Secondary regular expression

Secondary regular expression to match in elastic doc (optional). Use Lucene syntax

string

Negate secondary regex

Negate secondary regex? Default: False

string

Secondary disable pattern

Secondary regular expression to disable alerts (optional). Use Lucene syntax

string

Negate secondary disable regex

Negate secondary disable regex? Default: False

string

Alert when exists

True: Alerts when event is found. False: Alerts when even is NOT found

string

Warning

Occurrences warning threshold

integer

Critical

Occurrences critical threshold

integer

Persistence

Not OK state persistence time in minutes. 0 means no persistence

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

InfluxDB Versions

Shows all InfluxDB info

check_influxdb_info

_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 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

InfluxDB Points

Checks diff of writing ok/fail/total points of Influx Node

check_influxdb_points

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

Collectd Plugin

Shows all Collectd info

check_influxdb_collectd

_HOSTINFLUXDB_PORT

_HOSTINFLUXDB_USER

_HOSTINFLUXDB_PASS

_HOSTINFLUXDB_NODENAME

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

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_active_clients

Checks the active clients

check_active_clients

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_current_connections

Checks the current connections

check_current_connections

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_total_queries

Checks the total number of queries

check_total_queries

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_total_update_queries

Checks the total number of update queries

check_total_update_queries

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_version

Shows the mongodb version

check_mongo_version

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_writer_clients

Checks the number of writer cients

check_writer_clients

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_reader_clients

Checks the number of reader clients

check_reader_clients

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_node_memory

Checks the memory usage

check_mongo_memory

_HOSTMONGODB_PORT

_HOSTMONGODB_MEMORY_WARNING_THRESHOLD

_HOSTMONGODB_MEMORY_CRITICAL_THRESHOLD

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_total_delete_queries

Checks the total number of delete queries

check_total_delete_queries

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_total_insert_queries

Checks the total number of insert queries

check_total_insert_queries

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

MongoDB_software_uptime

Shows the mongodb software uptime

check_server_uptime

_HOSTMONGODB_PORT

_HOSTMONGODB_AUTHUSER

_HOSTMONGODB_AUTHPASS

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_AUTHUSER

Mongodb user login

string

_MONGODB_AUTHPASS

Mongodb password for the login user

string

_MONGODB_PORT

MongoDB port for the queries (default 27017)

integer

_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 - 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 - 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

MSSQL - Version

Shows MSSQL server version

check_mssql_version

_HOSTSQL_USER

_HOSTSQL_PASSWORD

MSSQL - Status

Checks MSSQL server process status

check_mssql_status

_HOSTSQL_USER

_HOSTSQL_PASSWORD

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

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 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 Threads Connected

Checks the actual number of connected threads

mysql_check_thread_connected

_HOSTMYSQLPORT

_HOSTMYSQLDATABASE

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTTHREAD_WARNING

_HOSTTHREAD_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 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 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 processes

Checks the actual number of processes

check_oracle_resources_procs

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTPROCS_WARN

_HOSTPROCS_CRIT

Oracle Tablespace usage

Checks the tablespace usage

check_oracle_resources_tablespace

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTTABLESPACE_WARNING

_HOSTTABLESPACE_CRITICAL

Oracle FRA usage

Checks the FRA (Fast Recovery Area) usage

check_oracle_resources_fra

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTFRA_WARNING

_HOSTFRA_CRITICAL

Oracle sessions

Checks the number of sessions

check_oracle_resources_sessions

_HOSTUSER

_HOSTPASSWD

_HOSTDDBB

_HOSTPORT

_HOSTSESSIONS_WARN

_HOSTSESSIONS_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-Query_Time

Checks the maximum running time of current queries

check_postgresql_query_time

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTQUERYTIME_WARN

_HOSTQUERYTIME_CRIT

PostgreSQL-disabled_triggers

Check if any triggers are disabled

check_postgresql_disabled_triggers

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

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-database_size

Report if a database is too big

check_postgresql_database_size

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTDBSIZE_WARN

_HOSTDBSIZE_CRIT

PostgreSQL-backends

Checks the number of connections

check_postgresql_backends

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTBACKENDS_WARN

_HOSTBACKENDS_CRIT

PostgreSQL-hitratio

Report if the hit ratio of a database is too low

check_postgresql_hitratio

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTHITRATIO_WARN

_HOSTHITRATIO_CRIT

PostgreSQL-index_size

Checks the size of indexes only

check_postgresql_index_size

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTINDEXSIZE_WARN

_HOSTINDEXSIZE_CRIT

PostgreSQL-connection

Simple connection check

check_postgresql_connection

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

PostgreSQL-Locks

Checks the number of locks

check_postgresql_locks

_HOSTPOSTGRESQLPORT

_HOSTPOSTGRESQLUSER

_HOSTPOSTGRESQLPASSWORD

_HOSTLOCKS_WARN

_HOSTLOCKS_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

_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

Simple-mysql

DESCRIPTION


Simple - Mysql Database Plugin Monitoring. Uptime, Connection Time, InnoDB Hit Rates, etc

../../_images/simple-mysql.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 Amount of Slow Processes -now-

Checks the actual number of slow processes

simple_mysql_check_slow_process

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTSLOW_PROCS_THRESHOLD

_HOSTSLOW_PROCS_WARNING

_HOSTSLOW_PROCS_CRITICAL

Mysql Connection Time

Checks the connection time

simple_mysql_check_connection_time

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTCONNECTION_TIME_WARNING

_HOSTCONNECTION_TIME_CRITICAL

Mysql Threads Connected

Checks the actual number of connected threads

simple_mysql_check_thread_connected

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTTHREAD_WARNING

_HOSTTHREAD_CRITICAL

Mysql InnoDB Buffer Hit Rate

Checks the buffer hit rate

simple_mysql_check_innodb_bufferpool_hitrate

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTBPHITRATE_WARNING

_HOSTBPHITRATE_CRITICAL

Mysql Temporary Tables created on disk -percent-

Checks the percentage of temporary tables created on disk

simple_mysql_check_tmp_dsk_tbl

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTTMP_DISK_TBL_WARNING

_HOSTTMP_DISK_TBL_CRITICAL

Mysql Amount of Slow Queries

Checks the actual number of slow queries

simple_mysql_check_slow_queries

_HOSTMYSQLPORT

_HOSTMYSQLUSER

_HOSTMYSQLPASS

_HOSTSLOW_PROCS_THRESHOLD

_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

_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.

percent

_BPHITRATE_CRITICAL

The percentage of hitrate from the InnoDB Buffer Pool to reach a CRITICAL state.

percent

_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_THRESHOLD

The time in milliseconds for a process to be considered slow.

integer

_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

Others

Mailbox-query

DESCRIPTION


Check alert messages in a mailbox via IMAP

../../_images/mailbox-query.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

Mailbox - Search $KEY$

Looks for alert messages in a mailbox via IMAP

check_mailbox-query

_HOSTMAILBOX_SERVER

_HOSTMAILBOX_ADDRESS

_HOSTMAILBOX_PASSWORD

_ALERT_MESSAGE_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

_MAILBOX_SERVER

IMAP Mail server address

string

_MAILBOX_ADDRESS

Mailbox address. Ex: mailbox@bussiness.com

string

_MAILBOX_PASSWORD

Mailbox password

string

COMPLEX MACROS

  • _ALERT_MESSAGE_LIST

    • Description: Alert message conditions


Fields

Description

Type

Display name

Name/ID of alert message (unique)

string

Alert type

String included in message Subject to identify the alert

string

Disable String

String included in message Subject to identify the alert disable message. Ex: return to nomal

string

Test-pack-random-states

DESCRIPTION


Test pack to generate random states service

This is a test purpose pack. Just to generate services with random states

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

Test pack random states

Generates random state (OK, WARNING, CRITICAL, UNKNOWN). Test purpose

check_test_pack_random_states

MACROS


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

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 - Virtual Volumes

Checks the Virtual Volumes state

check_3par_virtual_volumes

_HOSTUSER

_HOSTPASSWORD

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-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 - Nodes

Checks the Nodes state

check_3par_nodes

_HOSTUSER

_HOSTPASSWORD

3PAR - Alerts

Checks the Alerts

check_3par_alerts

_HOSTUSER

_HOSTPASSWORD

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-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-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-cpu

Checks 3Par CPU info.

check_3par_cpu

_HOST3PAR_API_PORT

_HOSTUSER

_HOSTPASSWORD

_HOST3PAR_API_PROTOCOL

_HOST3PAR_API_VERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

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 - Physical Disks

Checks the Physical Disks state

check_3par_physical_disks

_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

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

NAS_Iomega_Partition_$KEY$

Checks the partitions usage

check_iomega_partition_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTSTORAGE_USAGE_WARNING

_HOSTSTORAGE_USAGE_CRITICAL

_PARTITIONS

Nas-iomega_Raid_status

Checks the raid status

check_iomega_raid_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Memory_usage

Checks the memory usage

check_iomega_mem_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

CPU_usage

Checks the CPU usage

check_iomega_cpu_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTCPU_USAGE_WARNING

_HOSTCPU_USAGE_CRITICAL

nas-iomega-Disks_status

Checks the Disks status

check_iomega_disks_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

Nas-iomega_Info

Obtains device info: hostname, description and uptime

check_iomega_info

_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$ -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

CPU Fan Status

Checks the status of CPU fan

check_synology_cpu_fan_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

System Fan Status

Checks the status from system fan

check_synology_system_fan_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

Upgrade Available

Checks if there is an available upgrade

check_synology_upgrade_available

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

nas-synology_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

System Status

Checks the system status

check_synology_system_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Memory Usage

Checks the memory usage

check_synology_mem_usage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTMEM_USAGE_WARNING

_HOSTMEM_USAGE_CRITICAL

CPU Usage

Checks the CPU usage

check_synology_cpu_usage

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTCPU_USAGE_WARNING

_HOSTCPU_USAGE_CRITICAL

Disks Temperatures

Checks the temperature from disks

check_synology_disks_temperatures

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTDISK_TEMPERATURE_WARNING

_HOSTDISK_TEMPERATURE_CRITICAL

PowerSupplies Status

Checks the status from power supplies

check_synology_power_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Disks Status

Checks the disks status

check_synology_disks_status

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

Nas-synology_Info

Shows system information

check_synology_info

_HOSTSNMPVERSION

_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

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 - Occupancy - Volume $KEY$

Checks PureStorage FlashArray Volume occupancy

check_purestorage_occupancy_volume

_HOSTAPI_TOKEN

_PURESTORAGE_VOLUME_LIST

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 - Occupancy - FA

Checks PureStorage FlashArray occupancy

check_purestorage_occupancy_fa

_HOSTAPI_TOKEN

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

PureStorage - Open Alerts

Checks Open Alerts in PureStorage FlashArray

check_purestorage_alerts

_HOSTAPI_TOKEN

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 - Info

Checks PureStorage FlashArray model and Purity version info

check_purestorage_info

_HOSTAPI_TOKEN

PureStorage - Status - $KEY$

Checks status of PureStorage FlashArray HW components

check_purestorage_hw_status

_HOSTAPI_TOKEN

_HOSTVOLTAGE_WARN

_HOSTVOLTAGE_CRIT

_PURESTORAGE_HW_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:

_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

_VOLTAGE_WARN

Power supply voltage warning threshold

integer

_VOLTAGE_CRIT

Power supply voltage critical threshold

integer

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_fans

Checks the fans speed

check_qnap_fans

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTFAN_SPEED_WARNING

_HOSTFAN_SPEED_CRITICAL

Qnap_MEM

Checks the memory usage

check_qnap_mem

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

Qnap_Temp

Checks the system temperature

check_qnap_temp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTEMP_WARNING

_HOSTTEMP_CRITICAL

Qnap_raid_status

Checks the status from raid

check_qnap_raidstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_info

Shows system information

check_qnap_info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_hdtemp

Checks the hard disk temperature

check_qnap_hdtemp

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTHDTEMP_WARNING

_HOSTHDTEMP_CRITICAL

Qnap_CPU

Checks the CPU usage

check_qnap_cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Qnap_power_supply

Checks the power supply status

check_qnap_powersupply

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_lunstatus

Checks the LUN (Logical Unit Number) status

check_qnap_lunstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_volstatus

Checks the status from volumes

check_qnap_volstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_cache_disk_status

Checks the status from cache disk

check_qnap_cachediskstatus

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

Qnap_volusage

Checks the volumes usage

check_qnap_volusage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTVOL_USAGE_WARNING

_HOSTVOL_USAGE_CRITICAL

Qnap_hdstatus

Checks the hard drive status

check_qnap_hdstatus

_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

Operating System

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

Partition $KEY$

Checks the disk usage

check_nrpe_disk

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_PARTITIONS

Linux-nrpe_Load

Checks the CPU load

check_nrpe_load

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

Linux-nrpe_Swap

Checks the SWAP usage

check_nrpe_swap

_HOSTSWAP_WARN

_HOSTSWAP_CRIT

Linux-nrpe_Users

Checks the number of users

check_nrpe_users

_HOSTUSERS_WARN

_HOSTUSERS_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

Disks

Overall disks usage

check_linux_disks

_HOSTSNMPCOMMUNITY

_HOSTSTORAGE_PATH

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSNMP_MSG_MAX_SIZE

_HOSTSNMPVERSION

Linux-snmp_Memory

Check about physical memory space usage.

check_linux_memory

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_HOSTSNMPCOMMUNITY

Linux SNMP - SysDescr

Shows system description

check_linux_snmp_sysdescr

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

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

Load

Detect abnormal CPU usage

check_linux_load

_HOSTSNMPCOMMUNITY

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

_HOSTSNMPVERSION

_HOSTLOAD_THRESHOLD_TYPE

Cpu

Detect abnormal CPU usage

check_linux_cpu

_HOSTSNMPCOMMUNITY

_HOSTCPU_WARN

_HOSTCPU_CRIT

_HOSTSNMPVERSION

Linux SNMP - Uptime

Check about system uptime

check_linux_snmp_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

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

Linux SNMP - TCP Connections

Check TCP connections table

check_linux_snmp_tcpconn

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTTCP_CONN_WARN

_HOSTTCP_CONN_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

_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

LinuxSnmp-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

Linux-snmp3-Disks

Overall disks usage

check_linux_disks_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSTORAGE_PATH

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

_HOSTSNMP_MSG_MAX_SIZE

_HOSTSNMPCONTEXT

_HOSTSNMPSECURITYLEVEL

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 - SysDescr

Shows system description

check_linux_snmp_sysdescr_v3

_HOSTSNMPVERSION

_HOSTSNMPCONTEXT

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

Linux SNMP3 - Uptime

Check about system uptime

check_linux_snmp_uptime_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSNMPVERSION

_HOSTUPTIME_WARN

_HOSTUPTIME_CRIT

Linux-snmp3-Cpu

Detect abnormal CPU usage

check_linux_cpu_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTCPU_WARN

_HOSTCPU_CRIT

_HOSTSNMPCONTEXT

_HOSTSNMPSECURITYLEVEL

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_Load

Detect abnormal CPU usage

check_linux_load_v3

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTLOAD_WARN

_HOSTLOAD_CRIT

_HOSTSNMPCONTEXT

_HOSTSNMPSECURITYLEVEL

Linux-snmp3_Memory

Check about physical memory space usage.

check_linux_memory_v3

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

_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

_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

Linux-ssh_Memory

Checks the memory usage

check_ssh_linux_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

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

CPU Stats

Checks the CPU load statistics

check_ssh_linux_cpu_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-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

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

SSH Connexion

Checks the SSH connexion

check_ssh_connexion

_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

NFS Stats

Checks the NFS (Network File System) statistics

check_ssh_linux_nfs_stats

_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

NET Stats

Checks the network statistics

check_ssh_linux_net_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 local wocu user must be done)

string

_SSH_PORT

Remote port for the SSH service

integer

_SSH_KEY

SSH key file for local wocu user. EX: /var/opt/wocu/.ssh/id_rsa

string

_SSH_KEY_PASSPHRASE

SSH key file passphrase for local wocu user (void by default)

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

Linux-ssh-aggregated_Memory

Checks the memory usage

check_ssh_linux_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

Linux-ssh-aggregated_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

Linux-ssh-aggregasted-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

Linux-ssh-aggregated_Kernel Stats

Checks the Kernel statistics

check_ssh_linux_kernel_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_Read-only Filesystems

Checks if there are Read-only filesystems

check_ssh_ro_filesystem

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_Disks Stats

Checks the disk statistics

check_ssh_linux_disks_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_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

linux-ssh-aggregated_Connection

Checks the SSH connexion

check_ssh_connexion

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_TCP States

Checks the states from TCP connection table

check_ssh_linux_tcp_states

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_NFS Stats

Checks the NFS (Network File System) statistics

check_ssh_linux_nfs_stats

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_Reboot

Checks the system uptime

check_ssh_linux_uptime

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

Linux-ssh-aggregated_NET Stats

Checks the network statistics

check_ssh_linux_net_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

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

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

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

Process_$KEY$

Checks the state of a process

os_processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

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

Users

Checks the number of users sessions

os_users

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUSERS_WARNING_THRESHOLD

_HOSTUSERS_CRITICAL_THRESHOLD

_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

Uptime

Checks the server uptime

os_uptime

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTUPTIME_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

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

Windows-Disks

Overall disks usage

check_windows_disks

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_DISK_WARN

_HOSTWINDOWS_DISK_CRIT

DisksIO

Overall disks IO usage

check_windows_disks_io

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

LoadAverage

Detect abnormal CPU usage

check_windows_load_average

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_LOAD_WARN

_HOSTWINDOWS_LOAD_CRIT

EventLogSystem

Detect abnormal system events

check_windows_eventlogs_system

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTEVENTLOG_SYSTEM_TIME_PERIOD

EventLogApplication

Detect abnormal application events

check_windows_eventlogs_application

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTEVENTLOG_APP_TIME_PERIOD

Windows-Swap

Check swap space usage. Too many use of swap space means lacks of memory or memory leaks.

check_windows_swap

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_SWAP_WARN

_HOSTWINDOWS_SWAP_CRIT

Network Interface

Detect abnormal Network usage

check_windows_network_interface

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_BW_WARN

_HOSTWINDOWS_BW_CRIT

Windows-Cpu

Detect abnormal CPU usage

check_windows_cpu

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_CPU_WARN

_HOSTWINDOWS_CPU_CRIT

InactiveSessions

Detect inactive sessions

check_windows_inactive_sessions

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTINACTIVE_SESSIONS_WARN

_HOSTINACTIVE_SESSIONS_CRIT

Windows - BigProcesses

Obtain processes using high CPU resources

check_windows_big_processes

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_BIG_PROCESSES_WARN

_HOSTWINDOWS_BIG_PROCESSES_CRIT

Windows-Reboot

Checks uptime

check_windows_uptime

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_UPTIME_WARN

_HOSTWINDOWS_UPTIME_CRIT

Windows_Memory

Check about memory usage.

check_windows_memory

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_HOSTWINDOWS_MEM_WARN

_HOSTWINDOWS_MEM_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_WMI

Windows Domain of the server

string

_USER_WMI

Full name of the user launching the query.

string

_PASSWORD_WMI

Password for the user launching the query.

string

_WINDOWS_BIG_PROCESSES_WARN

CPU usage by process warning threshold (percentage).

percent

_WINDOWS_BIG_PROCESSES_CRIT

CPU usage by process critical threshold (percentage).

percent

_WINDOWS_CPU_WARN

System CPU usage warning threshold (percentage).

percent

_WINDOWS_CPU_CRIT

System CPU usage critical threshold (percentage).

percent

_WINDOWS_DISK_WARN

Disk usage warning threshold (percentage)

percent

_WINDOWS_DISK_CRIT

Disk usage critical threshold (percentage)

percent

_EVENTLOG_APP_TIME_PERIOD

Time range to look for events in application log file (in minutes)

integer

_EVENTLOG_SYSTEM_TIME_PERIOD

Time range to look for events in system log file (in minutes)

integer

_WINDOWS_MEM_WARN

Warning threshold for Windows RAM usage (percentage)

percent

_WINDOWS_MEM_CRIT

Critical threshold for Windows RAM 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

_INACTIVE_SESSIONS_WARN

Inactive sessions warning threshold

integer

_INACTIVE_SESSIONS_CRIT

Inactive sessions critical threshold

percent

_WINDOWS_BW_WARN

Total Bandwidth warning threshold (bytes per second)

integer

_WINDOWS_BW_CRIT

Total Bandwidth critical threshold (bytes per second)

integer

_WINDOWS_UPTIME_WARN

Uptime warning threshold (minutes)

integer

_WINDOWS_UPTIME_CRIT

Uptime critical threshold (minutes)

string

_WINDOWS_SWAP_WARN

Virtual memory usage warning threshold (percentage)

percent

_WINDOWS_SWAP_CRIT

Virtual memory usage critical threshold (percentage)

percent

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_windows_services_status

_HOSTUSER_WMI

_HOSTPASSWORD_WMI

_HOSTDOMAIN_WMI

_SERVICES_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:

_SERVICES_LIST:

wocu-discover-windows-wmi-services.py -H $HOSTADDRESS$ –user $_USER_WMI$ –password $_PASSWORD_WMI$ –domain $_DOMAIN_WMI$ –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_WMI

WMI User

string

_PASSWORD_WMI

WMI Password

string

_DOMAIN_WMI

WMI Domain

string

COMPLEX MACROS

  • _SERVICES_LIST

    • Description: List of Services to overwatch

    • Discover: wocu-discover-windows-wmi-services.py


Fields

Description

Type

name

Service display name

string

Service

Real name of the service

string

Status

Service status (Running/Stopped/Paused/Pending)

string

Wocu-traps-health

DESCRIPTION


Checks Wocu Traps system 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

WOCU_Traps_Health_Daemon_$KEY$

Checks Wocu Traps daemons status and consumption metrics

wocu-traps-health-process

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_TRAPS_DAEMONS

WOCU_Traps_Health_Spool

Checks the spool files number

wocu-traps-health-spool

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSPOOL_DIR

_HOSTSPOOL_WARNING

_HOSTSPOOL_CRITICAL

WOCU_Traps_Health_Kernel_Buffer

Checks the buffered traps

wocu-traps-health-buffer

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTBUFFER_WARNING

_HOSTBUFFER_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

_SSH_USER

SSH user (key interchange with Wocu user must be done).

string

_SSH_PORT

SSH port (default 22).

integer

_SSH_KEY

SSH Key File (default ~/.ssh/id_rsa)

string

_SPOOL_DIR

Spool dir for incoming traps (default /var/spool/snmptt)

string

_SPOOL_WARNING

Spool files warning threshold

integer

_SPOOL_CRITICAL

Spool files critical threshold

integer

_BUFFER_WARNING

Buffered traps warning threshold

integer

_BUFFER_CRITICAL

Buffered traps critical threshold

integer

COMPLEX MACROS

  • _TRAPS_DAEMONS

    • Description: Traps daemons and 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

Pid_path

Path to PID file.

string

Virtualization

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

dockerd

Checks the Docker daemon

check_docker_daemon

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

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$_CPU

Checks Docker container CPU

check_docker_container_cpu

_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$_memory

Checks Docker container Memory usage

check_docker_container_memory

_HOSTSSH_PORT

_HOSTSSH_USER

_HOSTSSH_PASSWORD

_HOSTSSH_KEY

_HOSTSSH_KEY_PASSPHRASE

_CONTAINERS

Container_$KEY$_status

Checks Docker container status

check_docker_container_status

_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

Esx

DESCRIPTION


This pack checks VMware ESX virtual machines (guests)

../../_images/esx.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

ESX Io

Checks Virtual Machine disk I/O info

check_esx_host_io

_HOSTVCENTER

_HOSTVCENTER_LOGIN

_HOSTVCENTER_PASSWORD

_HOSTVCENTER_SESSION

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

_VCENTER

VCenter address

string

_VCENTER_LOGIN

VCenter User login

string

_VCENTER_PASSWORD

VCenter User password

string

_VCENTER_SESSION

VCenter temporal session file (complete path)

absolute path

_ESX_CPU_CRIT

Critical threshold for CPU USAGE (absolute)

integer

_ESX_CPU_WARN

Warning threshold for CPU USAGE (absolute)

integer

_ESX_MEM_CRIT

Critical threshold for MEMORY USAGE (percentage)

percent

_ESX_MEM_WARN

Warning threshold for MEMORY USAGE (percentage)

percent

Esx-host

DESCRIPTION


This pack checks ESX hosts

../../_images/esx-host.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

ESX IO READ

Checks ESX Host I/O read info

check_esx_io_read

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_IO_READ

_HOSTHOST_CRIT_IO_READ

ESX NTP

Shows NTP info (drift and peers)

check_esx_ntp

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_NTP_SECONDS

_HOSTHOST_CRIT_NTP_SECONDS

_HOSTHOST_WARN_NTP_PEERS

_HOSTHOST_CRIT_NTP_PEERS

ESX IO WRITE

Checks ESX Host I/O write info

check_esx_io_write

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_IO_WRITE

_HOSTHOST_CRIT_IO_WRITE

ESX VMFS

Shows Datastore info

check_esx_vmfs

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_VMFS

_HOSTHOST_CRIT_VMFS

ESX MEM

Checks ESX Host memory usage

check_esx_mem

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_MEM

_HOSTHOST_CRIT_MEM

ESX CPU

Checks ESX Host CPU usage

check_esx_cpu

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_CPU

_HOSTHOST_CRIT_CPU

ESX NET

Shows ESX Host net info

check_esx_net

_HOSTHOST_LOGIN

_HOSTHOST_PASSWORD

_HOSTHOST_WARN_NET

_HOSTHOST_CRIT_NET

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

_HOST_LOGIN

Host user

string

_HOST_PASSWORD

Host password

string

_HOST_WARN_CPU

Warning value percentage for CPU (ESX)

integer

_HOST_CRIT_CPU

Critical value percentage for CPU (ESX)

integer

_HOST_WARN_MEM

Warning value percentage for MEM usage (ESX)

integer

_HOST_CRIT_MEM

Critical value percentage for MEM usage (ESX)

integer

_HOST_WARN_NET

Warning Overall network usage in KBps(Kilobytes per Second)

integer

_HOST_CRIT_NET

Critical overall network usage in KBps(Kilobytes per Second)

integer

_HOST_WARN_IO_READ

Warning value for status disks IO in ms(ESX)

integer

_HOST_CRIT_IO_READ

Critical value for status disks IO in ms (ESX)

integer

_HOST_WARN_IO_WRITE

Warning value for status disks IO in ms (ESX)

integer

_HOST_CRIT_IO_WRITE

Critical value for status disks IO in ms (ESX)

integer

_HOST_WARN_VMFS

Warning value for space DATASTORE (ESX)

string

_HOST_CRIT_VMFS

Critical value for space DATASTORE (ESX)

string

_HOST_WARN_NTP_SECONDS

Warning value for NTP drift (seconds)

integer

_HOST_CRIT_NTP_SECONDS

Critical value for NTP drift (seconds)

integer

_HOST_WARN_NTP_PEERS

Warning value for NTP peer servers

integer

_HOST_CRIT_NTP_PEERS

Critical value for NTP peer servers

integer

Proxmox

DESCRIPTION


proxmox checks, returns performance values for proxmox server.

../../_images/proxmox.png

Returns performance values for proxmox server via request: Cluster Health, CPU, Memory, Storage, Subscription, VM Status, Replication Status.

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

Proxmox Memory

Checks the memory usage

check_pve_memory

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

_HOSTAPI_NODE

Proxmox Storage

Checks the storage status and usage

check_pve_storage

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

_HOSTAPI_NODE

_HOSTAPI_STORAGE

Proxmox IO Wait

Checks the IO wait metrics

check_pve_io_wait

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

_HOSTAPI_NODE

Proxmox Services

Checks the proxmox services state

check_pve_services

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

_HOSTAPI_NODE

_HOSTIGNORE_SERVICES

Proxmox CPU Load

Checks the CPU load

check_pve_cpu

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

_HOSTAPI_NODE

Proxmox Cluster Health

Checks the cluster health status

check_pve_cluster_health

_HOSTAPI_USER

_HOSTAPI_PASSWD

_HOSTAPI_ENDPOINT

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

Remote user for the API calls

string

_API_PASSWD

Remote password for the API calls

string

_API_ENDPOINT

API Endpoing (Usually is the FQDN of the Proxmox Server)

string

_API_NODE

Proxmox node name

string

_API_STORAGE

Proxmox storage Name

string

_IGNORE_SERVICES

Ignore check services names

string

Wocu Monitoring

Wocu-check

DESCRIPTION


Checks the status of the passive service generetad by wocu-check action

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 Check status

Checks the status of the passive service generetad by wocu-check action

check-wocu-check-status

_HOSTLMD_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

_LMD_PORT

LMP listening port. Default: 50000

integer

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-events-diff

DESCRIPTION


Checks events/logs inserted in MongoDB and ElasticSearch

../../_images/wocu-events-diff.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 Events Diff

Checks events/logs inserted in MongoDB and ElasticSearch

check-wocu-events-diff

_HOSTMONGO_ADDRESS

_HOSTMONGO_PORT

_HOSTMONGO_USER

_HOSTMONGO_PASS

_HOSTMONGO_AUTH_DATABASE

_HOSTMONGO_DATABASE

_HOSTMONGO_COLLECTION

_HOSTMONGO_REALM

_HOSTELASTICSEARCH_CLUSTER_IP

_HOSTELASTICSEARCH_CLUSTER_PORT

_HOSTELASTICSEARCH_PROTOCOL

_HOSTELASTICSEARCHINDEX

_HOSTELASTICSEARCHUSER

_HOSTELASTICSEARCHPASS

_HOSTDIFF_FACTOR

_HOSTPRODUCTION

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

_MONGO_ADDRESS

MongoDB IP Address

string

_MONGO_PORT

MongoDB TCP Port (27017 by default)

string

_MONGO_USER

MongoDB username

string

_MONGO_PASS

MongoDB password

string

_MONGO_AUTH_DATABASE

MongoDB authentication database

string

_MONGO_COLLECTION

MongoDB collection. Usually the realm-name

string

_MONGO_DATABASE

MongoDB database

string

_MONGO_REALM

Wocu realm. It’s used to filter the queries to a centralized mongoDB. Leave it blank if local mongodb is used

string

_ELASTICSEARCH_CLUSTER_IP

ElasticSearch IP Address

string

_ELASTICSEARCH_CLUSTER_PORT

ElasticSearch port (default 9200).

integer

_ELASTICSEARCH_PROTOCOL

ElasticSearch web protocol (default http)

string

_ELASTICSEARCHINDEX

ElasticSearch index for monitoring events. Usually monitoring-realm-name

string

_ELASTICSEARCHUSER

ElasticSearch username. Leave it blank if not needed

string

_ELASTICSEARCHPASS

ElasticSearch password. Leave it blank if not needed

string

_DIFF_FACTOR

Multiplying factor to consider both event metrics are different enough to alert

integer

_PRODUCTION

Only production realms should insert events in MongoDB. Is this one a production realm? Default: True

string

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

_HOSTSHINKEN_WEB_PROTOCOL

_HOSTFQDN

_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 (HTTPS by default)

string

_SHINKEN_WEB_PROTOCOL

Shinken WEB protocol: HTTP/HTTPS (HTTP by default)

string

_FQDN

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

_HOSTSHINKEN_WEB_PROTOCOL

_HOSTFQDN

_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

_SHINKEN_WEB_PROTOCOL

Shinken WEB protocol: HTTP/HTTPS (HTTP by default)

string

_FQDN

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

_HOSTSHINKEN_WEB_PROTOCOL

_HOSTFQDN

_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

_SHINKEN_WEB_PROTOCOL

Shinken WEB protocol: HTTP/HTTPS (HTTP by default)

string

_FQDN

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

_HOSTSHINKEN_WEB_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

_SHINKEN_WEB_PROTOCOL

Shinken 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-hw-health

DESCRIPTION


Checks hardware sensors with smartctl and IPMI tools

Smartmontools and IPMICFG must be installed in target hosts. User wocu must be allowed to execute smartctl and IPMICFG commands as root without password

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 - IPMI Sensors

Checks hardware sensors via SSH

wocu-hw-health-ipmi_sdr

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_PORT

Hardware Health - Disks

Checks Disks health with smartctl via SSH

wocu-hw-health-smartctl

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_PORT

Hardware Health - IPMI pminfo

Executes IPMI pminfo (Power Modules Info) via SSH

wocu-hw-health-ipmi_pminfo

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_PORT

Hardware Health - IPMI Power

Checks power consumption via SSH

wocu-hw-health-ipmi_dcmi_power

_HOSTSSH_USER

_HOSTSSH_KEY

_HOSTSSH_PORT

_HOSTPOWER_WARNING

_HOSTPOWER_CRITICAL

Hardware Health - IPMI Selftest

Executes IPMI Selftest via SSH

wocu-hw-health-ipmi_selftest

_HOSTSSH_USER

_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

_POWER_WARNING

Instantaneous power warning threshold

integer

_POWER_CRITICAL

Instantaneous power 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

SSH Key File (default ~/.ssh/id_rsa)

string

Wocu-latency

DESCRIPTION


Obtains services and hosts latency from Livestatus and alerts when trespass thresholds

Services/hosts latency is the difference between the moment in which a service_check/host_check should be executed and the moment it’s really executed

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 Latency

Obtain max services and hosts latency from Livestatus and alerts when trespass thresholds

check-wocu-latency

_HOSTLIVESTATUS_PORT

_HOSTSERVICES_WARNING_LATENCY

_HOSTSERVICES_CRITICAL_LATENCY

_HOSTHOSTS_WARNING_LATENCY

_HOSTHOSTS_CRITICAL_LATENCY

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

_LIVESTATUS_PORT

Livestatus port. Default: 50000

integer

_SERVICES_WARNING_LATENCY

Services latency warning threshold

string

_SERVICES_CRITICAL_LATENCY

Services latency critical threshold

string

_HOSTS_WARNING_LATENCY

Hosts latency warning threshold

string

_HOSTS_CRITICAL_LATENCY

Hosts latency critical threshold

string

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$ - Last Check

Checks the time from last check command executed

check-realm-last-check

_HOSTLAST_CHECK_WARN

_HOSTLAST_CHECK_CRIT

_WOCU_REALMS

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

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

Cloud

Aws-ec2

DESCRIPTION


Checks for AWS EC2 instances

../../_images/aws-ec2.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

aws-ec2-cpu-usage

Checks the CPU usage of EC2 instances

check_aws_ec2_cpu

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTAWS_PROFILE

_HOSTAWS_INSTANCE_ID

aws-ec2-traffic

Checks the traffic information of EC2 instance

check_aws_ec2_traffic

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTAWS_PROFILE

_HOSTAWS_INSTANCE_ID

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

_AWS_PROFILE

AWS profile for API authentication

string

_AWS_INSTANCE_ID

AWS EC2 instance ID

string

_CPU_WARNING

CPU usage warning threshold

percent

_CPU_CRITICAL

CPU usage critical threshold

percent

Aws-eks

DESCRIPTION


Checks for AWS EKS clusters

../../_images/aws-eks.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

aws-eks-mem-usage

Checks the memory usage of EKS clusters

check_aws_eks_mem

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

_HOSTAWS_PROFILE

_HOSTAWS_EKS_CLUSTER_NAME

aws-eks-cpu-usage

Checks the CPU usage of EKS clusters

check_aws_eks_cpu

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

_HOSTAWS_PROFILE

_HOSTAWS_EKS_CLUSTER_NAME

aws-eks-nodes

Checks the number of nodes in the EKS cluster

check_aws_eks_nodes

_HOSTNODES_WARNING

_HOSTNODES_CRITICAL

_HOSTAWS_PROFILE

_HOSTAWS_EKS_CLUSTER_NAME

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

_AWS_PROFILE

AWS profile for API authentication

string

_AWS_EKS_CLUSTER_NAME

AWS EKS cluster name

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

_NODES_WARNING

Number of nodes warning threshold

percent

_NODES_CRITICAL

Number of nodes critical threshold

percent

Gce-vm

DESCRIPTION


Gloogle Cloud Engine Instance 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

Google Cloud Instance - Disk IOPS

Checks Google Cloud Instance Read and Write OPS

check_gce_vm_disk

_HOSTSERVICE_ACCOUNT

_HOSTPROJECT_ID

Google Cloud Instance - Traffic

Checks Google Cloud Instance Traffic

check_gce_vm_traffic

_HOSTSERVICE_ACCOUNT

_HOSTPROJECT_ID

Google Cloud Instance - CPU

Checks Google Cloud Instance CPU usage

check_gce_vm_cpu

_HOSTSERVICE_ACCOUNT

_HOSTPROJECT_ID

_HOSTCPU_WARNING

_HOSTCPU_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

_SERVICE_ACCOUNT

Service Account json file

string

_PROJECT_ID

Gloogle Cloud Project ID

string

_CPU_WARNING

CPU usage warning threshold (percent)

percent

_CPU_CRITICAL

CPU usage critical threshold (percent)

percent

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_Media

Checks the number and status of Media devices

check-cisco-ccm-devices-media

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_MEDIA_WARNING

_HOSTPROBLEM_MEDIA_CRITICAL

CCM-Info

Shows info about the Cisco Call Manager device

check-cisco-ccm-info

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

CallManager-Disks

Overall disks usage

check-cisco-ccm-disks

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTSTORAGE_WARN

_HOSTSTORAGE_CRIT

Devices_Gateways

Checks the number and status of Gateway devices

check-cisco-ccm-devices-gateways

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_GATEWAYS_WARNING

_HOSTPROBLEM_GATEWAYS_CRITICAL

CallManager-TimeSync

Checks the difference between device and Wocu UTC time

check-cisco-ccm-time

_HOSTSNMPVERSION

_HOSTSNMPCOMMUNITY

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTNTP_WARN

_HOSTNTP_CRIT

Devices_CTI

Checks the number and status of CTI devices

check-cisco-ccm-devices-cti

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_CTI_WARNING

_HOSTPROBLEM_CTI_CRITICAL

Devices_VoiceMails

Checks the number and status of Voicemail devices

check-cisco-ccm-devices-voicemails

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_VOICEMAIL_WARNING

_HOSTPROBLEM_VOICEMAIL_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

CallManager-Memory

Checks the memory usage

check-cisco-ccm-memory

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

Devices_Phones

Checks the number and status of Phone devices

check-cisco-ccm-devices-phones

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_PHONES_WARNING

_HOSTPROBLEM_PHONES_CRITICAL

CallManager-CPU

Checks the CPU usage

check-cisco-ccm-cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_WARN

_HOSTCPU_CRIT

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

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$

_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 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

_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

_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

_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 Memory Usage

Checks the memory usage

call-manager-cisco-snmp-memory

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTMEMORY_WARN

_HOSTMEMORY_CRIT

Call Manager Devices - VoiceMails

Checks the number and status of Voicemail devices

call-manager-cisco-snmp-voicemails

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_VOICEMAIL_WARNING

_HOSTPROBLEM_VOICEMAIL_CRITICAL

Call Manager Devices - Gateways

Checks the number and status of Gateway devices

call-manager-cisco-snmp-gateways

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_GATEWAYS_WARNING

_HOSTPROBLEM_GATEWAYS_CRITICAL

Call Manager Devices - Media

Checks the number and status of Media devices

call-manager-cisco-snmp-media

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_MEDIA_WARNING

_HOSTPROBLEM_MEDIA_CRITICAL

Call Manager Status - local

Checks status from local Cisco Call Manager

call-manager-cisco-snmp-status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

CUCM_Process_$KEY$

Checks process status

call-manager-cisco-snmp-processes

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_PROCESSES

Call Manager CPU Usage

Checks the CPU usage

call-manager-cisco-snmp-cpu

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTCPU_WARN

_HOSTCPU_CRIT

Call Manager Devices - Phones

Checks the number and status of Phone devices

call-manager-cisco-snmp-phones

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_PHONES_WARNING

_HOSTPROBLEM_PHONES_CRITICAL

Call Manager Devices - CTI

Checks the number and status of CTI devices

call-manager-cisco-snmp-cti

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPROBLEM_CTI_WARNING

_HOSTPROBLEM_CTI_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$

_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

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). Write $SNMPCONTEXT$ to use Shinken resource

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

_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

ProcParameters

Process parameters

string

Cisco-call-manager-cloud

DESCRIPTION


Check for Cisco Call Manager via CUCM APIs. Tested CUCM versions: 12.5, 14

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-call-manager-cloud_cti

Checks the CTI devices status

cisco-call-manager-cloud_cti

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTCTI_WARNING

_HOSTCTI_CRITICAL

cisco-call-manager-cloud_media

Checks the media resources status

cisco-call-manager-cloud_media

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTMEDIA_WARNING

_HOSTMEDIA_CRITICAL

cisco-call-manager-cloud_phones

Checks the Phones status

cisco-call-manager-cloud_phones

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTPHONES_WARNING

_HOSTPHONES_CRITICAL

cisco-call-manager-cloud_voicemail

Checks the VoiceMail devices status

cisco-call-manager-cloud_voicemail

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTVOICEMAIL_WARNING

_HOSTVOICEMAIL_CRITICAL

cisco-call-manager-cloud_sip_trunk_status_$KEY$

Checks the status of a given SIP Trunk

cisco-call-manager-cloud_sip_trunk_status

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS

cisco-call-manager-cloud_version

Obtains the CUCM version

cisco-call-manager-cloud_version

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

cisco-call-manager-cloud_memory

Checks the Call Manager Memory usage

cisco-call-manager-cloud_memory

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTMEM_WARNING

_HOSTMEM_CRITICAL

cisco-call-manager-cloud_gateway_status_$KEY$

Checks the status of a given Gateway

cisco-call-manager-cloud_gateway_status

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_CISCO_CALL_MANAGER_CLOUD_GATEWAYS

cisco-call-manager-cloud_gateways

Checks the gateways status

cisco-call-manager-cloud_gateways

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTGATEWAYS_WARNING

_HOSTGATEWAYS_CRITICAL

cisco-call-manager-cloud_cpu

Checks the Call Manager CPU usage

cisco-call-manager-cloud_cpu

_HOSTREAL_ADDRESS

_HOSTCUCM_USER

_HOSTCUCM_PASSWORD

_HOSTCPU_WARNING

_HOSTCPU_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:

_CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS:

wocu-discover-cisco-cucm-api.py -H $HOSTADDRESS$ -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ -t sip_trunks –remote $_POLLER_TAG_ADDRESS$

_CISCO_CALL_MANAGER_CLOUD_GATEWAYS:

wocu-discover-cisco-cucm-api.py -H $HOSTADDRESS$ -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ -t gateways –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

_REAL_ADDRESS

Call Manager real IP address. Fill it with real address when Call Manager is behind a NAT

string

_CUCM_USER

CUCM API user

string

_CUCM_PASSWORD

CUCM API password

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

_PHONES_WARNING

Not registered phones warning threshold

integer

_PHONES_CRITICAL

Not registered phones critical threshold

integer

_GATEWAYS_WARNING

Not registered gateways warning threshold

integer

_GATEWAYS_CRITICAL

Not registered gateways critical threshold

integer

_MEDIA_WARNING

Not registered media resources warning threshold

integer

_MEDIA_CRITICAL

Not registered media resources critical threshold

integer

_CTI_WARNING

Not registered CTI warning threshold

integer

_CTI_CRITICAL

Not registered CTI critical threshold

integer

_VOICEMAIL_WARNING

Not registered voicemails warning threshold

integer

_VOICEMAIL_CRITICAL

Not registered voicemails critical threshold

integer

COMPLEX MACROS

  • _CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS

    • Description: SIP Trunks list

    • Discover: wocu-discover-cisco-cucm-api.py


Fields

Description

Type

display_name

SIP Trunk display name

string

name

SIP Trunk name. Don’t modify the discovered value. Used in checks

string

description

SIP trunk description

string

  • _CISCO_CALL_MANAGER_CLOUD_GATEWAYS

    • Description: Gateways list

    • Discover: wocu-discover-cisco-cucm-api.py


Fields

Description

Type

display_name

Gateway name

string

name

Gateway name. Don’t modify the discovered value. Used in checks

string

description

Gateway description

string

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

Inbound Sessions $KEY$

Checks the actual inbound sessions number

sbc_acme_inbound_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_REALMLIST

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 License Usage

Checks the percentage of SBC license in use

sbc_acme_license_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTLICENSE_USAGE_WARNING

_HOSTLICENSE_USAGE_CRITICAL

SBC Memory Usage

sbc_acme_memory_usage

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTMEMORY_USAGE_WARNING

_HOSTMEMORY_USAGE_CRITICAL

SBC Redundancy State

Checks the redundancy state of the SBC node

sbc_acme_redundancy

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

System state

Check the snmp sytem state of the SBC device

sbc_system_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

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

Outbound Sessions $KEY$

Checks the actual outbound sessions number

sbc_acme_outbound_sessions

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_REALMLIST

SBC AcmePacket Info

Shows system information

sbc_acme_info

_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:

_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 DSP utilization

Checks the DSP (Digital Signal Processing) utilization

sbc_audiocodes_dsp_utilization

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTACTIVE_DSP_CHANNELS_WARNING

_HOSTACTIVE_DSP_CHANNELS_CRITICAL

SBC OffHook channels

Checks the Off Hook channels

sbc_audiocodes_offhook_channels

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTOFFHOOK_CHANNELS_WARNING

_HOSTOFFHOOK_CHANNELS_CRITICAL

SBC Audiocodes Info

Shows system information

sbc_audiocodes_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

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_Drivesize

Checks the storage usage

check_skype_for_business_drivesize

_HOSTDRIVESIZE_WARNING

_HOSTDRIVESIZE_CRITICAL

Skype_service_$KEY$

Checks the services status

check_skype_for_business_service

_SKYPE_SERVICES_LIST

Skype_CPU

Checks the CPU usage

check_skype_for_business_cpu

_HOSTCPU_WARNING

_HOSTCPU_CRITICAL

Skype_Memory

Checks the memory usage

check_skype_for_business_mem

_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

_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

Api

Api-test-generic

DESCRIPTION


Obtain the status and elapsed time from queries to API endpoint

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_Test_$KEY$

Checks API endpoints status and response time

check-api-test-generic

_HOSTELAPSED_TIME_WARNING

_HOSTELAPSED_TIME_CRITICAL

_HOSTAPI_USER

_HOSTAPI_PASSWORD

_HOSTAPI_TIMEOUT

_API_TEST_GENERIC_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

_API_USER

API User

string

_API_PASSWORD

API Password

string

_API_TIMEOUT

API Query timeout in seconds, default 10s

integer

_ELAPSED_TIME_WARNING

Elapsed time warning threshols (seconds)

integer

_ELAPSED_TIME_CRITICAL

Elapsed time critical threshols (seconds)

integer

COMPLEX MACROS

  • _API_TEST_GENERIC_LIST

    • Description: List of API Endpoints


Fields

Description

Type

display_name

Name to be shown in the web interface

string

url

API Endpoint url

string

user

API user. If blank, use generic one

string

password

API password. If blank, use generic one

string

warning

Elapsed time warning threshold. If blank, use generic one

string

critical

Elapsed time critical threshold. If blank, use generic one

string

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-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-version

Checks Kibana version information.

check_kibana_node_version

_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-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-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-version

Checks Logstash version information.

check_logstash_node_version

_HOSTLOGSTASH_PORT

_HOSTLOGSTASH_USERNAME

_HOSTLOGSTASH_PASSWORD

_HOSTLOGSTASH_HTTP_PROTOCOL

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-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-tcp-port

Checks Logstash host port.

check_logstash_node_tcp_port

_HOSTLOGSTASH_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

_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

Networking

Fibernet-leds

DESCRIPTION


Checks Fibernet leds state

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

Fibernet - Led State - $KEY$

Checks the Fibernet Leds state

check_fibernet_leds_state

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_FIBERNET_LEDS_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:

_FIBERNET_LEDS_LIST:

wocu-discover-fibernet-leds.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

  • _FIBERNET_LEDS_LIST

    • Description: Fibernet ledss list

    • Discover: wocu-discover-fibernet-leds.py


Fields

Description

Type

display_name

Name to be shown in the web interface. Discovered names are formed by: led + componentKey + bastidor + chassis + slot + ledIndex

string

bastidor

Bastidor number

integer

chassis

Chassis number

integer

slot

Slot number

integer

component_key

Component index (key)

integer

led_index

Led Index

integer

card_type

Card Type number

integer

Networkdevice-optical-ifaces-health

DESCRIPTION


Obtains metrics from optical ifaces sensors. Supported vendors: Cisco, Huawei, Extreme Networks, H3C, HH3C

Supported vendors: Cisco, Huawei, Extreme Networks, H3C, HH3C

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

Optical_iface_sensor_$KEY$

Checks the Optical interface sensor state and value

check_optical_ifaces_sensor

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTDEVICEVENDOR

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_OPTICAL_IFACES_SENSORS_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$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$

_OPTICAL_IFACES_SENSORS_LIST:

wocu-discover-optical-ifaces.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -V $_DEVICEVENDOR$ -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

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

  • _OPTICAL_IFACES_SENSORS_LIST

    • Description: List of sensors from optical ifaces

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


Fields

Description

Type

display_name

Name to be shown in the web interface

string

sensor_type

Sensor type

string

index

Sensor index. Used in snmp requests

integer

warning

Warning threshold. Nagios format supported. Units - Power:dBm, Current:mA, Temp:Celsius, Voltage:Volts

string

critical

Critical threshold. Nagios format supported. Units - Power:dBm, Current:mA, Temp:Celsius, Voltage:Volts

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

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

$KEY$

Checks the consumables state

check_printer_consum

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_CONSUMLIST

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

Code Repository

Gitlab

DESCRIPTION


Standard Gitlab 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

gitlab_project_$KEY$_stats

Show Gitlab Project statistics.

check_gitlab_project_statistics

_HOSTGITLAB_TOKEN

_GITLAB_PROJECTS

gitlab_project_$KEY$_branch_pipeline_status

Checks last pipeline status of project branch.

check_gitlab_project_branch_pipeline_status

_HOSTGITLAB_TOKEN

_GITLAB_PROJECTS

gitlab_project_$KEY$_runners

Check Gitlab Project runners.

check_gitlab_project_runners

_HOSTGITLAB_TOKEN

_GITLAB_PROJECTS

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:

_GITLAB_PROJECTS:

wocu-discover-gitlab-projects.py -H $HOSTADDRESS$ -T $_GITLAB_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

_GITLAB_TOKEN

Authentication Token. More info: TODO: Add link to GitLab API Documentation

string

COMPLEX MACROS

  • _GITLAB_PROJECTS

    • Description: List of projects to be monitored.

    • Discover: wocu-discover-gitlab-projects.py


Fields

Description

Type

project_id

Project ID

string

project_name

Project Name

string

project_branch

Project Branch

string

Web

Apache-tomcat

DESCRIPTION


Health and performance checks for Apache Tomcat servers

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

Apache Tomcat - Thread

Checks Apache Tomcat busy threads

check_apache_tomcat_thread

_HOSTTOMCAT_PORT

_HOSTTOMCAT_USER

_HOSTTOMCAT_PASS

_HOSTTHREAD_WARNING

_HOSTTHREAD_CRITICAL

Apache Tomcat - Status

Checks Apache Tomcat server status

check_apache_tomcat_status

_HOSTTOMCAT_PORT

_HOSTTOMCAT_USER

_HOSTTOMCAT_PASS

Apache Tomcat - APP - $KEY$

Checks Apache Tomcat App status and sessions

check_apache_tomcat_app

_HOSTTOMCAT_PORT

_HOSTTOMCAT_USER

_HOSTTOMCAT_PASS

_TOMCAT_APP_LIST

Apache Tomcat - Memory

Checks Apache Tomcat Memory usage

check_apache_tomcat_mem

_HOSTTOMCAT_PORT

_HOSTTOMCAT_USER

_HOSTTOMCAT_PASS

_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

_MEM_WARNING

Memory usage warning threshold

percent

_MEM_CRITICAL

Memory usage critical threshold

percent

_TOMCAT_PORT

TCP port where Tomcat server is listening to. Default: 8080

string

_TOMCAT_USER

Tomcat user

string

_TOMCAT_PASS

Tomcat password

string

_THREAD_WARNING

Used threads warning threshold

integer

_THREAD_CRITICAL

Used threads critical threshold

integer

COMPLEX MACROS

  • _TOMCAT_APP_LIST

    • Description: Apache Tomcat App list


Fields

Description

Type

display_name

Name to be shown in the web interface

string

app_name

Application name

string

Iot

Apc-epdu

DESCRIPTION


Health and performance check for APC-EPDU devices

../../_images/apc-epdu.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

apc-epdu_ps_status

Checks the power supplies status

apc-epdu_ps_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

apc-epdu_pdu_energy

Checks the PDU energy consumption

apc-epdu_pdu_energy

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

apc-epdu_outlet_load_status_$KEY$

Checks the outlets load status

apc-epdu_outlet_load_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APC_EPDU_OUTLET_LIST

apc-epdu_outlet_energy_$KEY$

Checks the outlets energy consumption

apc-epdu_outlet_energy

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_APC_EPDU_OUTLET_LIST

apc-epdu_pdu_load_status

Checks the PDU load status

apc-epdu_pdu_load_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

apc-epdu_outlet_power_$KEY$

Checks the outlets power consumption

apc-epdu_outlet_power

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTOUTLET_POWER_WARNING

_HOSTOUTLET_POWER_CRITICAL

_APC_EPDU_OUTLET_LIST

apc-epdu_outlet_current_$KEY$

Checks the outlets current

apc-epdu_outlet_current

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTOUTLET_CURRENT_WARNING

_HOSTOUTLET_CURRENT_CRITICAL

_APC_EPDU_OUTLET_LIST

apc-epdu_phase_bank_load_status

Checks the load and status from Phases and Banks

apc-epdu_phase_bank_load_status

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

apc-epdu_pdu_power

Checks the PDU power consumption

apc-epdu_pdu_power

_HOSTSNMPCOMMUNITY

_HOSTSNMPVERSION

_HOSTSNMPSECURITYNAME

_HOSTSNMPAUTHPROTOCOL

_HOSTSNMPAUTHKEY

_HOSTSNMPPRIVPROTOCOL

_HOSTSNMPPRIVKEY

_HOSTSNMPSECURITYLEVEL

_HOSTSNMPCONTEXT

_HOSTPDU_POWER_WARNING

_HOSTPDU_POWER_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:

_APC_EPDU_OUTLET_LIST:

wocu-discover-apc-epdu-outlets.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_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

_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

_PDU_POWER_WARNING

PDU power warning threshold in Watts

integer

_PDU_POWER_CRITICAL

PDU power critical threshold in Watts

integer

_OUTLET_POWER_WARNING

Outlet power warning threshold in Watts

integer

_OUTLET_POWER_CRITICAL

Outlet power critical threshold in Watts

integer

_OUTLET_CURRENT_WARNING

Outlet current warning threshold in Amps

float

_OUTLET_CURRENT_CRITICAL

Outlet current critical threshold in Amps

float

COMPLEX MACROS

  • _APC_EPDU_OUTLET_LIST

    • Description: List of outlets

    • Discover: wocu-discover-apc-epdu-outlets.py


Fields

Description

Type

display_name

Outlet name used in service description. Must be unique

string

index

OID index used in SNMP queries. Must be unique

integer

name

Outlet name

string