SystemMonitoring

java.lang.Object
- de.uni_hildesheim.sse.monitoring.runtime.recording.SystemMonitoring

```
public class SystemMonitoring
extends java.lang.Object
```
Does basic monitoring of the underlying operating system.

Since:

1.00

Version:

1.20

Author:

Holger Eichelberger

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`SystemMonitoring.LoadCounterTask` A runnable for periodically collecting measurements on the system.
`private static class`	`SystemMonitoring.LogEventTask` Defines a task for creating regular data events.
`private static class`	`SystemMonitoring.SystemConfigurationListener` Implements a configuration listener in order to react to selected configuration changes at runtime.

Field Summary

Fields
Modifier and Type	Field and Description
`private static boolean`	`accountForJvmIo` Account for JVM I/O.
`private static boolean`	`accountForProcessData` Account for process data.
`private static boolean`	`accountForSystemIo` Account for System I/O.
`private static double`	`jvmLoadSum` Stores the sum of all JVM loads.
`private static long`	`jvmMemUseSum` Stores the sum of all JVM memory usages.
`private static SystemMonitoring.LoadCounterTask`	`LOAD_COUNTER` Stores the load and statistics collecting thread.
`static long`	`LOAD_COUNTER_PERIOD` Stores the (default) timer execution period for the load counter.
`private static long`	`loadTickCount` Stores the number of load ticks (probes) taken.
`private static SystemMonitoring.LogEventTask`	`logEventTask` Stores the load and statistics collecting thread.
`static de.uni_hildesheim.sse.system.IMemoryDataGatherer`	`MEMORY_DATA_GATHERER` Stores the memory data gatherer.
`private static int`	`outIntervalCount` Stores the number of elapsed out interval counts.
`private static de.uni_hildesheim.sse.system.IThisProcessDataGatherer`	`PROCESS_DATA_GATHERER` Stores the process data gatherer.
`private static ProcessData`	`processData` Stores the local process data object used for collecting minimum and maximum information.
`private static de.uni_hildesheim.sse.system.IProcessorDataGatherer`	`PROCESSOR_DATA_GATHERER` Stores the processor data gatherer.
`private static double`	`sysLoadSum` Stores the sum of all system loads.
`private static long`	`sysMemUseSum` Stores the sum of all system memory usages.
`private static de.uni_hildesheim.sse.system.IThreadDataGatherer`	`THREAD_DATA_GATHERER` Stores the thread data gatherer.
`private static java.util.Timer`	`timer` Stores the central timer instance.

Constructor Summary

Constructors
Modifier Constructor and Description

private SystemMonitoring()
Prevents instance creation from outside.

Constructors
Modifier	Constructor and Description
`private`	`SystemMonitoring()` Prevents instance creation from outside.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`finishTimer()` Finishes the load and statistics counting thread.
`static long[]`	`getAllThreadIds()` Returns the ids of all running threads.
`static LongLongHashMap`	`getAllThreadTicks()` Returns the current thread ticks for all threads.
`static long`	`getAllTicks()` Returns the number of all thread ticks (CPU and user) consumed by all threads of this JVM.
`static long`	`getCurrentThreadId()` Returns the current thread id.
`static long`	`getCurrentTicks()` Returns the current ticks, i.e. the consumed thread CPU and thread user time of the current thread.
`static ProcessData`	`getProcessData()` Creates a process data object with the data collected in this class.
`static ThreadsInfo`	`getThreadInfo(long tid, long instanceid)` Returns information about the currently running thread and other (monitored and unmonitored remaining threads).
`static long`	`getTicks(long threadId)` Returns the ticks of the given thread.
`static void`	`startTimer()` Starts the load and statistics counting thread.
`static void`	`stopTimer()` Suspends the load and statistics counting thread.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LOAD_COUNTER_PERIOD
```
public static final long LOAD_COUNTER_PERIOD
```
    Stores the (default) timer execution period for the load counter.
    
    See Also:
    
    Constant Field Values
  - MEMORY_DATA_GATHERER
```
public static final de.uni_hildesheim.sse.system.IMemoryDataGatherer MEMORY_DATA_GATHERER
```
    Stores the memory data gatherer.
  - THREAD_DATA_GATHERER
```
private static final de.uni_hildesheim.sse.system.IThreadDataGatherer THREAD_DATA_GATHERER
```
    Stores the thread data gatherer.
  - PROCESS_DATA_GATHERER
```
private static final de.uni_hildesheim.sse.system.IThisProcessDataGatherer PROCESS_DATA_GATHERER
```
    Stores the process data gatherer.
  - PROCESSOR_DATA_GATHERER
```
private static final de.uni_hildesheim.sse.system.IProcessorDataGatherer PROCESSOR_DATA_GATHERER
```
    Stores the processor data gatherer.
  - timer
```
private static java.util.Timer timer
```
    Stores the central timer instance.
  - sysLoadSum
