NAME

WebService::DataDog::Metric - Interface to Metric functions in DataDog's API.

VERSION

Version 1.0.3

METHODS

post_metric()

Deprecated. Please use emit() instead.

emit()

Post single/multiple time-series metrics. NOTE: only metrics of type 'gauge' and type 'counter' are supported. You must use a dogstatsd client such as Net::Dogstatsd to post metrics of other types (ex: 'timer', 'histogram', 'sets' or use increment() or decrement() on a counter). The primary advantage of the API vs dogstatsd for posting metrics: API allows posting metrics from the past.

Per DataDog: "The metrics end-point allows you to post metrics data so it can be graphed on Datadog's dashboards."

my $metric = $datadog->build('Metric');
$metric->emit(
	name        => $metric_name,
	type        => $metric_type,  # Optional - gauge|counter. Default=gauge.
	value       => $metric_value, # For posting a single data point, time 'now'
	data_points => $data_points,  # 1+ data points, with timestamps
	host        => $hostname,     # Optional - host that produced the metric
	tags        => $tag_list,     # Optional - tags associated with the metric
);

Examples:
+ Submit a single point with a timestamp of `now`.
$metric->emit(
	name  => 'page_views',
	value => 1000,
);

+ Submit a point with a timestamp.
$metric->emit(
	name        => 'my.pair',
	data_points => [ [ 1317652676, 15 ] ],
);
	
+ Submit multiple points.
$metric->emit(
	name        => 'my.series',
	data_points => 
	[
		[ 1317652676, 15 ],
		[ 1317652800, 16 ],
	]
);

+ Submit a point with a host and tags.
$metric->emit(
	name  => 'my.series',
	value => 100,
	host  => "myhost.example.com",
	tags  => [ "version:1" ],
);

Parameters:

• name

  The metric name.

• type

  Optional. Metric type. Allowed values: gauge, counter. Default = gauge.

• value

  Metric value. Used when you only need to post a single data point, with timestamp 'now'. Use 'data_points' to post a single metric with a timestamp.

• data_points

  Array of arrays of timestamp and metric value.

• host

  Optional. Host that generated the metric.

• tags

  Optional. List of tags associated with the metric.

INTERNAL FUNCTIONS

_error_checks()

$self->_error_checks( %args );

Common error checking for all metric types.