Add a cost monitor example (#469)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-17 21:03:19.197216",
-            "spec_repo_commit": "617655da"
+            "regenerated": "2025-01-17 21:41:10.807788",
+            "spec_repo_commit": "27e609f7"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-17 21:03:19.212316",
-            "spec_repo_commit": "617655da"
+            "regenerated": "2025-01-17 21:41:10.823634",
+            "spec_repo_commit": "27e609f7"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -6784,6 +6784,62 @@ components:
       - FIREFOX_LAPTOP_LARGE
       - FIREFOX_TABLET
       - FIREFOX_MOBILE_SMALL
+    MonitorFormulaAndFunctionCostAggregator:
+      description: Aggregation methods for metric queries.
+      enum:
+      - avg
+      - sum
+      - max
+      - min
+      - last
+      - area
+      - l2norm
+      - percentile
+      - stddev
+      example: avg
+      type: string
+      x-enum-varnames:
+      - AVG
+      - SUM
+      - MAX
+      - MIN
+      - LAST
+      - AREA
+      - L2NORM
+      - PERCENTILE
+      - STDDEV
+    MonitorFormulaAndFunctionCostDataSource:
+      description: Data source for cost queries.
+      enum:
+      - metrics
+      - cloud_cost
+      - datadog_usage
+      example: cloud_cost
+      type: string
+      x-enum-varnames:
+      - METRICS
+      - CLOUD_COST
+      - DATADOG_USAGE
+    MonitorFormulaAndFunctionCostQueryDefinition:
+      description: A formula and functions cost query.
+      properties:
+        aggregator:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionCostAggregator'
+        data_source:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionCostDataSource'
+        name:
+          description: Name of the query for use in formulas.
+          example: query1
+          type: string
+        query:
+          description: The monitor query.
+          example: sum:all.cost{*}.rollup(sum, 86400)
+          type: string
+      required:
+      - name
+      - data_source
+      - query
+      type: object
     MonitorFormulaAndFunctionEventAggregation:
       description: Aggregation methods for event platform queries.
       enum:
@@ -6934,6 +6990,7 @@ components:
       description: A formula and function query.
       oneOf:
       - $ref: '#/components/schemas/MonitorFormulaAndFunctionEventQueryDefinition'
+      - $ref: '#/components/schemas/MonitorFormulaAndFunctionCostQueryDefinition'
     MonitorGroupSearchResponse:
       description: The response of a monitor group search.
       example:

examples/v1_monitors_CreateMonitor_1303514967.rs

@@ -0,0 +1,50 @@
+// Create a Cost Monitor returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV1::api_monitors::MonitorsAPI;
+use datadog_api_client::datadogV1::model::Monitor;
+use datadog_api_client::datadogV1::model::MonitorFormulaAndFunctionCostAggregator;
+use datadog_api_client::datadogV1::model::MonitorFormulaAndFunctionCostDataSource;
+use datadog_api_client::datadogV1::model::MonitorFormulaAndFunctionCostQueryDefinition;
+use datadog_api_client::datadogV1::model::MonitorFormulaAndFunctionQueryDefinition;
+use datadog_api_client::datadogV1::model::MonitorOptions;
+use datadog_api_client::datadogV1::model::MonitorThresholds;
+use datadog_api_client::datadogV1::model::MonitorType;
+
+#[tokio::main]
+async fn main() {
+    let body =
+        Monitor::new(
+            r#"formula("exclude_null(query1)").last("7d").anomaly(direction="above", threshold=10) >= 5"#.to_string(),
+            MonitorType::COST_ALERT,
+        )
+            .message("some message Notify: @hipchat-channel".to_string())
+            .name("Example Monitor".to_string())
+            .options(
+                MonitorOptions::new()
+                    .include_tags(true)
+                    .thresholds(MonitorThresholds::new().critical(5.0 as f64).warning(Some(3.0 as f64)))
+                    .variables(
+                        vec![
+                            MonitorFormulaAndFunctionQueryDefinition::MonitorFormulaAndFunctionCostQueryDefinition(
+                                Box::new(
+                                    MonitorFormulaAndFunctionCostQueryDefinition::new(
+                                        MonitorFormulaAndFunctionCostDataSource::CLOUD_COST,
+                                        "query1".to_string(),
+                                        "sum:aws.cost.net.amortized.shared.resources.allocated{aws_product IN (amplify ,athena, backup, bedrock ) } by {aws_product}.rollup(sum, 86400)".to_string(),
+                                    ).aggregator(MonitorFormulaAndFunctionCostAggregator::SUM),
+                                ),
+                            )
+                        ],
+                    ),
+            )
+            .priority(Some(3))
+            .tags(vec!["test:examplemonitor".to_string(), "env:ci".to_string()]);
+    let configuration = datadog::Configuration::new();
+    let api = MonitorsAPI::with_config(configuration);
+    let resp = api.create_monitor(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

src/datadogV1/model/mod.rs

@@ -930,6 +930,12 @@ pub mod model_monitor_formula_and_function_event_query_group_by_sort;
 pub use self::model_monitor_formula_and_function_event_query_group_by_sort::MonitorFormulaAndFunctionEventQueryGroupBySort;
 pub mod model_monitor_formula_and_function_event_query_definition_search;
 pub use self::model_monitor_formula_and_function_event_query_definition_search::MonitorFormulaAndFunctionEventQueryDefinitionSearch;
+pub mod model_monitor_formula_and_function_cost_query_definition;
+pub use self::model_monitor_formula_and_function_cost_query_definition::MonitorFormulaAndFunctionCostQueryDefinition;
+pub mod model_monitor_formula_and_function_cost_aggregator;
+pub use self::model_monitor_formula_and_function_cost_aggregator::MonitorFormulaAndFunctionCostAggregator;
+pub mod model_monitor_formula_and_function_cost_data_source;
+pub use self::model_monitor_formula_and_function_cost_data_source::MonitorFormulaAndFunctionCostDataSource;
 pub mod model_monitor_formula_and_function_query_definition;
 pub use self::model_monitor_formula_and_function_query_definition::MonitorFormulaAndFunctionQueryDefinition;
 pub mod model_monitor_overall_states;

src/datadogV1/model/model_monitor_formula_and_function_cost_aggregator.rs

@@ -0,0 +1,72 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+use serde::{Deserialize, Deserializer, Serialize, Serializer};
+
+#[non_exhaustive]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub enum MonitorFormulaAndFunctionCostAggregator {
+    AVG,
+    SUM,
+    MAX,
+    MIN,
+    LAST,
+    AREA,
+    L2NORM,
+    PERCENTILE,
+    STDDEV,
+    UnparsedObject(crate::datadog::UnparsedObject),
+}
+
+impl ToString for MonitorFormulaAndFunctionCostAggregator {
+    fn to_string(&self) -> String {
+        match self {
+            Self::AVG => String::from("avg"),
+            Self::SUM => String::from("sum"),
+            Self::MAX => String::from("max"),
+            Self::MIN => String::from("min"),
+            Self::LAST => String::from("last"),
+            Self::AREA => String::from("area"),
+            Self::L2NORM => String::from("l2norm"),
+            Self::PERCENTILE => String::from("percentile"),
+            Self::STDDEV => String::from("stddev"),
+            Self::UnparsedObject(v) => v.value.to_string(),
+        }
+    }
+}
+
+impl Serialize for MonitorFormulaAndFunctionCostAggregator {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        match self {
+            Self::UnparsedObject(v) => v.serialize(serializer),
+            _ => serializer.serialize_str(self.to_string().as_str()),
+        }
+    }
+}
+
+impl<'de> Deserialize<'de> for MonitorFormulaAndFunctionCostAggregator {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: Deserializer<'de>,
+    {
+        let s: String = String::deserialize(deserializer)?;
+        Ok(match s.as_str() {
+            "avg" => Self::AVG,
+            "sum" => Self::SUM,
+            "max" => Self::MAX,
+            "min" => Self::MIN,
+            "last" => Self::LAST,
+            "area" => Self::AREA,
+            "l2norm" => Self::L2NORM,
+            "percentile" => Self::PERCENTILE,
+            "stddev" => Self::STDDEV,
+            _ => Self::UnparsedObject(crate::datadog::UnparsedObject {
+                value: serde_json::Value::String(s.into()),
+            }),
+        })
+    }
+}

src/datadogV1/model/model_monitor_formula_and_function_cost_data_source.rs

@@ -0,0 +1,54 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+use serde::{Deserialize, Deserializer, Serialize, Serializer};
+
+#[non_exhaustive]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub enum MonitorFormulaAndFunctionCostDataSource {
+    METRICS,
+    CLOUD_COST,
+    DATADOG_USAGE,
+    UnparsedObject(crate::datadog::UnparsedObject),
+}
+
+impl ToString for MonitorFormulaAndFunctionCostDataSource {
+    fn to_string(&self) -> String {
+        match self {
+            Self::METRICS => String::from("metrics"),
+            Self::CLOUD_COST => String::from("cloud_cost"),
+            Self::DATADOG_USAGE => String::from("datadog_usage"),
+            Self::UnparsedObject(v) => v.value.to_string(),
+        }
+    }
+}
+
+impl Serialize for MonitorFormulaAndFunctionCostDataSource {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        match self {
+            Self::UnparsedObject(v) => v.serialize(serializer),
+            _ => serializer.serialize_str(self.to_string().as_str()),
+        }
+    }
+}
+
+impl<'de> Deserialize<'de> for MonitorFormulaAndFunctionCostDataSource {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: Deserializer<'de>,
+    {
+        let s: String = String::deserialize(deserializer)?;
+        Ok(match s.as_str() {
+            "metrics" => Self::METRICS,
+            "cloud_cost" => Self::CLOUD_COST,
+            "datadog_usage" => Self::DATADOG_USAGE,
+            _ => Self::UnparsedObject(crate::datadog::UnparsedObject {
+                value: serde_json::Value::String(s.into()),
+            }),
+        })
+    }
+}