/*******************************************************************************
* This file is part of OpenNMS(R).
*
* Copyright (C) 2008-2011 The OpenNMS Group, Inc.
* OpenNMS(R) is Copyright (C) 1999-2011 The OpenNMS Group, Inc.
*
* OpenNMS(R) is a registered trademark of The OpenNMS Group, Inc.
*
* OpenNMS(R) is free software: you can redistribute it and/or modify
* it under the 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.
*
* OpenNMS(R) 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.
*
* You should have received a copy of the GNU General Public License
* along with OpenNMS(R). If not, see:
* http://www.gnu.org/licenses/
*
* For more information contact:
* OpenNMS(R) Licensing <license@opennms.org>
* http://www.opennms.org/
* http://www.opennms.com/
*******************************************************************************/
package org.opennms.netmgt.poller.monitors;
import java.io.IOException;
import java.lang.reflect.UndeclaredThrowableException;
import java.net.InetAddress;
import java.util.Map;
import org.apache.log4j.Level;
import org.opennms.core.utils.InetAddressUtils;
import org.opennms.core.utils.ParameterMap;
import org.opennms.netmgt.config.SnmpPeerFactory;
import org.opennms.netmgt.model.PollStatus;
import org.opennms.netmgt.poller.Distributable;
import org.opennms.netmgt.poller.DistributionContext;
import org.opennms.netmgt.poller.MonitoredService;
import org.opennms.netmgt.poller.NetworkInterface;
import org.opennms.netmgt.snmp.SnmpAgentConfig;
import org.opennms.netmgt.snmp.SnmpInstId;
import org.opennms.netmgt.snmp.SnmpObjId;
import org.opennms.netmgt.snmp.SnmpUtils;
import org.opennms.netmgt.snmp.SnmpValue;
import antlr.StringUtils;
/**
* <P>
* This class is designed to be used by the service poller framework to test the
* status of services reported in the Host Resources SW Run Table. The class implements
* the ServiceMonitor interface that allows it to be used along with other
* plug-ins by the service poller framework.
* </P>
* <p>
* This does SNMP and therefore relies on the SNMP configuration so it is not distributable.
* </p>
*
* @author <A HREF="mailto:tarus@opennms.org">Tarus Balog </A>
* @author <A HREF="http://www.opennms.org/">OpenNMS </A>
*/
@Distributable(DistributionContext.DAEMON)
public class HostResourceSwRunMonitor extends SnmpMonitorStrategy {
/**
* Name of monitored service.
*/
private static final String SERVICE_NAME = "HOST-RESOURCES";
/**
* Default OID for the table that represents the name of the software running.
*/
private static final String HOSTRESOURCE_SW_NAME_OID = ".1.3.6.1.2.1.25.4.2.1.2";
/**
* Default OID for the table that represents the status of the software running.
*/
private static final String HOSTRESOURCE_SW_STATUS_OID = ".1.3.6.1.2.1.25.4.2.1.7";
/**
* <P>
* Returns the name of the service that the plug-in monitors ("SNMP").
* </P>
*
* @return The service that the plug-in monitors.
*/
public String serviceName() {
return SERVICE_NAME;
}
/**
* {@inheritDoc}
*
* <P>
* Initialize the service monitor.
* </P>
* @exception RuntimeException
* Thrown if an unrecoverable error occurs that prevents the
* plug-in from functioning.
*/
public void initialize(Map<String, Object> parameters) {
// Initialize the SnmpPeerFactory
//
try {
SnmpPeerFactory.init();
} catch (IOException ex) {
log().fatal("initialize: Failed to load SNMP configuration", ex);
throw new UndeclaredThrowableException(ex);
}
return;
}
/**
* <P>
* Called by the poller framework when an interface is being added to the
* scheduler. Here we perform any necessary initialization to prepare the
* NetworkInterface object for polling.
* </P>
*
* @exception RuntimeException
* Thrown if an unrecoverable error occurs that prevents the
* interface from being monitored.
* @param svc a {@link org.opennms.netmgt.poller.MonitoredService} object.
*/
public void initialize(MonitoredService svc) {
super.initialize(svc);
return;
}
/**
* {@inheritDoc}
*
* <P>
* The poll() method is responsible for polling the specified address for
* SNMP service availability.
* </P>
* @exception RuntimeException
* Thrown for any uncrecoverable errors.
*/
public PollStatus poll(MonitoredService svc, Map<String, Object> parameters) {
NetworkInterface<InetAddress> iface = svc.getNetInterface();
InetAddress ipaddr = (InetAddress) iface.getAddress();
// Retrieve this interface's SNMP peer object
//
SnmpAgentConfig agentConfig = SnmpPeerFactory.getInstance().getAgentConfig(ipaddr);
if (agentConfig == null) throw new RuntimeException("SnmpAgentConfig object not available for interface " + ipaddr);
final String hostAddress = InetAddressUtils.str(ipaddr);
log().debug("poll: setting SNMP peer attribute for interface " + hostAddress);
// Get configuration parameters
//
// This should never need to be overridden, but it can be in order to be used with similar tables.
String serviceNameOid = ParameterMap.getKeyedString(parameters, "service-name-oid", HOSTRESOURCE_SW_NAME_OID);
// This should never need to be overridden, but it can be in order to be used with similar tables.
String serviceStatusOid = ParameterMap.getKeyedString(parameters, "service-status-oid", HOSTRESOURCE_SW_STATUS_OID);
// This is the string that represents the service name to be monitored.
String serviceName = ParameterMap.getKeyedString(parameters, "service-name", null);
// The service name may appear in the table more than once. If this is set to true, all values must match the run level.
String matchAll = ParameterMap.getKeyedString(parameters, "match-all", "false");
// This is one of:
// running(1),
// runnable(2), -- waiting for resource
// -- (i.e., CPU, memory, IO)
// notRunnable(3), -- loaded but waiting for event
// invalid(4) -- not loaded
//
// This represents the maximum run-level, i.e. 2 means either running(1) or runnable(2) pass.
String runLevel = ParameterMap.getKeyedString(parameters, "run-level", "2");
// If "match-all" is true, there can be an optional "min-services" and "max-services" parameters that can define a range. The service is up if:
// a) services_count >= min-services and services_count <= max-services
// b) either one is not defined, then only one has to pass.
// c) neither are defined, the monitor acts just like it used to - checking all instances to see if they are all running.
// It is assumed that all services would have to pass the minimum run state test, no matter what the count.
int minServices = ParameterMap.getKeyedInteger(parameters, "min-services", -1);
int maxServices = ParameterMap.getKeyedInteger(parameters, "max-services", -1);
// set timeout and retries on SNMP peer object
//
agentConfig.setTimeout(ParameterMap.getKeyedInteger(parameters, "timeout", agentConfig.getTimeout()));
agentConfig.setRetries(ParameterMap.getKeyedInteger(parameters, "retry", ParameterMap.getKeyedInteger(parameters, "retries", agentConfig.getRetries())));
agentConfig.setPort(ParameterMap.getKeyedInteger(parameters, "port", agentConfig.getPort()));
if (log().isDebugEnabled()) log().debug("poll: service= SNMP address= " + agentConfig);
PollStatus status = PollStatus.unavailable("HostResourceSwRunMonitor service not found, addr=" + hostAddress + ", service-name=" + serviceName);
// Establish SNMP session with interface
//
int matches = 0;
try {
if (log().isDebugEnabled()) {
log().debug("HostResourceSwRunMonitor.poll: SnmpAgentConfig address: " +agentConfig);
}
if (serviceName == null) {
status.setReason("HostResourceSwRunMonitor no service-name defined, addr=" + hostAddress);
log().warn("HostResourceSwRunMonitor.poll: No Service Name Defined! ");
return status;
}
if (minServices > 0 && maxServices > 0 && minServices >= maxServices) {
String reason = "min-services(" + minServices + ") should be less than max-services(" + maxServices + ")";
status.setReason("HostResourceSwRunMonitor " + reason + ", addr=" + hostAddress+ ", service-name=" + serviceName);
log().warn("HostResourceSwRunMonitor.poll: " + reason + ".");
return status;
}
// This returns two maps: one of instance and service name, and one of instance and status.
Map<SnmpInstId, SnmpValue> nameResults = SnmpUtils.getOidValues(agentConfig, "HostResourceSwRunMonitor", SnmpObjId.get(serviceNameOid));
Map<SnmpInstId, SnmpValue> statusResults = SnmpUtils.getOidValues(agentConfig, "HostResourceSwRunMonitor", SnmpObjId.get(serviceStatusOid));
// Iterate over the list of running services
for(SnmpInstId nameInstance : nameResults.keySet()) {
// See if the service name is in the list of running services
if (match(serviceName, stripExtraQuotes(nameResults.get(nameInstance).toString()))) {
matches++;
log().debug("poll: HostResourceSwRunMonitor poll succeeded, addr=" + hostAddress + ", service-name=" + serviceName + ", value=" + nameResults.get(nameInstance));
// Using the instance of the service, get its status and see if it meets the criteria
if (meetsCriteria(statusResults.get(nameInstance), "<=", runLevel)) {
status = PollStatus.available();
// If we get here, that means the service passed the criteria, if only one match is desired we exit.
if ("false".equals(matchAll)) {
return status;
}
// if we get here, that means the meetsCriteria test failed.
} else {
status = logDown(Level.DEBUG, "HostResourceSwRunMonitor poll failed, addr=" + hostAddress + ", service-name=" + serviceName + ", status=" + statusResults.get(nameInstance));
return status;
}
}
}
log().debug("poll: HostResourceSwRunMonitor the number of matches found for " + serviceName + " was " + matches);
} catch (NumberFormatException e) {
status = logDown(Level.ERROR, "Number operator used on a non-number " + e.getMessage());
} catch (IllegalArgumentException e) {
status = logDown(Level.ERROR, "Invalid SNMP Criteria: " + e.getMessage());
} catch (Throwable t) {
status = logDown(Level.WARN, "Unexpected exception during SNMP poll of interface " + hostAddress, t);
}
// This will be executed only if match-all=true
boolean minOk = minServices > 0 ? matches >= minServices : true;
boolean maxOk = maxServices > 0 ? matches <= maxServices : true;
if (!minOk && maxServices < 0) { // failed min-services only
status = logDown(Level.DEBUG, "HostResourceSwRunMonitor poll failed: service-count(" + matches + ") >= min-services(" + minServices + "), addr=" + hostAddress + ", service-name=" + serviceName);
}
if (!maxOk && minServices < 0) { // failed max-services only
status = logDown(Level.DEBUG, "HostResourceSwRunMonitor poll failed: service-count(" + matches + ") <= max-services(" + maxServices + "), addr=" + hostAddress + ", service-name=" + serviceName);
}
if ((!minOk || !maxOk) && minServices > 0 && maxServices > 0) { // failed both (bad range)
status = logDown(Level.DEBUG, "HostResourceSwRunMonitor poll failed: min-services(" + minServices + ") >= service-count(" + matches + ") <= max-services(" + maxServices + "), addr=" + hostAddress + ", service-name=" + serviceName);
}
// If matchAll is set to true, then the status is set to available above with a single match.
// Otherwise, the service will be unavailable.
return status;
}
private boolean match(String expectedText, String currentText) {
if (expectedText.startsWith("~")) {
return currentText.matches(expectedText.replaceFirst("~", ""));
}
return currentText.equalsIgnoreCase(expectedText);
}
private static String stripExtraQuotes(String string) {
return StringUtils.stripFrontBack(string, "\"", "\"");
}
}