commitment_utilization_timeseries

Creates, updates, deletes, gets or lists a commitment_utilization_timeseries resource.

Overview

Name	commitment_utilization_timeseries
Type	Resource
Id	datadog.cloud_costs.commitment_utilization_timeseries

Fields

The following fields are returned by SELECT queries:

get_commitments_utilization_timeseries

Name	Datatype	Description
series	object	Timeseries data as a map of series names to their corresponding value arrays.
times	array	Unix timestamps in seconds for the timeseries data points.
unit	object	Unit metadata for a numeric metric.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_commitments_utilization_timeseries	select	provider, product, start, end	filter_by, commitment_type	Get timeseries utilization metrics for cloud commitment programs, including used and unused cost series over time.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
end	integer (int64)	End of the query time range in Unix milliseconds. (example: 1696118400000)
product	string	Cloud product identifier (for example, ec2, rds, virtualmachines). (example: ec2)
provider	string	Cloud provider for commitment programs (aws or azure).
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
start	integer (int64)	Start of the query time range in Unix milliseconds. (example: 1693526400000)
commitment_type	string	Type of commitment to query. ri for Reserved Instances, sp for Savings Plans. Defaults to ri. (wire: commitmentType)
filter_by	string	Optional filter expression to narrow down results. (wire: filterBy)

SELECT examples

get_commitments_utilization_timeseries

Get timeseries utilization metrics for cloud commitment programs, including used and unused cost series over time.

SELECT
series,
times,
unit
FROM datadog.cloud_costs.commitment_utilization_timeseries
WHERE provider = '{{ provider }}' -- required
AND product = '{{ product }}' -- required
AND start = '{{ start }}' -- required
AND end = '{{ end }}' -- required
AND filter_by = '{{ filter_by }}'
AND commitment_type = '{{ commitment_type }}'
;