add traceroute checktype to synthetic_monitoring_check resource (#327)

Author: rdubrock

docs/resources/synthetic_monitoring_check.md

@@ -355,6 +355,57 @@ EOS
 }
 ```
 
+### Traceroute Basic
+
+```terraform
+data "grafana_synthetic_monitoring_probes" "main" {}
+
+resource "grafana_synthetic_monitoring_check" "traceroute" {
+  job       = "Traceroute defaults"
+  target    = "grafana.com"
+  enabled   = false
+  frequency = 120000
+  timeout   = 30000
+  probes = [
+    data.grafana_synthetic_monitoring_probes.main.probes.Atlanta,
+  ]
+  labels = {
+    foo = "bar"
+  }
+  settings {
+    traceroute {}
+  }
+}
+```
+
+### Traceroute Complex
+
+```terraform
+data "grafana_synthetic_monitoring_probes" "main" {}
+
+resource "grafana_synthetic_monitoring_check" "traceroute" {
+  job       = "Traceroute complex"
+  target    = "grafana.net"
+  enabled   = false
+  frequency = 120000
+  timeout   = 30000
+  probes = [
+    data.grafana_synthetic_monitoring_probes.main.probes.Chicago,
+    data.grafana_synthetic_monitoring_probes.main.probes.LosAngeles,
+  ]
+  labels = {
+    foo = "baz"
+  }
+  settings {
+    traceroute {
+      max_hops         = 25
+      max_unknown_hops = 10
+      ptr_lookup       = false
+    }
+  }
+}
+```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -388,6 +439,7 @@ Optional:
 - **http** (Block Set, Max: 1) Settings for HTTP check. The target must be a URL (http or https). (see [below for nested schema](#nestedblock--settings--http))
 - **ping** (Block Set, Max: 1) Settings for ping (ICMP) check. The target must be a valid hostname or IP address. (see [below for nested schema](#nestedblock--settings--ping))
 - **tcp** (Block Set, Max: 1) Settings for TCP check. The target must be of the form `<host>:<port>`, where the host portion must be a valid hostname or IP address. (see [below for nested schema](#nestedblock--settings--tcp))
+- **traceroute** (Block Set, Max: 1) Settings for traceroute check. The target must be a valid hostname or IP address (see [below for nested schema](#nestedblock--settings--traceroute))
 
 <a id="nestedblock--settings--dns"></a>
 ### Nested Schema for `settings.dns`
@@ -552,3 +604,14 @@ Optional:
 - **server_name** (String) Used to verify the hostname for the targets.
 
 
+
+<a id="nestedblock--settings--traceroute"></a>
+### Nested Schema for `settings.traceroute`
+
+Optional:
+
+- **max_hops** (Number) Maximum TTL for the trace Defaults to `64`.
+- **max_unknown_hops** (Number) Maximum number of hosts to travers that give no response Defaults to `15`.
+- **ptr_lookup** (Boolean) Reverse lookup hostnames from IP addresses Defaults to `true`.
+
+

examples/resources/grafana_synthetic_monitoring_check/traceroute_basic.tf

@@ -0,0 +1,18 @@
+data "grafana_synthetic_monitoring_probes" "main" {}
+
+resource "grafana_synthetic_monitoring_check" "traceroute" {
+  job       = "Traceroute defaults"
+  target    = "grafana.com"
+  enabled   = false
+  frequency = 120000
+  timeout   = 30000
+  probes = [
+    data.grafana_synthetic_monitoring_probes.main.probes.Atlanta,
+  ]
+  labels = {
+    foo = "bar"
+  }
+  settings {
+    traceroute {}
+  }
+}

examples/resources/grafana_synthetic_monitoring_check/traceroute_complex.tf

@@ -0,0 +1,23 @@
+data "grafana_synthetic_monitoring_probes" "main" {}
+
+resource "grafana_synthetic_monitoring_check" "traceroute" {
+  job       = "Traceroute complex"
+  target    = "grafana.net"
+  enabled   = false
+  frequency = 120000
+  timeout   = 30000
+  probes = [
+    data.grafana_synthetic_monitoring_probes.main.probes.Chicago,
+    data.grafana_synthetic_monitoring_probes.main.probes.LosAngeles,
+  ]
+  labels = {
+    foo = "baz"
+  }
+  settings {
+    traceroute {
+      max_hops         = 25
+      max_unknown_hops = 10
+      ptr_lookup       = false
+    }
+  }
+}

grafana/resource_synthetic_monitoring_check.go

@@ -93,6 +93,13 @@ var (
 				MaxItems:    1,
 				Elem:        syntheticMonitoringCheckSettingsTCP,
 			},
+			"traceroute": {
+				Description: "Settings for traceroute check. The target must be a valid hostname or IP address",
+				Type:        schema.TypeSet,
+				Optional:    true,
+				MaxItems:    1,
+				Elem:        syntheticMonitoringCheckSettingsTraceroute,
+			},
 		},
 	}
 
@@ -394,6 +401,29 @@ var (
 			},
 		},
 	}
+
+	syntheticMonitoringCheckSettingsTraceroute = &schema.Resource{
+		Schema: map[string]*schema.Schema{
+			"max_hops": {
+				Description: "Maximum TTL for the trace",
+				Type:        schema.TypeInt,
+				Optional:    true,
+				Default:     64,
+			},
+			"max_unknown_hops": {
+				Description: "Maximum number of hosts to travers that give no response",
+				Type:        schema.TypeInt,
+				Optional:    true,
+				Default:     15,
+			},
+			"ptr_lookup": {
+				Description: "Reverse lookup hostnames from IP addresses",
+				Type:        schema.TypeBool,
+				Optional:    true,
+				Default:     true,
+			},
+		},
+	}
 )
 
 func resourceSyntheticMonitoringCheck() *schema.Resource {
@@ -700,6 +730,20 @@ func resourceSyntheticMonitoringCheckRead(ctx context.Context, d *schema.Resourc
 		settings.Add(map[string]interface{}{
 			"tcp": tcp,
 		})
+	case chk.Settings.Traceroute != nil:
+		traceroute := schema.NewSet(
+			schema.HashResource(syntheticMonitoringCheckSettingsTraceroute),
+			[]interface{}{},
+		)
+
+		traceroute.Add(map[string]interface{}{
+			"max_hops":         int(chk.Settings.Traceroute.MaxHops),
+			"max_unknown_hops": int(chk.Settings.Traceroute.MaxUnknownHops),
+			"ptr_lookup":       chk.Settings.Traceroute.PtrLookup,
+		})
+		settings.Add(map[string]interface{}{
+			"traceroute": traceroute,
+		})
 	}
 
 	d.Set("settings", settings)
@@ -899,5 +943,15 @@ func makeCheckSettings(settings map[string]interface{}) sm.CheckSettings {
 		}
 	}
 
+	traceroute := settings["traceroute"].(*schema.Set).List()
+	if len(traceroute) > 0 {
+		t := traceroute[0].(map[string]interface{})
+		cs.Traceroute = &sm.TracerouteSettings{
+			MaxHops:        int64(t["max_hops"].(int)),
+			MaxUnknownHops: int64(t["max_unknown_hops"].(int)),
+			PtrLookup:      t["ptr_lookup"].(bool),
+		}
+	}
+
 	return cs
 }

grafana/resource_synthetic_monitoring_check_test.go

@@ -199,3 +199,43 @@ func TestAccResourceSyntheticMonitoringCheck_tcp(t *testing.T) {
 		},
 	})
 }
+
+func TestAccResourceSyntheticMonitoringCheck_traceroute(t *testing.T) {
+	CheckCloudTestsEnabled(t)
+
+	resource.Test(t, resource.TestCase{
+		PreCheck:          func() { testAccPreCheckCloud(t) },
+		ProviderFactories: testAccProviderFactories,
+		Steps: []resource.TestStep{
+			{
+				Config: testAccExample(t, "resources/grafana_synthetic_monitoring_check/traceroute_basic.tf"),
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttrSet("grafana_synthetic_monitoring_check.traceroute", "id"),
+					resource.TestCheckResourceAttrSet("grafana_synthetic_monitoring_check.traceroute", "tenant_id"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "job", "Traceroute defaults"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "target", "grafana.com"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "probes.0", "1"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "labels.foo", "bar"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.max_hops", "64"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.max_unknown_hops", "15"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.ptr_lookup", "true"),
+				),
+			},
+			{
+				Config: testAccExample(t, "resources/grafana_synthetic_monitoring_check/traceroute_complex.tf"),
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttrSet("grafana_synthetic_monitoring_check.traceroute", "id"),
+					resource.TestCheckResourceAttrSet("grafana_synthetic_monitoring_check.traceroute", "tenant_id"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "job", "Traceroute complex"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "target", "grafana.net"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "probes.0", "2"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "probes.1", "3"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "labels.foo", "baz"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.max_hops", "25"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.max_unknown_hops", "10"),
+					resource.TestCheckResourceAttr("grafana_synthetic_monitoring_check.traceroute", "settings.0.traceroute.0.ptr_lookup", "false"),
+				),
+			},
+		},
+	})
+}

templates/resources/synthetic_monitoring_check.md.tmpl

@@ -44,6 +44,14 @@ description: |-
 
 {{ tffile "examples/resources/grafana_synthetic_monitoring_check/tcp_complex.tf" }}
 
+### Traceroute Basic
+
+{{ tffile "examples/resources/grafana_synthetic_monitoring_check/traceroute_basic.tf" }}
+
+### Traceroute Complex
+
+{{ tffile "examples/resources/grafana_synthetic_monitoring_check/traceroute_complex.tf" }}
+
 {{ .SchemaMarkdown | trimspace }}
 
 {{ if .HasImport -}}