Add Network Path fields to usage summary API (#3232)

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

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

.generator/schemas/v1/openapi.yaml

@@ -22294,6 +22294,11 @@ components:
             wireless devices over all hours in the current date for all organizations.
           format: int64
           type: integer
+        network_path_sum:
+          description: Shows the sum of all Network Path scheduled tests over all
+            hours in the current date for all organizations.
+          format: int64
+          type: integer
         npm_host_top99p:
           description: Shows the 99th percentile of all distinct Cloud Network Monitoring
             hosts (formerly known as Network hosts) over all hours in the current
@@ -23462,6 +23467,11 @@ components:
             wireless devices over all hours in the current date for the given org.
           format: int64
           type: integer
+        network_path_sum:
+          description: Shows the sum of all Network Path scheduled tests over all
+            hours in the current date for the given org.
+          format: int64
+          type: integer
         npm_host_top99p:
           description: Shows the 99th percentile of all distinct Cloud Network Monitoring
             hosts (formerly known as Network hosts) over all hours in the current
@@ -24650,6 +24660,11 @@ components:
             wireless devices over all hours in the current month for all organizations.
           format: int64
           type: integer
+        network_path_agg_sum:
+          description: Shows the sum of all Network Path scheduled tests over all
+            hours in the current month for all organizations.
+          format: int64
+          type: integer
         npm_host_top99p_sum:
           description: Shows the 99th percentile of all distinct Cloud Network Monitoring
             hosts (formerly known as Network hosts) over all hours in the current

.generator/schemas/v2/openapi.yaml

@@ -54739,6 +54739,69 @@ components:
       type: string
       x-enum-varnames:
       - RULESET
+    RumCrossProductSampling:
+      description: 'Configuration for additional APM trace data retention for sessions
+        that match this retention filter.
+
+        When a session matches the filter and is retained (based on `sample_rate`),
+        you can configure
+
+        the percentage of retained sessions with ingested traces whose traces are
+        indexed.'
+      properties:
+        trace_enabled:
+          description: Indicates whether trace cross-product sampling is enabled.
+            If `false`, no traces are indexed regardless of `trace_sample_rate`.
+          example: true
+          type: boolean
+        trace_sample_rate:
+          description: 'The percentage (0-100) of retained sessions with ingested
+            traces whose traces are indexed.
+
+            For example, 25.0 means 25% of retained sessions with ingested traces
+            have their traces indexed.'
+          example: 25.0
+          format: double
+          maximum: 100
+          minimum: 0
+          type: number
+      type: object
+    RumCrossProductSamplingCreate:
+      description: Configuration for cross-product sampling when creating a retention
+        filter.
+      properties:
+        trace_enabled:
+          description: Indicates whether trace cross-product sampling is enabled.
+          example: true
+          type: boolean
+        trace_sample_rate:
+          description: The percentage (0-100) of retained sessions with ingested traces
+            whose traces are indexed.
+          example: 25.0
+          format: double
+          maximum: 100
+          minimum: 0
+          type: number
+      required:
+      - trace_sample_rate
+      type: object
+    RumCrossProductSamplingUpdate:
+      description: Configuration for cross-product sampling when updating a retention
+        filter. All fields are optional for partial updates.
+      properties:
+        trace_enabled:
+          description: Indicates whether trace cross-product sampling is enabled.
+          example: true
+          type: boolean
+        trace_sample_rate:
+          description: The percentage (0-100) of retained sessions with ingested traces
+            whose traces are indexed.
+          example: 25.0
+          format: double
+          maximum: 100
+          minimum: 0
+          type: number
+      type: object
     RumMetricCompute:
       description: The compute rule to compute the rum-based metric.
       properties:
@@ -55026,6 +55089,8 @@ components:
     RumRetentionFilterAttributes:
       description: The object describing attributes of a RUM retention filter.
       properties:
+        cross_product_sampling:
+          $ref: '#/components/schemas/RumCrossProductSampling'
         enabled:
           $ref: '#/components/schemas/RumRetentionFilterEnabled'
         event_type:
@@ -55040,6 +55105,8 @@ components:
     RumRetentionFilterCreateAttributes:
       description: The object describing attributes of a RUM retention filter to create.
       properties:
+        cross_product_sampling:
+          $ref: '#/components/schemas/RumCrossProductSamplingCreate'
         enabled:
           $ref: '#/components/schemas/RumRetentionFilterEnabled'
         event_type:
@@ -55141,6 +55208,8 @@ components:
     RumRetentionFilterUpdateAttributes:
       description: The object describing attributes of a RUM retention filter to update.
       properties:
+        cross_product_sampling:
+          $ref: '#/components/schemas/RumCrossProductSamplingUpdate'
         enabled:
           $ref: '#/components/schemas/RumRetentionFilterEnabled'
         event_type:

docs/datadog_api_client.v2.model.rst

@@ -23867,6 +23867,27 @@ datadog\_api\_client.v2.model.rum\_compute\_type module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.rum\_cross\_product\_sampling module
+------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rum_cross_product_sampling
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.rum\_cross\_product\_sampling\_create module
+--------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rum_cross_product_sampling_create
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.rum\_cross\_product\_sampling\_update module
+--------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rum_cross_product_sampling_update
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.rum\_event module
 -----------------------------------------------
 

src/datadog_api_client/v1/model/usage_summary_date.py

@@ -149,6 +149,7 @@ def openapi_types(_):
             "ndm_netflow_events_sum": (int,),
             "netflow_indexed_events_count_sum": (int,),
             "network_device_wireless_top99p": (int,),
+            "network_path_sum": (int,),
             "npm_host_top99p": (int,),
             "observability_pipelines_bytes_processed_sum": (int,),
             "oci_host_sum": (int,),
@@ -367,6 +368,7 @@ def openapi_types(_):
         "ndm_netflow_events_sum": "ndm_netflow_events_sum",
         "netflow_indexed_events_count_sum": "netflow_indexed_events_count_sum",
         "network_device_wireless_top99p": "network_device_wireless_top99p",
+        "network_path_sum": "network_path_sum",
         "npm_host_top99p": "npm_host_top99p",
         "observability_pipelines_bytes_processed_sum": "observability_pipelines_bytes_processed_sum",
         "oci_host_sum": "oci_host_sum",
@@ -586,6 +588,7 @@ def __init__(
         ndm_netflow_events_sum: Union[int, UnsetType] = unset,
         netflow_indexed_events_count_sum: Union[int, UnsetType] = unset,
         network_device_wireless_top99p: Union[int, UnsetType] = unset,
+        network_path_sum: Union[int, UnsetType] = unset,
         npm_host_top99p: Union[int, UnsetType] = unset,
         observability_pipelines_bytes_processed_sum: Union[int, UnsetType] = unset,
         oci_host_sum: Union[int, UnsetType] = unset,
@@ -1056,6 +1059,9 @@ def __init__(
         :param network_device_wireless_top99p: Shows the 99th percentile of all Network Device Monitoring wireless devices over all hours in the current date for all organizations.
         :type network_device_wireless_top99p: int, optional
 
+        :param network_path_sum: Shows the sum of all Network Path scheduled tests over all hours in the current date for all organizations.
+        :type network_path_sum: int, optional
+
         :param npm_host_top99p: Shows the 99th percentile of all distinct Cloud Network Monitoring hosts (formerly known as Network hosts) over all hours in the current date for all organizations.
         :type npm_host_top99p: int, optional
 
@@ -1588,6 +1594,8 @@ def __init__(
             kwargs["netflow_indexed_events_count_sum"] = netflow_indexed_events_count_sum
         if network_device_wireless_top99p is not unset:
             kwargs["network_device_wireless_top99p"] = network_device_wireless_top99p
+        if network_path_sum is not unset:
+            kwargs["network_path_sum"] = network_path_sum
         if npm_host_top99p is not unset:
             kwargs["npm_host_top99p"] = npm_host_top99p
         if observability_pipelines_bytes_processed_sum is not unset:

src/datadog_api_client/v1/model/usage_summary_date_org.py

@@ -147,6 +147,7 @@ def openapi_types(_):
             "ndm_netflow_events_sum": (int,),
             "netflow_indexed_events_count_sum": (int,),
             "network_device_wireless_top99p": (int,),
+            "network_path_sum": (int,),
             "npm_host_top99p": (int,),
             "observability_pipelines_bytes_processed_sum": (int,),
             "oci_host_sum": (int,),
@@ -371,6 +372,7 @@ def openapi_types(_):
         "ndm_netflow_events_sum": "ndm_netflow_events_sum",
         "netflow_indexed_events_count_sum": "netflow_indexed_events_count_sum",
         "network_device_wireless_top99p": "network_device_wireless_top99p",
+        "network_path_sum": "network_path_sum",
         "npm_host_top99p": "npm_host_top99p",
         "observability_pipelines_bytes_processed_sum": "observability_pipelines_bytes_processed_sum",
         "oci_host_sum": "oci_host_sum",
@@ -596,6 +598,7 @@ def __init__(
         ndm_netflow_events_sum: Union[int, UnsetType] = unset,
         netflow_indexed_events_count_sum: Union[int, UnsetType] = unset,
         network_device_wireless_top99p: Union[int, UnsetType] = unset,
+        network_path_sum: Union[int, UnsetType] = unset,
         npm_host_top99p: Union[int, UnsetType] = unset,
         observability_pipelines_bytes_processed_sum: Union[int, UnsetType] = unset,
         oci_host_sum: Union[int, UnsetType] = unset,
@@ -1082,6 +1085,9 @@ def __init__(
         :param network_device_wireless_top99p: Shows the 99th percentile of all Network Device Monitoring wireless devices over all hours in the current date for the given org.
         :type network_device_wireless_top99p: int, optional
 
+        :param network_path_sum: Shows the sum of all Network Path scheduled tests over all hours in the current date for the given org.
+        :type network_path_sum: int, optional
+
         :param npm_host_top99p: Shows the 99th percentile of all distinct Cloud Network Monitoring hosts (formerly known as Network hosts) over all hours in the current date for the given org.
         :type npm_host_top99p: int, optional
 
@@ -1627,6 +1633,8 @@ def __init__(
             kwargs["netflow_indexed_events_count_sum"] = netflow_indexed_events_count_sum
         if network_device_wireless_top99p is not unset:
             kwargs["network_device_wireless_top99p"] = network_device_wireless_top99p
+        if network_path_sum is not unset:
+            kwargs["network_path_sum"] = network_path_sum
         if npm_host_top99p is not unset:
             kwargs["npm_host_top99p"] = npm_host_top99p
         if observability_pipelines_bytes_processed_sum is not unset:

src/datadog_api_client/v1/model/usage_summary_response.py

@@ -158,6 +158,7 @@ def openapi_types(_):
             "ndm_netflow_events_agg_sum": (int,),
             "netflow_indexed_events_count_agg_sum": (int,),
             "network_device_wireless_top99p_sum": (int,),
+            "network_path_agg_sum": (int,),
             "npm_host_top99p_sum": (int,),
             "observability_pipelines_bytes_processed_agg_sum": (int,),
             "oci_host_agg_sum": (int,),
@@ -387,6 +388,7 @@ def openapi_types(_):
         "ndm_netflow_events_agg_sum": "ndm_netflow_events_agg_sum",
         "netflow_indexed_events_count_agg_sum": "netflow_indexed_events_count_agg_sum",
         "network_device_wireless_top99p_sum": "network_device_wireless_top99p_sum",
+        "network_path_agg_sum": "network_path_agg_sum",
         "npm_host_top99p_sum": "npm_host_top99p_sum",
         "observability_pipelines_bytes_processed_agg_sum": "observability_pipelines_bytes_processed_agg_sum",
         "oci_host_agg_sum": "oci_host_agg_sum",
@@ -617,6 +619,7 @@ def __init__(
         ndm_netflow_events_agg_sum: Union[int, UnsetType] = unset,
         netflow_indexed_events_count_agg_sum: Union[int, UnsetType] = unset,
         network_device_wireless_top99p_sum: Union[int, UnsetType] = unset,
+        network_path_agg_sum: Union[int, UnsetType] = unset,
         npm_host_top99p_sum: Union[int, UnsetType] = unset,
         observability_pipelines_bytes_processed_agg_sum: Union[int, UnsetType] = unset,
         oci_host_agg_sum: Union[int, UnsetType] = unset,
@@ -1112,6 +1115,9 @@ def __init__(
         :param network_device_wireless_top99p_sum: Shows the 99th percentile of all Network Device Monitoring wireless devices over all hours in the current month for all organizations.
         :type network_device_wireless_top99p_sum: int, optional
 
+        :param network_path_agg_sum: Shows the sum of all Network Path scheduled tests over all hours in the current month for all organizations.
+        :type network_path_agg_sum: int, optional
+
         :param npm_host_top99p_sum: Shows the 99th percentile of all distinct Cloud Network Monitoring hosts (formerly known as Network hosts) over all hours in the current month for all organizations.
         :type npm_host_top99p_sum: int, optional
 
@@ -1674,6 +1680,8 @@ def __init__(
             kwargs["netflow_indexed_events_count_agg_sum"] = netflow_indexed_events_count_agg_sum
         if network_device_wireless_top99p_sum is not unset:
             kwargs["network_device_wireless_top99p_sum"] = network_device_wireless_top99p_sum
+        if network_path_agg_sum is not unset:
+            kwargs["network_path_agg_sum"] = network_path_agg_sum
         if npm_host_top99p_sum is not unset:
             kwargs["npm_host_top99p_sum"] = npm_host_top99p_sum
         if observability_pipelines_bytes_processed_agg_sum is not unset:

src/datadog_api_client/v2/model/rum_cross_product_sampling.py

@@ -0,0 +1,58 @@
+# 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.
+from __future__ import annotations
+
+from typing import Union
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+class RumCrossProductSampling(ModelNormal):
+    validations = {
+        "trace_sample_rate": {
+            "inclusive_maximum": 100,
+            "inclusive_minimum": 0,
+        },
+    }
+
+    @cached_property
+    def openapi_types(_):
+        return {
+            "trace_enabled": (bool,),
+            "trace_sample_rate": (float,),
+        }
+
+    attribute_map = {
+        "trace_enabled": "trace_enabled",
+        "trace_sample_rate": "trace_sample_rate",
+    }
+
+    def __init__(
+        self_,
+        trace_enabled: Union[bool, UnsetType] = unset,
+        trace_sample_rate: Union[float, UnsetType] = unset,
+        **kwargs,
+    ):
+        """
+        Configuration for additional APM trace data retention for sessions that match this retention filter.
+        When a session matches the filter and is retained (based on ``sample_rate`` ), you can configure
+        the percentage of retained sessions with ingested traces whose traces are indexed.
+
+        :param trace_enabled: Indicates whether trace cross-product sampling is enabled. If ``false`` , no traces are indexed regardless of ``trace_sample_rate``.
+        :type trace_enabled: bool, optional
+
+        :param trace_sample_rate: The percentage (0-100) of retained sessions with ingested traces whose traces are indexed.
+            For example, 25.0 means 25% of retained sessions with ingested traces have their traces indexed.
+        :type trace_sample_rate: float, optional
+        """
+        if trace_enabled is not unset:
+            kwargs["trace_enabled"] = trace_enabled
+        if trace_sample_rate is not unset:
+            kwargs["trace_sample_rate"] = trace_sample_rate
+        super().__init__(kwargs)

src/datadog_api_client/v2/model/rum_cross_product_sampling_create.py

@@ -0,0 +1,50 @@
+# 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.
+from __future__ import annotations
+
+from typing import Union
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+class RumCrossProductSamplingCreate(ModelNormal):
+    validations = {
+        "trace_sample_rate": {
+            "inclusive_maximum": 100,
+            "inclusive_minimum": 0,
+        },
+    }
+
+    @cached_property
+    def openapi_types(_):
+        return {
+            "trace_enabled": (bool,),
+            "trace_sample_rate": (float,),
+        }
+
+    attribute_map = {
+        "trace_enabled": "trace_enabled",
+        "trace_sample_rate": "trace_sample_rate",
+    }
+
+    def __init__(self_, trace_sample_rate: float, trace_enabled: Union[bool, UnsetType] = unset, **kwargs):
+        """
+        Configuration for cross-product sampling when creating a retention filter.
+
+        :param trace_enabled: Indicates whether trace cross-product sampling is enabled.
+        :type trace_enabled: bool, optional
+
+        :param trace_sample_rate: The percentage (0-100) of retained sessions with ingested traces whose traces are indexed.
+        :type trace_sample_rate: float
+        """
+        if trace_enabled is not unset:
+            kwargs["trace_enabled"] = trace_enabled
+        super().__init__(kwargs)
+
+        self_.trace_sample_rate = trace_sample_rate