software.amazon.cloudwatchlogs.emf.model

Class MetricsContext

java.lang.Object

software.amazon.cloudwatchlogs.emf.model.MetricsContext

public class MetricsContext
extends java.lang.Object

Stores metrics and their associated properties and dimensions.

Constructor Summary

Constructors

Constructor and Description
MetricsContext()
MetricsContext(software.amazon.cloudwatchlogs.emf.model.MetricDirective metricDirective)
MetricsContext(software.amazon.cloudwatchlogs.emf.model.RootNode rootNode)
MetricsContext(java.lang.String namespace, java.util.Map<java.lang.String,java.lang.Object> properties, java.util.List<DimensionSet> dimensionSets, DimensionSet defaultDimensionSet)

Method Summary

Modifier and Type	Method and Description
MetricsContext	createCopyWithContext()
DimensionSet	getDefaultDimensions()
java.util.List<DimensionSet>	getDimensions()
java.lang.String	getNamespace()
java.lang.Object	getProperty(java.lang.String name)
java.time.Instant	getTimestamp()
boolean	hasDefaultDimensions()
void	putDimension(DimensionSet dimensionSet) Add dimensions to the metric context.
void	putDimension(java.lang.String dimension, java.lang.String value) Add a dimension set with single dimension-value entry to the metric context.
void	putMetadata(java.lang.String key, java.lang.Object value) Add a key-value pair to the metadata
void	putMetric(java.lang.String key, double value) Add a metric measurement to the context without a unit Multiple calls using the same key will be stored as an array of scalar values.
void	putMetric(java.lang.String key, double value, Unit unit) Add a metric measurement to the context.
void	putProperty(java.lang.String name, java.lang.Object value) Add a property to this log entry.
java.util.List<java.lang.String>	serialize() Serialize the metrics in this context to strings.
void	setDefaultDimensions(DimensionSet dimensionSet) Sets default dimensions for all other dimensions that get added to the context.
void	setDimensions(DimensionSet... dimensionSets) Update the dimensions.
void	setNamespace(java.lang.String namespace) Update the namespace with the parameter.
void	setTimestamp(java.time.Instant timestamp) Update timestamp field in the metadata

Methods inherited from class java.lang.Object

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

Constructor Detail

MetricsContext

public MetricsContext()

MetricsContext

public MetricsContext(software.amazon.cloudwatchlogs.emf.model.RootNode rootNode)

MetricsContext

public MetricsContext(software.amazon.cloudwatchlogs.emf.model.MetricDirective metricDirective)

MetricsContext

public MetricsContext(java.lang.String namespace,
                      java.util.Map<java.lang.String,java.lang.Object> properties,
                      java.util.List<DimensionSet> dimensionSets,
                      DimensionSet defaultDimensionSet)

Method Detail

getNamespace

public java.lang.String getNamespace()

Returns:

the namespace. If the namespace is not set, it would return a default value.

setNamespace

public void setNamespace(java.lang.String namespace)

Update the namespace with the parameter.

Parameters:

namespace - The new namespace

getDefaultDimensions

public DimensionSet getDefaultDimensions()

Returns:

the default dimension set.

setDefaultDimensions

public void setDefaultDimensions(DimensionSet dimensionSet)

Sets default dimensions for all other dimensions that get added to the context. If no custom dimensions are specified, the metrics will be emitted with the defaults. If custom dimensions are specified, they will be prepended with the default dimensions

Parameters:

dimensionSet - the DimensionSet to be the default

hasDefaultDimensions

public boolean hasDefaultDimensions()

putMetric

public void putMetric(java.lang.String key,
                      double value,
                      Unit unit)

Add a metric measurement to the context. Multiple calls using the same key will be stored as an array of scalar values.

 metricContext.putMetric("Latency", 100, Unit.MILLISECONDS)
 

Parameters:

key - Name of the metric

value - Value of the metric

unit - The unit of the metric

putMetric

public void putMetric(java.lang.String key,
                      double value)

Add a metric measurement to the context without a unit Multiple calls using the same key will be stored as an array of scalar values.

 metricContext.putMetric("Count", 10)
 

Parameters:

key - Name of the metric

value - Value of the metric

putProperty

public void putProperty(java.lang.String name,
                        java.lang.Object value)

Add a property to this log entry. Properties are additional values that can be associated with metrics. They will not show up in CloudWatch metrics, but they are searchable in CloudWatch Insights.

 metricContext.putProperty("Location", 'US')
 

Parameters:

name - Name of the property

value - Value of the property

getProperty

public java.lang.Object getProperty(java.lang.String name)

putDimension

public void putDimension(DimensionSet dimensionSet)

Add dimensions to the metric context.

 metricContext.putDimension(DimensionSet.of("Dim", "Value" ))
 

Parameters:

dimensionSet - the dimensions set to add

putDimension

public void putDimension(java.lang.String dimension,
                         java.lang.String value)

Add a dimension set with single dimension-value entry to the metric context.

 metricContext.putDimension("Dim", "Value" )
 

Parameters:

dimension - the name of the dimension

value - the value associated with the dimension

getDimensions

public java.util.List<DimensionSet> getDimensions()

Returns:

the list of dimensions that has been added, including default dimensions.

setDimensions

public void setDimensions(DimensionSet... dimensionSets)

Update the dimensions. This would override default dimensions

Parameters:

dimensionSets - the dimensionSets to be set

putMetadata

public void putMetadata(java.lang.String key,
                        java.lang.Object value)

Add a key-value pair to the metadata

Parameters:

key - the name of the key

value - the value associated with the key

getTimestamp

public java.time.Instant getTimestamp()

Returns:

timestamp field from the metadata.

setTimestamp

public void setTimestamp(java.time.Instant timestamp)

Update timestamp field in the metadata

Parameters:

timestamp - value of timestamp to be set

createCopyWithContext

public MetricsContext createCopyWithContext()

Returns:

Creates an independently flushable context.

serialize

public java.util.List<java.lang.String> serialize()
                                           throws com.fasterxml.jackson.core.JsonProcessingException

Serialize the metrics in this context to strings. The EMF backend requires no more than 100 metrics in one log event. If there're more than 100 metrics, we split the metrics into multiple log events.

If a metric has more than 100 data points, we also split the metric.

Returns:

the serialized strings.

Throws:

com.fasterxml.jackson.core.JsonProcessingException - if there's any object that cannot be serialized