de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies

Class InstanceRecorderElement

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderElement

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.DefaultRecorderElement

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.InstanceRecorderElement

All Implemented Interfaces:

IMonitoringGroup

public class InstanceRecorderElement
extends DefaultRecorderElement

A sub-recorder element for a breakdown to individual instances.

Since:

1.20

Version:

1.20

Author:

Holger Eichelberger

Field Summary

Fields

Modifier and Type	Field and Description
private RecorderElement	parent Stores the parent.

Constructor Summary

Constructors

Constructor and Description
InstanceRecorderElement(MonitoringGroupConfiguration conf, RecorderElement parent) Creates an instance.

Method Summary

Modifier and Type	Method and Description
(package private) void	addNetBytes(long netInBytes, long netOutBytes) Adds an external amount of input or output bytes to this recording element.
(package private) void	memoryAllocated(long size) Records an amount of memory allocated by the underlying recording group.
(package private) void	memoryFreed(long size) Records an amount of memory freed within the underlying recording group (memory unallocation).
(package private) void	readIo(int bytes, StreamType type) Records an amount of bytes read from file or from network.
(package private) void	setCpuTimeTicks(long cpuTimeTicks) Sets the current CPI time ticks for finishing recording of the entire program.
(package private) boolean	startTimeRecording(long nanoTime, long threadTicks, long threadId) Start the time recording for this instance.
(package private) boolean	stopTimeRecording(long nanoTime, long threadTicks, long threadId) Stops the time recording for this instance.
(package private) void	timeCorrection(long timeDiff, long threadTimeFraction, boolean decrement, long threadId) Adds (overhead) time correction information.
(package private) void	writeIo(int bytes, StreamType type) Records an amount of bytes written to file or from network.

Methods inherited from class de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.DefaultRecorderElement

copy, getContributing, getContributing, getContributingSize, getCpuTimeTicks, getFileIn, getFileOut, getIoRead, getIoWrite, getMemAllocated, getMemUse, getNetIn, getNetOut, getStartCpuTime, getStartSystemTime, getSystemTimeTicks, updateMemoryFreedFromJvm, wasRecorded

Methods inherited from class de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderElement

accountResource, checkConf, createForTest, getConfiguration, getGroupAccounting, getInstanceRecorderElement, getResources, getVarId, hasDebugStates, instanceRecorderElements, instanceRecorderIds, isIndirectAccounting, isVisible, setVarId

Methods inherited from class java.lang.Object

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

Field Detail

parent

private RecorderElement parent

Stores the parent.

Constructor Detail

InstanceRecorderElement

InstanceRecorderElement(MonitoringGroupConfiguration conf,
                        RecorderElement parent)

Creates an instance.

Parameters:

conf - the monitoring group configuration

parent - the parent

Since:

1.00

Method Detail

startTimeRecording

boolean startTimeRecording(long nanoTime,
                           long threadTicks,
                           long threadId)

Description copied from class: DefaultRecorderElement

Start the time recording for this instance.

Overrides:

startTimeRecording in class DefaultRecorderElement

Parameters:

nanoTime - the current system time in nano seconds

threadTicks - the current number of thread ticks

threadId - the identifier of the thread causing the call

Returns:

true if recording started on this instance with this call, false if recording was yet active, e.g. in case of recursive or reentrant calls

stopTimeRecording

boolean stopTimeRecording(long nanoTime,
                          long threadTicks,
                          long threadId)

Description copied from class: DefaultRecorderElement

Stops the time recording for this instance.

Overrides:

stopTimeRecording in class DefaultRecorderElement

Parameters:

nanoTime - the current system time in nano seconds

threadTicks - the current number of thread ticks

threadId - the identifier of the thread causing the call

Returns:

true if recording stopped on this instance with this call, false if recording is still active, e.g. in case of recursive or reentrant calls, a negative value causes stopping time recording for all stored threaded times

timeCorrection

void timeCorrection(long timeDiff,
                    long threadTimeFraction,
                    boolean decrement,
                    long threadId)

Description copied from class: DefaultRecorderElement

Adds (overhead) time correction information.

Overrides:

timeCorrection in class DefaultRecorderElement

Parameters:

timeDiff - time difference

threadTimeFraction - threaded time fraction

decrement - negative or positive correction

threadId - the thread id of the causing thread

memoryAllocated

void memoryAllocated(long size)

Description copied from class: DefaultRecorderElement

Records an amount of memory allocated by the underlying recording group.

Overrides:

memoryAllocated in class DefaultRecorderElement

Parameters:

size - the amount of memory allocated

memoryFreed

void memoryFreed(long size)

Description copied from class: DefaultRecorderElement

Records an amount of memory freed within the underlying recording group (memory unallocation).

Overrides:

memoryFreed in class DefaultRecorderElement

Parameters:

size - the amount of memory freed

readIo

void readIo(int bytes,
            StreamType type)

Description copied from class: DefaultRecorderElement

Records an amount of bytes read from file or from network.

Overrides:

readIo in class DefaultRecorderElement

Parameters:

bytes - the amount of bytes read

type - the type of stream used for reading

writeIo

void writeIo(int bytes,
             StreamType type)

Description copied from class: DefaultRecorderElement

Records an amount of bytes written to file or from network.

Overrides:

writeIo in class DefaultRecorderElement

Parameters:

bytes - the amount of bytes written

type - the type of stream used for writing

setCpuTimeTicks

void setCpuTimeTicks(long cpuTimeTicks)

Description copied from class: DefaultRecorderElement

Sets the current CPI time ticks for finishing recording of the entire program.

Overrides:

setCpuTimeTicks in class DefaultRecorderElement

Parameters:

cpuTimeTicks - the current CPU time ticks

addNetBytes

void addNetBytes(long netInBytes,
                 long netOutBytes)

Description copied from class: DefaultRecorderElement

Adds an external amount of input or output bytes to this recording element. This method is used for recording overhead bytes. (This method is currently available only for network overhead as networked monitoring may lead to uncontrolled recursive network recording).

Overrides:

addNetBytes in class DefaultRecorderElement

Parameters:

netInBytes - the amount of bytes read from network

netOutBytes - the amount of bytes written to network