commitment_saving_timeseries
Creates, updates, deletes, gets or lists a commitment_saving_timeseries resource.
Overview
| Name | commitment_saving_timeseries |
| Type | Resource |
| Id | datadog.cloud_costs.commitment_saving_timeseries |
Fields
The following fields are returned by SELECT queries:
- get_commitments_savings_timeseries
| Name | Datatype | Description |
|---|---|---|
actual_cost | object | A timeseries metric containing timestamps, series values, and optional unit metadata. |
effective_savings_rate | object | A timeseries metric containing timestamps, series values, and optional unit metadata. |
on_demand_equivalent_cost | object | A timeseries metric containing timestamps, series values, and optional unit metadata. |
realized_savings | object | A timeseries metric containing timestamps, series values, and optional unit metadata. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_commitments_savings_timeseries | select | provider, product, start, end | filter_by | Get timeseries savings metrics for cloud commitment programs, including actual cost, on-demand equivalent cost, realized savings, and effective savings rate 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) |
filter_by | string | Optional filter expression to narrow down results. (wire: filterBy) |
SELECT examples
- get_commitments_savings_timeseries
Get timeseries savings metrics for cloud commitment programs, including actual cost, on-demand equivalent cost, realized savings, and effective savings rate over time.
SELECT
actual_cost,
effective_savings_rate,
on_demand_equivalent_cost,
realized_savings
FROM datadog.cloud_costs.commitment_saving_timeseries
WHERE provider = '{{ provider }}' -- required
AND product = '{{ product }}' -- required
AND start = '{{ start }}' -- required
AND end = '{{ end }}' -- required
AND filter_by = '{{ filter_by }}'
;