feat(suite): Implement Suites (#1239)

* feat(suite): Implement Suites Fixes #1230 * Update docs * Fix variable alignment * Prevent always-run endpoint from running if a context placeholder fails to resolve in the URL * Return errors when a context placeholder path fails to resolve * Add a couple of unit tests * Add a couple of unit tests * fix(ui): Update group count properly Fixes #1233 * refactor: Pass down entire config instead of several sub-configs * fix: Change default suite interval and timeout * fix: Deprecate disable-monitoring-lock in favor of concurrency * fix: Make sure there are no duplicate keys * Refactor some code * Update watchdog/watchdog.go * Update web/app/src/components/StepDetailsModal.vue Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * chore: Remove useless log * fix: Set default concurrency to 3 instead of 5 --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-09-05 15:39:12 -04:00
parent 10cabb9dde
commit d668a14703
74 changed files with 7513 additions and 652 deletions
--- a/config/endpoint/condition.go
+++ b/config/endpoint/condition.go
@@ -7,82 +7,11 @@ import (
 	"strings"
 	"time"

-	"github.com/TwiN/gatus/v5/jsonpath"
+	"github.com/TwiN/gatus/v5/config/gontext"
 	"github.com/TwiN/gatus/v5/pattern"
 )

-// Placeholders
 const (
-	// StatusPlaceholder is a placeholder for a HTTP status.
-	//
-	// Values that could replace the placeholder: 200, 404, 500, ...
-	StatusPlaceholder = "[STATUS]"
-
-	// IPPlaceholder is a placeholder for an IP.
-	//
-	// Values that could replace the placeholder: 127.0.0.1, 10.0.0.1, ...
-	IPPlaceholder = "[IP]"
-
-	// DNSRCodePlaceholder is a placeholder for DNS_RCODE
-	//
-	// Values that could replace the placeholder: NOERROR, FORMERR, SERVFAIL, NXDOMAIN, NOTIMP, REFUSED
-	DNSRCodePlaceholder = "[DNS_RCODE]"
-
-	// ResponseTimePlaceholder is a placeholder for the request response time, in milliseconds.
-	//
-	// Values that could replace the placeholder: 1, 500, 1000, ...
-	ResponseTimePlaceholder = "[RESPONSE_TIME]"
-
-	// BodyPlaceholder is a placeholder for the Body of the response
-	//
-	// Values that could replace the placeholder: {}, {"data":{"name":"john"}}, ...
-	BodyPlaceholder = "[BODY]"
-
-	// ConnectedPlaceholder is a placeholder for whether a connection was successfully established.
-	//
-	// Values that could replace the placeholder: true, false
-	ConnectedPlaceholder = "[CONNECTED]"
-
-	// CertificateExpirationPlaceholder is a placeholder for the duration before certificate expiration, in milliseconds.
-	//
-	// Values that could replace the placeholder: 4461677039 (~52 days)
-	CertificateExpirationPlaceholder = "[CERTIFICATE_EXPIRATION]"
-
-	// DomainExpirationPlaceholder is a placeholder for the duration before the domain expires, in milliseconds.
-	DomainExpirationPlaceholder = "[DOMAIN_EXPIRATION]"
-)
-
-// Functions
-const (
-	// LengthFunctionPrefix is the prefix for the length function
-	//
-	// Usage: len([BODY].articles) == 10, len([BODY].name) > 5
-	LengthFunctionPrefix = "len("
-
-	// HasFunctionPrefix is the prefix for the has function
-	//
-	// Usage: has([BODY].errors) == true
-	HasFunctionPrefix = "has("
-
-	// PatternFunctionPrefix is the prefix for the pattern function
-	//
-	// Usage: [IP] == pat(192.168.*.*)
-	PatternFunctionPrefix = "pat("
-
-	// AnyFunctionPrefix is the prefix for the any function
-	//
-	// Usage: [IP] == any(1.1.1.1, 1.0.0.1)
-	AnyFunctionPrefix = "any("
-
-	// FunctionSuffix is the suffix for all functions
-	FunctionSuffix = ")"
-)
-
-// Other constants
-const (
-	// InvalidConditionElementSuffix is the suffix that will be appended to an invalid condition
-	InvalidConditionElementSuffix = "(INVALID)"
-
 	// maximumLengthBeforeTruncatingWhenComparedWithPattern is the maximum length an element being compared to a
 	// pattern can have.
 	//
@@ -97,50 +26,50 @@ type Condition string
 // Validate checks if the Condition is valid
 func (c Condition) Validate() error {
 	r := &Result{}
-	c.evaluate(r, false)
+	c.evaluate(r, false, nil)
 	if len(r.Errors) != 0 {
 		return errors.New(r.Errors[0])
 	}
 	return nil
 }

-// evaluate the Condition with the Result of the health check
-func (c Condition) evaluate(result *Result, dontResolveFailedConditions bool) bool {
+// evaluate the Condition with the Result and an optional context
+func (c Condition) evaluate(result *Result, dontResolveFailedConditions bool, context *gontext.Gontext) bool {
 	condition := string(c)
 	success := false
 	conditionToDisplay := condition
 	if strings.Contains(condition, " == ") {
-		parameters, resolvedParameters := sanitizeAndResolve(strings.Split(condition, " == "), result)
+		parameters, resolvedParameters := sanitizeAndResolveWithContext(strings.Split(condition, " == "), result, context)
 		success = isEqual(resolvedParameters[0], resolvedParameters[1])
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettify(parameters, resolvedParameters, "==")
 		}
 	} else if strings.Contains(condition, " != ") {
-		parameters, resolvedParameters := sanitizeAndResolve(strings.Split(condition, " != "), result)
+		parameters, resolvedParameters := sanitizeAndResolveWithContext(strings.Split(condition, " != "), result, context)
 		success = !isEqual(resolvedParameters[0], resolvedParameters[1])
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettify(parameters, resolvedParameters, "!=")
 		}
 	} else if strings.Contains(condition, " <= ") {
-		parameters, resolvedParameters := sanitizeAndResolveNumerical(strings.Split(condition, " <= "), result)
+		parameters, resolvedParameters := sanitizeAndResolveNumericalWithContext(strings.Split(condition, " <= "), result, context)
 		success = resolvedParameters[0] <= resolvedParameters[1]
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettifyNumericalParameters(parameters, resolvedParameters, "<=")
 		}
 	} else if strings.Contains(condition, " >= ") {
-		parameters, resolvedParameters := sanitizeAndResolveNumerical(strings.Split(condition, " >= "), result)
+		parameters, resolvedParameters := sanitizeAndResolveNumericalWithContext(strings.Split(condition, " >= "), result, context)
 		success = resolvedParameters[0] >= resolvedParameters[1]
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettifyNumericalParameters(parameters, resolvedParameters, ">=")
 		}
 	} else if strings.Contains(condition, " > ") {
-		parameters, resolvedParameters := sanitizeAndResolveNumerical(strings.Split(condition, " > "), result)
+		parameters, resolvedParameters := sanitizeAndResolveNumericalWithContext(strings.Split(condition, " > "), result, context)
 		success = resolvedParameters[0] > resolvedParameters[1]
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettifyNumericalParameters(parameters, resolvedParameters, ">")
 		}
 	} else if strings.Contains(condition, " < ") {
-		parameters, resolvedParameters := sanitizeAndResolveNumerical(strings.Split(condition, " < "), result)
+		parameters, resolvedParameters := sanitizeAndResolveNumericalWithContext(strings.Split(condition, " < "), result, context)
 		success = resolvedParameters[0] < resolvedParameters[1]
 		if !success && !dontResolveFailedConditions {
 			conditionToDisplay = prettifyNumericalParameters(parameters, resolvedParameters, "<")
@@ -235,79 +164,29 @@ func isEqual(first, second string) bool {
 	return first == second
 }

-// sanitizeAndResolve sanitizes and resolves a list of elements and returns the list of parameters as well as a list
-// of resolved parameters
-func sanitizeAndResolve(elements []string, result *Result) ([]string, []string) {
+// sanitizeAndResolveWithContext sanitizes and resolves a list of elements with an optional context
+func sanitizeAndResolveWithContext(elements []string, result *Result, context *gontext.Gontext) ([]string, []string) {
 	parameters := make([]string, len(elements))
 	resolvedParameters := make([]string, len(elements))
-	body := strings.TrimSpace(string(result.Body))
 	for i, element := range elements {
 		element = strings.TrimSpace(element)
 		parameters[i] = element
-		switch strings.ToUpper(element) {
-		case StatusPlaceholder:
-			element = strconv.Itoa(result.HTTPStatus)
-		case IPPlaceholder:
-			element = result.IP
-		case ResponseTimePlaceholder:
-			element = strconv.Itoa(int(result.Duration.Milliseconds()))
-		case BodyPlaceholder:
-			element = body
-		case DNSRCodePlaceholder:
-			element = result.DNSRCode
-		case ConnectedPlaceholder:
-			element = strconv.FormatBool(result.Connected)
-		case CertificateExpirationPlaceholder:
-			element = strconv.FormatInt(result.CertificateExpiration.Milliseconds(), 10)
-		case DomainExpirationPlaceholder:
-			element = strconv.FormatInt(result.DomainExpiration.Milliseconds(), 10)
-		default:
-			// if contains the BodyPlaceholder, then evaluate json path
-			if strings.Contains(element, BodyPlaceholder) {
-				checkingForLength := false
-				checkingForExistence := false
-				if strings.HasPrefix(element, LengthFunctionPrefix) && strings.HasSuffix(element, FunctionSuffix) {
-					checkingForLength = true
-					element = strings.TrimSuffix(strings.TrimPrefix(element, LengthFunctionPrefix), FunctionSuffix)
-				}
-				if strings.HasPrefix(element, HasFunctionPrefix) && strings.HasSuffix(element, FunctionSuffix) {
-					checkingForExistence = true
-					element = strings.TrimSuffix(strings.TrimPrefix(element, HasFunctionPrefix), FunctionSuffix)
-				}
-				resolvedElement, resolvedElementLength, err := jsonpath.Eval(strings.TrimPrefix(strings.TrimPrefix(element, BodyPlaceholder), "."), result.Body)
-				if checkingForExistence {
-					if err != nil {
-						element = "false"
-					} else {
-						element = "true"
-					}
-				} else {
-					if err != nil {
-						if err.Error() != "unexpected end of JSON input" {
-							result.AddError(err.Error())
-						}
-						if checkingForLength {
-							element = LengthFunctionPrefix + element + FunctionSuffix + " " + InvalidConditionElementSuffix
-						} else {
-							element = element + " " + InvalidConditionElementSuffix
-						}
-					} else {
-						if checkingForLength {
-							element = strconv.Itoa(resolvedElementLength)
-						} else {
-							element = resolvedElement
-						}
-					}
-				}
-			}
+
+		// Use the unified ResolvePlaceholder function
+		resolved, err := ResolvePlaceholder(element, result, context)
+		if err != nil {
+			// If there's an error, add it to the result
+			result.AddError(err.Error())
+			resolvedParameters[i] = element + " " + InvalidConditionElementSuffix
+		} else {
+			resolvedParameters[i] = resolved
 		}
-		resolvedParameters[i] = element
 	}
 	return parameters, resolvedParameters
 }

-func sanitizeAndResolveNumerical(list []string, result *Result) (parameters []string, resolvedNumericalParameters []int64) {
-	parameters, resolvedParameters := sanitizeAndResolve(list, result)
+func sanitizeAndResolveNumericalWithContext(list []string, result *Result, context *gontext.Gontext) (parameters []string, resolvedNumericalParameters []int64) {
+	parameters, resolvedParameters := sanitizeAndResolveWithContext(list, result, context)
 	for _, element := range resolvedParameters {
 		if duration, err := time.ParseDuration(element); duration != 0 && err == nil {
 			// If the string is a duration, convert it to milliseconds
--- a/config/endpoint/condition_bench_test.go
+++ b/config/endpoint/condition_bench_test.go
@@ -8,7 +8,7 @@ func BenchmarkCondition_evaluateWithBodyStringAny(b *testing.B) {
 	condition := Condition("[BODY].name == any(john.doe, jane.doe)")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"john.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -17,7 +17,7 @@ func BenchmarkCondition_evaluateWithBodyStringAnyFailure(b *testing.B) {
 	condition := Condition("[BODY].name == any(john.doe, jane.doe)")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"bob.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -26,7 +26,7 @@ func BenchmarkCondition_evaluateWithBodyString(b *testing.B) {
 	condition := Condition("[BODY].name == john.doe")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"john.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -35,7 +35,7 @@ func BenchmarkCondition_evaluateWithBodyStringFailure(b *testing.B) {
 	condition := Condition("[BODY].name == john.doe")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"bob.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -44,7 +44,7 @@ func BenchmarkCondition_evaluateWithBodyStringFailureInvalidPath(b *testing.B) {
 	condition := Condition("[BODY].user.name == bob.doe")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"bob.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -53,7 +53,7 @@ func BenchmarkCondition_evaluateWithBodyStringLen(b *testing.B) {
 	condition := Condition("len([BODY].name) == 8")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"john.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -62,7 +62,7 @@ func BenchmarkCondition_evaluateWithBodyStringLenFailure(b *testing.B) {
 	condition := Condition("len([BODY].name) == 8")
 	for n := 0; n < b.N; n++ {
 		result := &Result{Body: []byte("{\"name\": \"bob.doe\"}")}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -71,7 +71,7 @@ func BenchmarkCondition_evaluateWithStatus(b *testing.B) {
 	condition := Condition("[STATUS] == 200")
 	for n := 0; n < b.N; n++ {
 		result := &Result{HTTPStatus: 200}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
@@ -80,7 +80,7 @@ func BenchmarkCondition_evaluateWithStatusFailure(b *testing.B) {
 	condition := Condition("[STATUS] == 200")
 	for n := 0; n < b.N; n++ {
 		result := &Result{HTTPStatus: 400}
-		condition.evaluate(result, false)
+		condition.evaluate(result, false, nil)
 	}
 	b.ReportAllocs()
 }
--- a/config/endpoint/condition_test.go
+++ b/config/endpoint/condition_test.go
@@ -755,7 +755,7 @@ func TestCondition_evaluate(t *testing.T) {
 	}
 	for _, scenario := range scenarios {
 		t.Run(scenario.Name, func(t *testing.T) {
-			scenario.Condition.evaluate(scenario.Result, scenario.DontResolveFailedConditions)
+			scenario.Condition.evaluate(scenario.Result, scenario.DontResolveFailedConditions, nil)
 			if scenario.Result.ConditionResults[0].Success != scenario.ExpectedSuccess {
 				t.Errorf("Condition '%s' should have been success=%v", scenario.Condition, scenario.ExpectedSuccess)
 			}
@@ -769,7 +769,7 @@ func TestCondition_evaluate(t *testing.T) {
 func TestCondition_evaluateWithInvalidOperator(t *testing.T) {
 	condition := Condition("[STATUS] ? 201")
 	result := &Result{HTTPStatus: 201}
-	condition.evaluate(result, false)
+	condition.evaluate(result, false, nil)
 	if result.Success {
 		t.Error("condition was invalid, result should've been a failure")
 	}
--- a/config/endpoint/endpoint.go
+++ b/config/endpoint/endpoint.go
@@ -21,6 +21,8 @@ import (
 	"github.com/TwiN/gatus/v5/config/endpoint/dns"
 	sshconfig "github.com/TwiN/gatus/v5/config/endpoint/ssh"
 	"github.com/TwiN/gatus/v5/config/endpoint/ui"
+	"github.com/TwiN/gatus/v5/config/gontext"
+	"github.com/TwiN/gatus/v5/config/key"
 	"github.com/TwiN/gatus/v5/config/maintenance"
 	"golang.org/x/crypto/ssh"
 )
@@ -134,6 +136,18 @@ type Endpoint struct {

 	// LastReminderSent is the time at which the last reminder was sent for this endpoint.
 	LastReminderSent time.Time `yaml:"-"`
+
+	///////////////////////
+	// SUITE-ONLY FIELDS //
+	///////////////////////
+
+	// Store is a map of values to extract from the result and store in the suite context
+	// This field is only used when the endpoint is part of a suite
+	Store map[string]string `yaml:"store,omitempty"`
+
+	// AlwaysRun defines whether to execute this endpoint even if previous endpoints in the suite failed
+	// This field is only used when the endpoint is part of a suite
+	AlwaysRun bool `yaml:"always-run,omitempty"`
 }

 // IsEnabled returns whether the endpoint is enabled or not
@@ -255,7 +269,7 @@ func (e *Endpoint) DisplayName() string {

 // Key returns the unique key for the Endpoint
 func (e *Endpoint) Key() string {
-	return ConvertGroupAndEndpointNameToKey(e.Group, e.Name)
+	return key.ConvertGroupAndNameToKey(e.Group, e.Name)
 }

 // Close HTTP connections between watchdog and endpoints to avoid dangling socket file descriptors
@@ -269,16 +283,26 @@ func (e *Endpoint) Close() {

 // EvaluateHealth sends a request to the endpoint's URL and evaluates the conditions of the endpoint.
 func (e *Endpoint) EvaluateHealth() *Result {
+	return e.EvaluateHealthWithContext(nil)
+}
+
+// EvaluateHealthWithContext sends a request to the endpoint's URL with context support and evaluates the conditions
+func (e *Endpoint) EvaluateHealthWithContext(context *gontext.Gontext) *Result {
 	result := &Result{Success: true, Errors: []string{}}
+	// Preprocess the endpoint with context if provided
+	processedEndpoint := e
+	if context != nil {
+		processedEndpoint = e.preprocessWithContext(result, context)
+	}
 	// Parse or extract hostname from URL
-	if e.DNSConfig != nil {
-		result.Hostname = strings.TrimSuffix(e.URL, ":53")
-	} else if e.Type() == TypeICMP {
+	if processedEndpoint.DNSConfig != nil {
+		result.Hostname = strings.TrimSuffix(processedEndpoint.URL, ":53")
+	} else if processedEndpoint.Type() == TypeICMP {
 		// To handle IPv6 addresses, we need to handle the hostname differently here. This is to avoid, for instance,
 		// "1111:2222:3333::4444" being displayed as "1111:2222:3333:" because :4444 would be interpreted as a port.
-		result.Hostname = strings.TrimPrefix(e.URL, "icmp://")
+		result.Hostname = strings.TrimPrefix(processedEndpoint.URL, "icmp://")
 	} else {
-		urlObject, err := url.Parse(e.URL)
+		urlObject, err := url.Parse(processedEndpoint.URL)
 		if err != nil {
 			result.AddError(err.Error())
 		} else {
@@ -287,11 +311,11 @@ func (e *Endpoint) EvaluateHealth() *Result {
 		}
 	}
 	// Retrieve IP if necessary
-	if e.needsToRetrieveIP() {
-		e.getIP(result)
+	if processedEndpoint.needsToRetrieveIP() {
+		processedEndpoint.getIP(result)
 	}
 	// Retrieve domain expiration if necessary
-	if e.needsToRetrieveDomainExpiration() && len(result.Hostname) > 0 {
+	if processedEndpoint.needsToRetrieveDomainExpiration() && len(result.Hostname) > 0 {
 		var err error
 		if result.DomainExpiration, err = client.GetDomainExpiration(result.Hostname); err != nil {
 			result.AddError(err.Error())
@@ -299,42 +323,91 @@ func (e *Endpoint) EvaluateHealth() *Result {
 	}
 	// Call the endpoint (if there's no errors)
 	if len(result.Errors) == 0 {
-		e.call(result)
+		processedEndpoint.call(result)
 	} else {
 		result.Success = false
 	}
 	// Evaluate the conditions
-	for _, condition := range e.Conditions {
-		success := condition.evaluate(result, e.UIConfig.DontResolveFailedConditions)
+	for _, condition := range processedEndpoint.Conditions {
+		success := condition.evaluate(result, processedEndpoint.UIConfig.DontResolveFailedConditions, context)
 		if !success {
 			result.Success = false
 		}
 	}
 	result.Timestamp = time.Now()
 	// Clean up parameters that we don't need to keep in the results
-	if e.UIConfig.HideURL {
+	if processedEndpoint.UIConfig.HideURL {
 		for errIdx, errorString := range result.Errors {
-			result.Errors[errIdx] = strings.ReplaceAll(errorString, e.URL, "<redacted>")
+			result.Errors[errIdx] = strings.ReplaceAll(errorString, processedEndpoint.URL, "<redacted>")
 		}
 	}
-	if e.UIConfig.HideHostname {
+	if processedEndpoint.UIConfig.HideHostname {
 		for errIdx, errorString := range result.Errors {
 			result.Errors[errIdx] = strings.ReplaceAll(errorString, result.Hostname, "<redacted>")
 		}
 		result.Hostname = "" // remove it from the result so it doesn't get exposed
 	}
-	if e.UIConfig.HidePort && len(result.port) > 0 {
+	if processedEndpoint.UIConfig.HidePort && len(result.port) > 0 {
 		for errIdx, errorString := range result.Errors {
 			result.Errors[errIdx] = strings.ReplaceAll(errorString, result.port, "<redacted>")
 		}
 		result.port = ""
 	}
-	if e.UIConfig.HideConditions {
+	if processedEndpoint.UIConfig.HideConditions {
 		result.ConditionResults = nil
 	}
 	return result
 }

+// preprocessWithContext creates a copy of the endpoint with context placeholders replaced
+func (e *Endpoint) preprocessWithContext(result *Result, context *gontext.Gontext) *Endpoint {
+	// Create a deep copy of the endpoint
+	processed := &Endpoint{}
+	*processed = *e
+	var err error
+	// Replace context placeholders in URL
+	if processed.URL, err = replaceContextPlaceholders(e.URL, context); err != nil {
+		result.AddError(err.Error())
+	}
+	// Replace context placeholders in Body
+	if processed.Body, err = replaceContextPlaceholders(e.Body, context); err != nil {
+		result.AddError(err.Error())
+	}
+	// Replace context placeholders in Headers
+	if e.Headers != nil {
+		processed.Headers = make(map[string]string)
+		for k, v := range e.Headers {
+			if processed.Headers[k], err = replaceContextPlaceholders(v, context); err != nil {
+				result.AddError(err.Error())
+			}
+		}
+	}
+	return processed
+}
+
+// replaceContextPlaceholders replaces [CONTEXT].path placeholders with actual values
+func replaceContextPlaceholders(input string, ctx *gontext.Gontext) (string, error) {
+	if ctx == nil {
+		return input, nil
+	}
+	var contextErrors []string
+	contextRegex := regexp.MustCompile(`\[CONTEXT\]\.[\w\.]+`)
+	result := contextRegex.ReplaceAllStringFunc(input, func(match string) string {
+		// Extract the path after [CONTEXT].
+		path := strings.TrimPrefix(match, "[CONTEXT].")
+		value, err := ctx.Get(path)
+		if err != nil {
+			contextErrors = append(contextErrors, fmt.Sprintf("path '%s' not found", path))
+			return match // Keep placeholder for error reporting
+		}
+		return fmt.Sprintf("%v", value)
+	})
+	if len(contextErrors) > 0 {
+		return result, fmt.Errorf("context placeholder resolution failed: %s", strings.Join(contextErrors, ", "))
+	}
+	return result, nil
+}
+
 func (e *Endpoint) getParsedBody() string {
 	body := e.Body
 	body = strings.ReplaceAll(body, "[ENDPOINT_NAME]", e.Name)
--- a/config/endpoint/endpoint_test.go
+++ b/config/endpoint/endpoint_test.go
@@ -16,6 +16,7 @@ import (
 	"github.com/TwiN/gatus/v5/config/endpoint/dns"
 	"github.com/TwiN/gatus/v5/config/endpoint/ssh"
 	"github.com/TwiN/gatus/v5/config/endpoint/ui"
+	"github.com/TwiN/gatus/v5/config/gontext"
 	"github.com/TwiN/gatus/v5/config/maintenance"
 	"github.com/TwiN/gatus/v5/test"
 )
@@ -932,3 +933,352 @@ func TestEndpoint_needsToRetrieveIP(t *testing.T) {
 		t.Error("expected true, got false")
 	}
 }
+
+func TestEndpoint_preprocessWithContext(t *testing.T) {
+	// Import the gontext package for creating test contexts
+	// This test thoroughly exercises the replaceContextPlaceholders function
+	tests := []struct {
+		name                  string
+		endpoint              *Endpoint
+		context               map[string]interface{}
+		expectedURL           string
+		expectedBody          string
+		expectedHeaders       map[string]string
+		expectedErrorCount    int
+		expectedErrorContains []string
+	}{
+		{
+			name: "successful_url_replacement",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].userId",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"userId": "12345",
+			},
+			expectedURL:        "https://api.example.com/users/12345",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "successful_body_replacement",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com",
+				Body: `{"userId": "[CONTEXT].userId", "action": "update"}`,
+			},
+			context: map[string]interface{}{
+				"userId": "67890",
+			},
+			expectedURL:        "https://api.example.com",
+			expectedBody:       `{"userId": "67890", "action": "update"}`,
+			expectedErrorCount: 0,
+		},
+		{
+			name: "successful_header_replacement",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com",
+				Body: "",
+				Headers: map[string]string{
+					"Authorization": "Bearer [CONTEXT].token",
+					"X-User-ID":     "[CONTEXT].userId",
+				},
+			},
+			context: map[string]interface{}{
+				"token":  "abc123token",
+				"userId": "user123",
+			},
+			expectedURL:  "https://api.example.com",
+			expectedBody: "",
+			expectedHeaders: map[string]string{
+				"Authorization": "Bearer abc123token",
+				"X-User-ID":     "user123",
+			},
+			expectedErrorCount: 0,
+		},
+		{
+			name: "multiple_placeholders_in_url",
+			endpoint: &Endpoint{
+				URL:  "https://[CONTEXT].host/api/v[CONTEXT].version/users/[CONTEXT].userId",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"host":    "api.example.com",
+				"version": "2",
+				"userId":  "12345",
+			},
+			expectedURL:        "https://api.example.com/api/v2/users/12345",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "nested_context_path",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].user.id",
+				Body: `{"name": "[CONTEXT].user.name"}`,
+			},
+			context: map[string]interface{}{
+				"user": map[string]interface{}{
+					"id":   "nested123",
+					"name": "John Doe",
+				},
+			},
+			expectedURL:        "https://api.example.com/users/nested123",
+			expectedBody:       `{"name": "John Doe"}`,
+			expectedErrorCount: 0,
+		},
+		{
+			name: "url_context_not_found",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].missingUserId",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"userId": "12345", // different key
+			},
+			expectedURL:           "https://api.example.com/users/[CONTEXT].missingUserId",
+			expectedBody:          "",
+			expectedErrorCount:    1,
+			expectedErrorContains: []string{"path 'missingUserId' not found"},
+		},
+		{
+			name: "body_context_not_found",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com",
+				Body: `{"userId": "[CONTEXT].missingUserId"}`,
+			},
+			context: map[string]interface{}{
+				"userId": "12345", // different key
+			},
+			expectedURL:           "https://api.example.com",
+			expectedBody:          `{"userId": "[CONTEXT].missingUserId"}`,
+			expectedErrorCount:    1,
+			expectedErrorContains: []string{"path 'missingUserId' not found"},
+		},
+		{
+			name: "header_context_not_found",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com",
+				Body: "",
+				Headers: map[string]string{
+					"Authorization": "Bearer [CONTEXT].missingToken",
+				},
+			},
+			context: map[string]interface{}{
+				"token": "validtoken", // different key
+			},
+			expectedURL:  "https://api.example.com",
+			expectedBody: "",
+			expectedHeaders: map[string]string{
+				"Authorization": "Bearer [CONTEXT].missingToken",
+			},
+			expectedErrorCount:    1,
+			expectedErrorContains: []string{"path 'missingToken' not found"},
+		},
+		{
+			name: "multiple_missing_context_paths",
+			endpoint: &Endpoint{
+				URL:  "https://[CONTEXT].missingHost/users/[CONTEXT].missingUserId",
+				Body: `{"token": "[CONTEXT].missingToken"}`,
+			},
+			context: map[string]interface{}{
+				"validKey": "validValue",
+			},
+			expectedURL:        "https://[CONTEXT].missingHost/users/[CONTEXT].missingUserId",
+			expectedBody:       `{"token": "[CONTEXT].missingToken"}`,
+			expectedErrorCount: 2, // 1 for URL (both placeholders), 1 for Body
+			expectedErrorContains: []string{
+				"path 'missingHost' not found",
+				"path 'missingUserId' not found",
+				"path 'missingToken' not found",
+			},
+		},
+		{
+			name: "mixed_valid_and_invalid_placeholders",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].userId/posts/[CONTEXT].missingPostId",
+				Body: `{"userId": "[CONTEXT].userId", "action": "[CONTEXT].missingAction"}`,
+			},
+			context: map[string]interface{}{
+				"userId": "12345",
+			},
+			expectedURL:        "https://api.example.com/users/12345/posts/[CONTEXT].missingPostId",
+			expectedBody:       `{"userId": "12345", "action": "[CONTEXT].missingAction"}`,
+			expectedErrorCount: 2,
+			expectedErrorContains: []string{
+				"path 'missingPostId' not found",
+				"path 'missingAction' not found",
+			},
+		},
+		{
+			name: "nil_context",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].userId",
+				Body: "",
+			},
+			context:            nil,
+			expectedURL:        "https://api.example.com/users/[CONTEXT].userId",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "empty_context",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].userId",
+				Body: "",
+			},
+			context:               map[string]interface{}{},
+			expectedURL:           "https://api.example.com/users/[CONTEXT].userId",
+			expectedBody:          "",
+			expectedErrorCount:    1,
+			expectedErrorContains: []string{"path 'userId' not found"},
+		},
+		{
+			name: "special_characters_in_context_values",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/search?q=[CONTEXT].query",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"query": "hello world & special chars!",
+			},
+			expectedURL:        "https://api.example.com/search?q=hello world & special chars!",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "numeric_context_values",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].userId/limit/[CONTEXT].limit",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"userId": 12345,
+				"limit":  100,
+			},
+			expectedURL:        "https://api.example.com/users/12345/limit/100",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "boolean_context_values",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com",
+				Body: `{"enabled": [CONTEXT].enabled, "active": [CONTEXT].active}`,
+			},
+			context: map[string]interface{}{
+				"enabled": true,
+				"active":  false,
+			},
+			expectedURL:        "https://api.example.com",
+			expectedBody:       `{"enabled": true, "active": false}`,
+			expectedErrorCount: 0,
+		},
+		{
+			name: "no_context_placeholders",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/health",
+				Body: `{"status": "check"}`,
+				Headers: map[string]string{
+					"Content-Type": "application/json",
+				},
+			},
+			context: map[string]interface{}{
+				"userId": "12345",
+			},
+			expectedURL:  "https://api.example.com/health",
+			expectedBody: `{"status": "check"}`,
+			expectedHeaders: map[string]string{
+				"Content-Type": "application/json",
+			},
+			expectedErrorCount: 0,
+		},
+		{
+			name: "deeply_nested_context_path",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].response.data.user.id",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"response": map[string]interface{}{
+					"data": map[string]interface{}{
+						"user": map[string]interface{}{
+							"id": "deep123",
+						},
+					},
+				},
+			},
+			expectedURL:        "https://api.example.com/users/deep123",
+			expectedBody:       "",
+			expectedErrorCount: 0,
+		},
+		{
+			name: "invalid_nested_context_path",
+			endpoint: &Endpoint{
+				URL:  "https://api.example.com/users/[CONTEXT].response.missing.path",
+				Body: "",
+			},
+			context: map[string]interface{}{
+				"response": map[string]interface{}{
+					"data": "value",
+				},
+			},
+			expectedURL:           "https://api.example.com/users/[CONTEXT].response.missing.path",
+			expectedBody:          "",
+			expectedErrorCount:    1,
+			expectedErrorContains: []string{"path 'response.missing.path' not found"},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			// Import gontext package for creating context
+			var ctx *gontext.Gontext
+			if tt.context != nil {
+				ctx = gontext.New(tt.context)
+			}
+			// Create a new Result to capture errors
+			result := &Result{}
+			// Call preprocessWithContext
+			processed := tt.endpoint.preprocessWithContext(result, ctx)
+			// Verify URL
+			if processed.URL != tt.expectedURL {
+				t.Errorf("URL mismatch:\nexpected: %s\nactual:   %s", tt.expectedURL, processed.URL)
+			}
+			// Verify Body
+			if processed.Body != tt.expectedBody {
+				t.Errorf("Body mismatch:\nexpected: %s\nactual:   %s", tt.expectedBody, processed.Body)
+			}
+			// Verify Headers
+			if tt.expectedHeaders != nil {
+				if processed.Headers == nil {
+					t.Error("Expected headers but got nil")
+				} else {
+					for key, expectedValue := range tt.expectedHeaders {
+						if actualValue, exists := processed.Headers[key]; !exists {
+							t.Errorf("Expected header %s not found", key)
+						} else if actualValue != expectedValue {
+							t.Errorf("Header %s mismatch:\nexpected: %s\nactual:   %s", key, expectedValue, actualValue)
+						}
+					}
+				}
+			}
+			// Verify error count
+			if len(result.Errors) != tt.expectedErrorCount {
+				t.Errorf("Error count mismatch:\nexpected: %d\nactual:   %d\nerrors: %v", tt.expectedErrorCount, len(result.Errors), result.Errors)
+			}
+			// Verify error messages contain expected strings
+			if tt.expectedErrorContains != nil {
+				actualErrors := strings.Join(result.Errors, " ")
+				for _, expectedError := range tt.expectedErrorContains {
+					if !strings.Contains(actualErrors, expectedError) {
+						t.Errorf("Expected error containing '%s' not found in: %v", expectedError, result.Errors)
+					}
+				}
+			}
+			// Verify original endpoint is not modified
+			if tt.endpoint.URL != ((&Endpoint{URL: tt.endpoint.URL, Body: tt.endpoint.Body, Headers: tt.endpoint.Headers}).URL) {
+				t.Error("Original endpoint was modified")
+			}
+		})
+	}
+}
--- a/config/endpoint/external_endpoint.go
+++ b/config/endpoint/external_endpoint.go
@@ -6,6 +6,7 @@ import (

 	"github.com/TwiN/gatus/v5/alerting/alert"
 	"github.com/TwiN/gatus/v5/config/endpoint/heartbeat"
+	"github.com/TwiN/gatus/v5/config/key"
 	"github.com/TwiN/gatus/v5/config/maintenance"
 )

@@ -82,7 +83,7 @@ func (externalEndpoint *ExternalEndpoint) DisplayName() string {

 // Key returns the unique key for the Endpoint
 func (externalEndpoint *ExternalEndpoint) Key() string {
-	return ConvertGroupAndEndpointNameToKey(externalEndpoint.Group, externalEndpoint.Name)
+	return key.ConvertGroupAndNameToKey(externalEndpoint.Group, externalEndpoint.Name)
 }

 // ToEndpoint converts the ExternalEndpoint to an Endpoint
--- a/config/endpoint/external_endpoint_test.go
+++ b/config/endpoint/external_endpoint_test.go
@@ -2,24 +2,379 @@ package endpoint

 import (
 	"testing"
+	"time"
+
+	"github.com/TwiN/gatus/v5/alerting/alert"
+	"github.com/TwiN/gatus/v5/config/endpoint/heartbeat"
+	"github.com/TwiN/gatus/v5/config/maintenance"
 )

-func TestExternalEndpoint_ToEndpoint(t *testing.T) {
-	externalEndpoint := &ExternalEndpoint{
-		Name:  "name",
-		Group: "group",
+func TestExternalEndpoint_ValidateAndSetDefaults(t *testing.T) {
+	tests := []struct {
+		name     string
+		endpoint *ExternalEndpoint
+		wantErr  error
+	}{
+		{
+			name: "valid-external-endpoint",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "test-group",
+				Token: "valid-token",
+			},
+			wantErr: nil,
+		},
+		{
+			name: "valid-external-endpoint-with-heartbeat",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "valid-token",
+				Heartbeat: heartbeat.Config{
+					Interval: 30 * time.Second,
+				},
+			},
+			wantErr: nil,
+		},
+		{
+			name: "missing-token",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "test-group",
+			},
+			wantErr: ErrExternalEndpointWithNoToken,
+		},
+		{
+			name: "empty-token",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "",
+			},
+			wantErr: ErrExternalEndpointWithNoToken,
+		},
+		{
+			name: "heartbeat-interval-too-low",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "valid-token",
+				Heartbeat: heartbeat.Config{
+					Interval: 5 * time.Second, // Less than 10 seconds
+				},
+			},
+			wantErr: ErrExternalEndpointHeartbeatIntervalTooLow,
+		},
+		{
+			name: "heartbeat-interval-exactly-10-seconds",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "valid-token",
+				Heartbeat: heartbeat.Config{
+					Interval: 10 * time.Second,
+				},
+			},
+			wantErr: nil,
+		},
+		{
+			name: "heartbeat-interval-zero-is-allowed",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "valid-token",
+				Heartbeat: heartbeat.Config{
+					Interval: 0, // Zero means no heartbeat monitoring
+				},
+			},
+			wantErr: nil,
+		},
+		{
+			name: "missing-name",
+			endpoint: &ExternalEndpoint{
+				Group: "test-group",
+				Token: "valid-token",
+			},
+			wantErr: ErrEndpointWithNoName,
+		},
 	}
-	convertedEndpoint := externalEndpoint.ToEndpoint()
-	if externalEndpoint.Name != convertedEndpoint.Name {
-		t.Errorf("expected %s, got %s", externalEndpoint.Name, convertedEndpoint.Name)
-	}
-	if externalEndpoint.Group != convertedEndpoint.Group {
-		t.Errorf("expected %s, got %s", externalEndpoint.Group, convertedEndpoint.Group)
-	}
-	if externalEndpoint.Key() != convertedEndpoint.Key() {
-		t.Errorf("expected %s, got %s", externalEndpoint.Key(), convertedEndpoint.Key())
-	}
-	if externalEndpoint.DisplayName() != convertedEndpoint.DisplayName() {
-		t.Errorf("expected %s, got %s", externalEndpoint.DisplayName(), convertedEndpoint.DisplayName())
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			err := tt.endpoint.ValidateAndSetDefaults()
+			if tt.wantErr != nil {
+				if err == nil {
+					t.Errorf("Expected error %v, but got none", tt.wantErr)
+					return
+				}
+				if err.Error() != tt.wantErr.Error() {
+					t.Errorf("Expected error %v, got %v", tt.wantErr, err)
+				}
+			} else {
+				if err != nil {
+					t.Errorf("Expected no error, but got %v", err)
+				}
+			}
+		})
 	}
 }
