feat(fastly_alert): implement resource and documentation

docs/resources/alert.md

@@ -0,0 +1,80 @@
+---
+layout: "fastly"
+page_title: "Fastly: alert"
+sidebar_current: "docs-fastly-resource-alert"
+description: |-
+  Provides a Fastly Alert. Alerts send notifications to custom integrations (e.g., Slack channels, PagerDuty, Microsoft Teams and New Relic) when an observed metric either exceeds or falls below a threshold.
+---
+
+# fastly_alert
+
+Provides a Fastly Alert. Alerts send notifications to custom integrations (e.g., Slack channels, PagerDuty, Microsoft Teams and New Relic) when an observed metric either exceeds or falls below a threshold.
+
+## Example Usage
+
+```terraform
+resource "fastly_service_vcl" "example" {
+  name = "my_vcl_service"
+  # ...
+}
+
+resource "fastly_alert" "example" {
+  name = "my_vcl_service errors"
+  service_id = fastly_service_vcl.example.id
+  source = "stats"
+  metric = "status_5xx"
+
+  evaluation_strategy {
+    type = "above_threshold"
+    period = "5m"
+    threshold = 10
+  }
+}
+```
+
+## Import
+
+Fastly Alerts can be imported using their ID, e.g.
+
+```sh
+$ terraform import fastly_alert.example xxxxxxxxxxxxxxxxxxxx
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `evaluation_strategy` (Block List, Min: 1, Max: 1) Criteria on how to alert. (see [below for nested schema](#nestedblock--evaluation_strategy))
+- `metric` (String) The metric name to alert on for a specific source: [domains](https://developer.fastly.com/reference/api/metrics-stats/domain-inspector/historical), [origins](https://developer.fastly.com/reference/api/metrics-stats/origin-inspector/historical), or [stats](https://developer.fastly.com/reference/api/metrics-stats/historical-stats).
+- `name` (String) The name of the alert.
+- `service_id` (String) The service which the alert monitors.
+- `source` (String) The source where the metric comes from. One of: `domains`, `origins`, `stats`.
+
+### Optional
+
+- `description` (String) Additional text that is included in the alert notification.
+- `dimensions` (Block List, Max: 1) More filters depending on the source type. (see [below for nested schema](#nestedblock--dimensions))
+- `integration_ids` (Set of String) List of integrations used to notify when alert fires.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+<a id="nestedblock--evaluation_strategy"></a>
+### Nested Schema for `evaluation_strategy`
+
+Required:
+
+- `period` (String) The length of time to evaluate whether the conditions have been met. The data is polled every minute. One of: `5m`, `15m`, `30m`.
+- `threshold` (Number) Threshold used to alert.
+- `type` (String) Type of strategy to use to evaluate. One of: `above_threshold`, `below_threshold`.
+
+
+<a id="nestedblock--dimensions"></a>
+### Nested Schema for `dimensions`
+
+Optional:
+
+- `domains` (Set of String) Names of a subset of domains that the alert monitors.
+- `origins` (Set of String) Addresses of a subset of backends that the alert monitors.

examples/resources/alert_basic_usage.tf

@@ -0,0 +1,17 @@
+resource "fastly_service_vcl" "example" {
+  name = "my_vcl_service"
+  # ...
+}
+
+resource "fastly_alert" "example" {
+  name = "my_vcl_service errors"
+  service_id = fastly_service_vcl.example.id
+  source = "stats"
+  metric = "status_5xx"
+
+  evaluation_strategy {
+    type = "above_threshold"
+    period = "5m"
+    threshold = 10
+  }
+}

examples/resources/components/alert_import_cmd.txt

@@ -0,0 +1 @@
+$ terraform import fastly_alert.example xxxxxxxxxxxxxxxxxxxx

fastly/provider.go

@@ -68,6 +68,7 @@ func Provider() *schema.Provider {
 			"fastly_waf_rules":                    dataSourceFastlyWAFRules(),
 		},
 		ResourcesMap: map[string]*schema.Resource{
+			"fastly_alert":                           resourceFastlyAlert(),
 			"fastly_configstore":                     resourceFastlyConfigStore(),
 			"fastly_configstore_entries":             resourceFastlyConfigStoreEntries(),
 			"fastly_kvstore":                         resourceFastlyKVStore(),