add uri_clean attribute, removes the leading backslash for uris that have only one leading backslash i.e saved at root

change the detail syntax, use uri_clean , include a formatted most_recent_run_time and print the exit code directly

change default empty state to unknown

for cases where user specifies title in filters, thresholds or directly in the arguent, change the empty result syntax and warn about title attribute usage

Author: inqrphl

pkg/snclient/check_tasksched.go

@@ -47,11 +47,11 @@ func (l *CheckTasksched) Build() *CheckData {
 		defaultFilter:   "enabled = true",
 		defaultCritical: "exit_code < 0",
 		defaultWarning:  "exit_code != 0",
-		detailSyntax:    "${uri}: ${exit_code} != 0",
+		detailSyntax:    "${uri_clean} (%{most_recent_run_time:date}) exited with ${exit_code}",
 		topSyntax:       "%(status) - ${problem_list}",
 		okSyntax:        "%(status) - All tasks are ok",
 		emptySyntax:     "%(status) - No tasks found",
-		emptyState:      CheckExitWarning,
+		emptyState:      CheckExitUnknown,
 		attributes: []CheckAttribute{
 			{name: "application", description: "Name of the application that the task is associated with"},
 			{name: "comment", description: "Comment or description for the work item"},
@@ -60,6 +60,8 @@ func (l *CheckTasksched) Build() *CheckData {
 			{name: "exit_code", description: "The last jobs exit code"},
 			{name: "exit_string", description: "The last jobs exit code as string"},
 			{name: "folder", description: "Task folder"},
+			{name: "uri", description: "Fully qualified path to the task, includes folder and the task title"},
+			{name: "uri_clean", description: "Remove the leading backslash from the URI, only for tasks directly saved at root and not for ones saved inside folders."},
 			{name: "has_run", description: "True if this task has ever been executed"},
 			{name: "max_run_time", description: "Maximum length of time the task can run", unit: UDuration},
 			{name: "most_recent_run_time", description: "Most recent time the work item began running", unit: UDate},

pkg/snclient/check_tasksched_windows.go

@@ -7,6 +7,7 @@ import (
 	_ "embed"
 	"fmt"
 	"strconv"
+	"strings"
 	"syscall"
 	"time"
 
@@ -78,6 +79,7 @@ func (l *CheckTasksched) addTasks(ctx context.Context, snc *Agent, check *CheckD
 			"exit_string":          task.LastTaskResult.String(),
 			"folder":               task.Path,
 			"uri":                  task.URI,
+			"uri_clean":            parseURIClean(task.URI),
 			"has_run":              fmt.Sprintf("%t", hasRun),
 			"max_run_time":         task.ExecutionTimeLimit,
 			"most_recent_run_time": fmt.Sprintf("%d", l.parseDate(task.LastRunTime).Unix()),
@@ -92,9 +94,24 @@ func (l *CheckTasksched) addTasks(ctx context.Context, snc *Agent, check *CheckD
 		check.listData = append(check.listData, entry)
 	}
 
+	if check.HasThreshold("title") || check.hasThresholdCond(check.filter, "title") || l.TaskTitle != CheckTaskschedDefaultTaskTitle {
+		check.emptyState = CheckExitUnknown
+		check.emptySyntax = "%(status) - No tasks found, check your arguments/filters/thresholds using title attribute."
+	}
+
 	return nil
 }
 
+func parseURIClean(uri string) string {
+	if strings.Count(uri, "\\") == 1 {
+		if cut, cutOk := strings.CutPrefix(uri, "\\"); cutOk {
+			return cut
+		}
+	}
+
+	return uri
+}
+
 func (l *CheckTasksched) parseDate(raw string) time.Time {
 	// date matches the pattern /Date(unixmilliseconds))/
 	if len(raw) > 6 && raw[0:6] == "/Date(" {