Add llm_spans and deprecate llm_observability for Hourly Usage Attribution and Monthly Usage Attribution (#1099)

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

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

.generator/schemas/v1/openapi.yaml

@@ -4315,6 +4315,7 @@ components:
       - invocations_usage
       - lambda_traced_invocations_usage
       - llm_observability_usage
+      - llm_spans_usage
       - logs_indexed_15day_usage
       - logs_indexed_180day_usage
       - logs_indexed_1day_usage
@@ -4396,6 +4397,7 @@ components:
       - INVOCATIONS_USAGE
       - LAMBDA_TRACED_INVOCATIONS_USAGE
       - LLM_OBSERVABILITY_USAGE
+      - LLM_SPANS_USAGE
       - LOGS_INDEXED_15DAY_USAGE
       - LOGS_INDEXED_180DAY_USAGE
       - LOGS_INDEXED_1DAY_USAGE
@@ -8752,6 +8754,8 @@ components:
       - lambda_traced_invocations_percentage
       - llm_observability_usage
       - llm_observability_percentage
+      - llm_spans_usage
+      - llm_spans_percentage
       - mobile_app_testing_percentage
       - mobile_app_testing_usage
       - ndm_netflow_usage
@@ -8909,6 +8913,8 @@ components:
       - LAMBDA_TRACED_INVOCATIONS_PERCENTAGE
       - LLM_OBSERVABILITY_USAGE
       - LLM_OBSERVABILITY_PERCENTAGE
+      - LLM_SPANS_USAGE
+      - LLM_SPANS_PERCENTAGE
       - MOBILE_APP_TESTING_USAGE
       - MOBILE_APP_TESTING_PERCENTAGE
       - NDM_NETFLOW_USAGE
@@ -9329,6 +9335,14 @@ components:
           description: The LLM Observability usage by tag(s).
           format: double
           type: number
+        llm_spans_percentage:
+          description: The percentage of LLM Spans usage by tag(s).
+          format: double
+          type: number
+        llm_spans_usage:
+          description: The LLM Spans usage by tag(s).
+          format: double
+          type: number
         logs_indexed_15day_percentage:
           description: The percentage of Indexed Logs (15-day Retention) usage by
             tag(s).
@@ -36599,7 +36613,10 @@ paths:
         code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetHourlyUsageAttribution(start_month,
-        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
+        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```\nThe
+        following values have been **deprecated**:\n    `estimated_indexed_spans_usage`,
+        `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`,
+        `llm_observability_usage`, `llm_observability_percentage`."
       operationId: GetHourlyUsageAttribution
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -37178,7 +37195,7 @@ paths:
           The following values have been **deprecated**:
 
           `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
-          `estimated_ingested_spans_percentage`.'
+          `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.'
         in: query
         name: fields
         required: true

src/datadogV1/api/api_usage_metering.rs

@@ -1296,6 +1296,8 @@ impl UsageMeteringAPI {
     ///   cursor := response.metadata.pagination.next_record_id
     /// END
     /// ```
+    /// The following values have been **deprecated**:
+    ///     `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.
     pub async fn get_hourly_usage_attribution(
         &self,
         start_hr: chrono::DateTime<chrono::Utc>,
@@ -1337,6 +1339,8 @@ impl UsageMeteringAPI {
     ///   cursor := response.metadata.pagination.next_record_id
     /// END
     /// ```
+    /// The following values have been **deprecated**:
+    ///     `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.
     pub async fn get_hourly_usage_attribution_with_http_info(
         &self,
         start_hr: chrono::DateTime<chrono::Utc>,

src/datadogV1/model/model_hourly_usage_attribution_usage_type.rs

@@ -49,6 +49,7 @@ pub enum HourlyUsageAttributionUsageType {
     INVOCATIONS_USAGE,
     LAMBDA_TRACED_INVOCATIONS_USAGE,
     LLM_OBSERVABILITY_USAGE,
+    LLM_SPANS_USAGE,
     LOGS_INDEXED_15DAY_USAGE,
     LOGS_INDEXED_180DAY_USAGE,
     LOGS_INDEXED_1DAY_USAGE,
@@ -146,6 +147,7 @@ impl ToString for HourlyUsageAttributionUsageType {
                 String::from("lambda_traced_invocations_usage")
             }
             Self::LLM_OBSERVABILITY_USAGE => String::from("llm_observability_usage"),
+            Self::LLM_SPANS_USAGE => String::from("llm_spans_usage"),
             Self::LOGS_INDEXED_15DAY_USAGE => String::from("logs_indexed_15day_usage"),
             Self::LOGS_INDEXED_180DAY_USAGE => String::from("logs_indexed_180day_usage"),
             Self::LOGS_INDEXED_1DAY_USAGE => String::from("logs_indexed_1day_usage"),
@@ -267,6 +269,7 @@ impl<'de> Deserialize<'de> for HourlyUsageAttributionUsageType {
             "invocations_usage" => Self::INVOCATIONS_USAGE,
             "lambda_traced_invocations_usage" => Self::LAMBDA_TRACED_INVOCATIONS_USAGE,
             "llm_observability_usage" => Self::LLM_OBSERVABILITY_USAGE,
+            "llm_spans_usage" => Self::LLM_SPANS_USAGE,
             "logs_indexed_15day_usage" => Self::LOGS_INDEXED_15DAY_USAGE,
             "logs_indexed_180day_usage" => Self::LOGS_INDEXED_180DAY_USAGE,
             "logs_indexed_1day_usage" => Self::LOGS_INDEXED_1DAY_USAGE,

src/datadogV1/model/model_monthly_usage_attribution_supported_metrics.rs

@@ -75,6 +75,8 @@ pub enum MonthlyUsageAttributionSupportedMetrics {
     LAMBDA_TRACED_INVOCATIONS_PERCENTAGE,
     LLM_OBSERVABILITY_USAGE,
     LLM_OBSERVABILITY_PERCENTAGE,
+    LLM_SPANS_USAGE,
+    LLM_SPANS_PERCENTAGE,
     MOBILE_APP_TESTING_USAGE,
     MOBILE_APP_TESTING_PERCENTAGE,
     NDM_NETFLOW_USAGE,
@@ -262,6 +264,8 @@ impl ToString for MonthlyUsageAttributionSupportedMetrics {
             }
             Self::LLM_OBSERVABILITY_USAGE => String::from("llm_observability_usage"),
             Self::LLM_OBSERVABILITY_PERCENTAGE => String::from("llm_observability_percentage"),
+            Self::LLM_SPANS_USAGE => String::from("llm_spans_usage"),
+            Self::LLM_SPANS_PERCENTAGE => String::from("llm_spans_percentage"),
             Self::MOBILE_APP_TESTING_USAGE => String::from("mobile_app_testing_percentage"),
             Self::MOBILE_APP_TESTING_PERCENTAGE => String::from("mobile_app_testing_usage"),
             Self::NDM_NETFLOW_USAGE => String::from("ndm_netflow_usage"),
@@ -485,6 +489,8 @@ impl<'de> Deserialize<'de> for MonthlyUsageAttributionSupportedMetrics {
             "lambda_traced_invocations_percentage" => Self::LAMBDA_TRACED_INVOCATIONS_PERCENTAGE,
             "llm_observability_usage" => Self::LLM_OBSERVABILITY_USAGE,
             "llm_observability_percentage" => Self::LLM_OBSERVABILITY_PERCENTAGE,
+            "llm_spans_usage" => Self::LLM_SPANS_USAGE,
+            "llm_spans_percentage" => Self::LLM_SPANS_PERCENTAGE,
             "mobile_app_testing_percentage" => Self::MOBILE_APP_TESTING_USAGE,
             "mobile_app_testing_usage" => Self::MOBILE_APP_TESTING_PERCENTAGE,
             "ndm_netflow_usage" => Self::NDM_NETFLOW_USAGE,

src/datadogV1/model/model_monthly_usage_attribution_values.rs

@@ -246,6 +246,12 @@ pub struct MonthlyUsageAttributionValues {
     /// The LLM Observability usage by tag(s).
     #[serde(rename = "llm_observability_usage")]
     pub llm_observability_usage: Option<f64>,
+    /// The percentage of LLM Spans usage by tag(s).
+    #[serde(rename = "llm_spans_percentage")]
+    pub llm_spans_percentage: Option<f64>,
+    /// The LLM Spans usage by tag(s).
+    #[serde(rename = "llm_spans_usage")]
+    pub llm_spans_usage: Option<f64>,
     /// The percentage of Indexed Logs (15-day Retention) usage by tag(s).
     #[serde(rename = "logs_indexed_15day_percentage")]
     pub logs_indexed_15day_percentage: Option<f64>,
@@ -556,6 +562,8 @@ impl MonthlyUsageAttributionValues {
             lambda_traced_invocations_usage: None,
             llm_observability_percentage: None,
             llm_observability_usage: None,
+            llm_spans_percentage: None,
+            llm_spans_usage: None,
             logs_indexed_15day_percentage: None,
             logs_indexed_15day_usage: None,
             logs_indexed_180day_percentage: None,
@@ -1025,6 +1033,16 @@ impl MonthlyUsageAttributionValues {
         self
     }
 
+    pub fn llm_spans_percentage(mut self, value: f64) -> Self {
+        self.llm_spans_percentage = Some(value);
+        self
+    }
+
+    pub fn llm_spans_usage(mut self, value: f64) -> Self {
+        self.llm_spans_usage = Some(value);
+        self
+    }
+
     pub fn logs_indexed_15day_percentage(mut self, value: f64) -> Self {
         self.logs_indexed_15day_percentage = Some(value);
         self
@@ -1505,6 +1523,8 @@ impl<'de> Deserialize<'de> for MonthlyUsageAttributionValues {
                 let mut lambda_traced_invocations_usage: Option<f64> = None;
                 let mut llm_observability_percentage: Option<f64> = None;
                 let mut llm_observability_usage: Option<f64> = None;
+                let mut llm_spans_percentage: Option<f64> = None;
+                let mut llm_spans_usage: Option<f64> = None;
                 let mut logs_indexed_15day_percentage: Option<f64> = None;
                 let mut logs_indexed_15day_usage: Option<f64> = None;
                 let mut logs_indexed_180day_percentage: Option<f64> = None;
@@ -2132,6 +2152,20 @@ impl<'de> Deserialize<'de> for MonthlyUsageAttributionValues {
                             llm_observability_usage =
                                 Some(serde_json::from_value(v).map_err(M::Error::custom)?);
                         }
+                        "llm_spans_percentage" => {
+                            if v.is_null() {
+                                continue;
+                            }
+                            llm_spans_percentage =
+                                Some(serde_json::from_value(v).map_err(M::Error::custom)?);
+                        }
+                        "llm_spans_usage" => {
+                            if v.is_null() {
+                                continue;
+                            }
+                            llm_spans_usage =
+                                Some(serde_json::from_value(v).map_err(M::Error::custom)?);
+                        }
                         "logs_indexed_15day_percentage" => {
                             if v.is_null() {
                                 continue;
@@ -2736,6 +2770,8 @@ impl<'de> Deserialize<'de> for MonthlyUsageAttributionValues {
                     lambda_traced_invocations_usage,
                     llm_observability_percentage,
                     llm_observability_usage,
+                    llm_spans_percentage,
+                    llm_spans_usage,
                     logs_indexed_15day_percentage,
                     logs_indexed_15day_usage,
                     logs_indexed_180day_percentage,