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

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

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

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