feat - Add data-quality alert monitor type support (#3594)

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

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

.generator/schemas/v1/openapi.yaml

@@ -7534,6 +7534,104 @@ components:
       - data_source
       - query
       type: object
+    MonitorFormulaAndFunctionDataQualityDataSource:
+      description: Data source for data quality queries.
+      enum:
+      - data_quality_metrics
+      example: data_quality_metrics
+      type: string
+      x-enum-varnames:
+      - DATA_QUALITY_METRICS
+    MonitorFormulaAndFunctionDataQualityMeasure:
+      description: 'The data quality measure to query. Common values include:
+
+        `bytes`, `cardinality`, `custom`, `freshness`, `max`, `mean`, `min`,
+
+        `nullness`, `percent_negative`, `percent_zero`, `row_count`, `stddev`,
+
+        `sum`, `uniqueness`. Additional values may be supported.'
+      example: row_count
+      type: string
+    MonitorFormulaAndFunctionDataQualityModelTypeOverride:
+      description: Override for the model type used in anomaly detection.
+      enum:
+      - freshness
+      - percentage
+      - any
+      type: string
+      x-enum-varnames:
+      - FRESHNESS
+      - PERCENTAGE
+      - ANY
+    MonitorFormulaAndFunctionDataQualityMonitorOptions:
+      description: Monitor configuration options for data quality queries.
+      properties:
+        crontab_override:
+          description: Crontab expression to override the default schedule.
+          example: '* * * 10'
+          type: string
+        custom_sql:
+          description: Custom SQL query for the monitor.
+          example: SELECT COUNT(*) FROM users AS dd_value
+          type: string
+        custom_where:
+          description: Custom WHERE clause for the query.
+          example: USER_ID = 123
+          type: string
+        group_by_columns:
+          description: Columns to group results by.
+          example:
+          - col1
+          - col2
+          items:
+            type: string
+          type: array
+        model_type_override:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionDataQualityModelTypeOverride'
+      type: object
+    MonitorFormulaAndFunctionDataQualityQueryDefinition:
+      description: A formula and functions data quality query.
+      properties:
+        data_source:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionDataQualityDataSource'
+        filter:
+          description: Filter expression used to match on data entities. Uses Aastra
+            query syntax.
+          example: search for column where `database:production AND table:users`
+          type: string
+        group_by:
+          description: Optional grouping fields for aggregation.
+          example:
+          - entity_id
+          items:
+            type: string
+          type: array
+        measure:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionDataQualityMeasure'
+        monitor_options:
+          $ref: '#/components/schemas/MonitorFormulaAndFunctionDataQualityMonitorOptions'
+        name:
+          description: Name of the query for use in formulas.
+          example: query1
+          type: string
+        schema_version:
+          description: Schema version for the data quality query.
+          example: 0.0.1
+          type: string
+        scope:
+          description: 'Optional scoping expression to further filter metrics. Uses
+            metrics filter syntax.
+
+            This is useful when an entity has been configured to emit metrics with
+            additional tags.'
+          example: env:production
+          type: string
+      required:
+      - name
+      - data_source
+      - measure
+      - filter
+      type: object
     MonitorFormulaAndFunctionEventAggregation:
       description: Aggregation methods for event platform queries.
       enum:
@@ -7685,6 +7783,7 @@ components:
       oneOf:
       - $ref: '#/components/schemas/MonitorFormulaAndFunctionEventQueryDefinition'
       - $ref: '#/components/schemas/MonitorFormulaAndFunctionCostQueryDefinition'
+      - $ref: '#/components/schemas/MonitorFormulaAndFunctionDataQualityQueryDefinition'
     MonitorGroupSearchResponse:
       description: The response of a monitor group search.
       example:
@@ -8523,6 +8622,7 @@ components:
       - database-monitoring alert
       - network-performance alert
       - cost alert
+      - data-quality alert
       example: query alert
       type: string
       x-enum-varnames:
@@ -8545,6 +8645,7 @@ components:
       - DATABASE_MONITORING_ALERT
       - NETWORK_PERFORMANCE_ALERT
       - COST_ALERT
+      - DATA_QUALITY_ALERT
     MonitorUpdateRequest:
       description: Object describing a monitor update request.
       properties:

api/datadogV1/model_monitor_formula_and_function_data_quality_data_source.go

@@ -0,0 +1,64 @@
+// 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.
+
+package datadogV1
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// MonitorFormulaAndFunctionDataQualityDataSource Data source for data quality queries.
+type MonitorFormulaAndFunctionDataQualityDataSource string
+
+// List of MonitorFormulaAndFunctionDataQualityDataSource.
+const (
+	MONITORFORMULAANDFUNCTIONDATAQUALITYDATASOURCE_DATA_QUALITY_METRICS MonitorFormulaAndFunctionDataQualityDataSource = "data_quality_metrics"
+)
+
+var allowedMonitorFormulaAndFunctionDataQualityDataSourceEnumValues = []MonitorFormulaAndFunctionDataQualityDataSource{
+	MONITORFORMULAANDFUNCTIONDATAQUALITYDATASOURCE_DATA_QUALITY_METRICS,
+}
+
+// GetAllowedValues reeturns the list of possible values.
+func (v *MonitorFormulaAndFunctionDataQualityDataSource) GetAllowedValues() []MonitorFormulaAndFunctionDataQualityDataSource {
+	return allowedMonitorFormulaAndFunctionDataQualityDataSourceEnumValues
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (v *MonitorFormulaAndFunctionDataQualityDataSource) UnmarshalJSON(src []byte) error {
+	var value string
+	err := datadog.Unmarshal(src, &value)
+	if err != nil {
+		return err
+	}
+	*v = MonitorFormulaAndFunctionDataQualityDataSource(value)
+	return nil
+}
+
+// NewMonitorFormulaAndFunctionDataQualityDataSourceFromValue returns a pointer to a valid MonitorFormulaAndFunctionDataQualityDataSource
+// for the value passed as argument, or an error if the value passed is not allowed by the enum.
+func NewMonitorFormulaAndFunctionDataQualityDataSourceFromValue(v string) (*MonitorFormulaAndFunctionDataQualityDataSource, error) {
+	ev := MonitorFormulaAndFunctionDataQualityDataSource(v)
+	if ev.IsValid() {
+		return &ev, nil
+	}
+	return nil, fmt.Errorf("invalid value '%v' for MonitorFormulaAndFunctionDataQualityDataSource: valid values are %v", v, allowedMonitorFormulaAndFunctionDataQualityDataSourceEnumValues)
+}
+
+// IsValid return true if the value is valid for the enum, false otherwise.
+func (v MonitorFormulaAndFunctionDataQualityDataSource) IsValid() bool {
+	for _, existing := range allowedMonitorFormulaAndFunctionDataQualityDataSourceEnumValues {
+		if existing == v {
+			return true
+		}
+	}
+	return false
+}
+
+// Ptr returns reference to MonitorFormulaAndFunctionDataQualityDataSource value.
+func (v MonitorFormulaAndFunctionDataQualityDataSource) Ptr() *MonitorFormulaAndFunctionDataQualityDataSource {
+	return &v
+}

api/datadogV1/model_monitor_formula_and_function_data_quality_model_type_override.go

@@ -0,0 +1,68 @@
+// 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.
+
+package datadogV1
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// MonitorFormulaAndFunctionDataQualityModelTypeOverride Override for the model type used in anomaly detection.
+type MonitorFormulaAndFunctionDataQualityModelTypeOverride string
+
+// List of MonitorFormulaAndFunctionDataQualityModelTypeOverride.
+const (
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_FRESHNESS  MonitorFormulaAndFunctionDataQualityModelTypeOverride = "freshness"
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_PERCENTAGE MonitorFormulaAndFunctionDataQualityModelTypeOverride = "percentage"
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_ANY        MonitorFormulaAndFunctionDataQualityModelTypeOverride = "any"
+)
+
+var allowedMonitorFormulaAndFunctionDataQualityModelTypeOverrideEnumValues = []MonitorFormulaAndFunctionDataQualityModelTypeOverride{
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_FRESHNESS,
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_PERCENTAGE,
+	MONITORFORMULAANDFUNCTIONDATAQUALITYMODELTYPEOVERRIDE_ANY,
+}
+
+// GetAllowedValues reeturns the list of possible values.
+func (v *MonitorFormulaAndFunctionDataQualityModelTypeOverride) GetAllowedValues() []MonitorFormulaAndFunctionDataQualityModelTypeOverride {
+	return allowedMonitorFormulaAndFunctionDataQualityModelTypeOverrideEnumValues
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (v *MonitorFormulaAndFunctionDataQualityModelTypeOverride) UnmarshalJSON(src []byte) error {
+	var value string
+	err := datadog.Unmarshal(src, &value)
+	if err != nil {
+		return err
+	}
+	*v = MonitorFormulaAndFunctionDataQualityModelTypeOverride(value)
+	return nil
+}
+
+// NewMonitorFormulaAndFunctionDataQualityModelTypeOverrideFromValue returns a pointer to a valid MonitorFormulaAndFunctionDataQualityModelTypeOverride
+// for the value passed as argument, or an error if the value passed is not allowed by the enum.
+func NewMonitorFormulaAndFunctionDataQualityModelTypeOverrideFromValue(v string) (*MonitorFormulaAndFunctionDataQualityModelTypeOverride, error) {
+	ev := MonitorFormulaAndFunctionDataQualityModelTypeOverride(v)
+	if ev.IsValid() {
+		return &ev, nil
+	}
+	return nil, fmt.Errorf("invalid value '%v' for MonitorFormulaAndFunctionDataQualityModelTypeOverride: valid values are %v", v, allowedMonitorFormulaAndFunctionDataQualityModelTypeOverrideEnumValues)
+}
+
+// IsValid return true if the value is valid for the enum, false otherwise.
+func (v MonitorFormulaAndFunctionDataQualityModelTypeOverride) IsValid() bool {
+	for _, existing := range allowedMonitorFormulaAndFunctionDataQualityModelTypeOverrideEnumValues {
+		if existing == v {
+			return true
+		}
+	}
+	return false
+}
+
+// Ptr returns reference to MonitorFormulaAndFunctionDataQualityModelTypeOverride value.
+func (v MonitorFormulaAndFunctionDataQualityModelTypeOverride) Ptr() *MonitorFormulaAndFunctionDataQualityModelTypeOverride {
+	return &v
+}