Add Network Path Monitors to API Docs (#3604)

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

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

.generator/schemas/v1/openapi.yaml

@@ -7993,6 +7993,7 @@ components:
       - spans
       - database_queries
       - network
+      - network_path
       example: rum
       type: string
       x-enum-varnames:
@@ -8005,6 +8006,7 @@ components:
       - SPANS
       - DATABASE_QUERIES
       - NETWORK
+      - NETWORK_PATH
     MonitorFormulaAndFunctionQueryDefinition:
       description: A formula and function query.
       oneOf:
@@ -8850,6 +8852,7 @@ components:
       - network-performance alert
       - cost alert
       - data-quality alert
+      - network-path alert
       example: query alert
       type: string
       x-enum-varnames:
@@ -8873,6 +8876,7 @@ components:
       - NETWORK_PERFORMANCE_ALERT
       - COST_ALERT
       - DATA_QUALITY_ALERT
+      - NETWORK_PATH_ALERT
     MonitorUpdateRequest:
       description: Object describing a monitor update request.
       properties:
@@ -31680,10 +31684,11 @@ paths:
         alert`\n- watchdog: `event-v2 alert`\n- event-v2: `event-v2 alert`\n- audit:
         `audit alert`\n- error-tracking: `error-tracking alert`\n- database-monitoring:
         `database-monitoring alert`\n- network-performance: `network-performance alert`\n-
-        cloud cost: `cost alert`\n\n**Notes**:\n- Synthetic monitors are created through
-        the Synthetics API. See the [Synthetics API](https://docs.datadoghq.com/api/latest/synthetics/)
-        documentation for more information.\n- Log monitors require an unscoped App
-        Key.\n\n#### Query Types\n\n##### Metric Alert Query\n\nExample: `time_aggr(time_window):space_aggr:metric{tags}
+        cloud cost: `cost alert`\n- network-path: `network-path alert`\n\n**Notes**:\n-
+        Synthetic monitors are created through the Synthetics API. See the [Synthetics
+        API](https://docs.datadoghq.com/api/latest/synthetics/) documentation for
+        more information.\n- Log monitors require an unscoped App Key.\n\n#### Query
+        Types\n\n##### Metric Alert Query\n\nExample: `time_aggr(time_window):space_aggr:metric{tags}
         [by {key}] operator #`\n\n- `time_aggr`: avg, sum, max, min, change, or pct_change\n-
         `time_window`: `last_#m` (with `#` between 1 and 10080 depending on the monitor
         type) or `last_#h`(with `#` between 1 and 168 depending on the monitor type)
@@ -31813,7 +31818,15 @@ paths:
         \   - for `threshold` supports `<`, `<=`, `>`, `>=`, `==`, or `!=`\n    -
         for `change` supports `>`, `<`\n    - for `anomaly` supports `>=`\n    - for
         `forecast` supports `>`\n- `#` an integer or decimal number used to set the
-        threshold."
+        threshold.\n\n**Network Path Alert Query**\n\nExample: `network-path(query).index(index_name).rollup(rollup_method[,
+        measure]).last(time_window) operator #`\n\n- `query` The search query - following
+        the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n-
+        `index_name` The data type to monitor on - supports `netpath-path` and `netpath-hop`.\n-
+        `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n-
+        `measure` For `avg` and cardinality `rollup_method` - specify the measure
+        or the facet name you want to use.\n- `time_window` #m (between 1 and 2880),
+        #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n-
+        `#` an integer or decimal number used to set the threshold."
       operationId: CreateMonitor
       requestBody:
         content:

api/datadogV1/api_monitors.go

@@ -131,6 +131,7 @@ func (a *MonitorsApi) CheckCanDeleteMonitor(ctx _context.Context, monitorIds []i
 // - database-monitoring: `database-monitoring alert`
 // - network-performance: `network-performance alert`
 // - cloud cost: `cost alert`
+// - network-path: `network-path alert`
 //
 // **Notes**:
 // - Synthetic monitors are created through the Synthetics API. See the [Synthetics API](https://docs.datadoghq.com/api/latest/synthetics/) documentation for more information.
@@ -324,6 +325,18 @@ func (a *MonitorsApi) CheckCanDeleteMonitor(ctx _context.Context, monitorIds []i
 //   - for `forecast` supports `>`
 //
 // - `#` an integer or decimal number used to set the threshold.
+//
+// **Network Path Alert Query**
+//
+// Example: `network-path(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #`
+//
+// - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+// - `index_name` The data type to monitor on - supports `netpath-path` and `netpath-hop`.
+// - `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.
+// - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+// - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+// - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+// - `#` an integer or decimal number used to set the threshold.
 func (a *MonitorsApi) CreateMonitor(ctx _context.Context, body Monitor) (Monitor, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost

api/datadogV1/model_monitor_formula_and_function_events_data_source.go

@@ -24,6 +24,7 @@ const (
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_SPANS            MonitorFormulaAndFunctionEventsDataSource = "spans"
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_DATABASE_QUERIES MonitorFormulaAndFunctionEventsDataSource = "database_queries"
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_NETWORK          MonitorFormulaAndFunctionEventsDataSource = "network"
+	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_NETWORK_PATH     MonitorFormulaAndFunctionEventsDataSource = "network_path"
 )
 
 var allowedMonitorFormulaAndFunctionEventsDataSourceEnumValues = []MonitorFormulaAndFunctionEventsDataSource{
@@ -36,6 +37,7 @@ var allowedMonitorFormulaAndFunctionEventsDataSourceEnumValues = []MonitorFormul
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_SPANS,
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_DATABASE_QUERIES,
 	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_NETWORK,
+	MONITORFORMULAANDFUNCTIONEVENTSDATASOURCE_NETWORK_PATH,
 }
 
 // GetAllowedValues reeturns the list of possible values.

api/datadogV1/model_monitor_type.go

@@ -35,6 +35,7 @@ const (
 	MONITORTYPE_NETWORK_PERFORMANCE_ALERT MonitorType = "network-performance alert"
 	MONITORTYPE_COST_ALERT                MonitorType = "cost alert"
 	MONITORTYPE_DATA_QUALITY_ALERT        MonitorType = "data-quality alert"
+	MONITORTYPE_NETWORK_PATH_ALERT        MonitorType = "network-path alert"
 )
 
 var allowedMonitorTypeEnumValues = []MonitorType{
@@ -58,6 +59,7 @@ var allowedMonitorTypeEnumValues = []MonitorType{
 	MONITORTYPE_NETWORK_PERFORMANCE_ALERT,
 	MONITORTYPE_COST_ALERT,
 	MONITORTYPE_DATA_QUALITY_ALERT,
+	MONITORTYPE_NETWORK_PATH_ALERT,
 }
 
 // GetAllowedValues reeturns the list of possible values.