Workato: Fix monitor definition which fails to match when stop_cause is None; update README (DataDog#20863)

Author: bskinny

workato/README.md

@@ -18,31 +18,23 @@ understand trends and issues.
 ### Generate API credentials in Workato
 
 1. Log in to [Workato][2] as an administrator.
-2. Navigate to the **Workspace Admin** tab. > API Clients**.
+2. Navigate to the **Workspace Admin** > **API Clients** tab.
 3. (Create a Client Role with sufficient permission) Click **Client Roles** tab.
 4. Click **+ Add client role**.
    1. Check the following boxes to allow minimal read access:
-   ```
-      Projects
-           Project Assets
-               List Projects
-               List Folders
-           Connections
-               List
-           Recipes
-               List
-               Get job counts for recipes
-               Get details
-           Recipe Versions
-               List
-           Jobs
-               List
-               Get job
-      Admin
-            Environment Management
-                Tags
-                    List tags
-   ```
+   
+        | Section  | Permission                                |
+        |----------|-------------------------------------------|
+        | Projects | Project Assets > List Projects            |
+        | Projects | Project Assets > List Folders             |
+        | Projects | Connections > List                        |
+        | Projects | Recipes > List                            |
+        | Projects | Recipes > Get job counts for recipes      |
+        | Projects | Recipes > Get details                     |
+        | Projects | Recipe Versions > List                    |
+        | Projects | Jobs > List                               |
+        | Projects | Jobs > Get job                            |
+        | Admin    | Environment Management > Tags > List tags |
    2. Edit the role name, and click **Save changes**.
 7. Select the **API Clients** tab.
 8. Click **+ Add API Client**, and then enter the required information:

workato/assets/logs/workato_tests.yaml

@@ -95,7 +95,7 @@ tests:
           "id": 62605996,
           "folder_id": 25077197,
           "tags": [
-            "custfacing"
+            "critical"
           ]
         },
         "project": {
@@ -138,7 +138,7 @@ tests:
           job_succeeded_count: 27941
           lifetime_task_count: 55882
           tags:
-            - "custfacing"
+            - "critical"
         started_at: "2025-06-14T16:06:52.000-07:00"
         status: "error"
         title: "Webhooks: new event via webhook: Accept=*/*, Content length=35, and Content type=application/x-www-form-urlencoded"
@@ -157,7 +157,7 @@ tests:
             "description" : "",
             "id" : 62605996,
             "folder_id" : 25077197,
-            "tags" : [ "custfacing" ]
+            "tags" : [ "critical" ]
           },
           "project" : {
             "name" : "Backend Batch Ops",

workato/assets/monitors/critical_recipe_offline.json

@@ -1,15 +1,15 @@
 {
   "version": 2,
   "created_at": "2025-06-09",
-  "last_updated_at": "2025-06-09",
+  "last_updated_at": "2025-07-27",
   "title": "Critical recipe is offline",
   "description": "A recipe which has been tagged as critical within Workato is offline.",
   "definition": {
-    "id": 174536177,
+    "id": 178957050,
     "name": "Critical Workato Recipe is {{#is_alert}}offline{{/is_alert}} {{#is_alert_recovery}}online{{/is_alert_recovery}}",
     "type": "query alert",
-    "query": "avg(last_5m):avg:workato.recipes.failure{workato_tags:*custfacing*} by {name,stop_cause} > 0",
-    "message": "{{#is_alert}}The recipe {{name}} is offline with stop cause of {{stop_cause}}{{/is_alert}}\n{{#is_alert_recovery}}The recipe {{name}} is online{{/is_alert_recovery}}\n\n@email@example.com",
+    "query": "avg(last_5m):avg:workato.recipes.failure{workato_tags:*critical*} by {name,stop_cause} > 0",
+	"message": "{{#is_alert}}The recipe {{name}} is offline with stop cause of {{stop_cause}}{{/is_alert}}\n{{#is_alert_recovery}}The recipe {{name}} is online{{/is_alert_recovery}}\n@email@example.com",
     "tags": [
             "source:workato"
     ],

workato/assets/monitors/critical_recipe_offline_cause_unknown.json

@@ -0,0 +1,30 @@
+{
+  "version": 2,
+  "created_at": "2025-07-27",
+  "last_updated_at": "2025-07-27",
+  "title": "Critical recipe is offline with cause unknown",
+  "description": "A recipe which has been tagged as critical within Workato is offline with cause unknown.",
+  "definition": {
+    "id": 174536177,
+    "name": "Critical Workato Recipe is {{#is_alert}}offline{{/is_alert}} {{#is_alert_recovery}}online{{/is_alert_recovery}}",
+    "type": "query alert",
+	"query": "avg(last_5m):avg:workato.recipes.failure{workato_tags:*critical*, !stop_cause:*} by {name} > 0",
+	"message": "{{#is_alert}}The recipe {{name}} is offline, possibly due to manual stopping of recipe{{/is_alert}}\n{{#is_alert_recovery}}The recipe {{name}} is online{{/is_alert_recovery}}\n@email@example.com",
+    "tags": [
+            "source:workato"
+    ],
+    "options": {
+            "thresholds": {
+                    "critical": 0
+            },
+            "notify_audit": false,
+            "on_missing_data": "resolve",
+            "include_tags": false,
+            "new_group_delay": 0
+    },
+    "priority": null
+  },
+  "tags": [
+    "integration:workato"
+  ]
+}

workato/images/workato_overview.png

@@ -54,6 +54,7 @@
     },
     "monitors": {
       "Critical recipe is offline" : "assets/monitors/critical_recipe_offline.json",
+      "Critical recipe is offline with cause unknown" : "assets/monitors/critical_recipe_offline_cause_unknown.json",
       "Connection with active recipes is down" : "assets/monitors/connection_with_active_recipes.json",
       "Connection is lost" : "assets/monitors/connection_lost.json",
       "Connection auth failure" : "assets/monitors/connection_auth_failure.json",