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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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/datadog_api_client/v1/api/usage_metering_api.py

@@ -1280,6 +1280,9 @@ def get_hourly_usage_attribution(
              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``.
+
         :param start_hr: Datetime in ISO-8601 format, UTC, precise to hour: ``[YYYY-MM-DDThh]`` for usage beginning at this hour.
         :type start_hr: datetime
         :param usage_type: Usage type to retrieve. The following values have been **deprecated** :
@@ -1446,7 +1449,7 @@ def get_monthly_usage_attribution(
         :type start_month: datetime
         :param fields: Comma-separated list of usage types to return, or ``*`` for all usage types.
             The following values have been **deprecated** :
-            ``estimated_indexed_spans_usage`` , ``estimated_indexed_spans_percentage`` , ``estimated_ingested_spans_usage`` , ``estimated_ingested_spans_percentage``.
+            ``estimated_indexed_spans_usage`` , ``estimated_indexed_spans_percentage`` , ``estimated_ingested_spans_usage`` , ``estimated_ingested_spans_percentage`` , ``llm_observability_usage`` , ``llm_observability_percentage``.
         :type fields: MonthlyUsageAttributionSupportedMetrics
         :param end_month: Datetime in ISO-8601 format, UTC, precise to month: ``[YYYY-MM]`` for usage ending this month.
         :type end_month: datetime, optional

src/datadog_api_client/v1/model/hourly_usage_attribution_usage_type.py

@@ -17,7 +17,7 @@ class HourlyUsageAttributionUsageType(ModelSimple):
     Supported products for hourly usage attribution requests.
         The following values have been **deprecated**: `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.
 
-    :param value: Must be one of ["api_usage", "apm_fargate_usage", "apm_host_usage", "apm_usm_usage", "appsec_fargate_usage", "appsec_usage", "asm_serverless_traced_invocations_usage", "asm_serverless_traced_invocations_percentage", "browser_usage", "ci_pipeline_indexed_spans_usage", "ci_test_indexed_spans_usage", "ci_visibility_itr_usage", "cloud_siem_usage", "code_security_host_usage", "container_excl_agent_usage", "container_usage", "cspm_containers_usage", "cspm_hosts_usage", "custom_event_usage", "custom_ingested_timeseries_usage", "custom_timeseries_usage", "cws_containers_usage", "cws_fargate_task_usage", "cws_hosts_usage", "data_jobs_monitoring_usage", "data_stream_monitoring_usage", "dbm_hosts_usage", "dbm_queries_usage", "error_tracking_usage", "error_tracking_percentage", "estimated_indexed_spans_usage", "estimated_ingested_spans_usage", "fargate_usage", "functions_usage", "incident_management_monthly_active_users_usage", "indexed_spans_usage", "infra_host_usage", "ingested_logs_bytes_usage", "ingested_spans_bytes_usage", "invocations_usage", "lambda_traced_invocations_usage", "llm_observability_usage", "logs_indexed_15day_usage", "logs_indexed_180day_usage", "logs_indexed_1day_usage", "logs_indexed_30day_usage", "logs_indexed_360day_usage", "logs_indexed_3day_usage", "logs_indexed_45day_usage", "logs_indexed_60day_usage", "logs_indexed_7day_usage", "logs_indexed_90day_usage", "logs_indexed_custom_retention_usage", "mobile_app_testing_usage", "ndm_netflow_usage", "npm_host_usage", "network_device_wireless_usage", "obs_pipeline_bytes_usage", "obs_pipelines_vcpu_usage", "online_archive_usage", "product_analytics_session_usage", "profiled_container_usage", "profiled_fargate_usage", "profiled_host_usage", "published_app", "rum_browser_mobile_sessions_usage", "rum_ingested_usage", "rum_investigate_usage", "rum_replay_sessions_usage", "rum_session_replay_add_on_usage", "sca_fargate_usage", "sds_scanned_bytes_usage", "serverless_apps_usage", "siem_analyzed_logs_add_on_usage", "siem_ingested_bytes_usage", "snmp_usage", "universal_service_monitoring_usage", "vuln_management_hosts_usage", "workflow_executions_usage"].
+    :param value: Must be one of ["api_usage", "apm_fargate_usage", "apm_host_usage", "apm_usm_usage", "appsec_fargate_usage", "appsec_usage", "asm_serverless_traced_invocations_usage", "asm_serverless_traced_invocations_percentage", "browser_usage", "ci_pipeline_indexed_spans_usage", "ci_test_indexed_spans_usage", "ci_visibility_itr_usage", "cloud_siem_usage", "code_security_host_usage", "container_excl_agent_usage", "container_usage", "cspm_containers_usage", "cspm_hosts_usage", "custom_event_usage", "custom_ingested_timeseries_usage", "custom_timeseries_usage", "cws_containers_usage", "cws_fargate_task_usage", "cws_hosts_usage", "data_jobs_monitoring_usage", "data_stream_monitoring_usage", "dbm_hosts_usage", "dbm_queries_usage", "error_tracking_usage", "error_tracking_percentage", "estimated_indexed_spans_usage", "estimated_ingested_spans_usage", "fargate_usage", "functions_usage", "incident_management_monthly_active_users_usage", "indexed_spans_usage", "infra_host_usage", "ingested_logs_bytes_usage", "ingested_spans_bytes_usage", "invocations_usage", "lambda_traced_invocations_usage", "llm_observability_usage", "llm_spans_usage", "logs_indexed_15day_usage", "logs_indexed_180day_usage", "logs_indexed_1day_usage", "logs_indexed_30day_usage", "logs_indexed_360day_usage", "logs_indexed_3day_usage", "logs_indexed_45day_usage", "logs_indexed_60day_usage", "logs_indexed_7day_usage", "logs_indexed_90day_usage", "logs_indexed_custom_retention_usage", "mobile_app_testing_usage", "ndm_netflow_usage", "npm_host_usage", "network_device_wireless_usage", "obs_pipeline_bytes_usage", "obs_pipelines_vcpu_usage", "online_archive_usage", "product_analytics_session_usage", "profiled_container_usage", "profiled_fargate_usage", "profiled_host_usage", "published_app", "rum_browser_mobile_sessions_usage", "rum_ingested_usage", "rum_investigate_usage", "rum_replay_sessions_usage", "rum_session_replay_add_on_usage", "sca_fargate_usage", "sds_scanned_bytes_usage", "serverless_apps_usage", "siem_analyzed_logs_add_on_usage", "siem_ingested_bytes_usage", "snmp_usage", "universal_service_monitoring_usage", "vuln_management_hosts_usage", "workflow_executions_usage"].
     :type value: str
     """
 
@@ -64,6 +64,7 @@ class HourlyUsageAttributionUsageType(ModelSimple):
         "invocations_usage",
         "lambda_traced_invocations_usage",
         "llm_observability_usage",
+        "llm_spans_usage",
         "logs_indexed_15day_usage",
         "logs_indexed_180day_usage",
         "logs_indexed_1day_usage",
@@ -144,6 +145,7 @@ class HourlyUsageAttributionUsageType(ModelSimple):
     INVOCATIONS_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     LAMBDA_TRACED_INVOCATIONS_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     LLM_OBSERVABILITY_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
+    LLM_SPANS_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     LOGS_INDEXED_15DAY_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     LOGS_INDEXED_180DAY_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
     LOGS_INDEXED_1DAY_USAGE: ClassVar["HourlyUsageAttributionUsageType"]
@@ -257,6 +259,7 @@ def openapi_types(_):
     "lambda_traced_invocations_usage"
 )
 HourlyUsageAttributionUsageType.LLM_OBSERVABILITY_USAGE = HourlyUsageAttributionUsageType("llm_observability_usage")
+HourlyUsageAttributionUsageType.LLM_SPANS_USAGE = HourlyUsageAttributionUsageType("llm_spans_usage")
 HourlyUsageAttributionUsageType.LOGS_INDEXED_15DAY_USAGE = HourlyUsageAttributionUsageType("logs_indexed_15day_usage")
 HourlyUsageAttributionUsageType.LOGS_INDEXED_180DAY_USAGE = HourlyUsageAttributionUsageType("logs_indexed_180day_usage")
 HourlyUsageAttributionUsageType.LOGS_INDEXED_1DAY_USAGE = HourlyUsageAttributionUsageType("logs_indexed_1day_usage")