```
private static double sysLoadSum
```
    Stores the sum of all system loads.
  - processData
```
private static ProcessData processData
```
    Stores the local process data object used for collecting minimum and maximum information.
  - jvmLoadSum
```
private static double jvmLoadSum
```
    Stores the sum of all JVM loads.
  - jvmMemUseSum
```
private static long jvmMemUseSum
```
    Stores the sum of all JVM memory usages.
  - sysMemUseSum
```
private static long sysMemUseSum
```
    Stores the sum of all system memory usages.
  - loadTickCount
```
private static long loadTickCount
```
    Stores the number of load ticks (probes) taken.
  - accountForJvmIo
```
private static boolean accountForJvmIo
```
    Account for JVM I/O.
  - accountForSystemIo
```
private static boolean accountForSystemIo
```
    Account for System I/O.
  - accountForProcessData
```
private static boolean accountForProcessData
```
    Account for process data.
  - outIntervalCount
```
private static int outIntervalCount
```
    Stores the number of elapsed out interval counts. Initialized to -1 to force output on first opportunity depending on Configuration.getOutInterval().
  - LOAD_COUNTER
```
private static final SystemMonitoring.LoadCounterTask LOAD_COUNTER
```
    Stores the load and statistics collecting thread.
  - logEventTask
```
private static SystemMonitoring.LogEventTask logEventTask
```
    Stores the load and statistics collecting thread.
- Constructor Detail
  - SystemMonitoring
```
private SystemMonitoring()
```
    Prevents instance creation from outside.
    
    Since:
    
    1.00
- Method Detail
  - getAllTicks
```
public static final long getAllTicks()
```
    Returns the number of all thread ticks (CPU and user) consumed by all threads of this JVM.
    
    Returns:
    
    the number of all ticks
    
    Since:
    
    1.00
  - getCurrentTicks
```
public static final long getCurrentTicks()
```
    Returns the current ticks, i.e. the consumed thread CPU and thread user time of the current thread.
    
    Returns:
    
    the current thread ticks
    
    Since:
    
    1.00
  - getTicks
```
public static final long getTicks(long threadId)
```
    Returns the ticks of the given thread.
    
    Parameters:
    
    threadId - the id of the thread to return the ticks for
    
    Returns:
    
    the current thread ticks
    
    Since:
    
    1.00
  - getAllThreadTicks
```
public static final LongLongHashMap getAllThreadTicks()
```
    Returns the current thread ticks for all threads. The keys contain the thread ids, the values the current thread ticks.
    
    Returns:
    
    the current id-tick mapping
    
    Since:
    
    1.00
  - getAllThreadIds
```
public static long[] getAllThreadIds()
```
    Returns the ids of all running threads.
    
    Returns:
    
    the ids of all running threads
    
    Since:
    
    1.00
  - startTimer
```
public static void startTimer()
```
    Starts the load and statistics counting thread.
    
    Since:
    
    1.00
  - stopTimer
```
public static void stopTimer()
```
    Suspends the load and statistics counting thread.
    
    Since:
    
    1.00
  - finishTimer
```
public static void finishTimer()
```
    Finishes the load and statistics counting thread.
    
    Since:
    
    1.00
  - getThreadInfo
```
public static ThreadsInfo getThreadInfo(long tid,
                                        long instanceid)
```
    Returns information about the currently running thread and other (monitored and unmonitored remaining threads). This information is relevant
    
    Parameters:
    
    tid - the thread id
    
    instanceid - the instance id (disabled if 0)
    
    Returns:
    
    the information object on currently running threads
    
    Since:
    
    1.20
  - getCurrentThreadId
```
public static long getCurrentThreadId()
```
    Returns the current thread id. This method was inserted in order to be adjusted in case of native monitoring.
    
    Returns:
    
    the identification of the current thread
    
    Since:
    
    1.00
  - getProcessData
```
public static ProcessData getProcessData()
```
    Creates a process data object with the data collected in this class.
    
    Returns:
    
    a process data object, must be released by ProcessData.POOL, may be null if not available
    
    Since:
    
    1.00

Class SystemMonitoring

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOAD_COUNTER_PERIOD

MEMORY_DATA_GATHERER

THREAD_DATA_GATHERER

PROCESS_DATA_GATHERER

PROCESSOR_DATA_GATHERER

timer

sysLoadSum

processData

jvmLoadSum

jvmMemUseSum

sysMemUseSum

loadTickCount

accountForJvmIo

accountForSystemIo

accountForProcessData

outIntervalCount

LOAD_COUNTER

logEventTask

Constructor Detail

SystemMonitoring

Method Detail

getAllTicks

getCurrentTicks

getTicks

getAllThreadTicks

getAllThreadIds

startTimer

stopTimer

finishTimer

getThreadInfo

getCurrentThreadId

getProcessData