+
+func TestExternalEndpoint_IsEnabled(t *testing.T) {
+	tests := []struct {
+		name     string
+		enabled  *bool
+		expected bool
+	}{
+		{
+			name:     "nil-enabled-defaults-to-true",
+			enabled:  nil,
+			expected: true,
+		},
+		{
+			name:     "explicitly-enabled",
+			enabled:  boolPtr(true),
+			expected: true,
+		},
+		{
+			name:     "explicitly-disabled",
+			enabled:  boolPtr(false),
+			expected: false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			endpoint := &ExternalEndpoint{
+				Name:    "test-endpoint",
+				Token:   "test-token",
+				Enabled: tt.enabled,
+			}
+			result := endpoint.IsEnabled()
+			if result != tt.expected {
+				t.Errorf("Expected %v, got %v", tt.expected, result)
+			}
+		})
+	}
+}
+
+func TestExternalEndpoint_DisplayName(t *testing.T) {
+	tests := []struct {
+		name     string
+		endpoint *ExternalEndpoint
+		expected string
+	}{
+		{
+			name: "with-group",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "test-group",
+			},
+			expected: "test-group/test-endpoint",
+		},
+		{
+			name: "without-group",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "",
+			},
+			expected: "test-endpoint",
+		},
+		{
+			name: "empty-group-string",
+			endpoint: &ExternalEndpoint{
+				Name:  "api-health",
+				Group: "",
+			},
+			expected: "api-health",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			result := tt.endpoint.DisplayName()
+			if result != tt.expected {
+				t.Errorf("Expected %q, got %q", tt.expected, result)
+			}
+		})
+	}
+}
+
+func TestExternalEndpoint_Key(t *testing.T) {
+	tests := []struct {
+		name     string
+		endpoint *ExternalEndpoint
+		expected string
+	}{
+		{
+			name: "with-group",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "test-group",
+			},
+			expected: "test-group_test-endpoint",
+		},
+		{
+			name: "without-group",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Group: "",
+			},
+			expected: "_test-endpoint",
+		},
+		{
+			name: "special-characters-in-name",
+			endpoint: &ExternalEndpoint{
+				Name:  "test endpoint with spaces",
+				Group: "test-group",
+			},
+			expected: "test-group_test-endpoint-with-spaces",
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			result := tt.endpoint.Key()
+			if result != tt.expected {
+				t.Errorf("Expected %q, got %q", tt.expected, result)
+			}
+		})
+	}
+}
+
+func TestExternalEndpoint_ToEndpoint(t *testing.T) {
+	tests := []struct {
+		name             string
+		externalEndpoint *ExternalEndpoint
+	}{
+		{
+			name: "complete-external-endpoint",
+			externalEndpoint: &ExternalEndpoint{
+				Enabled: boolPtr(true),
+				Name:    "test-endpoint",
+				Group:   "test-group",
+				Token:   "test-token",
+				Alerts: []*alert.Alert{
+					{
+						Type: alert.TypeSlack,
+					},
+				},
+				MaintenanceWindows: []*maintenance.Config{
+					{
+						Start:    "02:00",
+						Duration: time.Hour,
+					},
+				},
+				NumberOfFailuresInARow:  3,
+				NumberOfSuccessesInARow: 5,
+			},
+		},
+		{
+			name: "minimal-external-endpoint",
+			externalEndpoint: &ExternalEndpoint{
+				Name:  "minimal-endpoint",
+				Token: "minimal-token",
+			},
+		},
+		{
+			name: "disabled-external-endpoint",
+			externalEndpoint: &ExternalEndpoint{
+				Enabled: boolPtr(false),
+				Name:    "disabled-endpoint",
+				Token:   "disabled-token",
+			},
+		},
+		{
+			name: "original-test-case",
+			externalEndpoint: &ExternalEndpoint{
+				Name:  "name",
+				Group: "group",
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			result := tt.externalEndpoint.ToEndpoint()
+			// Verify all fields are correctly copied
+			if result.Enabled != tt.externalEndpoint.Enabled {
+				t.Errorf("Expected Enabled=%v, got %v", tt.externalEndpoint.Enabled, result.Enabled)
+			}
+			if result.Name != tt.externalEndpoint.Name {
+				t.Errorf("Expected Name=%q, got %q", tt.externalEndpoint.Name, result.Name)
+			}
+			if result.Group != tt.externalEndpoint.Group {
+				t.Errorf("Expected Group=%q, got %q", tt.externalEndpoint.Group, result.Group)
+			}
+			if len(result.Alerts) != len(tt.externalEndpoint.Alerts) {
+				t.Errorf("Expected %d alerts, got %d", len(tt.externalEndpoint.Alerts), len(result.Alerts))
+			}
+			if result.NumberOfFailuresInARow != tt.externalEndpoint.NumberOfFailuresInARow {
+				t.Errorf("Expected NumberOfFailuresInARow=%d, got %d", tt.externalEndpoint.NumberOfFailuresInARow, result.NumberOfFailuresInARow)
+			}
+			if result.NumberOfSuccessesInARow != tt.externalEndpoint.NumberOfSuccessesInARow {
+				t.Errorf("Expected NumberOfSuccessesInARow=%d, got %d", tt.externalEndpoint.NumberOfSuccessesInARow, result.NumberOfSuccessesInARow)
+			}
+			// Original test assertions
+			if tt.externalEndpoint.Key() != result.Key() {
+				t.Errorf("expected %s, got %s", tt.externalEndpoint.Key(), result.Key())
+			}
+			if tt.externalEndpoint.DisplayName() != result.DisplayName() {
+				t.Errorf("expected %s, got %s", tt.externalEndpoint.DisplayName(), result.DisplayName())
+			}
+			// Verify it's a proper Endpoint type
+			if result == nil {
+				t.Error("ToEndpoint() returned nil")
+			}
+		})
+	}
+}
+
+func TestExternalEndpoint_ValidationEdgeCases(t *testing.T) {
+	tests := []struct {
+		name     string
+		endpoint *ExternalEndpoint
+		wantErr  bool
+	}{
+		{
+			name: "very-long-name",
+			endpoint: &ExternalEndpoint{
+				Name:  "this-is-a-very-long-endpoint-name-that-might-cause-issues-in-some-systems-but-should-be-handled-gracefully",
+				Token: "valid-token",
+			},
+			wantErr: false,
+		},
+		{
+			name: "special-characters-in-name",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint@#$%^&*()",
+				Token: "valid-token",
+			},
+			wantErr: false,
+		},
+		{
+			name: "unicode-characters-in-name",
+			endpoint: &ExternalEndpoint{
+				Name:  "测试端点",
+				Token: "valid-token",
+			},
+			wantErr: false,
+		},
+		{
+			name: "very-long-token",
+			endpoint: &ExternalEndpoint{
+				Name:  "test-endpoint",
+				Token: "very-long-token-that-should-still-be-valid-even-though-it-is-extremely-long-and-might-not-be-practical-in-real-world-scenarios",
+			},
+			wantErr: false,
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			err := tt.endpoint.ValidateAndSetDefaults()
+			if tt.wantErr && err == nil {
+				t.Error("Expected error but got none")
+			}
+			if !tt.wantErr && err != nil {
+				t.Errorf("Expected no error but got: %v", err)
+			}
+		})
+	}
+}
+
+// Helper function to create bool pointers
+func boolPtr(b bool) *bool {
+	return &b
+}
--- a/config/endpoint/key.go
+++ b/config/endpoint/key.go
@@ -1,19 +0,0 @@
-package endpoint
-
-import "strings"
-
-// ConvertGroupAndEndpointNameToKey converts a group and an endpoint to a key
-func ConvertGroupAndEndpointNameToKey(groupName, endpointName string) string {
-	return sanitize(groupName) + "_" + sanitize(endpointName)
-}
-
-func sanitize(s string) string {
-	s = strings.TrimSpace(strings.ToLower(s))
-	s = strings.ReplaceAll(s, "/", "-")
-	s = strings.ReplaceAll(s, "_", "-")
-	s = strings.ReplaceAll(s, ".", "-")
-	s = strings.ReplaceAll(s, ",", "-")
-	s = strings.ReplaceAll(s, " ", "-")
-	s = strings.ReplaceAll(s, "#", "-")
-	return s
-}
--- a/config/endpoint/key_bench_test.go
+++ b/config/endpoint/key_bench_test.go
@@ -1,11 +0,0 @@
-package endpoint
-
-import (
-	"testing"
-)
-
-func BenchmarkConvertGroupAndEndpointNameToKey(b *testing.B) {
-	for n := 0; n < b.N; n++ {
-		ConvertGroupAndEndpointNameToKey("group", "name")
-	}
-}
--- a/config/endpoint/key_test.go
+++ b/config/endpoint/key_test.go
@@ -1,36 +0,0 @@
-package endpoint
-
-import "testing"
-
-func TestConvertGroupAndEndpointNameToKey(t *testing.T) {
-	type Scenario struct {
-		GroupName      string
-		EndpointName   string
-		ExpectedOutput string
-	}
-	scenarios := []Scenario{
-		{
-			GroupName:      "Core",
-			EndpointName:   "Front End",
-			ExpectedOutput: "core_front-end",
-		},
-		{
-			GroupName:      "Load balancers",
-			EndpointName:   "us-west-2",
-			ExpectedOutput: "load-balancers_us-west-2",
-		},
-		{
-			GroupName:      "a/b test",
-			EndpointName:   "a",
-			ExpectedOutput: "a-b-test_a",
-		},
-	}
-	for _, scenario := range scenarios {
-		t.Run(scenario.ExpectedOutput, func(t *testing.T) {
-			output := ConvertGroupAndEndpointNameToKey(scenario.GroupName, scenario.EndpointName)
-			if output != scenario.ExpectedOutput {
-				t.Errorf("expected '%s', got '%s'", scenario.ExpectedOutput, output)
-			}
-		})
-	}
-}
--- a/config/endpoint/placeholder.go
+++ b/config/endpoint/placeholder.go
@@ -0,0 +1,273 @@
+package endpoint
+
+import (
+	"fmt"
+	"strconv"
+	"strings"
+
+	"github.com/TwiN/gatus/v5/config/gontext"
+	"github.com/TwiN/gatus/v5/jsonpath"
+)
+
+// Placeholders
+const (
+	// StatusPlaceholder is a placeholder for a HTTP status.
+	//
+	// Values that could replace the placeholder: 200, 404, 500, ...
+	StatusPlaceholder = "[STATUS]"
+
+	// IPPlaceholder is a placeholder for an IP.
+	//
+	// Values that could replace the placeholder: 127.0.0.1, 10.0.0.1, ...
+	IPPlaceholder = "[IP]"
+
+	// DNSRCodePlaceholder is a placeholder for DNS_RCODE
+	//
+	// Values that could replace the placeholder: NOERROR, FORMERR, SERVFAIL, NXDOMAIN, NOTIMP, REFUSED
+	DNSRCodePlaceholder = "[DNS_RCODE]"
+
+	// ResponseTimePlaceholder is a placeholder for the request response time, in milliseconds.
+	//
+	// Values that could replace the placeholder: 1, 500, 1000, ...
+	ResponseTimePlaceholder = "[RESPONSE_TIME]"
+
+	// BodyPlaceholder is a placeholder for the Body of the response
+	//
+	// Values that could replace the placeholder: {}, {"data":{"name":"john"}}, ...
+	BodyPlaceholder = "[BODY]"
+
+	// ConnectedPlaceholder is a placeholder for whether a connection was successfully established.
+	//
+	// Values that could replace the placeholder: true, false
+	ConnectedPlaceholder = "[CONNECTED]"
+
+	// CertificateExpirationPlaceholder is a placeholder for the duration before certificate expiration, in milliseconds.
+	//
+	// Values that could replace the placeholder: 4461677039 (~52 days)
+	CertificateExpirationPlaceholder = "[CERTIFICATE_EXPIRATION]"
+
+	// DomainExpirationPlaceholder is a placeholder for the duration before the domain expires, in milliseconds.
+	DomainExpirationPlaceholder = "[DOMAIN_EXPIRATION]"
+
+	// ContextPlaceholder is a placeholder for suite context values
+	// Usage: [CONTEXT].path.to.value
+	ContextPlaceholder = "[CONTEXT]"
+)
+
+// Functions
+const (
+	// LengthFunctionPrefix is the prefix for the length function
+	//
+	// Usage: len([BODY].articles) == 10, len([BODY].name) > 5
+	LengthFunctionPrefix = "len("
+
+	// HasFunctionPrefix is the prefix for the has function
+	//
+	// Usage: has([BODY].errors) == true
+	HasFunctionPrefix = "has("
+
+	// PatternFunctionPrefix is the prefix for the pattern function
+	//
+	// Usage: [IP] == pat(192.168.*.*)
+	PatternFunctionPrefix = "pat("
+
+	// AnyFunctionPrefix is the prefix for the any function
+	//
+	// Usage: [IP] == any(1.1.1.1, 1.0.0.1)
+	AnyFunctionPrefix = "any("
+
+	// FunctionSuffix is the suffix for all functions
+	FunctionSuffix = ")"
+)
+
+// Other constants
+const (
+	// InvalidConditionElementSuffix is the suffix that will be appended to an invalid condition
+	InvalidConditionElementSuffix = "(INVALID)"
+)
+
+// functionType represents the type of function wrapper
+type functionType int
+
+const (
+	// Note that not all functions are handled here. Only len() and has() directly impact the handler
+	// e.g. "len([BODY].name) > 0" vs pat() or any(), which would be used like "[BODY].name == pat(john*)"
+
+	noFunction functionType = iota
+	functionLen
+	functionHas
+)
+
+// ResolvePlaceholder resolves all types of placeholders to their string values.
+//
+// Supported placeholders:
+//   - [STATUS]: HTTP status code (e.g., "200", "404")
+//   - [IP]: IP address from the response (e.g., "127.0.0.1")
+//   - [RESPONSE_TIME]: Response time in milliseconds (e.g., "250")
+//   - [DNS_RCODE]: DNS response code (e.g., "NOERROR", "NXDOMAIN")
+//   - [CONNECTED]: Connection status (e.g., "true", "false")
+//   - [CERTIFICATE_EXPIRATION]: Certificate expiration time in milliseconds
+//   - [DOMAIN_EXPIRATION]: Domain expiration time in milliseconds
+//   - [BODY]: Full response body
+//   - [BODY].path: JSONPath expression on response body (e.g., [BODY].status, [BODY].data[0].name)
+//   - [CONTEXT].path: Suite context values (e.g., [CONTEXT].user_id, [CONTEXT].session_token)
+//
+// Function wrappers:
+//   - len(placeholder): Returns the length of the resolved value
+//   - has(placeholder): Returns "true" if the placeholder exists and is non-empty, "false" otherwise
+//
+// Examples:
+//   - ResolvePlaceholder("[STATUS]", result, nil) → "200"
+//   - ResolvePlaceholder("len([BODY].items)", result, nil) → "5" (for JSON array with 5 items)
+//   - ResolvePlaceholder("has([CONTEXT].user_id)", result, ctx) → "true" (if context has user_id)
+//   - ResolvePlaceholder("[BODY].user.name", result, nil) → "john" (for {"user":{"name":"john"}})
+//
+// Case-insensitive: All placeholder names are handled case-insensitively, but paths preserve original case.
+func ResolvePlaceholder(placeholder string, result *Result, ctx *gontext.Gontext) (string, error) {
+	placeholder = strings.TrimSpace(placeholder)
+	originalPlaceholder := placeholder
+
+	// Extract function wrapper if present
+	fn, innerPlaceholder := extractFunctionWrapper(placeholder)
+	placeholder = innerPlaceholder
+
+	// Handle CONTEXT placeholders
+	uppercasePlaceholder := strings.ToUpper(placeholder)
+	if strings.HasPrefix(uppercasePlaceholder, ContextPlaceholder) && ctx != nil {
+		return resolveContextPlaceholder(placeholder, fn, originalPlaceholder, ctx)
+	}
+
+	// Handle basic placeholders (try uppercase first for backward compatibility)
+	switch uppercasePlaceholder {
+	case StatusPlaceholder:
+		return formatWithFunction(strconv.Itoa(result.HTTPStatus), fn), nil
+	case IPPlaceholder:
+		return formatWithFunction(result.IP, fn), nil
+	case ResponseTimePlaceholder:
+		return formatWithFunction(strconv.FormatInt(result.Duration.Milliseconds(), 10), fn), nil
+	case DNSRCodePlaceholder:
+		return formatWithFunction(result.DNSRCode, fn), nil
+	case ConnectedPlaceholder:
+		return formatWithFunction(strconv.FormatBool(result.Connected), fn), nil
+	case CertificateExpirationPlaceholder:
+		return formatWithFunction(strconv.FormatInt(result.CertificateExpiration.Milliseconds(), 10), fn), nil
+	case DomainExpirationPlaceholder:
+		return formatWithFunction(strconv.FormatInt(result.DomainExpiration.Milliseconds(), 10), fn), nil
+	case BodyPlaceholder:
+		body := strings.TrimSpace(string(result.Body))
+		if fn == functionHas {
+			return strconv.FormatBool(len(body) > 0), nil
+		}
+		if fn == functionLen {
+			// For len([BODY]), we need to check if it's JSON and get the actual length
+			// Use jsonpath to evaluate the root element
+			_, resolvedLength, err := jsonpath.Eval("", result.Body)
+			if err == nil {
+				return strconv.Itoa(resolvedLength), nil
+			}
+			// Fall back to string length if not valid JSON
+			return strconv.Itoa(len(body)), nil
+		}
+		return body, nil
+	}
+
+	// Handle JSONPath expressions on BODY (including array indexing)
+	if strings.HasPrefix(uppercasePlaceholder, BodyPlaceholder+".") || strings.HasPrefix(uppercasePlaceholder, BodyPlaceholder+"[") {
+		return resolveJSONPathPlaceholder(placeholder, fn, originalPlaceholder, result)
+	}
+
+	// Not a recognized placeholder
+	if fn != noFunction {
+		if fn == functionHas {
+			return "false", nil
+		}
+		// For len() with unrecognized placeholder, return with INVALID suffix
+		return originalPlaceholder + " " + InvalidConditionElementSuffix, nil
+	}
+
+	// Return the original placeholder if we can't resolve it
+	// This allows for literal string comparisons
+	return originalPlaceholder, nil
+}
+
+// extractFunctionWrapper detects and extracts function wrappers (len, has)
+func extractFunctionWrapper(placeholder string) (functionType, string) {
+	if strings.HasPrefix(placeholder, LengthFunctionPrefix) && strings.HasSuffix(placeholder, FunctionSuffix) {
+		inner := strings.TrimSuffix(strings.TrimPrefix(placeholder, LengthFunctionPrefix), FunctionSuffix)
+		return functionLen, inner
+	}
+	if strings.HasPrefix(placeholder, HasFunctionPrefix) && strings.HasSuffix(placeholder, FunctionSuffix) {
+		inner := strings.TrimSuffix(strings.TrimPrefix(placeholder, HasFunctionPrefix), FunctionSuffix)
+		return functionHas, inner
+	}
+	return noFunction, placeholder
+}
+
+// resolveJSONPathPlaceholder handles [BODY].path and [BODY][index] placeholders
+func resolveJSONPathPlaceholder(placeholder string, fn functionType, originalPlaceholder string, result *Result) (string, error) {
+	// Extract the path after [BODY] (case insensitive)
+	uppercasePlaceholder := strings.ToUpper(placeholder)
+	path := ""
+	if strings.HasPrefix(uppercasePlaceholder, BodyPlaceholder) {
+		path = placeholder[len(BodyPlaceholder):]
+	} else {
+		path = strings.TrimPrefix(placeholder, BodyPlaceholder)
+	}
+	// Remove leading dot if present
+	path = strings.TrimPrefix(path, ".")
+	resolvedValue, resolvedLength, err := jsonpath.Eval(path, result.Body)
+	if fn == functionHas {
+		return strconv.FormatBool(err == nil), nil
+	}
+	if err != nil {
+		return originalPlaceholder + " " + InvalidConditionElementSuffix, nil
+	}
+	if fn == functionLen {
+		return strconv.Itoa(resolvedLength), nil
+	}
+	return resolvedValue, nil
+}
+
+// resolveContextPlaceholder handles [CONTEXT] placeholder resolution
+func resolveContextPlaceholder(placeholder string, fn functionType, originalPlaceholder string, ctx *gontext.Gontext) (string, error) {
+	contextPath := strings.TrimPrefix(placeholder, ContextPlaceholder)
+	contextPath = strings.TrimPrefix(contextPath, ".")
+	if contextPath == "" {
+		if fn == functionHas {
+			return "false", nil
+		}
+		return originalPlaceholder + " " + InvalidConditionElementSuffix, nil
+	}
+	value, err := ctx.Get(contextPath)
+	if fn == functionHas {
+		return strconv.FormatBool(err == nil), nil
+	}
+	if err != nil {
+		return originalPlaceholder + " " + InvalidConditionElementSuffix, nil
+	}
+	if fn == functionLen {
+		switch v := value.(type) {
+		case string:
+			return strconv.Itoa(len(v)), nil
+		case []interface{}:
+			return strconv.Itoa(len(v)), nil
+		case map[string]interface{}:
+			return strconv.Itoa(len(v)), nil
+		default:
+			return strconv.Itoa(len(fmt.Sprintf("%v", v))), nil
+		}
+	}
+	return fmt.Sprintf("%v", value), nil
+}
+
+// formatWithFunction applies len/has functions to any value
+func formatWithFunction(value string, fn functionType) string {
+	switch fn {
+	case functionHas:
+		return strconv.FormatBool(value != "")
+	case functionLen:
+		return strconv.Itoa(len(value))
+	default:
+		return value
+	}
+}
--- a/config/endpoint/placeholder_test.go
+++ b/config/endpoint/placeholder_test.go
@@ -0,0 +1,125 @@
+package endpoint
+
+import (
+	"testing"
+	"time"
+
+	"github.com/TwiN/gatus/v5/config/gontext"
+)
+
+func TestResolvePlaceholder(t *testing.T) {
+	result := &Result{
+		HTTPStatus:            200,
+		IP:                    "127.0.0.1",
+		Duration:              250 * time.Millisecond,
+		DNSRCode:              "NOERROR",
+		Connected:             true,
+		CertificateExpiration: 30 * 24 * time.Hour,
+		DomainExpiration:      365 * 24 * time.Hour,
+		Body:                  []byte(`{"status":"success","items":[1,2,3],"user":{"name":"john","id":123}}`),
+	}
+
+	ctx := gontext.New(map[string]interface{}{
+		"user_id":       "abc123",
+		"session_token": "xyz789",
+		"array_data":    []interface{}{"a", "b", "c"},
+		"nested": map[string]interface{}{
+			"value": "test",
+		},
+	})
+
+	tests := []struct {
+		name        string
+		placeholder string
+		expected    string
+	}{
+		// Basic placeholders
+		{"status", "[STATUS]", "200"},
+		{"ip", "[IP]", "127.0.0.1"},
+		{"response-time", "[RESPONSE_TIME]", "250"},
+		{"dns-rcode", "[DNS_RCODE]", "NOERROR"},
+		{"connected", "[CONNECTED]", "true"},
+		{"certificate-expiration", "[CERTIFICATE_EXPIRATION]", "2592000000"},
+		{"domain-expiration", "[DOMAIN_EXPIRATION]", "31536000000"},
+		{"body", "[BODY]", `{"status":"success","items":[1,2,3],"user":{"name":"john","id":123}}`},
+
+		// Case insensitive placeholders
+		{"status-lowercase", "[status]", "200"},
+		{"ip-mixed-case", "[Ip]", "127.0.0.1"},
+
+		// Function wrappers on basic placeholders
+		{"len-status", "len([STATUS])", "3"},
+		{"len-ip", "len([IP])", "9"},
+		{"has-status", "has([STATUS])", "true"},
+		{"has-empty", "has()", "false"},
+
+		// JSONPath expressions
+		{"body-status", "[BODY].status", "success"},
+		{"body-user-name", "[BODY].user.name", "john"},
+		{"body-user-id", "[BODY].user.id", "123"},
+		{"len-body-items", "len([BODY].items)", "3"},
+		{"body-array-index", "[BODY].items[0]", "1"},
+		{"has-body-status", "has([BODY].status)", "true"},
+		{"has-body-missing", "has([BODY].missing)", "false"},
+
+		// Context placeholders
+		{"context-user-id", "[CONTEXT].user_id", "abc123"},
+		{"context-session-token", "[CONTEXT].session_token", "xyz789"},
+		{"context-nested", "[CONTEXT].nested.value", "test"},
+		{"len-context-array", "len([CONTEXT].array_data)", "3"},
+		{"has-context-user-id", "has([CONTEXT].user_id)", "true"},
+		{"has-context-missing", "has([CONTEXT].missing)", "false"},
+
+		// Invalid placeholders
+		{"unknown-placeholder", "[UNKNOWN]", "[UNKNOWN]"},
+		{"len-unknown", "len([UNKNOWN])", "len([UNKNOWN]) (INVALID)"},
+		{"has-unknown", "has([UNKNOWN])", "false"},
+		{"invalid-jsonpath", "[BODY].invalid.path", "[BODY].invalid.path (INVALID)"},
+
+		// Literal strings
+		{"literal-string", "literal", "literal"},
+		{"number-string", "123", "123"},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			actual, err := ResolvePlaceholder(test.placeholder, result, ctx)
+			if err != nil {
+				t.Errorf("unexpected error: %v", err)
+			}
+			if actual != test.expected {
+				t.Errorf("expected '%s', got '%s'", test.expected, actual)
+			}
+		})
+	}
+}
+
+func TestResolvePlaceholderWithoutContext(t *testing.T) {
+	result := &Result{
+		HTTPStatus: 404,
+		Body:       []byte(`{"error":"not found"}`),
+	}
+
+	tests := []struct {
+		name        string
+		placeholder string
+		expected    string
+	}{
+		{"status-without-context", "[STATUS]", "404"},
+		{"body-without-context", "[BODY].error", "not found"},
+		{"context-without-context", "[CONTEXT].user_id", "[CONTEXT].user_id"},
+		{"has-context-without-context", "has([CONTEXT].user_id)", "false"},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			actual, err := ResolvePlaceholder(test.placeholder, result, nil)
+			if err != nil {
+				t.Errorf("unexpected error: %v", err)
+			}
+			if actual != test.expected {
+				t.Errorf("expected '%s', got '%s'", test.expected, actual)
+			}
+		})
+	}
+}
--- a/config/endpoint/result.go
+++ b/config/endpoint/result.go
@@ -4,7 +4,7 @@ import (
 	"time"
 )

