From 94eb3868e62f63b306d49ae13f5d6e29803d3c8e Mon Sep 17 00:00:00 2001
From: TwinProduction <twin@twinnation.org>
Date: Thu, 26 Nov 2020 18:09:01 -0500
Subject: [PATCH 1/5] Start working on #13: Service groups

---
 core/condition-result.go     | 10 +++++
 core/health-status.go        | 11 ++++++
 core/{types.go => result.go} | 21 +----------
 core/service-status.go       | 27 ++++++++++++++
 core/service.go              |  3 ++
 main.go                      | 30 +++++++--------
 static/index.html            | 72 +++++++++++++++++++++++++++++-------
 watchdog/watchdog.go         | 35 +++++++++++-------
 8 files changed, 147 insertions(+), 62 deletions(-)
 create mode 100644 core/condition-result.go
 create mode 100644 core/health-status.go
 rename core/{types.go => result.go} (64%)
 create mode 100644 core/service-status.go

diff --git a/core/condition-result.go b/core/condition-result.go
new file mode 100644
index 00000000..d8bdc1e9
--- /dev/null
+++ b/core/condition-result.go
@@ -0,0 +1,10 @@
+package core
+
+// ConditionResult result of a Condition
+type ConditionResult struct {
+	// Condition that was evaluated
+	Condition string `json:"condition"`
+
+	// Success whether the condition was met (successful) or not (failed)
+	Success bool `json:"success"`
+}
diff --git a/core/health-status.go b/core/health-status.go
new file mode 100644
index 00000000..89e906eb
--- /dev/null
+++ b/core/health-status.go
@@ -0,0 +1,11 @@
+package core
+
+// HealthStatus is the status of Gatus
+type HealthStatus struct {
+	// Status is the state of Gatus (UP/DOWN)
+	Status string `json:"status"`
+
+	// Message is an accompanying description of why the status is as reported.
+	// If the Status is UP, no message will be provided
+	Message string `json:"message,omitempty"`
+}
diff --git a/core/types.go b/core/result.go
similarity index 64%
rename from core/types.go
rename to core/result.go
index fabca387..5c538c64 100644
--- a/core/types.go
+++ b/core/result.go
@@ -4,22 +4,12 @@ import (
 	"time"
 )
 
