Update Monitoring Alert Policy SQL Condition Documentation (#13214) (#21679)

[upstream:516920334b5775456396b9916dc1be6dc606873f]

Signed-off-by: Modular Magician <magic-modules@google.com>

Author: modular-magician

.changelog/13214.txt

@@ -0,0 +1,3 @@
+```release-note:none
+Added examples of monitoring alert policy sql conditions. Corrected field labels to reflect their intended behavior.
+```

google/services/monitoring/resource_monitoring_alert_policy.go

@@ -474,18 +474,17 @@ to filter the input so that the query receives all rows received
 since the last time the query was run.`,
 									},
 									"boolean_test": {
-										Type:     schema.TypeList,
-										Optional: true,
-										Description: `The start date and time of the query. If left unspecified, then the
-query will start immediately.`,
-										MaxItems: 1,
+										Type:        schema.TypeList,
+										Optional:    true,
+										Description: `A test that uses an alerting result in a boolean column produced by the SQL query.`,
+										MaxItems:    1,
 										Elem: &schema.Resource{
 											Schema: map[string]*schema.Schema{
 												"column": {
 													Type:     schema.TypeString,
 													Required: true,
-													Description: `The name of the column containing the boolean value. If the value
-in a row is NULL, that row is ignored.`,
+													Description: `The name of the column containing the boolean value. If the value in a row is
+NULL, that row is ignored.`,
 												},
 											},
 										},
@@ -591,7 +590,7 @@ equal to 5 minutes and less than or equal to 1440 minutes.`,
 									"row_count_test": {
 										Type:        schema.TypeList,
 										Optional:    true,
-										Description: `Test the row count against a threshold.`,
+										Description: `A test that checks if the number of rows in the result set violates some threshold.`,
 										MaxItems:    1,
 										Elem: &schema.Resource{
 											Schema: map[string]*schema.Schema{
@@ -611,7 +610,7 @@ COMPARISON_GT are supported currently. Possible values: ["COMPARISON_GT", "COMPA
 												"threshold": {
 													Type:        schema.TypeInt,
 													Required:    true,
-													Description: `Test the boolean value in the indicated column.`,
+													Description: `The value against which to compare the row count.`,
 												},
 											},
 										},

website/docs/r/monitoring_alert_policy.html.markdown

@@ -136,6 +136,28 @@ resource "google_monitoring_alert_policy" "alert_policy" {
   }
 }
 ```
+## Example Usage - Monitoring Alert Policy Sql Condition
+
+
+```hcl
+resource "google_monitoring_alert_policy" "alert_policy" {
+  display_name = "My Alert Policy"
+  combiner     = "OR"
+  conditions {
+    display_name = "minutes row count"
+    condition_sql {
+      query = "SELECT severity, resource FROM my_project.global._Default._AllLogs WHERE severity IS NOT NULL"
+      minutes {
+        periodicity = 600
+      }
+      row_count_test {
+        comparison = "COMPARISON_GT"
+        threshold  = "0"
+      }
+    }
+  }
+}
+```
 
 ## Argument Reference
 
@@ -879,13 +901,12 @@ The following arguments are supported:
 
 * `row_count_test` -
   (Optional)
-  Test the row count against a threshold.
+  A test that checks if the number of rows in the result set violates some threshold.
   Structure is [documented below](#nested_conditions_conditions_condition_sql_row_count_test).
 
 * `boolean_test` -
   (Optional)
-  The start date and time of the query. If left unspecified, then the
-  query will start immediately.
+  A test that uses an alerting result in a boolean column produced by the SQL query.
   Structure is [documented below](#nested_conditions_conditions_condition_sql_boolean_test).
 
 
@@ -965,14 +986,14 @@ The following arguments are supported:
 
 * `threshold` -
   (Required)
-  Test the boolean value in the indicated column.
+  The value against which to compare the row count.
 
 <a name="nested_conditions_conditions_condition_sql_boolean_test"></a>The `boolean_test` block supports:
 
 * `column` -
   (Required)
-  The name of the column containing the boolean value. If the value
-  in a row is NULL, that row is ignored.
+  The name of the column containing the boolean value. If the value in a row is
+  NULL, that row is ignored.
 
 - - -