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

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

services/usage_metering/src/v1/UsageMeteringApi.ts

@@ -4835,7 +4835,7 @@ export interface UsageMeteringApiGetMonthlyUsageAttributionRequest {
   /**
    * 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 MonthlyUsageAttributionSupportedMetrics
    */
   fields: MonthlyUsageAttributionSupportedMetrics;
@@ -5378,6 +5378,8 @@ export class 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`.
    * @param param The request object
    */
   public getHourlyUsageAttribution(

services/usage_metering/src/v1/models/HourlyUsageAttributionUsageType.ts

@@ -47,6 +47,7 @@ export type HourlyUsageAttributionUsageType =
   | typeof INVOCATIONS_USAGE
   | typeof LAMBDA_TRACED_INVOCATIONS_USAGE
   | typeof LLM_OBSERVABILITY_USAGE
+  | typeof LLM_SPANS_USAGE
   | typeof LOGS_INDEXED_15DAY_USAGE
   | typeof LOGS_INDEXED_180DAY_USAGE
   | typeof LOGS_INDEXED_1DAY_USAGE
@@ -133,6 +134,7 @@ export const INVOCATIONS_USAGE = "invocations_usage";
 export const LAMBDA_TRACED_INVOCATIONS_USAGE =
   "lambda_traced_invocations_usage";
 export const LLM_OBSERVABILITY_USAGE = "llm_observability_usage";
+export const LLM_SPANS_USAGE = "llm_spans_usage";
 export const LOGS_INDEXED_15DAY_USAGE = "logs_indexed_15day_usage";
 export const LOGS_INDEXED_180DAY_USAGE = "logs_indexed_180day_usage";
 export const LOGS_INDEXED_1DAY_USAGE = "logs_indexed_1day_usage";

services/usage_metering/src/v1/models/MonthlyUsageAttributionSupportedMetrics.ts

@@ -72,6 +72,8 @@ export type MonthlyUsageAttributionSupportedMetrics =
   | typeof LAMBDA_TRACED_INVOCATIONS_PERCENTAGE
   | typeof LLM_OBSERVABILITY_USAGE
   | typeof LLM_OBSERVABILITY_PERCENTAGE
+  | typeof LLM_SPANS_USAGE
+  | typeof LLM_SPANS_PERCENTAGE
   | typeof MOBILE_APP_TESTING_USAGE
   | typeof MOBILE_APP_TESTING_PERCENTAGE
   | typeof NDM_NETFLOW_USAGE
@@ -241,6 +243,8 @@ export const LAMBDA_TRACED_INVOCATIONS_PERCENTAGE =
   "lambda_traced_invocations_percentage";
 export const LLM_OBSERVABILITY_USAGE = "llm_observability_usage";
 export const LLM_OBSERVABILITY_PERCENTAGE = "llm_observability_percentage";
+export const LLM_SPANS_USAGE = "llm_spans_usage";
+export const LLM_SPANS_PERCENTAGE = "llm_spans_percentage";
 export const MOBILE_APP_TESTING_USAGE = "mobile_app_testing_percentage";
 export const MOBILE_APP_TESTING_PERCENTAGE = "mobile_app_testing_usage";
 export const NDM_NETFLOW_USAGE = "ndm_netflow_usage";

services/usage_metering/src/v1/models/MonthlyUsageAttributionValues.ts

@@ -317,6 +317,14 @@ export class MonthlyUsageAttributionValues {
    * The LLM Observability usage by tag(s).
    */
   "llmObservabilityUsage"?: number;
+  /**
+   * The percentage of LLM Spans usage by tag(s).
+   */
+  "llmSpansPercentage"?: number;
+  /**
+   * The LLM Spans usage by tag(s).
+   */
+  "llmSpansUsage"?: number;
   /**
    * The percentage of Indexed Logs (15-day Retention) usage by tag(s).
    */
@@ -1018,6 +1026,16 @@ export class MonthlyUsageAttributionValues {
       type: "number",
       format: "double",
     },
+    llmSpansPercentage: {
+      baseName: "llm_spans_percentage",
+      type: "number",
+      format: "double",
+    },
+    llmSpansUsage: {
+      baseName: "llm_spans_usage",
+      type: "number",
+      format: "double",
+    },
     logsIndexed15DayPercentage: {
       baseName: "logs_indexed_15day_percentage",
       type: "number",

services/usage_metering/src/v1/models/TypingInfo.ts

@@ -140,6 +140,7 @@ export const TypingInfo: ModelTypingInfo = {
       "invocations_usage",
       "lambda_traced_invocations_usage",
       "llm_observability_usage",
+      "llm_spans_usage",
       "logs_indexed_15day_usage",
       "logs_indexed_180day_usage",
       "logs_indexed_1day_usage",
@@ -247,6 +248,8 @@ export const TypingInfo: ModelTypingInfo = {
       "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",