feat: add labels field to kibana synthetics monitor resource

- Add labels field to SyntheticsMonitorConfig and SyntheticsMonitor structs
- Add labels field to terraform schema as MapAttribute
- Add conversion functions for labels between API and terraform types
- Update documentation with labels field description and example
- Labels support key-value pairs for filtering and grouping monitors

Author: RJiraya

docs/resources/kibana_synthetics_monitor.md

@@ -41,6 +41,11 @@ resource "elasticstack_kibana_synthetics_monitor" "my_monitor" {
   locations = ["us_west"]
   enabled   = false
   tags      = ["tag"]
+  labels = {
+    environment = "production"
+    team        = "platform"
+    service     = "web-app"
+  }
   alert = {
     status = {
       enabled = true
@@ -77,6 +82,7 @@ resource "elasticstack_kibana_synthetics_monitor" "my_monitor" {
 - `enabled` (Boolean) Whether the monitor is enabled. Default: `true`
 - `http` (Attributes) HTTP Monitor specific fields (see [below for nested schema](#nestedatt--http))
 - `icmp` (Attributes) ICMP Monitor specific fields (see [below for nested schema](#nestedatt--icmp))
+- `labels` (Map of String) Key-value pairs of labels to associate with the monitor. Labels can be used for filtering and grouping monitors.
 - `locations` (List of String) Where to deploy the monitor. Monitors can be deployed in multiple locations so that you can detect differences in availability and response times across those locations.
 - `namespace` (String) The data stream namespace. Note: if you change its value, kibana creates new datastream. A user needs permissions for new/old datastream in update case to be able to see full monitor history. The `namespace` field should be lowercase and not contain spaces. The namespace must not include any of the following characters: *, \, /, ?, ", <, >, |, whitespace, ,, #, :, or -. Default: `default`
 - `params` (String) Monitor parameters. Raw JSON object, use `jsonencode` function to represent JSON

examples/resources/elasticstack_kibana_synthetics_monitor/resource.tf

@@ -9,6 +9,11 @@ resource "elasticstack_kibana_synthetics_monitor" "my_monitor" {
   locations = ["us_west"]
   enabled   = false
   tags      = ["tag"]
+  labels = {
+    environment = "production"
+    team        = "platform"
+    service     = "web-app"
+  }
   alert = {
     status = {
       enabled = true

internal/kibana/synthetics/schema.go

@@ -107,6 +107,7 @@ type tfModelV0 struct {
 	PrivateLocations []types.String            `tfsdk:"private_locations"`
 	Enabled          types.Bool                `tfsdk:"enabled"`
 	Tags             []types.String            `tfsdk:"tags"`
+	Labels           types.Map                 `tfsdk:"labels"`
 	Alert            types.Object              `tfsdk:"alert"` //tfAlertConfigV0
 	APMServiceName   types.String              `tfsdk:"service_name"`
 	TimeoutSeconds   types.Int64               `tfsdk:"timeout"`
@@ -217,6 +218,11 @@ func monitorConfigSchema() schema.Schema {
 				Optional:            true,
 				MarkdownDescription: "An array of tags.",
 			},
+			"labels": schema.MapAttribute{
+				ElementType:         types.StringType,
+				Optional:            true,
+				MarkdownDescription: "Key-value pairs of labels to associate with the monitor. Labels can be used for filtering and grouping monitors.",
+			},
 			"alert": monitorAlertConfigSchema(),
 			"service_name": schema.StringAttribute{
 				Optional:            true,
@@ -557,6 +563,31 @@ func StringSliceValue(v []string) []types.String {
 	return res
 }
 
+func MapStringValue(v map[string]string) types.Map {
+	if len(v) == 0 {
+		return types.MapNull(types.StringType)
+	}
+	elements := make(map[string]attr.Value)
+	for k, val := range v {
+		elements[k] = types.StringValue(val)
+	}
+	mapValue, _ := types.MapValue(types.StringType, elements)
+	return mapValue
+}
+
+func ValueStringMap(v types.Map) map[string]string {
+	if v.IsNull() || v.IsUnknown() {
+		return make(map[string]string)
+	}
+	result := make(map[string]string)
+	for k, val := range v.Elements() {
+		if strVal, ok := val.(types.String); ok {
+			result[k] = strVal.ValueString()
+		}
+	}
+	return result
+}
+
 func toNormalizedValue(jsObj kbapi.JsonObject) (jsontypes.Normalized, error) {
 	res, err := json.Marshal(jsObj)
 	if err != nil {
@@ -679,6 +710,7 @@ func (v *tfModelV0) toModelV0(ctx context.Context, api *kbapi.SyntheticsMonitor,
 		PrivateLocations: StringSliceValue(privateLocLabels),
 		Enabled:          types.BoolPointerValue(api.Enabled),
 		Tags:             StringSliceValue(api.Tags),
+		Labels:           MapStringValue(api.Labels),
 		Alert:            alertV0,
 		APMServiceName:   types.StringValue(api.APMServiceName),
 		TimeoutSeconds:   types.Int64Value(timeout),
@@ -901,6 +933,7 @@ func (v *tfModelV0) toSyntheticsMonitorConfig(ctx context.Context) (*kbapi.Synth
 		PrivateLocations: ValueStringSlice(v.PrivateLocations),
 		Enabled:          v.Enabled.ValueBoolPointer(),
 		Tags:             ValueStringSlice(v.Tags),
+		Labels:           ValueStringMap(v.Labels),
 		Alert:            toTFAlertConfig(ctx, v.Alert),
 		APMServiceName:   v.APMServiceName.ValueString(),
 		TimeoutSeconds:   int(v.TimeoutSeconds.ValueInt64()),