Class AWSRequestMetrics

java.lang.Object

com.amazonaws.util.AWSRequestMetrics

Direct Known Subclasses:

AWSRequestMetricsFullSupport

public class AWSRequestMetrics
extends Object

Used as both a base class and a minimal support of AWS SDK request metrics. The base class of supporting AWS SDK request metrics.

In contrast to AWSRequestMetricsFullSupport, which is intended to be a full support of AWS SDK request metrics, this class only provides access to a TimingInfo instance that only has minimal support for start and end time (ie with no-ops for sub-event measurements) for backward compatibility reason. The other methods related to properties and counters in this class are effectively no-ops.

This class is instantiated instead of AWSRequestMetricsFullSupport when request metric collection is not required during a particular service request/response cycle.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	AWSRequestMetrics.Field	Predefined AWS SDK metric types general across all AWS clients.

Field Summary

Fields

Modifier and Type	Field	Description
protected final TimingInfo	timingInfo

Constructor Summary

Constructors

Modifier	Constructor	Description
	AWSRequestMetrics()	This constructor should be used only in the case when AWS SDK metrics collector is disabled, when minimal timing info is supported for backward compatibility reasons.
protected	AWSRequestMetrics(TimingInfo timingInfo)

Method Summary

Modifier and Type	Method	Description
void	addProperty(MetricType f, Object value)
void	addProperty(String propertyName, Object value)
final AWSRequestMetrics	addPropertyWith(MetricType f, Object value)	Fluent API of addProperty(MetricType, Object)
final AWSRequestMetrics	addPropertyWith(String propertyName, Object value)	Fluent API of addProperty(String, Object)
void	endEvent(MetricType f)
void	endEvent(String eventName)
List<Object>	getProperty(MetricType f)
List<Object>	getProperty(String propertyName)
final TimingInfo	getTimingInfo()
void	incrementCounter(MetricType f)
void	incrementCounter(String event)
final AWSRequestMetrics	incrementCounterWith(MetricType f)	Fluent API of incrementCounter(MetricType)
final AWSRequestMetrics	incrementCounterWith(String event)	Fluent API of incrementCounter(String)
boolean	isEnabled()	Returns true if this metrics is enabled; false otherwise.
void	log()
void	setCounter(MetricType f, long count)
void	setCounter(String counterName, long count)
void	startEvent(MetricType f)
void	startEvent(String eventName)
final AWSRequestMetrics	withCounter(MetricType f, long count)	Fluent API of setCounter(MetricType, long)
final AWSRequestMetrics	withCounter(String counterName, long count)	Fluent API of setCounter(String, long)

Methods inherited from class Object

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

Field Details

timingInfo

protected final TimingInfo timingInfo

Constructor Details

AWSRequestMetrics

public AWSRequestMetrics()

This constructor should be used only in the case when AWS SDK metrics collector is disabled, when minimal timing info is supported for backward compatibility reasons.

See Also:

• AWSRequestMetricsFullSupport

AWSRequestMetrics

protected AWSRequestMetrics(TimingInfo timingInfo)

Method Details

getTimingInfo

public final TimingInfo getTimingInfo()

isEnabled

public boolean isEnabled()

Returns true if this metrics is enabled; false otherwise. Returns false by default.

startEvent

public void startEvent(String eventName)

startEvent

public void startEvent(MetricType f)

endEvent

public void endEvent(String eventName)

endEvent

public void endEvent(MetricType f)

incrementCounter

public void incrementCounter(String event)

incrementCounter

public void incrementCounter(MetricType f)

incrementCounterWith

public final AWSRequestMetrics incrementCounterWith(String event)

Fluent API of incrementCounter(String)

incrementCounterWith

public final AWSRequestMetrics incrementCounterWith(MetricType f)

Fluent API of incrementCounter(MetricType)

setCounter

public void setCounter(String counterName,
 long count)

setCounter

public void setCounter(MetricType f,
 long count)

withCounter

public final AWSRequestMetrics withCounter(String counterName,
 long count)

Fluent API of setCounter(String, long)

withCounter

public final AWSRequestMetrics withCounter(MetricType f,
 long count)

Fluent API of setCounter(MetricType, long)

addProperty

public void addProperty(String propertyName,
 Object value)

addProperty

public void addProperty(MetricType f,
 Object value)

addPropertyWith

public final AWSRequestMetrics addPropertyWith(String propertyName,
 Object value)

Fluent API of addProperty(String, Object)

addPropertyWith

public final AWSRequestMetrics addPropertyWith(MetricType f,
 Object value)

Fluent API of addProperty(MetricType, Object)

log

public void log()

getProperty

public List<Object> getProperty(String propertyName)

getProperty

public List<Object> getProperty(MetricType f)