-// Result of the evaluation of a Endpoint
+// Result of the evaluation of an Endpoint
 type Result struct {
 	// HTTPStatus is the HTTP response status code
 	HTTPStatus int `json:"status,omitempty"`
@@ -54,6 +54,13 @@ type Result struct {
 	// Below is used only for the UI and is not persisted in the storage //
 	///////////////////////////////////////////////////////////////////////
 	port string `yaml:"-"` // used for endpoints[].ui.hide-port
+
+	///////////////////////////////////
+	// BELOW IS ONLY USED FOR SUITES //
+	///////////////////////////////////
+	// Name of the endpoint (ONLY USED FOR SUITES)
+	// Group is not needed because it's inherited from the suite
+	Name string `json:"name,omitempty"`
 }

 // AddError adds an error to the result's list of errors.
--- a/config/endpoint/status.go
+++ b/config/endpoint/status.go
@@ -1,6 +1,9 @@
 package endpoint

+import "github.com/TwiN/gatus/v5/config/key"
+
 // Status contains the evaluation Results of an Endpoint
+// This is essentially a DTO
 type Status struct {
 	// Name of the endpoint
 	Name string `json:"name,omitempty"`
@@ -30,7 +33,7 @@ func NewStatus(group, name string) *Status {
 	return &Status{
 		Name:    name,
 		Group:   group,
-		Key:     ConvertGroupAndEndpointNameToKey(group, name),
+		Key:     key.ConvertGroupAndNameToKey(group, name),
 		Results: make([]*Result, 0),
 		Events:  make([]*Event, 0),
 		Uptime:  NewUptime(),