-// HealthStatus is the status of Gatus
-type HealthStatus struct {
-	// Status is the state of Gatus (UP/DOWN)
-	Status string `json:"status"`
-
-	// Message is an accompanying description of why the status is as reported.
-	// If the Status is UP, no message will be provided
-	Message string `json:"message,omitempty"`
-}
-
 // Result of the evaluation of a Service
 type Result struct {
 	// HTTPStatus is the HTTP response status code
 	HTTPStatus int `json:"status"`
 
-	// DNSRCode is the response code of DNS query in human readable version
+	// DNSRCode is the response code of a DNS query in a human readable format
 	DNSRCode string `json:"dns-rcode"`
 
 	// Body is the response body
@@ -52,12 +42,3 @@ type Result struct {
 	// CertificateExpiration is the duration before the certificate expires
 	CertificateExpiration time.Duration `json:"certificate-expiration,omitempty"`
 }
-
-// ConditionResult result of a Condition
-type ConditionResult struct {
-	// Condition that was evaluated
-	Condition string `json:"condition"`
-
-	// Success whether the condition was met (successful) or not (failed)
-	Success bool `json:"success"`
-}
diff --git a/core/service-status.go b/core/service-status.go
new file mode 100644
index 00000000..92102dd7
--- /dev/null
+++ b/core/service-status.go
@@ -0,0 +1,27 @@
+package core
+
+// ServiceStatus contains the evaluation Results of a Service
+type ServiceStatus struct {
+	// Group the service is a part of. Used for grouping multiple services together on the front end.
+	Group string `json:"group,omitempty"`
+
+	// Results is the list of service evaluation results
+	Results []*Result `json:"results"`
+}
+
+// NewServiceStatus creates a new ServiceStatus
+func NewServiceStatus(service *Service) *ServiceStatus {
+	return &ServiceStatus{
+		Group:   service.Group,
+		Results: make([]*Result, 0),
+	}
+}
+
+// AddResult adds a Result to ServiceStatus.Results and makes sure that there are
+// no more than 20 results in the Results slice
+func (ss *ServiceStatus) AddResult(result *Result) {
+	ss.Results = append(ss.Results, result)
+	if len(ss.Results) > 20 {
+		ss.Results = ss.Results[1:]
+	}
+}
diff --git a/core/service.go b/core/service.go
index f735b2ca..928940cb 100644
--- a/core/service.go
+++ b/core/service.go
@@ -30,6 +30,9 @@ type Service struct {
 	// Name of the service. Can be anything.
 	Name string `yaml:"name"`
 
+	// Group the service is a part of. Used for grouping multiple services together on the front end.
+	Group string `yaml:"group,omitempty"`
+
 	// URL to send the request to
 	URL string `yaml:"url"`
 
diff --git a/main.go b/main.go
index e3cfd931..e01a7ae4 100644
--- a/main.go
+++ b/main.go
@@ -18,19 +18,19 @@ import (
 const cacheTTL = 10 * time.Second
 
 var (
-	cachedServiceResults          []byte
-	cachedServiceResultsGzipped   []byte
-	cachedServiceResultsTimestamp time.Time
+	cachedServiceStatuses          []byte
+	cachedServiceStatusesGzipped   []byte
+	cachedServiceStatusesTimestamp time.Time
 )
 
 func main() {
 	cfg := loadConfiguration()
-	resultsHandler := serviceResultsHandler
+	statusesHandler := serviceStatusesHandler
 	if cfg.Security != nil && cfg.Security.IsValid() {
-		resultsHandler = security.Handler(serviceResultsHandler, cfg.Security)
+		statusesHandler = security.Handler(serviceStatusesHandler, cfg.Security)
 	}
 	http.HandleFunc("/favicon.ico", favIconHandler) // favicon needs to be always served from the root
-	http.HandleFunc(cfg.Web.PrependWithContextRoot("/api/v1/results"), resultsHandler)
+	http.HandleFunc(cfg.Web.PrependWithContextRoot("/api/v1/statuses"), statusesHandler)
 	http.HandleFunc(cfg.Web.PrependWithContextRoot("/health"), healthHandler)
 	http.Handle(cfg.Web.ContextRoot, GzipHandler(http.StripPrefix(cfg.Web.ContextRoot, http.FileServer(http.Dir("./static")))))
 
@@ -56,29 +56,29 @@ func loadConfiguration() *config.Config {
 	return config.Get()
 }
 
-func serviceResultsHandler(writer http.ResponseWriter, r *http.Request) {
-	if isExpired := cachedServiceResultsTimestamp.IsZero() || time.Now().Sub(cachedServiceResultsTimestamp) > cacheTTL; isExpired {
+func serviceStatusesHandler(writer http.ResponseWriter, r *http.Request) {
+	if isExpired := cachedServiceStatusesTimestamp.IsZero() || time.Now().Sub(cachedServiceStatusesTimestamp) > cacheTTL; isExpired {
 		buffer := &bytes.Buffer{}
 		gzipWriter := gzip.NewWriter(buffer)
-		data, err := watchdog.GetJSONEncodedServiceResults()
+		data, err := watchdog.GetJSONEncodedServiceStatuses()
 		if err != nil {
-			log.Printf("[main][serviceResultsHandler] Unable to marshal object to JSON: %s", err.Error())
+			log.Printf("[main][serviceStatusesHandler] Unable to marshal object to JSON: %s", err.Error())
 			writer.WriteHeader(http.StatusInternalServerError)
 			_, _ = writer.Write([]byte("Unable to marshal object to JSON"))
 			return
 		}
 		gzipWriter.Write(data)
 		gzipWriter.Close()
-		cachedServiceResults = data
-		cachedServiceResultsGzipped = buffer.Bytes()
-		cachedServiceResultsTimestamp = time.Now()
+		cachedServiceStatuses = data
+		cachedServiceStatusesGzipped = buffer.Bytes()
+		cachedServiceStatusesTimestamp = time.Now()
 	}
 	var data []byte
 	if strings.Contains(r.Header.Get("Accept-Encoding"), "gzip") {
 		writer.Header().Set("Content-Encoding", "gzip")
-		data = cachedServiceResultsGzipped
+		data = cachedServiceStatusesGzipped
 	} else {
-		data = cachedServiceResults
+		data = cachedServiceStatuses
 	}
 	writer.Header().Add("Content-type", "application/json")
 	writer.WriteHeader(http.StatusOK)
diff --git a/static/index.html b/static/index.html
index 7ada745a..ac18811d 100644
--- a/static/index.html
+++ b/static/index.html
@@ -99,6 +99,13 @@
 		#settings select:focus {
 			box-shadow: none;
 		}
+		.service-group {
+            cursor: pointer;
+            user-select: none;
+		}
+        .service-group h5:hover {
+            color: #1b1e21 !important;
+        }
 	</style>
 </head>
 <body>
@@ -162,7 +169,7 @@
 		function showTooltip(serviceName, index, element) {
 			userClickedStatus = false;
 			clearTimeout(timerHandler);
-			let serviceResult = serviceStatuses[serviceName][index];
+			let serviceResult = serviceStatuses[serviceName].results[index];
 			$("#tooltip-timestamp").text(prettifyTimestamp(serviceResult.timestamp));
 			$("#tooltip-response-time").text(parseInt(serviceResult.duration/1000000) + "ms");
 			// Populate the condition section
@@ -219,8 +226,8 @@
 			return "<span class='status badge badge-danger' style='width: 5%' onmouseenter='showTooltip(\""+serviceName+"\", "+index+", this)' onmouseleave='fadeTooltip()' onclick='userClickedStatus = !userClickedStatus;'>X</span>";
 		}
 
-		function refreshResults() {
-			$.getJSON("./api/v1/results", function (data) {
+		function refreshStatuses() {
+			$.getJSON("./api/v1/statuses", function (data) {
 				// Update the table only if there's a change
 				if (JSON.stringify(serviceStatuses) !== JSON.stringify(data)) {
 					serviceStatuses = data;
@@ -230,16 +237,17 @@
 		}
 
 		function buildTable() {
-			let output = "";
+			let outputByGroup = {};
 			for (let serviceName in serviceStatuses) {
 				let serviceStatusOverTime = "";
-				let hostname = serviceStatuses[serviceName][serviceStatuses[serviceName].length-1].hostname
+				let serviceStatus = serviceStatuses[serviceName];
+				let hostname = serviceStatus.results[serviceStatus.results.length-1].hostname;
 				let minResponseTime = null;
 				let maxResponseTime = null;
 				let newestTimestamp = null;
 				let oldestTimestamp = null;
-				for (let key in serviceStatuses[serviceName]) {
-					let serviceResult = serviceStatuses[serviceName][key];
+				for (let key in serviceStatus.results) {
+					let serviceResult = serviceStatus.results[key];
 					serviceStatusOverTime = createStatusBadge(serviceName, key, serviceResult.success) + serviceStatusOverTime;
 					const responseTime = parseInt(serviceResult.duration/1000000);
 					if (minResponseTime == null || minResponseTime > responseTime) {
@@ -256,8 +264,8 @@
 						oldestTimestamp = timestamp;
 					}
 				}
-				output += ""
-					+ "<div class='container py-3 border-left border-right border-top border-black'>"
+				let output = ""
+					+ "<div class='container py-3 border-left border-right border-top border-black rounded-0'>"
 					+ "  <div class='row mb-2'>"
 					+ "    <div class='col-md-10'>"
 					+ "      <span class='font-weight-bold'>" + serviceName + "</span> <span class='text-secondary font-weight-lighter'>- " + hostname + "</span>"
@@ -280,10 +288,48 @@
 					+ "    </div>"
 					+ "  </div>"
 					+ "</div>";
+				// create an empty entry if this group is new
+				if (!outputByGroup[serviceStatus.group]) {
+					outputByGroup[serviceStatus.group] = "";
+				}
+				outputByGroup[serviceStatus.group] += output;
+			}
+			let output = "";
+			for (let group in outputByGroup) {
+				let key = group.replace(/[^a-zA-Z0-9]/g, '');
+				let existingGroupContentSelector = $("#service-group-" + key + "-content");
+				let isCurrentlyHidden = existingGroupContentSelector.length && existingGroupContentSelector[0].style.display === 'none';
+				let groupStatus = "<span class='text-success'>&#10003;</span>";
+				if (outputByGroup[group].includes("badge badge-danger")) {
+					groupStatus = "<span class='text-warning'>~</span>";
+				}
+				output += ""
+					+ "<div class='mt-" + (output.length ? '4' : '3') + "'>"
+					+ "  <div class='container pt-2 border-left border-right border-top border-black border-bottom service-group' id='service-group-" + key + "' data-group='" + key + "' onclick='toggleGroup(this)'>"
+					+ "    <h5 class='text-secondary text-monospace pb-0'>"
+					+ "      " + groupStatus + " " + group
+					+ "      <span class='float-right service-group-arrow' id='service-group-" + key + "-arrow'>" + (isCurrentlyHidden ? "&#9660;" : "&#9650;") + "</span>"
+					+ "    </h5>"
+					+ "  </div>"
+					+ "  <div class='service-group-content' id='service-group-" + key + "-content' style='" + (isCurrentlyHidden ? "display: none;" : "") + "'>"
+					+ "    " + outputByGroup[group]
+					+ "  </div>"
+					+ "</div>";
 			}
 			$("#results").html(output);
 		}
 
+		function toggleGroup(element) {
+			let selector = $("#service-group-" + element.dataset.group + "-content");
+			selector.toggle("fast", function() {
+				if (selector.length && selector[0].style.display === 'none') {
+					$("#service-group-" + element.dataset.group + "-arrow").html("&#9660;");
+				} else {
+					$("#service-group-" + element.dataset.group + "-arrow").html("&#9650;");
+				}
+			});
+		}
+
 		function prettifyTimestamp(timestamp) {
 			let date = new Date(timestamp);
 			let YYYY = date.getFullYear();
@@ -318,15 +364,15 @@
 		}
 
 		function setRefreshInterval(seconds) {
-			refreshResults();
+			refreshStatuses();
 			refreshIntervalHandler = setInterval(function() {
-				refreshResults();
-			}, seconds * 1000)
+				refreshStatuses();
+			}, seconds * 1000);
 		}
 
 		$("#refresh-rate").change(function() {
 			clearInterval(refreshIntervalHandler);
-			setRefreshInterval($(this).val())
+			setRefreshInterval($(this).val());
 		});
 		setRefreshInterval(30);
 		$("#refresh-rate").val(30);
diff --git a/watchdog/watchdog.go b/watchdog/watchdog.go
index e0151675..281b534b 100644
--- a/watchdog/watchdog.go
+++ b/watchdog/watchdog.go
@@ -13,22 +13,22 @@ import (
 )
 
 var (
-	serviceResults = make(map[string][]*core.Result)
+	serviceStatuses = make(map[string]*core.ServiceStatus)
 
-	// serviceResultsMutex is used to prevent concurrent map access
-	serviceResultsMutex sync.RWMutex
+	// serviceStatusesMutex is used to prevent concurrent map access
+	serviceStatusesMutex sync.RWMutex
 
 	// monitoringMutex is used to prevent multiple services from being evaluated at the same time.
 	// Without this, conditions using response time may become inaccurate.
 	monitoringMutex sync.Mutex
 )
 
-// GetJSONEncodedServiceResults returns a list of the last 20 results for each services encoded using json.Marshal.
+// GetJSONEncodedServiceStatuses returns a list of core.ServiceStatus for each services encoded using json.Marshal.
 // The reason why the encoding is done here is because we use a mutex to prevent concurrent map access.
-func GetJSONEncodedServiceResults() ([]byte, error) {
-	serviceResultsMutex.RLock()
-	data, err := json.Marshal(serviceResults)
-	serviceResultsMutex.RUnlock()
+func GetJSONEncodedServiceStatuses() ([]byte, error) {
+	serviceStatusesMutex.RLock()
+	data, err := json.Marshal(serviceStatuses)
+	serviceStatusesMutex.RUnlock()
 	return data, err
 }
 
@@ -55,12 +55,7 @@ func monitor(service *core.Service) {
 		}
 		result := service.EvaluateHealth()
 		metric.PublishMetricsForService(service, result)
-		serviceResultsMutex.Lock()
-		serviceResults[service.Name] = append(serviceResults[service.Name], result)
-		if len(serviceResults[service.Name]) > 20 {
-			serviceResults[service.Name] = serviceResults[service.Name][1:]
-		}
-		serviceResultsMutex.Unlock()
+		UpdateServiceStatuses(service, result)
 		var extra string
 		if !result.Success {
 			extra = fmt.Sprintf("responseBody=%s", result.Body)
@@ -83,3 +78,15 @@ func monitor(service *core.Service) {
 		time.Sleep(service.Interval)
 	}
 }
+
+// UpdateServiceStatuses updates the slice of service statuses
+func UpdateServiceStatuses(service *core.Service, result *core.Result) {
+	serviceStatusesMutex.Lock()
+	serviceStatus, exists := serviceStatuses[service.Name]
+	if !exists {
+		serviceStatus = core.NewServiceStatus(service)
+		serviceStatuses[service.Name] = serviceStatus
+	}
+	serviceStatus.AddResult(result)
+	serviceStatusesMutex.Unlock()
+}

From 35b9758b23fbbedbb4cad13f83550cf86f543a56 Mon Sep 17 00:00:00 2001
From: TwinProduction <twin@twinnation.org>
Date: Thu, 26 Nov 2020 18:29:11 -0500
Subject: [PATCH 2/5] Add non-grouped services at the bottom of the dashboard

---
 static/index.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/static/index.html b/static/index.html
index ac18811d..a80e0081 100644
--- a/static/index.html
+++ b/static/index.html
@@ -296,6 +296,10 @@
 			}
 			let output = "";
 			for (let group in outputByGroup) {
+				// Services that don't have a group should be skipped and left for last
+				if (group === 'undefined') {
+					continue
+				}
 				let key = group.replace(/[^a-zA-Z0-9]/g, '');
 				let existingGroupContentSelector = $("#service-group-" + key + "-content");
 				let isCurrentlyHidden = existingGroupContentSelector.length && existingGroupContentSelector[0].style.display === 'none';
@@ -316,6 +320,13 @@
 					+ "  </div>"
 					+ "</div>";
 			}
+			// Add all services that don't have a group at the end
+			if (outputByGroup['undefined']) {
+				output += ""
+					+ "<div class='mt-" + (output.length ? '4' : '3') + "'>"
+					+ "  " + outputByGroup['undefined']
+					+ "</div>"
+			}
 			$("#results").html(output);
 		}
 

From da4fb10bfcd3d915b23f7edcc17fd32bd192ddfd Mon Sep 17 00:00:00 2001
From: TwinProduction <twin@twinnation.org>
Date: Thu, 26 Nov 2020 23:23:51 -0500
Subject: [PATCH 3/5] Add documentation for groups

---
 .github/assets/service-groups.png | Bin 0 -> 39559 bytes
 README.md                         |  48 ++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)
 create mode 100644 .github/assets/service-groups.png

diff --git a/.github/assets/service-groups.png b/.github/assets/service-groups.png
new file mode 100644
index 0000000000000000000000000000000000000000..25d34ce0dbbc18d5b01139d6cc24e5d383d87e71
GIT binary patch
literal 39559
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

literal 0
HcmV?d00001

diff --git a/README.md b/README.md
index 54398b40..39529ab8 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,7 @@ core applications: https://status.twinnation.org/
   - [Monitoring using DNS queries](#monitoring-using-dns-queries)
   - [Basic authentication](#basic-authentication)
   - [disable-monitoring-lock](#disable-monitoring-lock)
+  - [Service groups](#service-groups)
 
 
 ## Features
@@ -97,6 +98,7 @@ Note that you can also add environment variables in the configuration file (i.e.
 | `metrics`                                | Whether to expose metrics at /metrics                                         | `false`        |
 | `services`                               | List of services to monitor                                                   | Required `[]`  |
 | `services[].name`                        | Name of the service. Can be anything.                                         | Required `""`  |
+| `services[].group`                       | Group name. Used to group multiple services together on the dashboard. See [Service groups](#service-groups). | `""`           |
 | `services[].url`                         | URL to send the request to                                                    | Required `""`  |
 | `services[].method`                      | Request method                                                                | `GET`          |
 | `services[].insecure`                    | Whether to skip verifying the server's certificate chain and host name        | `false`        |
@@ -614,3 +616,49 @@ There are three main reasons why you might want to disable the monitoring lock:
 technically, if you create 100 services with a 1 seconds interval, Gatus will send 100 requests per second)
 - You have a _lot_ of services to monitor
 - You want to test multiple services at very short interval (< 5s)
+
+
+### Service groups
+
+Service groups are used for grouping multiple services together on the dashboard.
+
+```yaml
+services:
+  - name: frontend
+    group: core
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: backend
+    group: core
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: monitoring
+    group: internal
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: nas
+    group: internal
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: random service that isn't part of a group
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+```
+
+The configuration above will result in a dashboard that looks like this:
+
+![Gatus Service Groups](.github/assets/service-groups.png)
\ No newline at end of file

From 6a08c816e56bab73baddbafca9f169f69f51291a Mon Sep 17 00:00:00 2001
From: TwinProduction <twin@twinnation.org>
Date: Thu, 26 Nov 2020 23:23:59 -0500
Subject: [PATCH 4/5] Update default configuration

---
 config.yaml | 30 ++++++++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/config.yaml b/config.yaml
index e14b1006..0c09a6e1 100644
--- a/config.yaml
+++ b/config.yaml
@@ -1,15 +1,37 @@
-metrics: true
 services:
-  - name: twinnation
+  - name: frontend
+    group: core
     url: "https://twinnation.org/health"
-    interval: 30s
+    interval: 1m
     conditions:
       - "[STATUS] == 200"
       - "[BODY].status == UP"
       - "[RESPONSE_TIME] < 1000"
+
+  - name: backend
+    group: core
+    url: "http://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: monitoring
+    group: internal
+    url: "http://example.com/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
+  - name: nas
+    group: internal
+    url: "https://example.org/"
+    interval: 5m
+    conditions:
+      - "[STATUS] == 200"
+
   - name: cat-fact
     url: "https://cat-fact.herokuapp.com/facts/random"
-    interval: 1m
+    interval: 5m
     conditions:
       - "[STATUS] == 200"
       - "[BODY].deleted == false"

From 9c8bfcd19f1da48408c9b0d487522120b65a2484 Mon Sep 17 00:00:00 2001
From: TwinProduction <twin@twinnation.org>
Date: Thu, 26 Nov 2020 23:45:17 -0500
Subject: [PATCH 5/5] Add service-status_test.go

---
 core/service-status_test.go | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 core/service-status_test.go

diff --git a/core/service-status_test.go b/core/service-status_test.go
new file mode 100644
index 00000000..4e833dfd
--- /dev/null
+++ b/core/service-status_test.go
@@ -0,0 +1,22 @@
+package core
+
+import "testing"
+
+func TestNewServiceStatus(t *testing.T) {
+	service := &Service{Group: "test"}
+	serviceStatus := NewServiceStatus(service)
+	if serviceStatus.Group != service.Group {
+		t.Errorf("expected %s, got %s", service.Group, serviceStatus.Group)
+	}
+}
+
+func TestServiceStatus_AddResult(t *testing.T) {
+	service := &Service{Group: "test"}
+	serviceStatus := NewServiceStatus(service)
+	for i := 0; i < 50; i++ {
+		serviceStatus.AddResult(&Result{})
+	}
+	if len(serviceStatus.Results) != 20 {
+		t.Errorf("expected serviceStatus.Results to not exceed a length of 20")
+	}
+}