diff --git a/build/hpux/hc_hpux_platform/hc_hpux_platform.psf b/build/hpux/hc_hpux_platform/hc_hpux_platform.psf index ec7cf21..c08d595 100644 --- a/build/hpux/hc_hpux_platform/hc_hpux_platform.psf +++ b/build/hpux/hc_hpux_platform/hc_hpux_platform.psf @@ -69,7 +69,8 @@ This is the OS/platform plugin package" file -m 755 check_hpux_guid_status.sh file -m 644 check_hpux_hpvm_vpar_status.sh file -m 755 check_hpux_httpd_status.sh - file -m 755 check_hpux_kernel_params.sh + file -m 755 check_hpux_kernel_params.sh + file -m 755 check_hpux_kernel_usage.sh file -m 755 check_hpux_named_status.sh file -m 755 check_hpux_ntp_status.sh file -m 755 check_hpux_ovpa_status.sh @@ -105,6 +106,7 @@ This is the OS/platform plugin package" file -m 644 check_hpux_ignite_backup.conf.dist file -m 644 check_hpux_ioscan.conf.dist file -m 644 check_hpux_kernel_params.conf.dist + file -m 644 check_hpux_kernel_usage.conf.dist file -m 644 check_hpux_ntp_status.conf.dist file -m 644 check_hpux_root_crontab.conf.dist file -m 644 check_hpux_sg_package_status.conf.dist diff --git a/configs/etc/check_hpux_kernel_usage.conf.dist b/configs/etc/check_hpux_kernel_usage.conf.dist new file mode 100644 index 0000000..d1775e4 --- /dev/null +++ b/configs/etc/check_hpux_kernel_usage.conf.dist @@ -0,0 +1,27 @@ +#****************************************************************************** +# @(#) check_hpux_kernel_usage.conf +#****************************************************************************** +# This is a configuration file for the check_hpux_kernel_usage HC plugin. +# All lines starting with a '#' are comment lines. +# [default: indicates hardcoded script values if no value is defined here] +#****************************************************************************** + +# specify a general maximum usage threshold (percentage) +# [ default: 90% ] +max_kcusage=90 + +# specify individual kernel parameters and their maximum usage threshold (percentage) +# definitions here will overrides max_kcusage for these parameters +# [param::] +param:nproc:70 + +# specify parameters that should be excluded from the check +# comma-separated list (as shown by kctune/kcusage) +# (does not override param:: lines from above) +# [ default: none ] +exclude_params="" + + +#****************************************************************************** +# End of FILE +#****************************************************************************** \ No newline at end of file diff --git a/sources/lib/platform/hp-ux/check_hpux_kernel_usage.sh b/sources/lib/platform/hp-ux/check_hpux_kernel_usage.sh new file mode 100644 index 0000000..77aefef --- /dev/null +++ b/sources/lib/platform/hp-ux/check_hpux_kernel_usage.sh @@ -0,0 +1,208 @@ +#!/usr/bin/env ksh +#****************************************************************************** +# @(#) check_hpux_kernel_usage.sh +#****************************************************************************** +# @(#) Copyright (C) 2017 by KUDOS BVBA (info@kudos.be). All rights reserved. +# +# This program is a free software; you can redistribute it and/or modify +# it under the same terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details +#****************************************************************************** +# +# DOCUMENTATION (MAIN) +# ----------------------------------------------------------------------------- +# @(#) MAIN: check_hpux_kernel_usage +# DOES: see _show_usage() +# EXPECTS: see _show_usage() +# REQUIRES: data_space2comma(), init_hc(), log_hc() +# +# @(#) HISTORY: +# @(#) 2017-12-22: original version [Patrick Van der Veken] +# ----------------------------------------------------------------------------- +# DO NOT CHANGE THIS FILE UNLESS YOU KNOW WHAT YOU ARE DOING! +#****************************************************************************** + +# ----------------------------------------------------------------------------- +function check_hpux_kernel_usage +{ +# ------------------------- CONFIGURATION starts here ------------------------- +typeset _CONFIG_FILE="${CONFIG_DIR}/$0.conf" +typeset _KCUSAGE_BIN="/usr/sbin/kcusage" +typeset _VERSION="2018-01-05" # YYYY-MM-DD +typeset _SUPPORTED_PLATFORMS="HP-UX" # uname -s match +# ------------------------- CONFIGURATION ends here --------------------------- + +# set defaults +(( ARG_DEBUG != 0 && ARG_DEBUG_LEVEL > 0 )) && set ${DEBUG_OPTS} +init_hc "$0" "${_SUPPORTED_PLATFORMS}" "${_VERSION}" +typeset _ARGS=$(data_space2comma "$*") +typeset _ARG="" +typeset _MSG="" +typeset _STC=0 +typeset _MAX_KCUSAGE=0 +typeset _EXCLUDED_PARAMS="" +typeset _HANDLED_PARAMS="" +typeset _PARAM_NAME="" +typeset _CONFIG_VALUE="" +typeset _CEIL_VALUE="" +typeset _CHECK_VALUE="" +typeset _CURR_VALUE="" +typeset _FOUND_PARAM=0 +typeset _KCUSAGE_LINE="" +typeset _LINE_COUNT=1 +typeset _DUMMY="" + +# handle arguments (originally comma-separated) +for _ARG in ${_ARGS} +do + case "${_ARG}" in + help) + _show_usage $0 ${_VERSION} ${_CONFIG_FILE} && return 0 + ;; + esac +done + +# handle configuration file +[[ -n "${ARG_CONFIG_FILE}" ]] && _CONFIG_FILE="${ARG_CONFIG_FILE}" +if [[ ! -r ${_CONFIG_FILE} ]] +then + warn "unable to read configuration file at ${_CONFIG_FILE}" + return 1 +fi +# read required configuration values +_MAX_KCUSAGE=$(_CONFIG_FILE="${_CONFIG_FILE}" data_get_lvalue_from_config 'max_kcusage') +if [[ -z "${_MAX_KCUSAGE}" ]] +then + # default + _IGNORE_FS=90 +fi +_EXCLUDED_PARAMS=$(_CONFIG_FILE="${_CONFIG_FILE}" data_get_lvalue_from_config 'exclude_params') +if [[ -n "${_EXCLUDED_PARAMS}" ]] +then + log "excluding following kernel parameters: ${_EXCLUDED_PARAMS}" +fi + +# check & get kcusage information +if [[ ! -x ${_KCUSAGE_BIN} ]] +then + warn "kcusage is not installed here (not HP-UX 11.31?)" + return 1 +else + ${_KCUSAGE_BIN} >>${HC_STDOUT_LOG} 2>>${HC_STDERR_LOG} + if (( $? != 0 )) + then + _MSG="unable to gather kcusage information" + log_hc "$0" 1 "${_MSG}" + return 0 + fi +fi + +# check configuration values +grep -i '^param:' ${_CONFIG_FILE} 2>/dev/null |\ + while IFS=':' read _DUMMY _PARAM_NAME _CONFIG_VALUE +do + # check for empties + if [[ -z "${_PARAM_NAME}" || -z "${_CONFIG_VALUE}" ]] + then + warn "missing parameter name and/or value in configuration file ${_CONFIG_FILE} at data line ${_LINE_COUNT}" + return 1 + fi + # check if the kernel parameter is valid + _FOUND_PARAM=$(awk '{ print $1 }' ${HC_STDOUT_LOG} 2>/dev/null | grep -c -E -e "^${_PARAM_NAME}$") + if (( _FOUND_PARAM == 0 )) + then + warn "parameter '${_PARAM_NAME}' in configuration file ${_CONFIG_FILE} at data line ${_LINE_COUNT} is not an existing kernel parameter" + return 1 + fi + _LINE_COUNT=$(( _LINE_COUNT + 1 )) +done + +# 1) perform checks (first the invidually configured ones) +grep -i '^param:' ${_CONFIG_FILE} 2>/dev/null |\ + while IFS=':' read _DUMMY _PARAM_NAME _CONFIG_VALUE +do + # check for actual values and ceilings + _CURR_VALUE=$(grep -E -e "^${_PARAM_NAME}[ \t].*" ${HC_STDOUT_LOG} 2>/dev/null | awk '{ print $2 }') + _CEIL_VALUE=$(grep -E -e "^${_PARAM_NAME}[ \t].*" ${HC_STDOUT_LOG} 2>/dev/null | awk '{ print $4 }') + + _CHECK_VALUE=$(( (_CURR_VALUE * 100 ) / _CEIL_VALUE )) + + if (( _CHECK_VALUE > _CONFIG_VALUE )) + then + _MSG="${_PARAM_NAME} has exceeded its individual threshold (${_CHECK_VALUE} > ${_CONFIG_VALUE})" + _STC=1 + else + _MSG="${_PARAM_NAME} is below its individual threshold (${_CHECK_VALUE} <= ${_CONFIG_VALUE})" + fi + # push to handled list + _HANDLED_PARAMS="${_HANDLED_PARAMS}\n${_PARAM_NAME}" + + # handle unit result + log_hc "$0" ${_STC} "${_MSG}" "${_CHECK_VALUE}" "${_CONFIG_VALUE}" + _STC=0 +done + +# perform checks (second the ones mapping the general threshold) +cat ${HC_STDOUT_LOG} 2>/dev/null | tail -n +3 | while read _KCUSAGE_LINE +do + _PARAM_NAME=$(print "${_KCUSAGE_LINE}" | awk '{ print $1 }') + + # parameter excluded? + if (( $(print "${_EXCLUDED_PARAMS}" | tr ',' '\n' | grep -c -E -e "${_PARAM_NAME}") != 0 )) + then + (( ARG_DEBUG != 0 )) && debug "excluding kernel parameter ${_PARAM_NAME} ..." + continue + fi + + # parameter already handled? + if (( $(print "${_HANDLED_PARAMS}" | grep -c -E -e "${_PARAM_NAME}") == 0 )) + then + # check for actual values and ceilings + _CURR_VALUE=$(print "${_KCUSAGE_LINE}" | awk '{ print $2 }') + _CEIL_VALUE=$(print "${_KCUSAGE_LINE}" | awk '{ print $4 }') + + _CHECK_VALUE=$(( (_CURR_VALUE * 100 ) / _CEIL_VALUE )) + + if (( _CHECK_VALUE > _MAX_KCUSAGE )) + then + _MSG="${_PARAM_NAME} has exceeded the general threshold (${_CURR_VALUE} > ${_MAX_KCUSAGE})" + _STC=1 + else + _MSG="${_PARAM_NAME} is below the general threshold (${_CHECK_VALUE} <= ${_MAX_KCUSAGE})" + fi + fi + + # handle unit result + log_hc "$0" ${_STC} "${_MSG}" "${_CHECK_VALUE}" "${_MAX_KCUSAGE}" + _STC=0 +done + +return 0 +} + +# ----------------------------------------------------------------------------- +function _show_usage +{ +cat <<- EOT +NAME : $1 +VERSION : $2 +CONFIG : $3 with formatted stanzas: + param:: + Other options: + max_kcusage= + exclude_params= +PURPOSE : Checks the current usage of kernel paremeter resources + +EOT + +return 0 +} + +#****************************************************************************** +# END of script +#******************************************************************************