diff --git a/plugins/emc/emc_vnx_block_lun_perfdata b/plugins/emc/emc_vnx_block_lun_perfdata index 83219830..59284b38 100755 --- a/plugins/emc/emc_vnx_block_lun_perfdata +++ b/plugins/emc/emc_vnx_block_lun_perfdata @@ -1,78 +1,93 @@ #!/bin/bash -###################################################################################################################### -# Plugin to monitor basic statistics of EMC VNX 5300 Unified Datamovers # -###################################################################################################################### -# Author: Evgeny Beysembaev +: <<=cut -##################################### -# Description # -##################################### +=head1 NAME -# The plugin monitors LUN of EMC Unified Storage FLARE SP's. Probably it can also be compatible with -# other Clariion systems. It uses SSH to connect to Control Stations, then remotely executes -# /nas/sbin/navicli and fetches and parses data from it. Obviously, it's easy to reconfigure plugin not to use -# Control Stations' navicli in favor of using locally installed /opt/Navisphere's cli. There is no difference which -# Storage Processor to use to gather data, so this plugin tries both of them and uses the first active one. -# This plugin also automatically chooses Primary Control Station from the list by calling /nasmcd/sbin/getreason and -# /nasmcd/sbin/t2slot. -# -# I left some parts of this plugin as rudimental to make easy to reconfigure it to draw more (or less) data. + emc_vnx_block_lun_perfdata - Plugin to monitor Block statistics of EMC VNX 5300 Unified Storage Processors + +=head1 AUTHOR + + Evgeny Beysembaev + +=head1 LICENSE + + GPLv2 + +=head1 MAGIC MARKERS + + #%# family=auto + #%# capabilities=autoconf + +=head1 DESCRIPTION + + The plugin monitors LUN of EMC Unified Storage FLARE SP's. Probably it can also be compatible with + other Clariion systems. It uses SSH to connect to Control Stations, then remotely executes + /nas/sbin/navicli and fetches and parses data from it. Obviously, it's easy to reconfigure plugin not to use + Control Stations' navicli in favor of using locally installed /opt/Navisphere's cli. There is no difference which + Storage Processor to use to gather data, so this plugin tries both of them and uses the first active one. + This plugin also automatically chooses Primary Control Station from the list by calling /nasmcd/sbin/getreason and + /nasmcd/sbin/t2slot. -##################################### -# Configuration # -##################################### + I left some parts of this plugin as rudimental to make easy to reconfigure it to draw more (or less) data. -######### Prerequisites ######### +=head1 COMPATIBILITY -# First of all, be sure that statistics collection is turned on. You can do this by typing: -# navicli -h spa setstats -on -# on your Control Station or locally through /opt/Navisphere + The plugin has been written for being compatible with EMC VNX5300 Storage system, as this is the only EMC storage which + i have. By the way, i am pretty sure it can also work with other VNX1 storages, like VNX5100 and VNX5500, and old-style + Clariion systems. + About VNX2 series, i don't know whether the plugin will be able to work with them. Maybe it would need some corrections + in command-line backend. The same situation is with other EMC systems, so i encourage you to try and fix the plugin. + +=head1 CONFIGURATION -# Also, the plugin actively uses buggy "cdef" feature of Munin, and here we can be hit by the following bugs: -# http://munin-monitoring.org/ticket/1017 - Here I have some workarounds in plugin, be sure that they are working. -# http://munin-monitoring.org/ticket/1352 - -# Metrics in my plugin can be much longer than 15 characters, so you have to edit the following file: -# /usr/share/perl5/Munin/Master/GraphOld.pm -# Find get_field_name() function and change "15" to "255". +=head2 Prerequisites -######### Installation ######### + First of all, be sure that statistics collection is turned on. You can do this by typing: + navicli -h spa setstats -on + on your Control Station or locally through /opt/Navisphere -# The plugin uses SSH to connect to Control Stations. It's possible to use 'nasadmin' user, but it would be better -# if you create read-only global user by Unisphere Client. The user should have only Operator role. -# I created "operator" user but due to the fact that Control Stations already had one internal "operator" user, -# the new one was called "operator1". So be careful. -# -# On munin-node side choose a user which will be used to connect through SSH. Generally user "munin" is ok. Then, -# execute "sudo su munin -s /bin/bash", "ssh-keygen" and "ssh-copy-id" to both Control Stations with newly created -# user. -# -# Make a link from /usr/share/munin/plugins/emc_vnx_dm_basic_stats to /etc/munin/plugins/emc_vnx_dm_basic_stats_, -# where is any arbitrary name of your storage system. The plugin will return in its answer -# as "host_name" field. -# Assume your storage system is called "VNX5300". -# -# Make a configuration file at /etc/munin/plugin-conf.d/emc_vnx_block_lun_perfdata_VNX5300 -# -# [emc_vnx_block_lun_perfdata_VNX5300] -# user munin # SSH Client local user -# env.username operator1 # Remote user with Operator role -# env.cs_addr 192.168.1.1 192.168.1.2 # Control Stations addresses + Also, the plugin actively uses buggy "cdef" feature of Munin, and here we can be hit by the following bugs: + http://munin-monitoring.org/ticket/1017 - Here I have some workarounds in plugin, be sure that they are working. + http://munin-monitoring.org/ticket/1352 - + Metrics in my plugin can be much longer than 15 characters, so you have to edit the following file: + /usr/share/perl5/Munin/Master/GraphOld.pm + Find get_field_name() function and change "15" to "255". -##################################### -# Errata # -##################################### -# It counts Queue Length in not fully correct way. We take parameters totally from both SP's, but after we divide them -# independently by load of SPA and SPB. Anyway, in most AAA / ALUA cases the formula is correct. +=head2 Installation + The plugin uses SSH to connect to Control Stations. It's possible to use 'nasadmin' user, but it would be better + if you create read-only global user by Unisphere Client. The user should have only Operator role. + I created "operator" user but due to the fact that Control Stations already had one internal "operator" user, + the new one was called "operator1". So be careful. + + On munin-node side choose a user which will be used to connect through SSH. Generally user "munin" is ok. Then, + execute "sudo su munin -s /bin/bash", "ssh-keygen" and "ssh-copy-id" to both Control Stations with newly created + user. + + Make a link from /usr/share/munin/plugins/emc_vnx_dm_basic_stats to /etc/munin/plugins/emc_vnx_dm_basic_stats_, + where is any arbitrary name of your storage system. The plugin will return in its answer + as "host_name" field. + Assume your storage system is called "VNX5300". + + Make a configuration file at /etc/munin/plugin-conf.d/emc_vnx_block_lun_perfdata_VNX5300 + + [emc_vnx_block_lun_perfdata_VNX5300] + user munin # SSH Client local user + env.username operator1 # Remote user with Operator role + env.cs_addr 192.168.1.1 192.168.1.2 # Control Stations addresses -##################################### -# History # -##################################### +=head1 ERRATA -# 09.11.2016 - First Release + It counts Queue Length in not fully correct way. We take parameters totally from both SP's, but after we divide them + independently by load of SPA and SPB. Anyway, in most AAA / ALUA cases the formula is correct. -###################################################################################################################### +=head1 HISTORY + + 09.11.2016 - First Release + 26.12.2016 - Compatibility with Munin coding style + +=cut export LANG=C TARGET=$(echo "${0##*/}" | cut -d _ -f 6) diff --git a/plugins/emc/emc_vnx_file_stats b/plugins/emc/emc_vnx_file_stats index ea948e91..95cbee51 100755 --- a/plugins/emc/emc_vnx_file_stats +++ b/plugins/emc/emc_vnx_file_stats @@ -4,7 +4,7 @@ =head1 NAME - emc_vnx_file_stats - Plugin to monitor NFS statistics of EMC VNX 5300 Unified Storage system + emc_vnx_file_stats - Plugin to monitor Basic, NFSv3 and NFSv4 statistics of EMC VNX 5300 Unified Storage system's Datamovers =head1 AUTHOR