feat: Add disable_health_status_reporting field

Author: Gabe Fuentes

newrelic/resource_newrelic_nrql_alert_condition.go

@@ -98,6 +98,12 @@ func termSchema() *schema.Resource {
 					},
 				},
 			},
+			"disable_health_status_reporting": {
+				Type:        schema.TypeBool,
+				Optional:    true,
+				Default:     false,
+				Description: "Violations will not change system health status for this term.",
+			},
 		},
 	}
 }

newrelic/resource_newrelic_nrql_alert_condition_test.go

@@ -612,6 +612,28 @@ func TestAccNewRelicNrqlAlertCondition_StaticConditionPrediction(t *testing.T) {
 	})
 }
 
+func TestAccNewRelicNrqlAlertCondition_StaticConditionDisableHealthStatusReporting(t *testing.T) {
+	resourceName := "newrelic_nrql_alert_condition.foo"
+	rName := acctest.RandString(5)
+
+	resource.ParallelTest(t, resource.TestCase{
+		PreCheck:     func() { testAccPreCheckEnvVars(t) },
+		Providers:    testAccProviders,
+		CheckDestroy: testAccCheckNewRelicNrqlAlertConditionDestroy,
+		Steps: []resource.TestStep{
+			// Test: Create
+			{
+				Config: testAccNewRelicNrqlAlertConditionStaticWithDisableHealthStatusReporting(
+					rName,
+				),
+				Check: resource.ComposeTestCheckFunc(
+					testAccCheckNewRelicNrqlAlertConditionExists(resourceName),
+				),
+			},
+		},
+	})
+}
+
 func TestAccNewRelicNrqlAlertCondition_StaticConditionExpectedTermination(t *testing.T) {
 	resourceName := "newrelic_nrql_alert_condition.foo"
 	rName := acctest.RandString(5)
@@ -1423,3 +1445,36 @@ resource "newrelic_nrql_alert_condition" "foo" {
 }
 `, name, predictBy)
 }
+
+func testAccNewRelicNrqlAlertConditionStaticWithDisableHealthStatusReporting(
+	name string,
+) string {
+	return fmt.Sprintf(`
+resource "newrelic_alert_policy" "foo" {
+	name = "tf-test-%[1]s"
+}
+
+resource "newrelic_nrql_alert_condition" "foo" {
+	policy_id = newrelic_alert_policy.foo.id
+
+	name                         = "tf-test-%[1]s"
+	type                         = "static"
+	enabled                      = false
+	violation_time_limit_seconds = 3600
+	aggregation_delay            = 120
+	aggregation_method           = "event_flow"
+
+	nrql {
+		query = "SELECT uniqueCount(hostname) FROM ComputeSample"
+	}
+
+	critical {
+		operator              = "below"
+		threshold             = 0
+		threshold_duration    = 120
+		threshold_occurrences = "ALL"
+		disable_health_status_reporting = true
+	}
+}
+`, name)
+}

newrelic/structures_newrelic_nrql_alert_condition.go

@@ -286,6 +286,11 @@ func expandNrqlConditionTerm(term map[string]interface{}, conditionType, priorit
 		ThresholdOccurrences: *thresholdOccurrences,
 	}
 
+	if term["disable_health_status_reporting"] != nil {
+		disableHealthStatusReporting := term["disable_health_status_reporting"].(bool)
+		expandedTerm.DisableHealthStatusReporting = &disableHealthStatusReporting
+	}
+
 	if conditionType == "baseline" {
 		return &expandedTerm, nil
 	}
@@ -781,6 +786,10 @@ func flattenNrqlTerms(terms []alerts.NrqlConditionTerm, configTerms []interface{
 			dst["threshold_occurrences"] = strings.ToLower(string(term.ThresholdOccurrences))
 		}
 
+		if term.DisableHealthStatusReporting != nil {
+			dst["disable_health_status_reporting"] = term.DisableHealthStatusReporting
+		}
+
 		out = append(out, dst)
 	}
 
@@ -808,6 +817,10 @@ func handleImportFlattenNrqlTerms(terms []alerts.NrqlConditionTerm) []map[string
 			dst["prediction"] = []interface{}{predictionBlockContents}
 		}
 
+		if term.DisableHealthStatusReporting != nil {
+			dst["disable_health_status_reporting"] = term.DisableHealthStatusReporting
+		}
+
 		out = append(out, dst)
 	}
 
@@ -828,8 +841,9 @@ func getConfiguredTerms(configTerms []interface{}) []map[string]interface{} {
 			"time_function": t["time_function"],
 
 			// NerdGraph fields
-			"threshold_duration":    t["threshold_duration"],
-			"threshold_occurrences": t["threshold_occurrences"],
+			"threshold_duration":              t["threshold_duration"],
+			"threshold_occurrences":           t["threshold_occurrences"],
+			"disable_health_status_reporting": t["disable_health_status_reporting"],
 		}
 
 		if t["prediction"] != nil {

newrelic/structures_newrelic_nrql_alert_condition_test.go

@@ -17,8 +17,9 @@ import (
 )
 
 var (
-	testThresholdLow  = 1.0
-	testThresholdHigh = 10.9
+	testThresholdLow                 = 1.0
+	testThresholdHigh                = 10.9
+	testDisableHealthStatusReporting = true
 )
 
 func TestExpandNrqlAlertConditionInput(t *testing.T) {
@@ -714,17 +715,19 @@ func TestExpandNrqlConditionTerm(t *testing.T) {
 			Priority:      "critical",
 			ConditionType: "static",
 			Term: map[string]interface{}{
-				"threshold":             10.9,
-				"threshold_duration":    5,
-				"threshold_occurrences": "ALL",
-				"operator":              "equals",
+				"threshold":                       10.9,
+				"threshold_duration":              5,
+				"threshold_occurrences":           "ALL",
+				"operator":                        "equals",
+				"disable_health_status_reporting": true,
 			},
 			Expected: &alerts.NrqlConditionTerm{
-				Operator:             alerts.AlertsNRQLConditionTermsOperator("EQUALS"),
-				Priority:             alerts.NrqlConditionPriority("CRITICAL"),
-				Threshold:            &testThresholdHigh,
-				ThresholdDuration:    5,
-				ThresholdOccurrences: "ALL",
+				Operator:                     alerts.AlertsNRQLConditionTermsOperator("EQUALS"),
+				Priority:                     alerts.NrqlConditionPriority("CRITICAL"),
+				Threshold:                    &testThresholdHigh,
+				ThresholdDuration:            5,
+				ThresholdOccurrences:         "ALL",
+				DisableHealthStatusReporting: &testDisableHealthStatusReporting,
 			},
 		},
 		"critical explicit priority": {

website/docs/r/alert_condition.html.markdown

@@ -6,7 +6,7 @@ description: |-
   Create and manage alert conditions for APM, Browser, and Mobile in New Relic.
 ---
 
-# Resource: newrelic\_alert\_condition
+# Resource: newrelic_alert_condition
 
 Use this resource to create and manage alert conditions for APM, Browser, and Mobile in New Relic.
 
@@ -49,63 +49,63 @@ resource "newrelic_alert_condition" "foo" {
 
 The following arguments are supported:
 
-  * `policy_id` - (Required) The ID of the policy where this condition should be used.
-  * `name` - (Required) The title of the condition. Must be between 1 and 64 characters, inclusive.
-  * `type` - (Required) The type of condition. One of: `apm_app_metric`, `apm_jvm_metric`, `apm_kt_metric`, `browser_metric`, `mobile_metric`
-  * `entities` - (Required) The instance IDs associated with this condition.
-  * `metric` - (Required) The metric field accepts parameters based on the `type` set. One of these metrics based on `type`:
-    * `apm_app_metric`
-      * `apdex`
-      * `error_percentage`
-      * `response_time_background`
-      * `response_time_web`
-      * `throughput_background`
-      * `throughput_web`
-      * `user_defined`
-    * `apm_jvm_metric`
-      * `cpu_utilization_time`
-      * `deadlocked_threads`
-      * `gc_cpu_time`
-      * `heap_memory_usage`
-    * `apm_kt_metric`
-      * `apdex`
-      * `error_count`
-      * `error_percentage`
-      * `response_time`
-      * `throughput`
-    * `browser_metric`
-      * `ajax_response_time`
-      * `ajax_throughput`
-      * `dom_processing`
-      * `end_user_apdex`
-      * `network`
-      * `page_rendering`
-      * `page_view_throughput`
-      * `page_views_with_js_errors`
-      * `request_queuing`
-      * `total_page_load`
-      * `user_defined`
-      * `web_application`
-    * `mobile_metric`
-      * `database`
-      * `images`
-      * `json`
-      * `mobile_crash_rate`
-      * `network_error_percentage`
-      * `network`
-      * `status_error_percentage`
-      * `user_defined`
-      * `view_loading`
-  * `condition_scope` - (Required for some types) `application` or `instance`.  Choose `application` for most scenarios.  If you are using the JVM plugin in New Relic, the `instance` setting allows your condition to trigger [for specific app instances](https://docs.newrelic.com/docs/alerts/new-relic-alerts/defining-conditions/scope-alert-thresholds-specific-instances).
-  * `enabled` - (Optional) Whether the condition is enabled or not. Defaults to true.
-  * `gc_metric` - (Optional) A valid Garbage Collection metric e.g. `GC/G1 Young Generation`.
-  * `violation_close_timer` - (Optional) Automatically close instance-based incidents, including JVM health metric incidents, after the number of hours specified. Must be between 1 and 720 hours. Must be specified in the following two cases, to prevent drift:
-    * when `type` = `apm_app_metric` and `condition_scope` = `instance`
-    * when `type` = `apm_jvm_metric`
-  * `runbook_url` - (Optional) Runbook URL to display in notifications.
-  * `term` - (Required) A list of terms for this condition. See [Terms](#terms) below for details.
-  * `user_defined_metric` - (Optional) A custom metric to be evaluated.
-  * `user_defined_value_function` - (Optional) One of: `average`, `min`, `max`, `total`, `sample_size`, `rate` or `percent`.
+- `policy_id` - (Required) The ID of the policy where this condition should be used.
+- `name` - (Required) The title of the condition. Must be between 1 and 64 characters, inclusive.
+- `type` - (Required) The type of condition. One of: `apm_app_metric`, `apm_jvm_metric`, `apm_kt_metric`, `browser_metric`, `mobile_metric`
+- `entities` - (Required) The instance IDs associated with this condition.
+- `metric` - (Required) The metric field accepts parameters based on the `type` set. One of these metrics based on `type`:
+  - `apm_app_metric`
+    - `apdex`
+    - `error_percentage`
+    - `response_time_background`
+    - `response_time_web`
+    - `throughput_background`
+    - `throughput_web`
+    - `user_defined`
+  - `apm_jvm_metric`
+    - `cpu_utilization_time`
+    - `deadlocked_threads`
+    - `gc_cpu_time`
+    - `heap_memory_usage`
+  - `apm_kt_metric`
+    - `apdex`
+    - `error_count`
+    - `error_percentage`
+    - `response_time`
+    - `throughput`
+  - `browser_metric`
+    - `ajax_response_time`
+    - `ajax_throughput`
+    - `dom_processing`
+    - `end_user_apdex`
+    - `network`
+    - `page_rendering`
+    - `page_view_throughput`
+    - `page_views_with_js_errors`
+    - `request_queuing`
+    - `total_page_load`
+    - `user_defined`
+    - `web_application`
+  - `mobile_metric`
+    - `database`
+    - `images`
+    - `json`
+    - `mobile_crash_rate`
+    - `network_error_percentage`
+    - `network`
+    - `status_error_percentage`
+    - `user_defined`
+    - `view_loading`
+- `condition_scope` - (Required for some types) `application` or `instance`. Choose `application` for most scenarios. If you are using the JVM plugin in New Relic, the `instance` setting allows your condition to trigger [for specific app instances](https://docs.newrelic.com/docs/alerts/new-relic-alerts/defining-conditions/scope-alert-thresholds-specific-instances).
+- `enabled` - (Optional) Whether the condition is enabled or not. Defaults to true.
+- `gc_metric` - (Optional) A valid Garbage Collection metric e.g. `GC/G1 Young Generation`.
+- `violation_close_timer` - (Optional) Automatically close instance-based incidents, including JVM health metric incidents, after the number of hours specified. Must be between 1 and 720 hours. Must be specified in the following two cases, to prevent drift:
+  - when `type` = `apm_app_metric` and `condition_scope` = `instance`
+  - when `type` = `apm_jvm_metric`
+- `runbook_url` - (Optional) Runbook URL to display in notifications.
+- `term` - (Required) A list of terms for this condition. See [Terms](#terms) below for details.
+- `user_defined_metric` - (Optional) A custom metric to be evaluated.
+- `user_defined_value_function` - (Optional) One of: `average`, `min`, `max`, `total`, `sample_size`, `rate` or `percent`.
 
 -> **NOTE:** The `user_defined_value_function` can have `rate` or `percent` only when the `type` is `mobile_metric`.
 
@@ -117,18 +117,19 @@ Warning: This resource will use the account ID linked to your API key. At the mo
 
 The `term` mapping supports the following arguments:
 
-  * `duration` - (Required) In minutes, must be in the range of `5` to `120`, inclusive.
-  * `operator` - (Optional) `above`, `below`, or `equal`.  Defaults to `equal`.
-  * `priority` - (Optional) `critical` or `warning`.  Defaults to `critical`. Terms must include at least one `critical` priority term
-  * `threshold` - (Required) Must be 0 or greater.
-  * `time_function` - (Required) `all` or `any`.
+- `duration` - (Required) In minutes, must be in the range of `5` to `120`, inclusive.
+- `operator` - (Optional) `above`, `below`, or `equal`. Defaults to `equal`.
+- `priority` - (Optional) `critical` or `warning`. Defaults to `critical`. Terms must include at least one `critical` priority term
+- `threshold` - (Required) Must be 0 or greater.
+- `time_function` - (Required) `all` or `any`.
+- `disable_health_status_reporting` - (Optional) `true` or `false`. Defaults to `false` when field not included in TF config. Violations will not change system health status for this term.
 
 ## Attributes Reference
 
 In addition to all arguments above, the following attributes are exported:
 
-  * `id` - The ID of the alert condition.
-  * `entity_guid` - The unique entity identifier of the condition in New Relic.
+- `id` - The ID of the alert condition.
+- `entity_guid` - The unique entity identifier of the condition in New Relic.
 
 ## Import