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.
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
DNS_$KEY$ |
Checks if DNS query reply is what it’s expected |
check_dns_advanced |
_DNS_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
COMPLEX MACROS
_DNS_LIST
Description: List of DNS names to be queried
Fields |
Description |
Type |
---|---|---|
descr |
Query name. It will be used in the service name |
string |
dns_server |
DNS server you want to use for the lookup |
string |
dns_hostname |
The name or address you want to query |
string |
dns_expected_result |
Dns address or cname expected to be returned. If you want to configure several addresses, you must separate them with commas. All of them must be included in the response. When using cname and a FQDN, it ends with a dot (.) |
string |
Efficientip
DESCRIPTION
Monitoring Efficient IP devices via snmp
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Efficientip_dns_answers_stats |
Gest DNS Answers Statistics |
check_efficientip_dns_answers_stats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Efficientip_cpu_usage |
Checks the average CPU usage |
check_efficientip_cpu_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTCPU_USAGE_PCT_WARNING_THRESHOLD _HOSTCPU_USAGE_PCT_CRITICAL_THRESHOLD |
Efficientip_dnssec_stats |
Gest DNSSEC Statistics |
check_efficientip_dns_sec_stats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Efficientip_cpu_load |
Checks the average CPU load |
check_efficientip_cpu_load |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTCPU_LOAD_WARNING_THRESHOLD _HOSTCPU_LOAD_CRITICAL_THRESHOLD |
Efficientip_mem_usage |
Checks the Memory usage |
check_efficientip_mem |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTMEM_WARNING_THRESHOLD _HOSTMEM_CRITICAL_THRESHOLD |
Efficientip_dns_res_queries_stats |
Gest DNS Resolution Queries Statistics |
check_efficientip_dns_res_queries_stats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Efficientip_dnsstats |
Gest DNS Statistics |
check_efficientip_dnsstats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Efficientip_process_$KEY$ |
Checks the state of a given process |
check_efficientip_process |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _PROCESSES |
Efficientip_dns_transfer_req_stats |
Gest DNS Transfer Requests Statistics |
check_efficientip_dns_transfer_req_stats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Efficientip_dhscpstats |
Gest DHCP Statistics |
check_efficientip_dhcpstats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTDHCP_WARNING_DISCOVERS _HOSTDHCP_CRITICAL_DISCOVERS _HOSTDHCP_WARNING_REQUESTS _HOST_DHCPCRITICAL_REQUESTS _HOSTDHCP_WARNING_RELEASES _HOSTDHCP_CRITICAL_RELEASES _HOSTDHCP_WARNING_OFFERS _HOSTDHCP_CRITICAL_OFFERS _HOSTDHCP_WARNING_ACKS _HOSTDHCP_CRITICAL_ACKS _HOSTDHCP_WARNING_NACKS _HOSTDHCP_CRITICAL_NACKS _HOSTDHCP_WARNING_DECLINES _HOSTDHCP_CRITICAL_DECLINES _HOSTDHCP_WARNING_INFORMS _HOSTDHCP_CRITICAL_INFORMS |
Efficientip_disks_usage_$KEY$ |
Checks the Disks usage |
check_efficientip_disks_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTDISK_WARNING_THRESHOLD _HOSTDISK_CRITICAL_THRESHOLD _PARTITIONS |
Efficientip_swap |
Checks the Swap usage |
check_efficientip_swap |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTSWAP_WARNING_THRESHOLD _HOSTSWAP_CRITICAL_THRESHOLD |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
_PARTITIONS:
wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$
_PROCESSES:
wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c and 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
_CPU_LOAD_WARNING_THRESHOLD |
CPU Load warning threshold |
integer |
_CPU_LOAD_CRITICAL_THRESHOLD |
CPU Load critical threshold |
integer |
_CPU_USAGE_PCT_WARNING_THRESHOLD |
CPU usage percent warning threshold |
percent |
_CPU_USAGE_PCT_CRITICAL_THRESHOLD |
CPU usage percent critical threshold |
percent |
_MEM_WARNING_THRESHOLD |
Memory warning threshold |
percent |
_MEM_CRITICAL_THRESHOLD |
Memory critical threshold |
percent |
_SWAP_WARNING_THRESHOLD |
Swap memory warning threshold |
percent |
_SWAP_CRITICAL_THRESHOLD |
Swap memory critical threshold |
percent |
_DISK_WARNING_THRESHOLD |
Disk storage warning threshold |
percent |
_DISK_CRITICAL_THRESHOLD |
Disk storage critical threshold |
percent |
_DHCP_WARNING_DISCOVERS |
DHCP Discovers warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_DISCOVERS |
DHCP Discovers critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_REQUESTS |
DHCP Requests warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_REQUESTS |
DHCP Requests critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_RELEASES |
DHCP Releases warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_RELEASES |
DHCP Releases critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_OFFERS |
DHCP Offers warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_OFFERS |
DHCP Offers critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_ACKS |
DHCP Acks warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_ACKS |
DHCP Acks critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_NACKS |
DHCP NAcks warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_NACKS |
DHCP NAcks critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_DECLINES |
DHCP Declines warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_DECLINES |
DHCP Declines critical threshold (Requests/s). Optional |
string |
_DHCP_WARNING_INFORMS |
DHCP Informs warning threshold (Requests/s). Optional |
string |
_DHCP_CRITICAL_INFORMS |
DHCP Informs critical threshold (Requests/s). Optional |
string |
COMPLEX MACROS
_PARTITIONS
Description: Disk partitions
Discover: wocu-discover-os-resources-partitions.py
Fields |
Description |
Type |
---|---|---|
index |
Partition index |
integer |
label |
Partition label |
string |
unit |
Letter unit or path |
string |
_PROCESSES
Description: Processes
Discover: wocu-discover-os-resources-processes.py
Fields |
Description |
Type |
---|---|---|
ProcName |
Process label |
string |
ProcParameters |
Process parameters |
string |
Extreme-networks-hw-health
DESCRIPTION
Custom checks for Extreme Networks devices. tested on VOSS
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
extreme_networks_hw_health_temp |
Checks Temperature from HW sensors |
check_extreme_networks_hw_health_temp |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTTEMP_WARNING _HOSTTEMP_CRITICAL _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
extreme_networks_hw_health_fan |
Checks Fan status and speed |
check_extreme_networks_hw_health_fan |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTFAN_SPEED_WARNING _HOSTFAN_SPEED_CRITICAL _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
extreme_networks_hw_health_powersupply |
Checks status from all Power Supplies |
check_extreme_networks_hw_health_powersupply |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The snmp community read configured on remote device |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
_FAN_SPEED_WARNING |
Fan speed warning threshold in RPM |
integer |
_FAN_SPEED_CRITICAL |
Fan speed critical threshold in RPM |
integer |
_TEMP_WARNING |
Temperature warning threshold in Celsius |
integer |
_TEMP_CRITICAL |
Temperature critical threshold in Celsius |
integer |
F5-bigip
DESCRIPTION
Custom checks for F5 BIG-IP devices.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
F5 PowerSupply |
Checks PowerSupply(s) status |
check_f5_health_powersupply |
_HOSTSNMPCOMMUNITY |
F5 Temp |
Checks hardware temperature(s) |
check_f5_health_temp |
_HOSTSNMPCOMMUNITY _HOSTTEMP_WARNING _HOSTTEMP_CRITICAL |
F5 Fan |
Checks Fan(s) status |
check_f5_health_fan |
_HOSTSNMPCOMMUNITY _HOSTRPM_WARNING _HOSTRPM_CRITICAL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The snmp community read configured on remote device |
string |
_RPM_WARNING |
Fan RPM warning threshold |
integer |
_RPM_CRITICAL |
Fan RPM critical threshold |
integer |
_TEMP_WARNING |
Temperature warning threshold (in Celsius) |
integer |
_TEMP_CRITICAL |
Temperature critical threshold (in Celsius) |
integer |
F5-tls-certificates
DESCRIPTION
Check TLS certificates from F5 BIG-IP devices.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
f5_tls_certificates_expiration |
Checks the TLS certificates expiration date |
check_f5_tls_certificates_expiration |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTEXPIRATION_WARNING _HOSTEXPIRATION_CRITICAL _HOSTEXCLUDE_REGEX |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The snmp community read configured on remote device |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
_EXPIRATION_WARNING |
Days to certificates expiration warning threshold. Leave it blank to not alert with WARNING state. Default: 30 days |
integer |
_EXPIRATION_CRITICAL |
Days to certificates expiration critical threshold. Leave it blank to not alert with CRITICAL state. Default: blank |
integer |
_EXCLUDE_REGEX |
Regular expression to exclude certificates by name. Ex: Azure|Verisign|SSL_Cert_Custom |
string |
Fortigate-health
DESCRIPTION
Hardware checks for Fortigate (Fans, Temperature and PowerSupply) via snmp. Small models are not supported
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
https_proxy_$KEY$ |
Checks the https web site status through a proxy |
wocu_check_https_proxy |
_HOSTHTTP_PROXY _HOSTHTTP_PROXY_AUTH _HOSTHTTP_TIMEOUT _HTTPS_LIST |
http_proxy_$KEY$ |
Checks the http web site status through a proxy |
wocu_check_http_proxy |
_HOSTHTTP_PROXY _HOSTHTTP_PROXY_AUTH _HOSTHTTP_TIMEOUT _HTTP_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_HTTP_PROXY |
IP:Port to check. |
string |
_HTTP_PROXY_AUTH |
Proxy authentication (user:pass) |
string |
_HTTP_TIMEOUT |
Amount of time to wait for a connection in seconds (default: 30) |
integer |
COMPLEX MACROS
_HTTP_LIST
Description: HTTP sites (list)
Fields |
Description |
Type |
---|---|---|
Display Name |
Custom Name appearing in the service: HTTP_<Display Name> |
string |
Host |
Host to check (IP or name) |
string |
Port |
Port to check (default: 80) |
integer |
Url |
url path with leading / (default: /) |
string |
_HTTPS_LIST
Description: HTTPS sites (list)
Fields |
Description |
Type |
---|---|---|
Display Name |
Custom Name appearing in the service: HTTPS_<Display Name> |
string |
Host |
Host to check (IP or name) |
string |
Url |
url path with leading / (default: /) |
string |
Port |
Port to check (default: 443) |
integer |
Verify_Cert |
Verify SSL Certificate? (default: True) |
string |
Unauthorized_code_bypass |
Return OK whith 401 Unauthorized code? (default: False) |
string |
Huawei-wifi-controller
DESCRIPTION
Obtain metrics from Huawei wifi controllers. S300, S500, S1700, S2700, S5700, and S6700 Series
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
huawei-wifi-controller-ap-state |
Checks the state of all registered APs |
check_huawei_wifi_controller_ap_state |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTAP_NOT_NORMAL_WARNING _HOSTAP_NOT_NORMAL_CRITICAL |
huawei-wifi-controller-high-dl-retrans-users |
Checks the users with downlink retransmission percentage >50% |
check_huawei_wifi_controller_users_dl_retrans_percent |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTHIGH_RETRANSMISSION_USERS_WARNING _HOSTHIGH_RETRANSMISSION_USERS_CRITICAL |
huawei-wifi-controller-cpu |
Checks the CPU usage |
check_huawei_wifi_controller_cpu |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTCPU_WARNING _HOSTCPU_CRITICAL |
huawei-wifi-controller-radio-noise-dist |
Shows Radio distribution based on noise strength |
check_huawei_wifi_controller_radio_noise_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-users_by_ap |
Shows the connected users by Access Point |
check_huawei_wifi_controller_users_by_ap |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-radio-channel-util-dist |
Shows Radio distribution based on channel utilization |
check_huawei_wifi_controller_channel_utilization_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-low-dl-neg-users |
Checks the users with downlink negotation rate <12Mbps |
check_huawei_wifi_controller_users_dl_rate |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTLOW_DOWNLINK_NEG_USERS_WARNING _HOSTLOW_DOWNLINK_NEG_USERS_CRITICAL |
huawei-wifi-controller-high-dl-pkt_loss-users |
Checks the users with downlink packet loss percentage >5% |
check_huawei_wifi_controller_users_dl_packet_loss_percent |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTHIGH_DOWNLINK_PACKET_LOSS_USERS_WARNING _HOSTHIGH_DOWNLINK_PACKET_LOSS_USERS_CRITICAL |
huawei-wifi-controller-ap-sta-logout-dist |
Shows AP distribution based on station logout |
check_huawei_wifi_controller_ap_logout_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-users_by_ssid |
Shows the connected users by SSID |
check_huawei_wifi_controller_users_by_ssid |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-dl-retrans-by-ssid |
Shows the rdownlonk retransmissions by SSID |
check_huawei_wifi_controller_dl_retrans_by_ssid |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-mem |
Checks the Memory usage |
check_huawei_wifi_controller_mem |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTMEM_WARNING _HOSTMEM_CRITICAL |
huawei-wifi-controller-high-channel-util-radio |
Checks the radios with channel utilization >70% |
check_huawei_wifi_controller_channel_utilization_percent |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTHIGH_CHANNEL_UTILIZATION_WARNING _HOSTHIGH_CHANNEL_UTILIZATION_CRITICAL |
huawei-wifi-controller-ap-by-ssid |
Shows the registered APs by SSID |
check_huawei_wifi_controller_ap_by_ssid |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-total-users |
Checks the total number of connected users |
check_huawei_wifi_controller_total_users |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-ap-load-dist |
Shows AP distribution based on load |
check_huawei_wifi_controller_ap_load_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-radio-interference-dist |
Shows Radio distribution based on interference percentage |
check_huawei_wifi_controller_radio_interf_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-users_by_band |
Shows the connected users by band (2.4Ghz and 5Ghz) |
check_huawei_wifi_controller_users_by_band |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-high-noise-radio |
Checks the radios with noise strength >-80dBm |
check_huawei_wifi_controller_radio_noise_strength |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTLOW_NOISE_STRENGTH_RADIO_WARNING _HOSTLOW_NOISE_STRENGTH_RADIO_CRITICAL |
huawei-wifi-controller-high-interf-radio |
Checks the radios with interference >40% |
check_huawei_wifi_controller_channel_interference |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTHIGH_CHANNEL_INTERFERENCE_WARNING _HOSTHIGH_CHANNEL_INTERFERENCE_CRITICAL |
huawei-wifi-controller-high-load-radio |
Checks the radios with load >40 |
check_huawei_wifi_controller_channel_load |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTHIGH_CHANNEL_LOAD_WARNING _HOSTHIGH_CHANNEL_LOAD_CRITICAL |
huawei-wifi-controller-low-snr-users |
Shows the users with low SNR (signal-noise ratio) |
check_huawei_wifi_controller_users_snr |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTLOW_SNR_USERS_WARNING _HOSTLOW_SNR_USERS_CRITICAL |
huawei-wifi-controller-radio-dl-pkt-loss-dist |
Shows Radio distribution based on downlink packet loss rate |
check_huawei_wifi_controller_radio_dl_packet_loss_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
huawei-wifi-controller-ap-sta-access-fail-dist |
Shows AP distribution based on station access failures |
check_huawei_wifi_controller_ap_access_fail_dist |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
_CPU_WARNING |
CPU warning threshold (percentage) |
percent |
_CPU_CRITICAL |
CPU critical threshold (percentage) |
percent |
_MEM_WARNING |
Memory usage warning threshold |
percent |
_MEM_CRITICAL |
Memory usage critical threshold |
percent |
_LOW_SNR_USERS_WARNING |
Number of users with SNR < 20dB warning threshold |
integer |
_LOW_SNR_USERS_CRITICAL |
Number of users with SNR < 20dB critical threshold |
integer |
_LOW_DOWNLINK_NEG_USERS_WARNING |
Number of users with downlink negotiation rate <12Mbps warning threshold |
integer |
_LOW_DOWNLINK_NEG_USERS_CRITICAL |
Number of users with downlink negotiation rate <12Mbps critical threshold |
integer |
_HIGH_RETRANSMISSION_USERS_WARNING |
Number of users with retransmission rate >50% warning threshold |
integer |
_HIGH_RETRANSMISSION_USERS_CRITICAL |
Number of users with retransmission rate >50% critical threshold |
integer |
_HIGH_DOWNLINK_PACKET_LOSS_USERS_WARNING |
Number of users with downlink packet loss rate >5% warning threshold |
integer |
_HIGH_DOWNLINK_PACKET_LOSS_USERS_CRITICAL |
Number of users with downlink packet loss rate >5% critical threshold |
integer |
_LOW_NOISE_STRENGTH_RADIO_WARNING |
Number of radio with noise strength >-80dBm warning threshold |
integer |
_LOW_NOISE_STRENGTH_RADIO_CRITICAL |
Number of radio with noise strength >-80dBm critical threshold |
integer |
_HIGH_CHANNEL_UTILIZATION_WARNING |
Number of radio channels with utilization >70% warning threshold |
percent |
_HIGH_CHANNEL_UTILIZATION_CRITICAL |
Number of radio channels with utilization >70% critical threshold |
percent |
_HIGH_CHANNEL_LOAD_WARNING |
Number of radio channels with load >40% warning threshold |
percent |
_HIGH_CHANNEL_LOAD_CRITICAL |
Number of radio channels with load >40% critical threshold |
percent |
_HIGH_CHANNEL_INTERFERENCE_WARNING |
Number of radio channels with interference >40% warning threshold |
percent |
_HIGH_CHANNEL_INTERFERENCE_CRITICAL |
Number of radio channels with interference >40% critical threshold |
percent |
_AP_NOT_NORMAL_WARNING |
Number of APs in not-normal state warning threshold |
integer |
_AP_NOT_NORMAL_CRITICAL |
Number of APs in not-normal state critical threshold |
integer |
Infinera-edu
DESCRIPTION
Checks for Infinera EDU devices using SNMP
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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)
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
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
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)
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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
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
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
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
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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
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
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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
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
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
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
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
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
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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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.)
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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this 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
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
Checks for NAS Synology devices.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
CPU Fan Status |
Checks the status of CPU fan |
check_synology_cpu_fan_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
System Fan Status |
Checks the status from system fan |
check_synology_system_fan_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Storage Usage |
Checks the storage usage |
check_synology_storage_usage |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTSTORAGE_USAGE_WARNING _HOSTSTORAGE_USAGE_CRITICAL |
Raid Status |
Checks the raid status |
check_synology_raid_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Upgrade Available |
Checks if there is an available upgrade |
check_synology_upgrade_available |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
nas-synology_Load Average |
Checks the system load average |
check_synology_load |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTLOAD_WARNING _HOSTLOAD_CRITICAL |
System Temperature |
Checks the temperature from system |
check_synology_system_temperature |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTSYSTEM_TEMPERATURE_WARNING _HOSTSYSTEM_TEMPERATURE_CRITICAL |
System Status |
Checks the system status |
check_synology_system_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Memory Usage |
Checks the memory usage |
check_synology_mem_usage |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTMEM_USAGE_WARNING _HOSTMEM_USAGE_CRITICAL |
CPU Usage |
Checks the CPU usage |
check_synology_cpu_usage |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTCPU_USAGE_WARNING _HOSTCPU_USAGE_CRITICAL |
Disks Temperatures |
Checks the temperature from disks |
check_synology_disks_temperatures |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTDISK_TEMPERATURE_WARNING _HOSTDISK_TEMPERATURE_CRITICAL |
PowerSupplies Status |
Checks the status from power supplies |
check_synology_power_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Disks Status |
Checks the disks status |
check_synology_disks_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Nas-synology_Info |
Shows system information |
check_synology_info |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP Community |
string |
_SNMPVERSION |
SNMP version |
string |
_SYSTEM_TEMPERATURE_WARNING |
Warning threshold for system temperature (in Celsius degrees) |
integer |
_SYSTEM_TEMPERATURE_CRITICAL |
Critical threshold for system temperature (in Celsius degrees) |
integer |
_STORAGE_USAGE_WARNING |
Global Warning threshold for storage usage |
percent |
_STORAGE_USAGE_CRITICAL |
Global Critical threshold for storage usage |
percent |
_DISK_TEMPERATURE_WARNING |
Warning threshold for all disks temperatures (in Celsius degrees) |
integer |
_DISK_TEMPERATURE_CRITICAL |
Critical threshold for all disks temperatures (in Celsius degrees) |
integer |
_CPU_USAGE_WARNING |
Warning threshold for CPU usage (percentage) |
percent |
_CPU_USAGE_CRITICAL |
Critical threshold for CPU usage (percentage) |
percent |
_MEM_USAGE_WARNING |
Warning threshold for Memory usage as (percentage) |
percent |
_MEM_USAGE_CRITICAL |
Critical threshold for Memory usage as (percentage) |
percent |
_LOAD_WARNING |
Warning threshold for load average in last 15 minutes |
integer |
_LOAD_CRITICAL |
Critical threshold for load average in last 15 minutes |
integer |
Purestorage
DESCRIPTION
PureStorage specific health and performance checks
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
PureStorage - Occupancy - Volume $KEY$ |
Checks PureStorage FlashArray Volume occupancy |
check_purestorage_occupancy_volume |
_HOSTAPI_TOKEN _PURESTORAGE_VOLUME_LIST |
PureStorage - Load - FA |
Checks PureStorage FlashArray load average percent |
check_purestorage_load_fa |
_HOSTAPI_TOKEN _HOSTPRIV_KEYPASS _HOSTPURE1_API_KEY _HOSTLOAD_WARN _HOSTLOAD_CRIT |
PureStorage - Occupancy - FA |
Checks PureStorage FlashArray occupancy |
check_purestorage_occupancy_fa |
_HOSTAPI_TOKEN |
PureStorage - Performance - FA |
Checks PureStorage FlashArray performance |
check_purestorage_perf_fa |
_HOSTAPI_TOKEN _HOSTWLAT_CRIT _HOSTWLAT_WARN _HOSTRLAT_CRIT _HOSTRLAT_WARN _HOSTWBW_CRIT _HOSTWBW_WARN _HOSTRBW_CRIT _HOSTRBW_WARN _HOSTWIOPS_CRIT _HOSTWIOPS_WARN _HOSTRIOPS_CRIT _HOSTRIOPS_WARN |
PureStorage - Open Alerts |
Checks Open Alerts in PureStorage FlashArray |
check_purestorage_alerts |
_HOSTAPI_TOKEN |
PureStorage - Performance - Volume $KEY$ |
Checks PureStorage FlashArray Volume performance |
check_purestorage_perf_volume |
_HOSTAPI_TOKEN _HOSTWLAT_CRIT _HOSTWLAT_WARN _HOSTRLAT_CRIT _HOSTRLAT_WARN _HOSTWBW_CRIT _HOSTWBW_WARN _HOSTRBW_CRIT _HOSTRBW_WARN _HOSTWIOPS_CRIT _HOSTWIOPS_WARN _HOSTRIOPS_CRIT _HOSTRIOPS_WARN _PURESTORAGE_VOLUME_LIST |
PureStorage - Info |
Checks PureStorage FlashArray model and Purity version info |
check_purestorage_info |
_HOSTAPI_TOKEN |
PureStorage - Status - $KEY$ |
Checks status of PureStorage FlashArray HW components |
check_purestorage_hw_status |
_HOSTAPI_TOKEN _HOSTVOLTAGE_WARN _HOSTVOLTAGE_CRIT _PURESTORAGE_HW_LIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_PURESTORAGE_VOLUME_LIST:
wocu-discover-purestorage-volumes.py -H $HOSTADDRESS$ -at $_API_TOKEN$ –remote $_POLLER_TAG_ADDRESS$
_PURESTORAGE_HW_LIST:
wocu-discover-purestorage-hw.py -H $HOSTADDRESS$ -at $_API_TOKEN$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_API_TOKEN |
Autentication token for the API REST call session |
string |
_PRIV_KEYPASS |
Private key passphrase installed in Pure1 |
string |
_PURE1_API_KEY |
API key installed in Pure1. Must start with: pure1:apikey: |
string |
_WLAT_CRIT |
Write Latency critical threshold (in milliseconds) |
integer |
_WLAT_WARN |
Write Latency warning threshold (in milliseconds) |
integer |
_RLAT_CRIT |
Read Latency critical threshold (in milliseconds) |
integer |
_RLAT_WARN |
Read Latency warning threshold (in milliseconds) |
integer |
_WBW_CRIT |
Write bandwidth critical threshold (in Bps) |
integer |
_WBW_WARN |
Write bandwidth warning threshold (in Bps) |
integer |
_RBW_CRIT |
Read bandwidth critical threshold (in Bps) |
integer |
_RBW_WARN |
Read bandwidth warning threshold (in Bps) |
integer |
_WIOPS_CRIT |
Write IOPS critical threshold (in IOPS/s) |
integer |
_WIOPS_WARN |
Write IOPS warning threshold (in IOPS/s) |
integer |
_RIOPS_CRIT |
Read IOPS critical threshold (in IOPS/s) |
integer |
_RIOPS_WARN |
Read IOPS warning threshold (in IOPS/s) |
integer |
_LOAD_CRIT |
Array 5 minute avg load percent critical threshold |
percent |
_LOAD_WARN |
Array 5 minute avg load percent warning threshold |
percent |
_VOLTAGE_WARN |
Power supply voltage warning threshold |
integer |
_VOLTAGE_CRIT |
Power supply voltage critical threshold |
integer |
COMPLEX MACROS
_PURESTORAGE_VOLUME_LIST
Description: List of Volumes to be checked
Discover: wocu-discover-purestorage-volumes.py
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface |
string |
name |
Volume name |
string |
_PURESTORAGE_HW_LIST
Description: List of Hardware components to be checked
Discover: wocu-discover-purestorage-hw.py
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface |
string |
name |
Hardware component name |
string |
Qnap
DESCRIPTION
Checks for the QNAP NAS devices
Checks for the QNAP NAS devices
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Qnap_fans |
Checks the fans speed |
check_qnap_fans |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTFAN_SPEED_WARNING _HOSTFAN_SPEED_CRITICAL |
Qnap_MEM |
Checks the memory usage |
check_qnap_mem |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTMEM_WARNING _HOSTMEM_CRITICAL |
Qnap_Temp |
Checks the system temperature |
check_qnap_temp |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTTEMP_WARNING _HOSTTEMP_CRITICAL |
Qnap_raid_status |
Checks the status from raid |
check_qnap_raidstatus |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_info |
Shows system information |
check_qnap_info |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_hdtemp |
Checks the hard disk temperature |
check_qnap_hdtemp |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTHDTEMP_WARNING _HOSTHDTEMP_CRITICAL |
Qnap_CPU |
Checks the CPU usage |
check_qnap_cpu |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTCPU_WARNING _HOSTCPU_CRITICAL |
Qnap_power_supply |
Checks the power supply status |
check_qnap_powersupply |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_lunstatus |
Checks the LUN (Logical Unit Number) status |
check_qnap_lunstatus |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_volstatus |
Checks the status from volumes |
check_qnap_volstatus |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_cache_disk_status |
Checks the status from cache disk |
check_qnap_cachediskstatus |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Qnap_volusage |
Checks the volumes usage |
check_qnap_volusage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTVOL_USAGE_WARNING _HOSTVOL_USAGE_CRITICAL |
Qnap_hdstatus |
Checks the hard drive status |
check_qnap_hdstatus |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1 and 2c |
string |
_CPU_WARNING |
CPU usage warning threshold |
percent |
_CPU_CRITICAL |
CPU usage critical threshold |
percent |
_MEM_WARNING |
Memory usage warning threshold |
percent |
_MEM_CRITICAL |
Memory usage critical threshold |
percent |
_TEMP_WARNING |
System temperature warning threshold (in Celsius) |
integer |
_TEMP_CRITICAL |
System temperature critical threshold (in Celsius) |
integer |
_HDTEMP_WARNING |
HD temperature warning threshold (in Celsius) |
integer |
_HDTEMP_CRITICAL |
HD temperature critical threshold (in Celsius) |
integer |
_VOL_USAGE_WARNING |
Volume usage warning threshold |
percent |
_VOL_USAGE_CRITICAL |
Volume usage critical threshold |
percent |
_FAN_SPEED_WARNING |
Fan speed warning threshold (rpm) |
integer |
_FAN_SPEED_CRITICAL |
Fan speed critical threshold (rpm) |
integer |
Operating System
Linux-nrpe
DESCRIPTION
Linux host monitoring via NRPE (Nagios remote plugin execution)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Zombie procs |
Checks the number of Zombie processes |
check_nrpe_zombie_procs |
_HOSTZOMBIEPROCS_WARN _HOSTZOMBIEPROCS_CRIT |
Total procs |
Checks the total number of processes |
check_nrpe_total_procs |
_HOSTTOTALPROCS_WARN _HOSTTOTALPROCS_CRIT |
Partition $KEY$ |
Checks the disk usage |
check_nrpe_disk |
_HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT _PARTITIONS |
Linux-nrpe_Load |
Checks the CPU load |
check_nrpe_load |
_HOSTLOAD_WARN _HOSTLOAD_CRIT |
Linux-nrpe_Swap |
Checks the SWAP usage |
check_nrpe_swap |
_HOSTSWAP_WARN _HOSTSWAP_CRIT |
Linux-nrpe_Users |
Checks the number of users |
check_nrpe_users |
_HOSTUSERS_WARN _HOSTUSERS_CRIT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_LOAD_WARN |
CPU load warning threshold |
string |
_LOAD_CRIT |
CPU load critical threshold |
string |
_STORAGE_WARN |
Storage warning threshold |
string |
_STORAGE_CRIT |
Storage critical threshold |
string |
_PARTITIONS |
Filesystem partions to monitor, for example /,/var |
string |
_USERS_WARN |
Current users logged warning threshold |
integer |
_USERS_CRIT |
Current users logged critical threshold |
integer |
_ZOMBIEPROCS_WARN |
Zombie processes warning threshold |
integer |
_ZOMBIEPROCS_CRIT |
Zombie processes critical threshold |
integer |
_TOTALPROCS_WARN |
Total processes warning threshold |
integer |
_TOTALPROCS_CRIT |
Total processes critical threshold |
integer |
_SWAP_WARN |
Swap usage warning threshold |
string |
_SWAP_CRIT |
Swap usage critical threshold |
string |
Linux-snmp
DESCRIPTION
Standard linux checks, like CPU, RAM and disk space. Checks are done by SNMP.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Disks |
Overall disks usage |
check_linux_disks |
_HOSTSNMPCOMMUNITY _HOSTSTORAGE_PATH _HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT _HOSTSNMP_MSG_MAX_SIZE _HOSTSNMPVERSION |
Linux-snmp_Memory |
Check about physical memory space usage. |
check_linux_memory |
_HOSTMEMORY_WARN _HOSTMEMORY_CRIT _HOSTSNMPCOMMUNITY |
Linux SNMP - SysDescr |
Shows system description |
check_linux_snmp_sysdescr |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
Linux SNMP - Swap |
Check about swap space usage. Too many use of swap space means lacks of memory or memory leaks. |
check_linux_snmp_swap |
_HOSTMEMORY_WARN _HOSTMEMORY_CRIT _HOSTSNMPVERSION _HOSTSNMPCOMMUNITY |
Load |
Detect abnormal CPU usage |
check_linux_load |
_HOSTSNMPCOMMUNITY _HOSTLOAD_WARN _HOSTLOAD_CRIT _HOSTSNMPVERSION _HOSTLOAD_THRESHOLD_TYPE |
Cpu |
Detect abnormal CPU usage |
check_linux_cpu |
_HOSTSNMPCOMMUNITY _HOSTCPU_WARN _HOSTCPU_CRIT _HOSTSNMPVERSION |
Linux SNMP - Uptime |
Check about system uptime |
check_linux_snmp_uptime |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTUPTIME_WARN _HOSTUPTIME_CRIT |
TimeSync |
Compare system time with time where shinken operate. Both must be synchronized with a ntp source. |
check_linux_time |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTNTP_WARN _HOSTNTP_CRIT |
Linux SNMP - TCP Connections |
Check TCP connections table |
check_linux_snmp_tcpconn |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTTCP_CONN_WARN _HOSTTCP_CONN_CRIT |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The read snmp community allowed on the linux server |
string |
_SNMP_MSG_MAX_SIZE |
Maximum size of the snmp messages (in bytes) |
integer |
_LOAD_WARN |
Value for starting warning state for the load average at 1m,5m,15m |
3 comma-separated integer |
_LOAD_CRIT |
Value for starting critical state for the load average at 1m,5m,15m |
3 comma-separated integer |
_LOAD_THRESHOLD_TYPE |
Load average threshold type: Choose from absolute number or relative percentage of use. Relative use is based on CPUs number. Formula: % = (load / CPUs number) * 100. Ex: An absolute load of 3 in a system with 3 cores, has a realtive load of 100% |
string |
_STORAGE_WARN |
Warning level threshold for used disk space (percentage) |
percent |
_STORAGE_CRIT |
Critical level threshold for used disk space (percentage) |
percent |
_CPU_WARN |
Warning level for the CPU usage (percentage) |
percent |
_CPU_CRIT |
Critical level for the CPU usage (percentage) |
percent |
_MEMORY_WARN |
Physical memory and swap warning level (percentage) |
percent |
_MEMORY_CRIT |
Physical memory and swap critical level (percentage) |
percent |
_NTP_WARN |
NTP timings warning level (in seconds) |
integer |
_NTP_CRIT |
NTP timings critical level (in seconds) |
integer |
_SNMPVERSION |
Device SNMP versions supported are: 1 and 2c |
string |
_STORAGE_PATH |
Absolute path to check its storage |
absolute path |
_UPTIME_WARN |
System uptime warning threshold (in seconds) |
integer |
_UPTIME_CRIT |
System uptime critical threshold (in seconds) |
integer |
_TCP_CONN_WARN |
TCP connections warning threshold (total number) |
integer |
_TCP_CONN_CRIT |
TCP connections critical threshold (total number) |
integer |
Linux-snmp3
DESCRIPTION
Standard linux checks, like CPU, RAM and disk space. Checks are done by SNMP3.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
LinuxSnmp-TimeSync |
Compare system time with time where shinken operate. Both must be synchronized with a ntp source. |
check_linux_time_v3 |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTNTP_WARN _HOSTNTP_CRIT |
Linux-snmp3-Disks |
Overall disks usage |
check_linux_disks_v3 |
_HOSTSNMPSECURITYNAME _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSTORAGE_PATH _HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT _HOSTSNMP_MSG_MAX_SIZE _HOSTSNMPCONTEXT _HOSTSNMPSECURITYLEVEL |
Linux SNMP3 - TCP Connections |
Check TCP connections table |
check_linux_snmp_tcpconn_v3 |
_HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTSNMPVERSION _HOSTTCP_CONN_WARN _HOSTTCP_CONN_CRIT |
Linux SNMP3 - SysDescr |
Shows system description |
check_linux_snmp_sysdescr_v3 |
_HOSTSNMPVERSION _HOSTSNMPCONTEXT _HOSTSNMPSECURITYLEVEL _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY |
Linux SNMP3 - Uptime |
Check about system uptime |
check_linux_snmp_uptime_v3 |
_HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTSNMPVERSION _HOSTUPTIME_WARN _HOSTUPTIME_CRIT |
Linux-snmp3-Cpu |
Detect abnormal CPU usage |
check_linux_cpu_v3 |
_HOSTSNMPSECURITYNAME _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTCPU_WARN _HOSTCPU_CRIT _HOSTSNMPCONTEXT _HOSTSNMPSECURITYLEVEL |
Linux SNMP3 - Swap |
Check about swap space usage. Too many use of swap space means lacks of memory or memory leaks. |
check_linux_snmp_swap_v3 |
_HOSTMEMORY_WARN _HOSTMEMORY_CRIT _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Linux-snmp3_Load |
Detect abnormal CPU usage |
check_linux_load_v3 |
_HOSTSNMPSECURITYNAME _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTLOAD_WARN _HOSTLOAD_CRIT _HOSTSNMPCONTEXT _HOSTSNMPSECURITYLEVEL |
Linux-snmp3_Memory |
Check about physical memory space usage. |
check_linux_memory_v3 |
_HOSTMEMORY_WARN _HOSTMEMORY_CRIT _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
_SNMP_MSG_MAX_SIZE |
Maximum size of the snmp messages (in bytes) |
integer |
_LOAD_WARN |
Value for starting warning state for the load average at 1m,5m,15m |
3 comma-separated integer |
_LOAD_CRIT |
Value for starting critical state for the load average at 1m,5m,15m |
3 comma-separated integer |
_STORAGE_WARN |
Warning level threshold for used disk space (percentage) |
percent |
_STORAGE_CRIT |
Critical level threshold for used disk space (percentage) |
percent |
_CPU_WARN |
Warning level for the CPU usage (percentage) |
percent |
_CPU_CRIT |
Critical level for the CPU usage (percentage) |
percent |
_MEMORY_WARN |
Physical memory and swap warning level (percentage) |
percent |
_MEMORY_CRIT |
Physical memory and swap critical level (percentage) |
percent |
_NTP_WARN |
NTP timings warning level (in seconds) |
integer |
_NTP_CRIT |
NTP timings critical level (in seconds) |
integer |
_SNMPVERSION |
Device SNMP versions supported are: 3 |
string |
_CHKLOG_CONF |
absolute path to checklog conf file. Default: /usr/local/shinken/libexec/logFiles_linux.conf |
absolute path |
_STORAGE_PATH |
Absolute path to check its storage |
absolute path |
_UPTIME_WARN |
System uptime warning threshold (in seconds) |
integer |
_UPTIME_CRIT |
System uptime critical threshold (in seconds) |
integer |
_TCP_CONN_WARN |
TCP connections warning threshold (total number) |
integer |
_TCP_CONN_CRIT |
TCP connections critical threshold (total number) |
integer |
Linux-ssh
DESCRIPTION
Standard linux checks, like CPU, RAM and disk space. Checks are done by SSH.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Linux-ssh_Memory |
Checks the memory usage |
check_ssh_linux_memory |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTMEMORY_WARN _HOSTMEMORY_CRIT |
Load Average |
Checks the system load average |
check_ssh_linux_load_average |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTLOAD_WARN _HOSTLOAD_CRIT |
CPU Stats |
Checks the CPU load statistics |
check_ssh_linux_cpu_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-Disks |
Checks the disk usage |
check_ssh_linux_disks |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTSTORAGE_UNIT _HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT _HOSTSTORAGE_MOUNTS |
Kernel Stats |
Checks the Kernel statistics |
check_ssh_linux_kernel_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Read-only Filesystems |
Checks if there are Read-only filesystems |
check_ssh_ro_filesystem |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Disks Stats |
Checks the disk statistics |
check_ssh_linux_disks_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
SSH Connexion |
Checks the SSH connexion |
check_ssh_connexion |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
TCP States |
Checks the states from TCP connection table |
check_ssh_linux_tcp_states |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
NFS Stats |
Checks the NFS (Network File System) statistics |
check_ssh_linux_nfs_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Reboot |
Checks the system uptime |
check_ssh_linux_uptime |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
NET Stats |
Checks the network statistics |
check_ssh_linux_net_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SSH_USER |
Remote user for the SSH service (key interchange with local wocu user must be done) |
string |
_SSH_PORT |
Remote port for the SSH service |
integer |
_SSH_KEY |
SSH key file for local wocu user. EX: /var/opt/wocu/.ssh/id_rsa |
string |
_SSH_KEY_PASSPHRASE |
SSH key file passphrase for local wocu user (void by default) |
string |
_LOAD_WARN |
Value for starting warning state for the load average at 1m,5m,15m |
3 comma-separated integer |
_LOAD_CRIT |
Value for starting critical state for the load average at 1m,5m,15m |
3 comma-separated integer |
_STORAGE_WARN |
Warning level for used disk space (percentage) |
percent |
_STORAGE_CRIT |
Critical level for used disk space (percentage) |
percent |
_STORAGE_UNIT |
Unit of disk space : B, KB, MB, GB or TB |
string |
_STORAGE_MOUNTS |
List of mount points to monitor |
comma-separated absolute path |
_CPU_WARN |
Warning level for the CPU usage (percentage) |
percent |
_CPU_CRIT |
Critical level for the CPU usage (percentage) |
percent |
_MEMORY_WARN |
Physical memory warning threshold (percentage) |
percent |
_MEMORY_CRIT |
Physical memory critical threshold (percentage) |
percent |
Linux-ssh-aggregated
DESCRIPTION
Standard linux checks, like CPU, RAM and disk space. Checks are done by SSH.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Linux-ssh-aggregated_Memory |
Checks the memory usage |
check_ssh_linux_memory |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTMEMORY_WARN _HOSTMEMORY_CRIT |
Linux-ssh-aggregated_Load Average |
Checks the system load average |
check_ssh_linux_load_average |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTLOAD_WARN _HOSTLOAD_CRIT |
Linux-ssh-aggregasted-Disks |
Checks the disk usage |
check_ssh_linux_disks |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _HOSTSTORAGE_UNIT _HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT _HOSTSTORAGE_MOUNTS |
Linux-ssh-aggregated_Kernel Stats |
Checks the Kernel statistics |
check_ssh_linux_kernel_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_Read-only Filesystems |
Checks if there are Read-only filesystems |
check_ssh_ro_filesystem |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_Disks Stats |
Checks the disk statistics |
check_ssh_linux_disks_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_CPU Stats |
Checks the CPU load statistics. Returns only aggregated metrics |
check_ssh_linux_cpu_stats_aggregated |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
linux-ssh-aggregated_Connection |
Checks the SSH connexion |
check_ssh_connexion |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_TCP States |
Checks the states from TCP connection table |
check_ssh_linux_tcp_states |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_NFS Stats |
Checks the NFS (Network File System) statistics |
check_ssh_linux_nfs_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_Reboot |
Checks the system uptime |
check_ssh_linux_uptime |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Linux-ssh-aggregated_NET Stats |
Checks the network statistics |
check_ssh_linux_net_stats |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SSH_USER |
Remote user for the SSH service (key interchange with Shinken user must be done ) |
string |
_SSH_PORT |
Remote port for the SSH service |
integer |
_SSH_KEY |
SSH key (Shinken user) |
string |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Shinken user) |
string |
_LOAD_WARN |
Value for starting warning state for the load average at 1m,5m,15m |
3 comma-separated integer |
_LOAD_CRIT |
Value for starting critical state for the load average at 1m,5m,15m |
3 comma-separated integer |
_STORAGE_WARN |
Warning level for used disk space (percentage) |
percent |
_STORAGE_CRIT |
Critical level for used disk space (percentage) |
percent |
_STORAGE_UNIT |
Unit of disk space : B, KB, MB, GB or TB |
string |
_STORAGE_MOUNTS |
List of mount points to monitor |
comma-separated absolute path |
_CPU_WARN |
Warning level for the CPU usage (percentage) |
percent |
_CPU_CRIT |
Critical level for the CPU usage (percentage) |
percent |
_MEMORY_WARN |
Physical memory warning threshold (percentage) |
percent |
_MEMORY_CRIT |
Physical memory critical threshold (percentage) |
percent |
Nginx-node
DESCRIPTION
Custom checks for Nginx services
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
nginx-node-status |
Checks nginx status service detailed . |
check_nginx_node_status |
_HOSTNGINX_PORT _HOSTNGINX_PROTOCOL _HOSTNGINX_DOMAIN _HOSTNGINX_ACTIVE_CONN_WARNING _HOSTNGINX_ACTIVE_CONN_CRITICAL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_NGINX_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_NGINX_DOMAIN |
Used for Nginx checks if value is not default |
string |
_NGINX_ACTIVE_CONN_WARNING |
Active connections warning threshold |
integer |
_NGINX_ACTIVE_CONN_CRITICAL |
Active connections critical threshold |
integer |
_NGINX_PORT |
NGINX port (default 22). |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
Os_resources
DESCRIPTION
Monitoring Windows an Linux Servers, via snmp
Script to check the state of Windows an Linux servers, through snmp
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Memory buffer usage |
Checks the memory buffer usage |
os_mem_buffer |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTMEMORY_BUFFER_DEFAULT_WARNING _HOSTMEMORY_BUFFER_DEFAULT_CRITICAL _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Partition_$KEY$ |
Checks the partitions storage usage |
os_partition_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSTORAGE_WARNING_THRESHOLD _HOSTSTORAGE_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _PARTITIONS |
Virtual memory usage |
Checks the virtual memory usage |
os_vm_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTVM_WARNING_THRESHOLD _HOSTVM_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Process_$KEY$ |
Checks the state of a process |
os_processes |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _PROCESSES |
Number of processes |
Checks the number of processes |
os_count_processes |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTCOUNT_PROCESSES_WARNING_THRESHOLD _HOSTCOUNT_PROCESSES_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Users |
Checks the number of users sessions |
os_users |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTUSERS_WARNING_THRESHOLD _HOSTUSERS_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
RAM usage |
Checks the memory usage |
os_ram_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTRAM_WARNING_THRESHOLD _HOSTRAM_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
Uptime |
Checks the server uptime |
os_uptime |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTUPTIME_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
CPU usage 1m |
Checks the last minute average CPU usage |
os_cpu_1m_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTCPU_WARNING_THRESHOLD _HOSTCPU_CRITICAL_THRESHOLD _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
_PARTITIONS:
wocu-discover-os-resources-partitions.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
_PROCESSES:
wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c and 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
_CPU_WARNING_THRESHOLD |
CPU warning threshold |
percent |
_CPU_CRITICAL_THRESHOLD |
CPU critical threshold |
percent |
_RAM_WARNING_THRESHOLD |
RAM warning threshold |
percent |
_RAM_CRITICAL_THRESHOLD |
RAM critical threshold |
percent |
_VM_WARNING_THRESHOLD |
Virtual memory warning threshold |
percent |
_VM_CRITICAL_THRESHOLD |
Virtual memory critical threshold |
percent |
_STORAGE_WARNING_THRESHOLD |
Storage warning threshold |
percent |
_STORAGE_CRITICAL_THRESHOLD |
Storage critical threshold |
percent |
_UPTIME_CRITICAL_THRESHOLD |
Uptime critical threshold |
integer |
_USERS_WARNING_THRESHOLD |
Users warning threshold |
integer |
_USERS_CRITICAL_THRESHOLD |
Users critical threshold |
integer |
_COUNT_PROCESSES_WARNING_THRESHOLD |
Number of processes running warning threshold |
integer |
_COUNT_PROCESSES_CRITICAL_THRESHOLD |
Number of processes running critical threshold |
integer |
_MEMORY_BUFFER_DEFAULT_WARNING |
Percent of memory buffer used warning threshold |
integer |
_MEMORY_BUFFER_DEFAULT_CRITICAL |
Percent of memory buffer used critical threshold |
integer |
COMPLEX MACROS
_PARTITIONS
Description: Disk partitions
Discover: wocu-discover-os-resources-partitions.py
Fields |
Description |
Type |
---|---|---|
index |
Partition index |
integer |
label |
Partition label |
string |
unit |
Letter unit or path |
string |
_PROCESSES
Description: Processes
Discover: wocu-discover-os-resources-processes.py
Fields |
Description |
Type |
---|---|---|
ProcName |
Process label |
string |
ProcParameters |
Process parameters |
string |
Processes_snmp
DESCRIPTION
Monitoring Windows an Linux processes, via snmp
Script to check the processes of Windows an Linux servers, through snmp
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Processes_$KEY$ |
Checks the state of a process |
os_processes |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _PROCESSES |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
_PROCESSES:
wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
Device SNMP Community, use $SNMPCOMMUNITYREAD$ for the default system community |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c and 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
COMPLEX MACROS
_PROCESSES
Description: Processes
Discover: wocu-discover-os-resources-processes.py
Fields |
Description |
Type |
---|---|---|
ProcName |
Process label |
string |
ProcParameters |
Process parameters |
string |
Unix-files-ssh
DESCRIPTION
Checks last modification day for a file via ssh protocol
Checks last modification day for a file via ssh protocol
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
File $KEY$ |
Connects to a server via SSH and checks if a file exists |
check_unix-files-ssh |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY_FILE _FILES |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SSH_PORT |
SSH port (default 22) |
integer |
_SSH_USER |
SSH User |
string |
_SSH_PASSWORD |
SSH Password. If default (SSH_PASSWORD), SSH_KEY_FILE will be used |
string |
_SSH_KEY_FILE |
SSH Key File (default ~/.ssh/id_rsa) |
string |
COMPLEX MACROS
_FILES
Description: File details
Fields |
Description |
Type |
---|---|---|
Display name |
File id (unique) |
string |
File name prefix |
File name without date suffix. Wildcards (*, ?, etc.) are supported |
string |
Path |
File path |
string |
Time period |
If Time Period Unit is days, 1 means today, 2 means yesterday and today, etc. |
integer |
Time period Unit |
Time period unit |
string |
Windows
DESCRIPTION
Standard windows checks, like CPU, RAM and disk space. Checks are done by WMI.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Windows-Disks |
Overall disks usage |
check_windows_disks |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_DISK_WARN _HOSTWINDOWS_DISK_CRIT |
DisksIO |
Overall disks IO usage |
check_windows_disks_io |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI |
LoadAverage |
Detect abnormal CPU usage |
check_windows_load_average |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_LOAD_WARN _HOSTWINDOWS_LOAD_CRIT |
EventLogSystem |
Detect abnormal system events |
check_windows_eventlogs_system |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTEVENTLOG_SYSTEM_TIME_PERIOD |
EventLogApplication |
Detect abnormal application events |
check_windows_eventlogs_application |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTEVENTLOG_APP_TIME_PERIOD |
Windows-Swap |
Check swap space usage. Too many use of swap space means lacks of memory or memory leaks. |
check_windows_swap |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_SWAP_WARN _HOSTWINDOWS_SWAP_CRIT |
Network Interface |
Detect abnormal Network usage |
check_windows_network_interface |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_BW_WARN _HOSTWINDOWS_BW_CRIT |
Windows-Cpu |
Detect abnormal CPU usage |
check_windows_cpu |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_CPU_WARN _HOSTWINDOWS_CPU_CRIT |
InactiveSessions |
Detect inactive sessions |
check_windows_inactive_sessions |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTINACTIVE_SESSIONS_WARN _HOSTINACTIVE_SESSIONS_CRIT |
Windows - BigProcesses |
Obtain processes using high CPU resources |
check_windows_big_processes |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_BIG_PROCESSES_WARN _HOSTWINDOWS_BIG_PROCESSES_CRIT |
Windows-Reboot |
Checks uptime |
check_windows_uptime |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_UPTIME_WARN _HOSTWINDOWS_UPTIME_CRIT |
Windows_Memory |
Check about memory usage. |
check_windows_memory |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _HOSTWINDOWS_MEM_WARN _HOSTWINDOWS_MEM_CRIT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_DOMAIN_WMI |
Windows Domain of the server |
string |
_USER_WMI |
Full name of the user launching the query. |
string |
_PASSWORD_WMI |
Password for the user launching the query. |
string |
_WINDOWS_BIG_PROCESSES_WARN |
CPU usage by process warning threshold (percentage). |
percent |
_WINDOWS_BIG_PROCESSES_CRIT |
CPU usage by process critical threshold (percentage). |
percent |
_WINDOWS_CPU_WARN |
System CPU usage warning threshold (percentage). |
percent |
_WINDOWS_CPU_CRIT |
System CPU usage critical threshold (percentage). |
percent |
_WINDOWS_DISK_WARN |
Disk usage warning threshold (percentage) |
percent |
_WINDOWS_DISK_CRIT |
Disk usage critical threshold (percentage) |
percent |
_EVENTLOG_APP_TIME_PERIOD |
Time range to look for events in application log file (in minutes) |
integer |
_EVENTLOG_SYSTEM_TIME_PERIOD |
Time range to look for events in system log file (in minutes) |
integer |
_WINDOWS_MEM_WARN |
Warning threshold for Windows RAM usage (percentage) |
percent |
_WINDOWS_MEM_CRIT |
Critical threshold for Windows RAM usage (percentage) |
percent |
_WINDOWS_LOAD_WARN |
Warning threshold for CPU load (absolute, single value) |
string |
_WINDOWS_LOAD_CRIT |
Critical threshold for CPU load (absolute, single value) |
string |
_INACTIVE_SESSIONS_WARN |
Inactive sessions warning threshold |
integer |
_INACTIVE_SESSIONS_CRIT |
Inactive sessions critical threshold |
percent |
_WINDOWS_BW_WARN |
Total Bandwidth warning threshold (bytes per second) |
integer |
_WINDOWS_BW_CRIT |
Total Bandwidth critical threshold (bytes per second) |
integer |
_WINDOWS_UPTIME_WARN |
Uptime warning threshold (minutes) |
integer |
_WINDOWS_UPTIME_CRIT |
Uptime critical threshold (minutes) |
string |
_WINDOWS_SWAP_WARN |
Virtual memory usage warning threshold (percentage) |
percent |
_WINDOWS_SWAP_CRIT |
Virtual memory usage critical threshold (percentage) |
percent |
Windows-drive-size
DESCRIPTION
Get drive size on windows servers by WMI interface
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
DRIVE_$KEY$_STATUS |
Checks the drive size and status |
check_drive_size |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _DRIVES_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_USER_WMI |
Server WMI User |
string |
_PASSWORD_WMI |
Server WMI Password |
string |
COMPLEX MACROS
_DRIVES_LIST
Description: List of drives to overwatch
Fields |
Description |
Type |
---|---|---|
Drive |
Drive: |
string |
Warning |
% warning value |
string |
Critical |
% critical value |
string |
Windows-events
DESCRIPTION
Check event viewer id by WMI interface
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
EVENTS_$KEY$_STATUS |
Looks for events in remote event viewer |
check_events_windows_status |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _EVENTS_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_USER_WMI |
Server WMI User |
string |
_PASSWORD_WMI |
Server WMI Password |
string |
COMPLEX MACROS
_EVENTS_LIST
Description: List of Events to overwatch
Fields |
Description |
Type |
---|---|---|
name |
Name of sample Event Viewer |
string |
service |
Name of the log eg System or Application or any other Event log as shown in the Windows Event Viewer |
string |
type |
Eventtype: # 1=error , 2=warning , 3=Information,4=Security Audit Success,5=Security Audit Failure Multiple Eventypes possible with coma separation |
string |
id |
Eventid Multiple Eventids possible with coma separation |
integer |
minutes |
Number of past min to check for events |
integer |
warning |
Set warning if past min to check for events |
integer |
critical |
Set critical if past min to check for events |
integer |
Windows-process
DESCRIPTION
Gets data usage of processes running on windows servers per WMI interface
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
PROCESS_$KEY$_CPU |
Checks the CPU used by a process |
check_process_windows_cpu |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _PROCESSES_LIST |
PROCESS_$KEY$_MEM |
Checks the Memory used by a process |
check_process_windows_mem |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _PROCESSES_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_USER_WMI |
Server WMI User |
string |
_PASSWORD_WMI |
Server WMI Password |
string |
COMPLEX MACROS
_PROCESSES_LIST
Description: List of Process to overwatch
Fields |
Description |
Type |
---|---|---|
name |
Custom Service Name |
string |
Process |
Name of the Process to be displayed without extension |
string |
warning Memory |
warning threshold use Memory |
string |
critical Memory |
critical threshold use Memory |
string |
warning CPU |
warning threshold use CPU |
string |
critical CPU |
critical threshold use CPU |
string |
Windows-services
DESCRIPTION
Get service status on windows servers by WMI interface
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
SERVICES_$KEY$_STATUS |
Checks the status of a service |
check_windows_services_status |
_HOSTUSER_WMI _HOSTPASSWORD_WMI _HOSTDOMAIN_WMI _SERVICES_LIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SERVICES_LIST:
wocu-discover-windows-wmi-services.py -H $HOSTADDRESS$ –user $_USER_WMI$ –password $_PASSWORD_WMI$ –domain $_DOMAIN_WMI$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_USER_WMI |
WMI User |
string |
_PASSWORD_WMI |
WMI Password |
string |
_DOMAIN_WMI |
WMI Domain |
string |
COMPLEX MACROS
_SERVICES_LIST
Description: List of Services to overwatch
Discover: wocu-discover-windows-wmi-services.py
Fields |
Description |
Type |
---|---|---|
name |
Service display name |
string |
Service |
Real name of the service |
string |
Status |
Service status (Running/Stopped/Paused/Pending) |
string |
Wocu-traps-health
DESCRIPTION
Checks Wocu Traps system health
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU_Traps_Health_Daemon_$KEY$ |
Checks Wocu Traps daemons status and consumption metrics |
wocu-traps-health-process |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _TRAPS_DAEMONS |
WOCU_Traps_Health_Spool |
Checks the spool files number |
wocu-traps-health-spool |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTSPOOL_DIR _HOSTSPOOL_WARNING _HOSTSPOOL_CRITICAL |
WOCU_Traps_Health_Kernel_Buffer |
Checks the buffered traps |
wocu-traps-health-buffer |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_KEY _HOSTBUFFER_WARNING _HOSTBUFFER_CRITICAL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_SPOOL_DIR |
Spool dir for incoming traps (default /var/spool/snmptt) |
string |
_SPOOL_WARNING |
Spool files warning threshold |
integer |
_SPOOL_CRITICAL |
Spool files critical threshold |
integer |
_BUFFER_WARNING |
Buffered traps warning threshold |
integer |
_BUFFER_CRITICAL |
Buffered traps critical threshold |
integer |
COMPLEX MACROS
_TRAPS_DAEMONS
Description: Traps daemons and to monitorize.
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Pid_path |
Path to PID file. |
string |
Virtualization
Docker
DESCRIPTION
Standard Docker checks
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
dockerd |
Checks the Docker daemon |
check_docker_daemon |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE |
Container_$KEY$_network |
Checks Docker container Network Usage |
check_docker_container_network |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _CONTAINERS |
Container_$KEY$_CPU |
Checks Docker container CPU |
check_docker_container_cpu |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _CONTAINERS |
Container_$KEY$_blkio |
Checks Docker container Block I/O Bytes |
check_docker_container_blkio |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _CONTAINERS |
Container_$KEY$_memory |
Checks Docker container Memory usage |
check_docker_container_memory |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _CONTAINERS |
Container_$KEY$_status |
Checks Docker container status |
check_docker_container_status |
_HOSTSSH_PORT _HOSTSSH_USER _HOSTSSH_PASSWORD _HOSTSSH_KEY _HOSTSSH_KEY_PASSPHRASE _CONTAINERS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_CONTAINERS:
wocu-discover-docker-containers.py -H $HOSTADDRESS$ -P $_SSH_PORT$ -u $_SSH_USER$ -p $_SSH_PASSWORD$ -i $_SSH_KEY$ -S $_SSH_KEY_PASSPHRASE$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SSH_USER |
Remote user for the SSH service (key interchange with Shinken user must be done ) |
string |
_SSH_PASSWORD |
Remote password for the SSH service |
string |
_SSH_KEY |
SSH key |
string |
_SSH_KEY_PASSPHRASE |
SSH passphrase |
string |
_SSH_PORT |
Remote port for the SSH service |
integer |
COMPLEX MACROS
_CONTAINERS
Description: List of containers to be checked.
Discover: wocu-discover-docker-containers.py
Fields |
Description |
Type |
---|---|---|
container_id |
Container ID |
string |
container_name |
Container Name |
string |
container_image |
Docker Image |
string |
Esx
DESCRIPTION
This pack checks VMware ESX virtual machines (guests)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
ESX Io |
Checks Virtual Machine disk I/O info |
check_esx_host_io |
_HOSTVCENTER _HOSTVCENTER_LOGIN _HOSTVCENTER_PASSWORD _HOSTVCENTER_SESSION |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_VCENTER |
VCenter address |
string |
_VCENTER_LOGIN |
VCenter User login |
string |
_VCENTER_PASSWORD |
VCenter User password |
string |
_VCENTER_SESSION |
VCenter temporal session file (complete path) |
absolute path |
_ESX_CPU_CRIT |
Critical threshold for CPU USAGE (absolute) |
integer |
_ESX_CPU_WARN |
Warning threshold for CPU USAGE (absolute) |
integer |
_ESX_MEM_CRIT |
Critical threshold for MEMORY USAGE (percentage) |
percent |
_ESX_MEM_WARN |
Warning threshold for MEMORY USAGE (percentage) |
percent |
Esx-host
DESCRIPTION
This pack checks ESX hosts
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
ESX IO READ |
Checks ESX Host I/O read info |
check_esx_io_read |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_IO_READ _HOSTHOST_CRIT_IO_READ |
ESX NTP |
Shows NTP info (drift and peers) |
check_esx_ntp |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_NTP_SECONDS _HOSTHOST_CRIT_NTP_SECONDS _HOSTHOST_WARN_NTP_PEERS _HOSTHOST_CRIT_NTP_PEERS |
ESX IO WRITE |
Checks ESX Host I/O write info |
check_esx_io_write |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_IO_WRITE _HOSTHOST_CRIT_IO_WRITE |
ESX VMFS |
Shows Datastore info |
check_esx_vmfs |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_VMFS _HOSTHOST_CRIT_VMFS |
ESX MEM |
Checks ESX Host memory usage |
check_esx_mem |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_MEM _HOSTHOST_CRIT_MEM |
ESX CPU |
Checks ESX Host CPU usage |
check_esx_cpu |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_CPU _HOSTHOST_CRIT_CPU |
ESX NET |
Shows ESX Host net info |
check_esx_net |
_HOSTHOST_LOGIN _HOSTHOST_PASSWORD _HOSTHOST_WARN_NET _HOSTHOST_CRIT_NET |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_HOST_LOGIN |
Host user |
string |
_HOST_PASSWORD |
Host password |
string |
_HOST_WARN_CPU |
Warning value percentage for CPU (ESX) |
integer |
_HOST_CRIT_CPU |
Critical value percentage for CPU (ESX) |
integer |
_HOST_WARN_MEM |
Warning value percentage for MEM usage (ESX) |
integer |
_HOST_CRIT_MEM |
Critical value percentage for MEM usage (ESX) |
integer |
_HOST_WARN_NET |
Warning Overall network usage in KBps(Kilobytes per Second) |
integer |
_HOST_CRIT_NET |
Critical overall network usage in KBps(Kilobytes per Second) |
integer |
_HOST_WARN_IO_READ |
Warning value for status disks IO in ms(ESX) |
integer |
_HOST_CRIT_IO_READ |
Critical value for status disks IO in ms (ESX) |
integer |
_HOST_WARN_IO_WRITE |
Warning value for status disks IO in ms (ESX) |
integer |
_HOST_CRIT_IO_WRITE |
Critical value for status disks IO in ms (ESX) |
integer |
_HOST_WARN_VMFS |
Warning value for space DATASTORE (ESX) |
string |
_HOST_CRIT_VMFS |
Critical value for space DATASTORE (ESX) |
string |
_HOST_WARN_NTP_SECONDS |
Warning value for NTP drift (seconds) |
integer |
_HOST_CRIT_NTP_SECONDS |
Critical value for NTP drift (seconds) |
integer |
_HOST_WARN_NTP_PEERS |
Warning value for NTP peer servers |
integer |
_HOST_CRIT_NTP_PEERS |
Critical value for NTP peer servers |
integer |
Proxmox
DESCRIPTION
proxmox checks, returns performance values for proxmox server.
Returns performance values for proxmox server via request: Cluster Health, CPU, Memory, Storage, Subscription, VM Status, Replication Status.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Proxmox Memory |
Checks the memory usage |
check_pve_memory |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT _HOSTAPI_NODE |
Proxmox Storage |
Checks the storage status and usage |
check_pve_storage |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT _HOSTAPI_NODE _HOSTAPI_STORAGE |
Proxmox IO Wait |
Checks the IO wait metrics |
check_pve_io_wait |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT _HOSTAPI_NODE |
Proxmox Services |
Checks the proxmox services state |
check_pve_services |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT _HOSTAPI_NODE _HOSTIGNORE_SERVICES |
Proxmox CPU Load |
Checks the CPU load |
check_pve_cpu |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT _HOSTAPI_NODE |
Proxmox Cluster Health |
Checks the cluster health status |
check_pve_cluster_health |
_HOSTAPI_USER _HOSTAPI_PASSWD _HOSTAPI_ENDPOINT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_API_USER |
Remote user for the API calls |
string |
_API_PASSWD |
Remote password for the API calls |
string |
_API_ENDPOINT |
API Endpoing (Usually is the FQDN of the Proxmox Server) |
string |
_API_NODE |
Proxmox node name |
string |
_API_STORAGE |
Proxmox storage Name |
string |
_IGNORE_SERVICES |
Ignore check services names |
string |
Wocu Monitoring
Wocu-check
DESCRIPTION
Checks the status of the passive service generetad by wocu-check action
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Check status |
Checks the status of the passive service generetad by wocu-check action |
check-wocu-check-status |
_HOSTLMD_PORT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_LMD_PORT |
LMP listening port. Default: 50000 |
integer |
Wocu-credits
DESCRIPTION
Checks the credits used by WOCU realm
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Credits |
Checks credits used by WOCU realm |
check-wocu-credits |
_HOSTCREDITS_USAGE_WARNING _HOSTCREDITS_USAGE_CRITICAL _HOSTAPI_IMPORT_TOOL_USER _HOSTAPI_IMPORT_TOOL_PASSWORD _HOSTAPI_TIMEOUT _HOSTAPI_PROTOCOL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_API_IMPORT_TOOL_USER |
Import-tool API User |
string |
_API_IMPORT_TOOL_PASSWORD |
Import-tool API Password |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
_API_PROTOCOL |
API protocol (http/https) |
string |
_CREDITS_USAGE_WARNING |
Credits usage warning threshols (percent) |
percent |
_CREDITS_USAGE_CRITICAL |
Credits usage critical threshols (percent) |
percent |
Wocu-events-diff
DESCRIPTION
Checks events/logs inserted in MongoDB and ElasticSearch
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Events Diff |
Checks events/logs inserted in MongoDB and ElasticSearch |
check-wocu-events-diff |
_HOSTMONGO_ADDRESS _HOSTMONGO_PORT _HOSTMONGO_USER _HOSTMONGO_PASS _HOSTMONGO_AUTH_DATABASE _HOSTMONGO_DATABASE _HOSTMONGO_COLLECTION _HOSTMONGO_REALM _HOSTELASTICSEARCH_CLUSTER_IP _HOSTELASTICSEARCH_CLUSTER_PORT _HOSTELASTICSEARCH_PROTOCOL _HOSTELASTICSEARCHINDEX _HOSTELASTICSEARCHUSER _HOSTELASTICSEARCHPASS _HOSTDIFF_FACTOR _HOSTPRODUCTION |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_MONGO_ADDRESS |
MongoDB IP Address |
string |
_MONGO_PORT |
MongoDB TCP Port (27017 by default) |
string |
_MONGO_USER |
MongoDB username |
string |
_MONGO_PASS |
MongoDB password |
string |
_MONGO_AUTH_DATABASE |
MongoDB authentication database |
string |
_MONGO_COLLECTION |
MongoDB collection. Usually the realm-name |
string |
_MONGO_DATABASE |
MongoDB database |
string |
_MONGO_REALM |
Wocu realm. It’s used to filter the queries to a centralized mongoDB. Leave it blank if local mongodb is used |
string |
_ELASTICSEARCH_CLUSTER_IP |
ElasticSearch IP Address |
string |
_ELASTICSEARCH_CLUSTER_PORT |
ElasticSearch port (default 9200). |
integer |
_ELASTICSEARCH_PROTOCOL |
ElasticSearch web protocol (default http) |
string |
_ELASTICSEARCHINDEX |
ElasticSearch index for monitoring events. Usually monitoring-realm-name |
string |
_ELASTICSEARCHUSER |
ElasticSearch username. Leave it blank if not needed |
string |
_ELASTICSEARCHPASS |
ElasticSearch password. Leave it blank if not needed |
string |
_DIFF_FACTOR |
Multiplying factor to consider both event metrics are different enough to alert |
integer |
_PRODUCTION |
Only production realms should insert events in MongoDB. Is this one a production realm? Default: True |
string |
Wocu-health-aggregator
DESCRIPTION
Checks Wocu Aggregator daemons running on a server. Netcat must be installed in monitored server
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Health - Aggregator - $KEY$ |
Checks Wocu Aggregator daemons status and consumption metrics |
check-wocu-aggregator-daemon |
_HOSTWEB_PROTOCOL _HOSTDOMAIN _HOSTACTIVE_CONN_WARNING _HOSTACTIVE_CONN_CRITICAL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT _HOSTAPI_AGGREGATOR_ENDPOINT _HOSTAPI_AGGREGATOR_USER _HOSTAPI_AGGREGATOR_PASSWORD _HOSTAPI_TIMEOUT _WOCU_DAEMONS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_WOCU_DAEMONS:
wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Aggregator -p $_WEB_PROTOCOL$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_WEB_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_DOMAIN |
Used for Nginx checks if value is not default |
string |
_ACTIVE_CONN_WARNING |
Active connections warning threshold |
integer |
_ACTIVE_CONN_CRITICAL |
Active connections critical threshold |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_API_AGGREGATOR_USER |
Aggregtor API User |
string |
_API_AGGREGATOR_PASSWORD |
Aggregtor API Password |
string |
_API_AGGREGATOR_ENDPOINT |
Aggregtor API Query endpoint |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
COMPLEX MACROS
_WOCU_DAEMONS
Description: Wocu daemons and ports to monitorize.
Discover: wocu-discover-wocu-daemons.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Port |
Daemon TCP Port to be checked. |
integer |
Wocu-health-generic
DESCRIPTION
Checks Wocu daemons running on a server. Netcat must be installed in monitored server
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Health - $KEY$ |
Checks Wocu daemons status and consumption metrics |
check-wocu-daemon |
_HOSTWEB_PROTOCOL _HOSTSHINKEN_WEB_PROTOCOL _HOSTFQDN _HOSTACTIVE_CONN_WARNING _HOSTACTIVE_CONN_CRITICAL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT _HOSTAPI_AGGREGATOR_ENDPOINT _HOSTAPI_AGGREGATOR_USER _HOSTAPI_AGGREGATOR_PASSWORD _HOSTAPI_IMPORT_TOOL_ENDPOINT _HOSTAPI_IMPORT_TOOL_USER _HOSTAPI_IMPORT_TOOL_PASSWORD _HOSTAPI_TIMEOUT _WOCU_DAEMONS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_WOCU_DAEMONS:
wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f $_WOCU_FLAVOUR$ -p $_WEB_PROTOCOL$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_WOCU_FLAVOUR |
Choose Wocu Flavour |
string |
_WEB_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTPS by default) |
string |
_SHINKEN_WEB_PROTOCOL |
Shinken WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_FQDN |
Used for Nginx checks if value is not default |
string |
_ACTIVE_CONN_WARNING |
Active connections warning threshold |
integer |
_ACTIVE_CONN_CRITICAL |
Active connections critical threshold |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_API_AGGREGATOR_USER |
Aggregtor API User |
string |
_API_AGGREGATOR_PASSWORD |
Aggregtor API Password |
string |
_API_AGGREGATOR_ENDPOINT |
Aggregtor API Query endpoint |
string |
_API_IMPORT_TOOL_USER |
Import-tool API User |
string |
_API_IMPORT_TOOL_PASSWORD |
Import-tool API Password |
string |
_API_IMPORT_TOOL_ENDPOINT |
Import-tool API Query endpoint |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
COMPLEX MACROS
_WOCU_DAEMONS
Description: Wocu daemons and ports to monitorize.
Discover: wocu-discover-wocu-daemons.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Port |
Daemon TCP Port to be checked. |
integer |
Wocu-health-monitoring
DESCRIPTION
Checks Wocu Monitoring daemons running on a server. Netcat must be installed in monitored server
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Health - Monitoring - $KEY$ |
Checks Wocu Monitoring daemons status and consumption metrics |
check-wocu-monitoring-daemon |
_HOSTWEB_PROTOCOL _HOSTSHINKEN_WEB_PROTOCOL _HOSTFQDN _HOSTACTIVE_CONN_WARNING _HOSTACTIVE_CONN_CRITICAL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT _HOSTAPI_IMPORT_TOOL_ENDPOINT _HOSTAPI_IMPORT_TOOL_USER _HOSTAPI_IMPORT_TOOL_PASSWORD _HOSTAPI_TIMEOUT _WOCU_DAEMONS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_WOCU_DAEMONS:
wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Monitoring -p $_WEB_PROTOCOL$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_WEB_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_SHINKEN_WEB_PROTOCOL |
Shinken WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_FQDN |
Used for Nginx checks if value is not default |
string |
_ACTIVE_CONN_WARNING |
Active connections warning threshold |
integer |
_ACTIVE_CONN_CRITICAL |
Active connections critical threshold |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_API_IMPORT_TOOL_USER |
Import-tool API User |
string |
_API_IMPORT_TOOL_PASSWORD |
Import-tool API Password |
string |
_API_IMPORT_TOOL_ENDPOINT |
Import-tool API Query endpoint |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
COMPLEX MACROS
_WOCU_DAEMONS
Description: Wocu daemons and ports to monitorize.
Discover: wocu-discover-wocu-daemons.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Port |
Daemon TCP Port to be checked. |
integer |
Wocu-health-monitoring-visor
DESCRIPTION
Checks Wocu Monitoring Visor daemons running on a server. Netcat must be installed in monitored server
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Health - Monitoring Visor - $KEY$ |
Checks Wocu Monitoring Visor daemons status and consumption metrics |
check-wocu-monitoring-visor-daemon |
_HOSTWEB_PROTOCOL _HOSTSHINKEN_WEB_PROTOCOL _HOSTFQDN _HOSTACTIVE_CONN_WARNING _HOSTACTIVE_CONN_CRITICAL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT _HOSTAPI_IMPORT_TOOL_ENDPOINT _HOSTAPI_IMPORT_TOOL_USER _HOSTAPI_IMPORT_TOOL_PASSWORD _HOSTAPI_TIMEOUT _WOCU_DAEMONS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_WOCU_DAEMONS:
wocu-discover-wocu-daemons.py -H $HOSTADDRESS$ -f Monitoring-Visor -p $_WEB_PROTOCOL$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_WEB_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_SHINKEN_WEB_PROTOCOL |
Shinken WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_FQDN |
Used for Nginx checks if value is not default |
string |
_ACTIVE_CONN_WARNING |
Active connections warning threshold |
integer |
_ACTIVE_CONN_CRITICAL |
Active connections critical threshold |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
_API_IMPORT_TOOL_USER |
Import-tool API User |
string |
_API_IMPORT_TOOL_PASSWORD |
Import-tool API Password |
string |
_API_IMPORT_TOOL_ENDPOINT |
Import-tool API Query endpoint |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
COMPLEX MACROS
_WOCU_DAEMONS
Description: Wocu daemons and ports to monitorize.
Discover: wocu-discover-wocu-daemons.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Port |
Daemon TCP Port to be checked. |
integer |
Wocu-health-satellite
DESCRIPTION
Checks Wocu Satellite daemons running on a server
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Health - Satellite - $KEY$ |
Checks Wocu Satellite daemons status and consumption metrics |
check-wocu-satellite-daemon |
_HOSTWEB_PROTOCOL _HOSTSHINKEN_WEB_PROTOCOL _HOSTSSH_USER _HOSTSSH_KEY_PASSPHRASE _HOSTSSH_KEY _HOSTSSH_PORT _WOCU_DAEMONS |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_WEB_PROTOCOL |
WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_SHINKEN_WEB_PROTOCOL |
Shinken WEB protocol: HTTP/HTTPS (HTTP by default) |
string |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY_PASSPHRASE |
SSH passphrase (Wocu user) |
string |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
COMPLEX MACROS
_WOCU_DAEMONS
Description: Wocu daemons and ports to monitorize.
Fields |
Description |
Type |
---|---|---|
Display Name |
Display name to be shown as part of the service description. |
string |
Daemon |
Daemon (process name) to monitor. |
string |
Port |
Daemon TCP Port to be checked. |
integer |
Wocu-hw-health
DESCRIPTION
Checks hardware sensors with smartctl and IPMI tools
Smartmontools and IPMICFG must be installed in target hosts. User wocu must be allowed to execute smartctl and IPMICFG commands as root without password
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Hardware Health - IPMI Sensors |
Checks hardware sensors via SSH |
wocu-hw-health-ipmi_sdr |
_HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_PORT |
Hardware Health - Disks |
Checks Disks health with smartctl via SSH |
wocu-hw-health-smartctl |
_HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_PORT |
Hardware Health - IPMI pminfo |
Executes IPMI pminfo (Power Modules Info) via SSH |
wocu-hw-health-ipmi_pminfo |
_HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_PORT |
Hardware Health - IPMI Power |
Checks power consumption via SSH |
wocu-hw-health-ipmi_dcmi_power |
_HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_PORT _HOSTPOWER_WARNING _HOSTPOWER_CRITICAL |
Hardware Health - IPMI Selftest |
Executes IPMI Selftest via SSH |
wocu-hw-health-ipmi_selftest |
_HOSTSSH_USER _HOSTSSH_KEY _HOSTSSH_PORT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_POWER_WARNING |
Instantaneous power warning threshold |
integer |
_POWER_CRITICAL |
Instantaneous power critical threshold |
integer |
_SSH_USER |
SSH user (key interchange with Wocu user must be done). |
string |
_SSH_PORT |
SSH port (default 22). |
integer |
_SSH_KEY |
SSH Key File (default ~/.ssh/id_rsa) |
string |
Wocu-latency
DESCRIPTION
Obtains services and hosts latency from Livestatus and alerts when trespass thresholds
Services/hosts latency is the difference between the moment in which a service_check/host_check should be executed and the moment it’s really executed
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Latency |
Obtain max services and hosts latency from Livestatus and alerts when trespass thresholds |
check-wocu-latency |
_HOSTLIVESTATUS_PORT _HOSTSERVICES_WARNING_LATENCY _HOSTSERVICES_CRITICAL_LATENCY _HOSTHOSTS_WARNING_LATENCY _HOSTHOSTS_CRITICAL_LATENCY |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_LIVESTATUS_PORT |
Livestatus port. Default: 50000 |
integer |
_SERVICES_WARNING_LATENCY |
Services latency warning threshold |
string |
_SERVICES_CRITICAL_LATENCY |
Services latency critical threshold |
string |
_HOSTS_WARNING_LATENCY |
Hosts latency warning threshold |
string |
_HOSTS_CRITICAL_LATENCY |
Hosts latency critical threshold |
string |
Wocu-realm
DESCRIPTION
Checks to obtain host/services stats per realm from Wocu-aggregator servers
This pack should be applied only to wocu-aggregator
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
WOCU Realm - $KEY$ - Last Check |
Checks the time from last check command executed |
check-realm-last-check |
_HOSTLAST_CHECK_WARN _HOSTLAST_CHECK_CRIT _WOCU_REALMS |
WOCU Realm - $KEY$ - Stats |
Checks hosts/services/bphost/bpservices statistics from realms |
check-realm-status |
_HOSTAPI_PROTOCOL _HOSTAPI_ENDPOINT _HOSTAPI_USER _HOSTAPI_PASSWORD _HOSTAPI_TIMEOUT _HOSTDOMAIN _HOSTHOST_WARN _HOSTHOST_CRIT _HOSTSERVICE_WARN _HOSTSERVICE_CRIT _HOSTBPHOST_WARN _HOSTBPHOST_CRIT _HOSTBPSERVICE_WARN _HOSTBPSERVICE_CRIT _WOCU_REALMS |
WOCU Realm - $KEY$ - LMD Status |
Checks LMD status from every realm |
check-realm-lmd-status |
_WOCU_REALMS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_WOCU_REALMS:
wocu-discover-wocu-realms.py -H $HOSTADDRESS$ -P $_API_PROTOCOL$ -u $_API_USER$ -p $_API_PASSWORD$ -d $_DOMAIN$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_API_USER |
Aggregator API user |
string |
_API_PASSWORD |
Aggregator API password |
string |
_API_PROTOCOL |
Aggregator API protocol: HTTP/HTTPS (HTTP by default) |
string |
_API_ENDPOINT |
API Query endpoint |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
_HOST_WARN |
Not OK Hosts warning threshold (percentage) |
percent |
_HOST_CRIT |
Not OK Hosts critical threshold (percentage) |
percent |
_SERVICE_WARN |
Not OK Services warning threshold (percentage) |
percent |
_SERVICE_CRIT |
Not OK Services critical threshold (percentage) |
percent |
_BPHOST_WARN |
Not OK BPHosts warning threshold (percentage) |
percent |
_BPHOST_CRIT |
Not OK BPHosts critical threshold (percentage) |
percent |
_BPSERVICE_WARN |
Not OK BPServices warning threshold (percentage) |
percent |
_BPSERVICE_CRIT |
Not OK BPServices critical threshold (percentage) |
percent |
_LAST_CHECK_WARN |
Minutes from last executed check warning threshold |
integer |
_LAST_CHECK_CRIT |
Minutes from last executed check critical threshold |
integer |
_DOMAIN |
Domain hostname |
string |
COMPLEX MACROS
_WOCU_REALMS
Description: Wocu realms
Discover: wocu-discover-wocu-realms.py
Fields |
Description |
Type |
---|---|---|
display_name |
Display name to be shown as part of the service description. |
string |
name |
Realm name to monitor. |
string |
monitoring_ip |
IP address to query. |
string |
monitoring_port |
Port to query. |
integer |
Cloud
Aws-ec2
DESCRIPTION
Checks for AWS EC2 instances
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
aws-ec2-cpu-usage |
Checks the CPU usage of EC2 instances |
check_aws_ec2_cpu |
_HOSTCPU_WARNING _HOSTCPU_CRITICAL _HOSTAWS_PROFILE _HOSTAWS_INSTANCE_ID |
aws-ec2-traffic |
Checks the traffic information of EC2 instance |
check_aws_ec2_traffic |
_HOSTCPU_WARNING _HOSTCPU_CRITICAL _HOSTAWS_PROFILE _HOSTAWS_INSTANCE_ID |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_AWS_PROFILE |
AWS profile for API authentication |
string |
_AWS_INSTANCE_ID |
AWS EC2 instance ID |
string |
_CPU_WARNING |
CPU usage warning threshold |
percent |
_CPU_CRITICAL |
CPU usage critical threshold |
percent |
Aws-eks
DESCRIPTION
Checks for AWS EKS clusters
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
aws-eks-mem-usage |
Checks the memory usage of EKS clusters |
check_aws_eks_mem |
_HOSTMEM_WARNING _HOSTMEM_CRITICAL _HOSTAWS_PROFILE _HOSTAWS_EKS_CLUSTER_NAME |
aws-eks-cpu-usage |
Checks the CPU usage of EKS clusters |
check_aws_eks_cpu |
_HOSTCPU_WARNING _HOSTCPU_CRITICAL _HOSTAWS_PROFILE _HOSTAWS_EKS_CLUSTER_NAME |
aws-eks-nodes |
Checks the number of nodes in the EKS cluster |
check_aws_eks_nodes |
_HOSTNODES_WARNING _HOSTNODES_CRITICAL _HOSTAWS_PROFILE _HOSTAWS_EKS_CLUSTER_NAME |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_AWS_PROFILE |
AWS profile for API authentication |
string |
_AWS_EKS_CLUSTER_NAME |
AWS EKS cluster name |
string |
_CPU_WARNING |
CPU usage warning threshold |
percent |
_CPU_CRITICAL |
CPU usage critical threshold |
percent |
_MEM_WARNING |
Memory usage warning threshold |
percent |
_MEM_CRITICAL |
Memory usage critical threshold |
percent |
_NODES_WARNING |
Number of nodes warning threshold |
percent |
_NODES_CRITICAL |
Number of nodes critical threshold |
percent |
Gce-vm
DESCRIPTION
Gloogle Cloud Engine Instance checks
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Google Cloud Instance - Disk IOPS |
Checks Google Cloud Instance Read and Write OPS |
check_gce_vm_disk |
_HOSTSERVICE_ACCOUNT _HOSTPROJECT_ID |
Google Cloud Instance - Traffic |
Checks Google Cloud Instance Traffic |
check_gce_vm_traffic |
_HOSTSERVICE_ACCOUNT _HOSTPROJECT_ID |
Google Cloud Instance - CPU |
Checks Google Cloud Instance CPU usage |
check_gce_vm_cpu |
_HOSTSERVICE_ACCOUNT _HOSTPROJECT_ID _HOSTCPU_WARNING _HOSTCPU_CRITICAL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SERVICE_ACCOUNT |
Service Account json file |
string |
_PROJECT_ID |
Gloogle Cloud Project ID |
string |
_CPU_WARNING |
CPU usage warning threshold (percent) |
percent |
_CPU_CRITICAL |
CPU usage critical threshold (percent) |
percent |
Voip
Call-manager-cisco
DESCRIPTION
Generic and specific checks for Cisco Call Manager devices
Supported CUCM v10 and olders
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Devices_Media |
Checks the number and status of Media devices |
check-cisco-ccm-devices-media |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_MEDIA_WARNING _HOSTPROBLEM_MEDIA_CRITICAL |
CCM-Info |
Shows info about the Cisco Call Manager device |
check-cisco-ccm-info |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
CallManager-Disks |
Overall disks usage |
check-cisco-ccm-disks |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTSTORAGE_WARN _HOSTSTORAGE_CRIT |
Devices_Gateways |
Checks the number and status of Gateway devices |
check-cisco-ccm-devices-gateways |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_GATEWAYS_WARNING _HOSTPROBLEM_GATEWAYS_CRITICAL |
CallManager-TimeSync |
Checks the difference between device and Wocu UTC time |
check-cisco-ccm-time |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTNTP_WARN _HOSTNTP_CRIT |
Devices_CTI |
Checks the number and status of CTI devices |
check-cisco-ccm-devices-cti |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_CTI_WARNING _HOSTPROBLEM_CTI_CRITICAL |
Devices_VoiceMails |
Checks the number and status of Voicemail devices |
check-cisco-ccm-devices-voicemails |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_VOICEMAIL_WARNING _HOSTPROBLEM_VOICEMAIL_CRITICAL |
SIP_ActiveCalls_$KEY$ |
Checks the number of active and in-progress calls per SIP |
check-cisco-ccm-sip-activecalls |
_HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTACTIVECALLS_WARNING _HOSTACTIVECALLS_CRITICAL _SIP_DEVICES |
CallManager-Memory |
Checks the memory usage |
check-cisco-ccm-memory |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTMEMORY_WARN _HOSTMEMORY_CRIT |
Devices_Phones |
Checks the number and status of Phone devices |
check-cisco-ccm-devices-phones |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_PHONES_WARNING _HOSTPROBLEM_PHONES_CRITICAL |
CallManager-CPU |
Checks the CPU usage |
check-cisco-ccm-cpu |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTCPU_WARN _HOSTCPU_CRIT |
MGCP_ActiveCalls_$KEY$ |
Checks the number Active calls per MGCP |
check-cisco-ccm-mgcp-activecalls |
_HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTACTIVECALLS_WARNING _HOSTACTIVECALLS_CRITICAL _MGCP_DEVICES |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
_SIP_DEVICES:
wocu-discover-cucm.py –server $HOSTADDRESS$ -t sip -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ –remote $_POLLER_TAG_ADDRESS$
_MGCP_DEVICES:
wocu-discover-cucm.py –server $HOSTADDRESS$ -t mgcp -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP version, supported 1, 2c and 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
_PROBLEM_PHONES_WARNING |
Unregistered + Rejected Phones warning threshold |
integer |
_PROBLEM_PHONES_CRITICAL |
Unregistered + Rejected Phones critical threshold |
integer |
_PROBLEM_GATEWAYS_WARNING |
Unregistered + Rejected Gateways warning threshold |
integer |
_PROBLEM_GATEWAYS_CRITICAL |
Unregistered + Rejected Gateways critical threshold |
integer |
_PROBLEM_MEDIA_WARNING |
Unregistered + Rejected Media warning threshold |
integer |
_PROBLEM_MEDIA_CRITICAL |
Unregistered + Rejected Media critical threshold |
integer |
_PROBLEM_CTI_WARNING |
Unregistered + Rejected Cti warning threshold |
integer |
_PROBLEM_CTI_CRITICAL |
Unregistered + Rejected Cti critical threshold |
integer |
_PROBLEM_VOICEMAIL_WARNING |
Unregistered + Rejected Voicemails warning threshold |
integer |
_PROBLEM_VOICEMAIL_CRITICAL |
Unregistered + Rejected Voicemails critical threshold |
integer |
_CPU_WARN |
Warning level for the CPU usage |
percent |
_CPU_CRIT |
Critical level for the CPU usage |
percent |
_MEMORY_WARN |
Physical memory and swap warning level |
percent |
_MEMORY_CRIT |
Physical memory and swap critical level |
percent |
_STORAGE_PATH |
Absolute path to check its storage |
absolute path |
_STORAGE_WARN |
Warning level for used disk space |
percent |
_STORAGE_CRIT |
Critical level for used disk space |
percent |
_NTP_WARN |
NTP timings warning level (in seconds) |
integer |
_NTP_CRIT |
NTP timings critical level (in seconds) |
integer |
_CUCM_USER |
Call Manager connecting user (SOAP checks) |
string |
_CUCM_PASSWORD |
Password of the Call Manager connecting user(SOAP checks) |
string |
_ACTIVECALLS_WARNING |
Warning threshold for ActiveCalls in the Call Manager |
integer |
_ACTIVECALLS_CRITICAL |
Critical threshold for ActiveCalls in the Call Manager |
integer |
COMPLEX MACROS
_SIP_DEVICES
Description: SIP Devices from Call Manager
Discover: wocu-discover-cucm.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Custom Name appearing in the service: SIP_<Display Name> |
string |
Device Name |
SIP Device name (configured on remote device) |
string |
_MGCP_DEVICES
Description: MGCP Devices from Call Manager
Discover: wocu-discover-cucm.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Custom Name appearing in the service: MGCP_<Display Name> |
string |
Device Name |
MGCP Device name (configured on remote device) |
string |
Call-manager-cisco-snmp
DESCRIPTION
Generic and specific checks for Cisco Call Manager devices using only SNMP
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Call Manager Memory Usage |
Checks the memory usage |
call-manager-cisco-snmp-memory |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTMEMORY_WARN _HOSTMEMORY_CRIT |
Call Manager Devices - VoiceMails |
Checks the number and status of Voicemail devices |
call-manager-cisco-snmp-voicemails |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_VOICEMAIL_WARNING _HOSTPROBLEM_VOICEMAIL_CRITICAL |
Call Manager Devices - Gateways |
Checks the number and status of Gateway devices |
call-manager-cisco-snmp-gateways |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_GATEWAYS_WARNING _HOSTPROBLEM_GATEWAYS_CRITICAL |
Call Manager Devices - Media |
Checks the number and status of Media devices |
call-manager-cisco-snmp-media |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_MEDIA_WARNING _HOSTPROBLEM_MEDIA_CRITICAL |
Call Manager Status - local |
Checks status from local Cisco Call Manager |
call-manager-cisco-snmp-status |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
CUCM_Process_$KEY$ |
Checks process status |
call-manager-cisco-snmp-processes |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _PROCESSES |
Call Manager CPU Usage |
Checks the CPU usage |
call-manager-cisco-snmp-cpu |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTCPU_WARN _HOSTCPU_CRIT |
Call Manager Devices - Phones |
Checks the number and status of Phone devices |
call-manager-cisco-snmp-phones |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_PHONES_WARNING _HOSTPROBLEM_PHONES_CRITICAL |
Call Manager Devices - CTI |
Checks the number and status of CTI devices |
call-manager-cisco-snmp-cti |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPPRIVPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPROBLEM_CTI_WARNING _HOSTPROBLEM_CTI_CRITICAL |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
_PROCESSES:
wocu-discover-os-resources-processes.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -s $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -x $_SNMPPRIVPROTOCOL$ -A $_SNMPAUTHKEY$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP version, supported 1, 2c and 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3). Write $SNMPCONTEXT$ to use Shinken resource |
string |
_PROBLEM_PHONES_WARNING |
Unregistered + Rejected Phones warning threshold |
integer |
_PROBLEM_PHONES_CRITICAL |
Unregistered + Rejected Phones critical threshold |
integer |
_PROBLEM_GATEWAYS_WARNING |
Unregistered + Rejected Gateways warning threshold |
integer |
_PROBLEM_GATEWAYS_CRITICAL |
Unregistered + Rejected Gateways critical threshold |
integer |
_PROBLEM_MEDIA_WARNING |
Unregistered + Rejected Media warning threshold |
integer |
_PROBLEM_MEDIA_CRITICAL |
Unregistered + Rejected Media critical threshold |
integer |
_PROBLEM_CTI_WARNING |
Unregistered + Rejected Cti warning threshold |
integer |
_PROBLEM_CTI_CRITICAL |
Unregistered + Rejected Cti critical threshold |
integer |
_PROBLEM_VOICEMAIL_WARNING |
Unregistered + Rejected Voicemails warning threshold |
integer |
_PROBLEM_VOICEMAIL_CRITICAL |
Unregistered + Rejected Voicemails critical threshold |
integer |
_CPU_WARN |
CPU usage percent critical threshold |
percent |
_CPU_CRIT |
CPU usage percent critical threshold |
percent |
_MEMORY_WARN |
Physical memory usage percent warning threshold |
percent |
_MEMORY_CRIT |
Physical memory usage percent critical threshold |
percent |
COMPLEX MACROS
_PROCESSES
Description: Processes
Discover: wocu-discover-os-resources-processes.py
Fields |
Description |
Type |
---|---|---|
ProcName |
Process label |
string |
ProcParameters |
Process parameters |
string |
Cisco-call-manager-cloud
DESCRIPTION
Check for Cisco Call Manager via CUCM APIs. Tested CUCM versions: 12.5, 14
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
cisco-call-manager-cloud_cti |
Checks the CTI devices status |
cisco-call-manager-cloud_cti |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTCTI_WARNING _HOSTCTI_CRITICAL |
cisco-call-manager-cloud_media |
Checks the media resources status |
cisco-call-manager-cloud_media |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTMEDIA_WARNING _HOSTMEDIA_CRITICAL |
cisco-call-manager-cloud_phones |
Checks the Phones status |
cisco-call-manager-cloud_phones |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTPHONES_WARNING _HOSTPHONES_CRITICAL |
cisco-call-manager-cloud_voicemail |
Checks the VoiceMail devices status |
cisco-call-manager-cloud_voicemail |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTVOICEMAIL_WARNING _HOSTVOICEMAIL_CRITICAL |
cisco-call-manager-cloud_sip_trunk_status_$KEY$ |
Checks the status of a given SIP Trunk |
cisco-call-manager-cloud_sip_trunk_status |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS |
cisco-call-manager-cloud_version |
Obtains the CUCM version |
cisco-call-manager-cloud_version |
_HOSTCUCM_USER _HOSTCUCM_PASSWORD |
cisco-call-manager-cloud_memory |
Checks the Call Manager Memory usage |
cisco-call-manager-cloud_memory |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTMEM_WARNING _HOSTMEM_CRITICAL |
cisco-call-manager-cloud_gateway_status_$KEY$ |
Checks the status of a given Gateway |
cisco-call-manager-cloud_gateway_status |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _CISCO_CALL_MANAGER_CLOUD_GATEWAYS |
cisco-call-manager-cloud_gateways |
Checks the gateways status |
cisco-call-manager-cloud_gateways |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTGATEWAYS_WARNING _HOSTGATEWAYS_CRITICAL |
cisco-call-manager-cloud_cpu |
Checks the Call Manager CPU usage |
cisco-call-manager-cloud_cpu |
_HOSTREAL_ADDRESS _HOSTCUCM_USER _HOSTCUCM_PASSWORD _HOSTCPU_WARNING _HOSTCPU_CRITICAL |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS:
wocu-discover-cisco-cucm-api.py -H $HOSTADDRESS$ -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ -t sip_trunks –remote $_POLLER_TAG_ADDRESS$
_CISCO_CALL_MANAGER_CLOUD_GATEWAYS:
wocu-discover-cisco-cucm-api.py -H $HOSTADDRESS$ -u $_CUCM_USER$ -p $_CUCM_PASSWORD$ -t gateways –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_REAL_ADDRESS |
Call Manager real IP address. Fill it with real address when Call Manager is behind a NAT |
string |
_CUCM_USER |
CUCM API user |
string |
_CUCM_PASSWORD |
CUCM API password |
string |
_CPU_WARNING |
CPU Usage warning threshold |
percent |
_CPU_CRITICAL |
CPU Usage critical threshold |
percent |
_MEM_WARNING |
Memory usage warning threshold |
percent |
_MEM_CRITICAL |
Memory usage critical threshold |
percent |
_PHONES_WARNING |
Not registered phones warning threshold |
integer |
_PHONES_CRITICAL |
Not registered phones critical threshold |
integer |
_GATEWAYS_WARNING |
Not registered gateways warning threshold |
integer |
_GATEWAYS_CRITICAL |
Not registered gateways critical threshold |
integer |
_MEDIA_WARNING |
Not registered media resources warning threshold |
integer |
_MEDIA_CRITICAL |
Not registered media resources critical threshold |
integer |
_CTI_WARNING |
Not registered CTI warning threshold |
integer |
_CTI_CRITICAL |
Not registered CTI critical threshold |
integer |
_VOICEMAIL_WARNING |
Not registered voicemails warning threshold |
integer |
_VOICEMAIL_CRITICAL |
Not registered voicemails critical threshold |
integer |
COMPLEX MACROS
_CISCO_CALL_MANAGER_CLOUD_SIP_TRUNKS
Description: SIP Trunks list
Discover: wocu-discover-cisco-cucm-api.py
Fields |
Description |
Type |
---|---|---|
display_name |
SIP Trunk display name |
string |
name |
SIP Trunk name. Don’t modify the discovered value. Used in checks |
string |
description |
SIP trunk description |
string |
_CISCO_CALL_MANAGER_CLOUD_GATEWAYS
Description: Gateways list
Discover: wocu-discover-cisco-cucm-api.py
Fields |
Description |
Type |
---|---|---|
display_name |
Gateway name |
string |
name |
Gateway name. Don’t modify the discovered value. Used in checks |
string |
description |
Gateway description |
string |
Mxone-advanced
DESCRIPTION
Additional Pack for Advanced Licensed devices. Get the operational backup status and traffic status of service nodes (LIMs) using SNMP
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
LIM_Oper_status_$KEY$ |
Gets the LIM traffic state |
check_mxone_advanced_oper_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _LIM_ADVANCED_LIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_LIM_ADVANCED_LIST:
wocu-discover-mxone-advanced.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP Community |
string |
_SNMPVERSION |
SNMP version |
string |
COMPLEX MACROS
_LIM_ADVANCED_LIST
Description: List of node services (LIMs) to be checked
Discover: wocu-discover-mxone-advanced.py
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown as Service Description in the web interface |
string |
index |
Index of node service (LIM) (integer) |
integer |
ip_address |
Management IP Address of node service (LIM). Discovered IP is the host address where the pack is applied, configure manually a LIM IP address accessible from Wocu |
string |
name |
Name of node service (LIM) |
string |
Mxone-basic
DESCRIPTION
Pack for Basic Licensed devices. Get the number of active (unhandled) alarms and status of every LIM using SNMP
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
MX-ONE_Active_alarms_$KEY$ |
Shows the total number of active (unhandled) alarms on the node service (LIM) |
check_mxone_basic_alarms |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTALARM_WARNING _HOSTALARM_CRITICAL _LIM_LIST |
MX-ONE_Alarms_max_level_$KEY$ |
Shows the current alarm status in the node service (LIM). |
check_mxone_basic_status |
_HOSTSNMPVERSION _HOSTSNMPCOMMUNITY _HOSTSTATUS_CRITICAL _LIM_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP Community |
string |
_SNMPVERSION |
SNMP version |
string |
_ALARM_WARNING |
Warning threshold for number of active (unhandled) alarms |
integer |
_ALARM_CRITICAL |
Critical threshold for number of active (unhandled) alarms |
integer |
_STATUS_CRITICAL |
Critical threshold for maximum severity level of active (unhandled) alarms. Must be in the 0-5 range |
integer |
COMPLEX MACROS
_LIM_LIST
Description: List of node services (LIMs) to be checked
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown as Service Description in the web interface |
string |
ip_address |
Management IP Address of node service (LIM). Discovered IP is the host address where the pack is applied, configure manually a LIM IP address accessible from Wocu |
string |
Sbc-acme-packet
DESCRIPTION
Checks for AcmePacket SBC gateways via snmp
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Inbound Sessions $KEY$ |
Checks the actual inbound sessions number |
sbc_acme_inbound_sessions |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _REALMLIST |
SBC System Health |
Check the system health expressed as percentage |
sbc_acme_system_health |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSYSTEM_HEALTH_WARNING _HOSTSYSTEM_HEALTH_CRITICAL |
Call Rate $KEY$ |
Checks the inbound and outbound sessions increment |
sbc_acme_call_rate |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _REALMLIST |
SBC License Usage |
Checks the percentage of SBC license in use |
sbc_acme_license_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTLICENSE_USAGE_WARNING _HOSTLICENSE_USAGE_CRITICAL |
SBC Memory Usage |
sbc_acme_memory_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTMEMORY_USAGE_WARNING _HOSTMEMORY_USAGE_CRITICAL |
|
SBC Redundancy State |
Checks the redundancy state of the SBC node |
sbc_acme_redundancy |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
System state |
Check the snmp sytem state of the SBC device |
sbc_system_state |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
SBC CPU Usage |
Checks the CPU usage |
sbc_acme_cpu_usage |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTCPU_USAGE_WARNING _HOSTCPU_USAGE_CRITICAL |
SBC Call Statistics |
Checks the global call statistics (concurrent sessions and call per second) |
sbc_acme_call_stats |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTCONCURRENT_SESSIONS_WARNING _HOSTCONCURRENT_SESSIONS_CRITICAL |
Outbound Sessions $KEY$ |
Checks the actual outbound sessions number |
sbc_acme_outbound_sessions |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _REALMLIST |
SBC AcmePacket Info |
Shows system information |
sbc_acme_info |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_REALMLIST:
wocu-discover-sbc-realms.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –snmpversion $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The read snmp community allowed on the SBC server |
string |
_SNMPVERSION |
SNMP version of the SBC server (allowed 1 and 2c) |
string |
_INBOUND_SESSIONS_WARNING |
Inbound sessions warning threshold |
integer |
_INBOUND_SESSIONS_CRITICAL |
Inbound sessions critical threshold |
integer |
_OUTBOUND_SESSIONS_WARNING |
Outbound sessions warning threshold |
integer |
_OUTBOUND_SESSIONS_CRITICAL |
Outbound sessions critical threshold |
integer |
_CPU_USAGE_WARNING |
CPU usage Warning threshold |
integer |
_CPU_USAGE_CRITICAL |
CPU usage Critical threshold |
integer |
_MEMORY_USAGE_WARNING |
Memory usage Warning threshold |
integer |
_MEMORY_USAGE_CRITICAL |
Memory usage Critical threshold |
integer |
_SYSTEM_HEALTH_WARNING |
System health Warning threshold |
integer |
_SYSTEM_HEALTH_CRITICAL |
System health Critical threshold |
integer |
_CONCURRENT_SESSIONS_WARNING |
Concurrent sessions Warning threshold |
integer |
_CONCURRENT_SESSIONS_CRITICAL |
Concurrent sessions Critical threshold |
integer |
_LICENSE_USAGE_WARNING |
License usage Warning threshold |
integer |
_LICENSE_USAGE_CRITICAL |
License usage Critical threshold |
integer |
COMPLEX MACROS
_REALMLIST
Description: List of Realms
Discover: wocu-discover-sbc-realms.py
Fields |
Description |
Type |
---|---|---|
display_name |
Realm name |
string |
index |
snmp realm index |
integer |
inbound_rejected_warning |
Inbound rejected sessions warning threshold |
integer |
inbound_rejected_critical |
Inbound rejected sessions critical threshold |
integer |
outbound_rejected_warning |
Outbound rejected sessions warning threshold |
integer |
outbound_rejected_critical |
Outbound rejected sessions critical threshold |
integer |
inbound_call_rate_warning |
Inbound sessions increment warning threshold |
integer |
outbound_call_rate_critical |
Outbound sessions increment critical threshold |
integer |
inbound_active_warning |
Inbound active sessions warning threshold |
integer |
inbound_active_critical |
Inbound active sessions critical threshold |
integer |
outbound_active_warning |
Outbound active sessions warning threshold |
integer |
outbound_active_critical |
Outbound active sessions critical threshold |
integer |
Sbc-audiocodes
DESCRIPTION
Checks for Audiocodes SBC gateways via snmp
Pack for checking SBC Audiocodes VoIP Gateway devices. This pack checks Audiocodes gateway devices, polled via snmp.
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
SBC PSTN channels |
Check the PSTN channels utilization |
sbc_audiocodes_pstn_channels |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTTRUNK_CHANNELS_IN_SERVICE_WARNING _HOSTTRUNK_CHANNELS_IN_SERVICE_CRITICAL |
SBC DSP utilization |
Checks the DSP (Digital Signal Processing) utilization |
sbc_audiocodes_dsp_utilization |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTACTIVE_DSP_CHANNELS_WARNING _HOSTACTIVE_DSP_CHANNELS_CRITICAL |
SBC OffHook channels |
Checks the Off Hook channels |
sbc_audiocodes_offhook_channels |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTOFFHOOK_CHANNELS_WARNING _HOSTOFFHOOK_CHANNELS_CRITICAL |
SBC Audiocodes Info |
Shows system information |
sbc_audiocodes_info |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The read snmp community allowed on the SBC server |
string |
_SNMPVERSION |
SNMP version of the SBC server |
string |
_ACTIVE_DSP_CHANNELS_WARNING |
Active DSP channels warning threshold |
integer |
_ACTIVE_DSP_CHANNELS_CRITICAL |
Active DSP channels critical threshold |
integer |
_TRUNK_CHANNELS_IN_SERVICE_WARNING |
Trunk channels in service warning threshold |
integer |
_TRUNK_CHANNELS_IN_SERVICE_CRITICAL |
Trunk channels in service critical threshold |
integer |
_OFFHOOK_CHANNELS_WARNING |
Off Hook channels Warning threshold |
integer |
_OFFHOOK_CHANNELS_CRITICAL |
Off Hook channels Critical threshold |
integer |
Skype-for-business
DESCRIPTION
Skype For Business health and performance checks via nsclient
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Skype_Drivesize |
Checks the storage usage |
check_skype_for_business_drivesize |
_HOSTDRIVESIZE_WARNING _HOSTDRIVESIZE_CRITICAL |
Skype_service_$KEY$ |
Checks the services status |
check_skype_for_business_service |
_SKYPE_SERVICES_LIST |
Skype_CPU |
Checks the CPU usage |
check_skype_for_business_cpu |
_HOSTCPU_WARNING _HOSTCPU_CRITICAL |
Skype_Memory |
Checks the memory usage |
check_skype_for_business_mem |
_HOSTMEM_WARNING _HOSTMEM_CRITICAL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_CPU_WARNING |
CPU usage warning threshold (percent) |
integer |
_CPU_CRITICAL |
CPU usage critical threshold (percent) |
integer |
_MEM_WARNING |
Memory usage warning threshold (percent) |
integer |
_MEM_CRITICAL |
Memory usage critical threshold (percent) |
integer |
_DRIVESIZE_WARNING |
Drive usage warning threshold (percent) |
integer |
_DRIVESIZE_CRITICAL |
Drive usage critical threshold (percent) |
integer |
COMPLEX MACROS
_SKYPE_SERVICES_LIST
Description: List of Skype services to overwatch
Fields |
Description |
Type |
---|---|---|
name |
Display name to be shown as part of the service description |
string |
service |
Service name to monitor. Ex: RTCCLSAGT |
string |
Api
Api-test-generic
DESCRIPTION
Obtain the status and elapsed time from queries to API endpoint
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
API_Test_$KEY$ |
Checks API endpoints status and response time |
check-api-test-generic |
_HOSTELAPSED_TIME_WARNING _HOSTELAPSED_TIME_CRITICAL _HOSTAPI_USER _HOSTAPI_PASSWORD _HOSTAPI_TIMEOUT _API_TEST_GENERIC_LIST |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_API_USER |
API User |
string |
_API_PASSWORD |
API Password |
string |
_API_TIMEOUT |
API Query timeout in seconds, default 10s |
integer |
_ELAPSED_TIME_WARNING |
Elapsed time warning threshols (seconds) |
integer |
_ELAPSED_TIME_CRITICAL |
Elapsed time critical threshols (seconds) |
integer |
COMPLEX MACROS
_API_TEST_GENERIC_LIST
Description: List of API Endpoints
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface |
string |
url |
API Endpoint url |
string |
user |
API user. If blank, use generic one |
string |
password |
API password. If blank, use generic one |
string |
warning |
Elapsed time warning threshold. If blank, use generic one |
string |
critical |
Elapsed time critical threshold. If blank, use generic one |
string |
Kibana-node
DESCRIPTION
Custom checks for Kibana services
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
kibana-node-uptime |
Checks Kibana uptime information. |
check_kibana_node_uptime |
_HOSTKIBANA_PORT _HOSTKIBANA_USERNAME _HOSTKIBANA_PASSWORD _HOSTKIBANA_HTTP_PROTOCOL _HOSTKIBANA_UPTIME_WARNING _HOSTKIBANA_UPTIME_CRITICAL _HOSTKIBANA_APIURL |
kibana-node-version |
Checks Kibana version information. |
check_kibana_node_version |
_HOSTKIBANA_PORT _HOSTKIBANA_USERNAME _HOSTKIBANA_PASSWORD _HOSTKIBANA_HTTP_PROTOCOL _HOSTKIBANA_APIURL |
kibana-node-tcp-port |
Checks Kibana host port. |
check_kibana_node_tcp_port |
_HOSTKIBANA_PORT |
kibana-node-plugins-info |
Checks Kibana plugins status information. |
check_kibana_node_plugins_info |
_HOSTKIBANA_PORT _HOSTKIBANA_USERNAME _HOSTKIBANA_PASSWORD _HOSTKIBANA_HTTP_PROTOCOL _HOSTKIBANA_APIURL |
kibana-node-memory-heap |
Checks Kibana Heap Memory information. |
check_kibana_node_memory_heap |
_HOSTKIBANA_PORT _HOSTKIBANA_USERNAME _HOSTKIBANA_PASSWORD _HOSTKIBANA_HTTP_PROTOCOL _HOSTKIBANA_MEMHEAP_WARNING _HOSTKIBANA_MEMHEAP_CRITICAL _HOSTKIBANA_APIURL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_KIBANA_USERNAME |
Username for API auth |
string |
_KIBANA_PASSWORD |
Password for API auth |
string |
_KIBANA_PORT |
Api port for HTTP requests |
string |
_KIBANA_APIURL |
Api url for HTTP requests, usually starts with a / and ends without a / |
string |
_KIBANA_UPTIME_WARNING |
Uptime warning threshold |
string |
_KIBANA_UPTIME_CRITICAL |
Uptime critical threshold |
string |
_KIBANA_MEMHEAP_WARNING |
Heap memory warning threshold |
string |
_KIBANA_MEMHEAP_CRITICAL |
Heap memory critical threshold |
string |
_KIBANA_HTTP_PROTOCOL |
HTTP protocol choice with or without ssl |
string |
Logstash-node
DESCRIPTION
Custom checks for Logstash services
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
logstash-node-version |
Checks Logstash version information. |
check_logstash_node_version |
_HOSTLOGSTASH_PORT _HOSTLOGSTASH_USERNAME _HOSTLOGSTASH_PASSWORD _HOSTLOGSTASH_HTTP_PROTOCOL |
logstash-node-status-info |
Checks Logstash node status information. |
check_logstash_node_status_info |
_HOSTLOGSTASH_PORT _HOSTLOGSTASH_USERNAME _HOSTLOGSTASH_PASSWORD _HOSTLOGSTASH_HTTP_PROTOCOL |
logstash-node-uptime |
Checks Logstash uptime information. |
check_logstash_node_uptime |
_HOSTLOGSTASH_PORT _HOSTLOGSTASH_USERNAME _HOSTLOGSTASH_PASSWORD _HOSTLOGSTASH_HTTP_PROTOCOL _HOSTLOGSTASH_UPTIME_WARNING _HOSTLOGSTASH_UPTIME_CRITICAL |
logstash-node-tcp-port |
Checks Logstash host port. |
check_logstash_node_tcp_port |
_HOSTLOGSTASH_PORT |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_LOGSTASH_USERNAME |
Username for API auth |
string |
_LOGSTASH_PASSWORD |
Password for API auth |
string |
_LOGSTASH_PORT |
Api port for HTTP requests |
string |
_LOGSTASH_UPTIME_WARNING |
Uptime warning threshold |
string |
_LOGSTASH_UPTIME_CRITICAL |
Uptime critical threshold |
string |
_LOGSTASH_HTTP_PROTOCOL |
HTTP protocol choice with or without ssl |
string |
Networking
Fibernet-leds
DESCRIPTION
Checks Fibernet leds state
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Fibernet - Led State - $KEY$ |
Checks the Fibernet Leds state |
check_fibernet_leds_state |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _FIBERNET_LEDS_LIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_FIBERNET_LEDS_LIST:
wocu-discover-fibernet-leds.py -H $HOSTADDRESS$ –community $_SNMPCOMMUNITY$ –version $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n $_SNMPCONTEXT$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
COMPLEX MACROS
_FIBERNET_LEDS_LIST
Description: Fibernet ledss list
Discover: wocu-discover-fibernet-leds.py
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface. Discovered names are formed by: led + componentKey + bastidor + chassis + slot + ledIndex |
string |
bastidor |
Bastidor number |
integer |
chassis |
Chassis number |
integer |
slot |
Slot number |
integer |
component_key |
Component index (key) |
integer |
led_index |
Led Index |
integer |
card_type |
Card Type number |
integer |
Networkdevice-optical-ifaces-health
DESCRIPTION
Obtains metrics from optical ifaces sensors. Supported vendors: Cisco, Huawei, Extreme Networks, H3C, HH3C
Supported vendors: Cisco, Huawei, Extreme Networks, H3C, HH3C
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Optical_iface_sensor_$KEY$ |
Checks the Optical interface sensor state and value |
check_optical_ifaces_sensor |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTDEVICEVENDOR _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _OPTICAL_IFACES_SENSORS_LIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_DEVICEVENDOR:
wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
_OPTICAL_IFACES_SENSORS_LIST:
wocu-discover-optical-ifaces.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -V $_DEVICEVENDOR$ -v $_SNMPVERSION$ –remote $_POLLER_TAG_ADDRESS$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
_DEVICEVENDOR |
Device vendor |
string |
COMPLEX MACROS
_OPTICAL_IFACES_SENSORS_LIST
Description: List of sensors from optical ifaces
Discover: wocu-discover-optical-ifaces.py
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface |
string |
sensor_type |
Sensor type |
string |
index |
Sensor index. Used in snmp requests |
integer |
warning |
Warning threshold. Nagios format supported. Units - Power:dBm, Current:mA, Temp:Celsius, Voltage:Volts |
string |
critical |
Critical threshold. Nagios format supported. Units - Power:dBm, Current:mA, Temp:Celsius, Voltage:Volts |
string |
Printing
Generic-printer
DESCRIPTION
Checks for the printer status (also consumibles and trays)
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Printer_Pagecount |
Checks the page count number |
check_printer_pagecount |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
$KEY$ |
Checks the printer trays status |
check_printer_tray |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _TRAYLIST |
Printer_Description |
Shows the printer description |
check_printer_description |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION |
$KEY$ |
Checks the consumables state |
check_printer_consum |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _CONSUMLIST |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_SNMPVERSION:
wocu-discover-snmpversion.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
_DEVICEVENDOR:
wocu-discover-vendor.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ –remote $_POLLER_TAG_ADDRESS$
_TRAYLIST:
wocu-discover-printers.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ -t trays –remote $_POLLER_TAG_ADDRESS$
_CONSUMLIST:
wocu-discover-printers.py -H $HOSTADDRESS$ -c $_SNMPCOMMUNITY$ -S $_SNMPVERSION$ -t consum –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
SNMP community to use in the check |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1 and 2c |
string |
_DEVICEVENDOR |
Device vendor |
string |
COMPLEX MACROS
_TRAYLIST
Description: List of Printer Trays (internal/external/paper)
Discover: wocu-discover-printers.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Name to be shown in the service (web interface) |
string |
Index |
ifIndex for snmp queries (integer) |
integer |
Name |
Real name of the Tray (on device) |
string |
Warning |
Warning percentage for the printer Tray |
percent |
Critical |
Critical percentage for the printer Tray |
percent |
_CONSUMLIST
Description: List of Printer supply list (Drum/Toner/etc)
Discover: wocu-discover-printers.py
Fields |
Description |
Type |
---|---|---|
Display Name |
Name to be shown in the service (web interface) |
string |
Index |
ifName for snmp queries |
integer |
Name |
Real name of the Supply (on device) |
string |
Warning |
Warning percentage for the printer Consumable |
percent |
Critical |
Critical percentage for the printer Consumable |
percent |
Code Repository
Gitlab
DESCRIPTION
Standard Gitlab checks
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
gitlab_project_$KEY$_stats |
Show Gitlab Project statistics. |
check_gitlab_project_statistics |
_HOSTGITLAB_TOKEN _GITLAB_PROJECTS |
gitlab_project_$KEY$_branch_pipeline_status |
Checks last pipeline status of project branch. |
check_gitlab_project_branch_pipeline_status |
_HOSTGITLAB_TOKEN _GITLAB_PROJECTS |
gitlab_project_$KEY$_runners |
Check Gitlab Project runners. |
check_gitlab_project_runners |
_HOSTGITLAB_TOKEN _GITLAB_PROJECTS |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_GITLAB_PROJECTS:
wocu-discover-gitlab-projects.py -H $HOSTADDRESS$ -T $_GITLAB_TOKEN$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_GITLAB_TOKEN |
Authentication Token. More info: TODO: Add link to GitLab API Documentation |
string |
COMPLEX MACROS
_GITLAB_PROJECTS
Description: List of projects to be monitored.
Discover: wocu-discover-gitlab-projects.py
Fields |
Description |
Type |
---|---|---|
project_id |
Project ID |
string |
project_name |
Project Name |
string |
project_branch |
Project Branch |
string |
Web
Apache-tomcat
DESCRIPTION
Health and performance checks for Apache Tomcat servers
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
Apache Tomcat - Thread |
Checks Apache Tomcat busy threads |
check_apache_tomcat_thread |
_HOSTTOMCAT_PORT _HOSTTOMCAT_USER _HOSTTOMCAT_PASS _HOSTTHREAD_WARNING _HOSTTHREAD_CRITICAL |
Apache Tomcat - Status |
Checks Apache Tomcat server status |
check_apache_tomcat_status |
_HOSTTOMCAT_PORT _HOSTTOMCAT_USER _HOSTTOMCAT_PASS |
Apache Tomcat - APP - $KEY$ |
Checks Apache Tomcat App status and sessions |
check_apache_tomcat_app |
_HOSTTOMCAT_PORT _HOSTTOMCAT_USER _HOSTTOMCAT_PASS _TOMCAT_APP_LIST |
Apache Tomcat - Memory |
Checks Apache Tomcat Memory usage |
check_apache_tomcat_mem |
_HOSTTOMCAT_PORT _HOSTTOMCAT_USER _HOSTTOMCAT_PASS _HOSTMEM_WARNING _HOSTMEM_CRITICAL |
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_MEM_WARNING |
Memory usage warning threshold |
percent |
_MEM_CRITICAL |
Memory usage critical threshold |
percent |
_TOMCAT_PORT |
TCP port where Tomcat server is listening to. Default: 8080 |
string |
_TOMCAT_USER |
Tomcat user |
string |
_TOMCAT_PASS |
Tomcat password |
string |
_THREAD_WARNING |
Used threads warning threshold |
integer |
_THREAD_CRITICAL |
Used threads critical threshold |
integer |
COMPLEX MACROS
_TOMCAT_APP_LIST
Description: Apache Tomcat App list
Fields |
Description |
Type |
---|---|---|
display_name |
Name to be shown in the web interface |
string |
app_name |
Application name |
string |
Iot
Apc-epdu
DESCRIPTION
Health and performance check for APC-EPDU devices
Important
The terms and concepts used in this section are explained in the Terminology section.
SERVICES
The following table shows the services that this pack will manage. Each row contains information about the managed service, such as its description, check_command and macros.
Name |
Description |
Check Command |
Macros |
---|---|---|---|
apc-epdu_ps_status |
Checks the power supplies status |
apc-epdu_ps_status |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
apc-epdu_pdu_energy |
Checks the PDU energy consumption |
apc-epdu_pdu_energy |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
apc-epdu_outlet_load_status_$KEY$ |
Checks the outlets load status |
apc-epdu_outlet_load_status |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _APC_EPDU_OUTLET_LIST |
apc-epdu_outlet_energy_$KEY$ |
Checks the outlets energy consumption |
apc-epdu_outlet_energy |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _APC_EPDU_OUTLET_LIST |
apc-epdu_pdu_load_status |
Checks the PDU load status |
apc-epdu_pdu_load_status |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
apc-epdu_outlet_power_$KEY$ |
Checks the outlets power consumption |
apc-epdu_outlet_power |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTOUTLET_POWER_WARNING _HOSTOUTLET_POWER_CRITICAL _APC_EPDU_OUTLET_LIST |
apc-epdu_outlet_current_$KEY$ |
Checks the outlets current |
apc-epdu_outlet_current |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTOUTLET_CURRENT_WARNING _HOSTOUTLET_CURRENT_CRITICAL _APC_EPDU_OUTLET_LIST |
apc-epdu_phase_bank_load_status |
Checks the load and status from Phases and Banks |
apc-epdu_phase_bank_load_status |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT |
apc-epdu_pdu_power |
Checks the PDU power consumption |
apc-epdu_pdu_power |
_HOSTSNMPCOMMUNITY _HOSTSNMPVERSION _HOSTSNMPSECURITYNAME _HOSTSNMPAUTHPROTOCOL _HOSTSNMPAUTHKEY _HOSTSNMPPRIVPROTOCOL _HOSTSNMPPRIVKEY _HOSTSNMPSECURITYLEVEL _HOSTSNMPCONTEXT _HOSTPDU_POWER_WARNING _HOSTPDU_POWER_CRITICAL |
DISCOVER SCRIPTS
A monitoring pack can provide discover scripts to automatically gather some macros.
Note
A discover script has the following format:
<_MACRO> : Macro discovered
<script.py> <arguments>: Script and arguments to discover _MACRO
The discover scripts provided by this pack can discover the next macros:
_APC_EPDU_OUTLET_LIST:
wocu-discover-apc-epdu-outlets.py -H $HOSTADDRESS$ -C $_SNMPCOMMUNITY$ -v $_SNMPVERSION$ -u $_SNMPSECURITYNAME$ -a $_SNMPAUTHPROTOCOL$ -A $_SNMPAUTHKEY$ -x $_SNMPPRIVPROTOCOL$ -X $_SNMPPRIVKEY$ -l $_SNMPSECURITYLEVEL$ -n ‘$_SNMPCONTEXT$’ –remote $_POLLER_TAG_ADDRESS$
MACROS
The following macros can be configured in order to modify the pack behaviour for each host that uses it:
SIMPLE MACROS
Name |
Description |
Type |
---|---|---|
_SNMPCOMMUNITY |
The snmp community read configured on remote device |
string |
_SNMPVERSION |
Device SNMP versions supported are: 1, 2c or 3 |
string |
_SNMPSECURITYNAME |
SNMP security name (only snmp v3) |
string |
_SNMPAUTHPROTOCOL |
SNMP authentication type, can be either MD5 or SHA (only snmp v3) |
string |
_SNMPAUTHKEY |
SNMP authentication key (only snmp v3) |
string |
_SNMPPRIVPROTOCOL |
SNMP privacy type, can be either AES or DES (only snmp v3) |
string |
_SNMPPRIVKEY |
SNMP privacy key (only snmp v3)’ |
string |
_SNMPSECURITYLEVEL |
SNMP Security level, noAuthNoPriv or authNoPriv or authPriv (only snmp v3) |
string |
_SNMPCONTEXT |
SNMP context name (only snmp v3) |
string |
_PDU_POWER_WARNING |
PDU power warning threshold in Watts |
integer |
_PDU_POWER_CRITICAL |
PDU power critical threshold in Watts |
integer |
_OUTLET_POWER_WARNING |
Outlet power warning threshold in Watts |
integer |
_OUTLET_POWER_CRITICAL |
Outlet power critical threshold in Watts |
integer |
_OUTLET_CURRENT_WARNING |
Outlet current warning threshold in Amps |
float |
_OUTLET_CURRENT_CRITICAL |
Outlet current critical threshold in Amps |
float |
COMPLEX MACROS
_APC_EPDU_OUTLET_LIST
Description: List of outlets
Discover: wocu-discover-apc-epdu-outlets.py
Fields |
Description |
Type |
---|---|---|
display_name |
Outlet name used in service description. Must be unique |
string |
index |
OID index used in SNMP queries. Must be unique |
integer |
name |
Outlet name |
string |