org.miloss.fgsms.osagent

Class OSAgent

java.lang.Object

org.miloss.fgsms.osagent.OSAgent

public class OSAgent
extends Object

fgsms's Operating System agent Provides monitoring and some SLA processing for the machine as a whole or processes running on a machine. Uses the SIGARS API provided by VMWare


FAQ: How to change the reporting rate of os (machine and process monitor) agents?
OS Agents use two different timers.

1. 1) update the running process list, hardware and network information. This is referred to as the refresh rate.
2. 2) update the current status and performnace data. This is referred to as the Reporting Frequency.

The RF is changed via the global configuration setting, Agents.Process, ReportingFrequency.

However, changes with this value are by default updated

• when the agent starts
• once an hour

Since 6.2.1. To increase the rate, a command line option can be added to the os agent's startup script with overrides the default refresh rate to whatever you want, measured in ms. This will generate slightly more load on the machine hosting the agent, and will add additional bandwidth consumption if it is turned down from the defaults. Use the following option -DrefreshRateOverride=(some duration in milliseconds) Since 6.3, OS Agents can now report sensor data back to fgsms. To configure a sensor data feed, a properties file must be provided. Either place sensor.properties in the current working directory or use -DsensorProviders=path to provide the configuration.

The properties file needs only a single setting, sensorProviders with a value equal to a comma delimited list of classes that implement the ISensorProvider interface.

Since:

RC6

Author:

AO

See Also:

ISensorProvider, SensorProviderFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	OSAgent.RunWhenShuttingDown

Field Summary

Fields

Modifier and Type	Field and Description
protected int	callback_port
protected int	currentportattempts
long	datasend_failures
long	datasend_success
static Logger	log
protected int	maxportattempts
protected boolean	running
long	startedat

Constructor Summary

Constructors

Constructor and Description
OSAgent()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	fire() Fetches the most recent performance data, sends it to fgsms, then performs some basic
protected static MachineInformation	gatherInformation() Gathers the current machine information
SecurityWrapper	getClasslevel()
SecurityWrapper	getClassLevelAsCopy()
protected static List<DriveInformation>	getDriveInfo()
protected MachinePerformanceData	getMachineInfo(MachinePolicy machine) Get machine information, such as current cpu, memory, disk, nic usage
protected static List<String>	getServiceList(boolean isWindows) Returns a list of running processes, if windows, the windows installed service list is also included
static void	main(String[] args)
protected void	startSensorFeeds()
protected void	startup(String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

public static final Logger log

running

protected boolean running

startedat

public long startedat

datasend_success

public long datasend_success

datasend_failures

public long datasend_failures

callback_port

protected int callback_port

maxportattempts

protected int maxportattempts

currentportattempts

protected int currentportattempts

Constructor Detail

OSAgent

public OSAgent()
        throws DatatypeConfigurationException

Throws:

DatatypeConfigurationException

Method Detail

main

public static void main(String[] args)
                 throws Exception

Parameters:

args - the command line arguments

Throws:

Exception

gatherInformation

protected static MachineInformation gatherInformation()
                                               throws org.hyperic.sigar.SigarException

Gathers the current machine information

Returns:

Throws:

org.hyperic.sigar.SigarException

getServiceList

protected static List<String> getServiceList(boolean isWindows)
                                      throws org.hyperic.sigar.SigarException

Returns a list of running processes, if windows, the windows installed service list is also included

Parameters:

isWindows -

Returns:

Throws:

org.hyperic.sigar.SigarException

startup

protected void startup(String[] args)
                throws Exception

Throws:

Exception

getClasslevel

public SecurityWrapper getClasslevel()

getClassLevelAsCopy

public SecurityWrapper getClassLevelAsCopy()

fire

protected void fire()
             throws ConfigurationException,
                    org.hyperic.sigar.SigarException,
                    DatatypeConfigurationException

Fetches the most recent performance data, sends it to fgsms, then performs some basic

Throws:

ConfigurationException

org.hyperic.sigar.SigarException

DatatypeConfigurationException

getDriveInfo

protected static List<DriveInformation> getDriveInfo()
                                              throws org.hyperic.sigar.SigarException

Throws:

org.hyperic.sigar.SigarException

getMachineInfo

protected MachinePerformanceData getMachineInfo(MachinePolicy machine)
                                         throws DatatypeConfigurationException,
                                                org.hyperic.sigar.SigarException,
                                                ConfigurationException

Get machine information, such as current cpu, memory, disk, nic usage

Parameters:

machine -

Returns:

Throws:

DatatypeConfigurationException

org.hyperic.sigar.SigarException

ConfigurationException

startSensorFeeds

protected void startSensorFeeds()