Update template_variables.md

content/en/synthetics/notifications/conditional_alerting.md

@@ -26,32 +26,78 @@ For more detailed information, see the <a href="https://docs.datadoghq.com/monit
 
 ### Examples
 
+**Send alerts based on status code:**
+
+```handlebars
+{{!
+If a test triggers an alert for an API test and returns a 500 statuscode, notify the backend team.
+}}
+{{#is_alert}}
+  {{#is_exact_match "synthetics.attributes.result.response.statusCode" "500"}}@notify-slack-backend{{/is_exact_match}}
+{{/is_alert}}
+```
+
 **Send alerts to a specific Slack channel based on failed step:**
 
 ```handlebars
-{{#is_match "synthetics.failed_step.description" "Checkout"}}
-@notify-slack-payments
-{{/is_match}}
+{{!
+If a test triggers an alert for Browser or Mobile tests, loop through each step and find the failed step.
+If the failed step's description field matches Checkout, notify the recipient
+}}
+{{#is_alert}}
+  {{#each synthetics.attributes.result.steps}}
+    {{#is_match "status" "failed"}}
+      {{#is_match "description" "Checkout"}}@notify-slack-payments{{/is_match}}
+    {{/is_match}}
+  {{/each}}
+{{/is_alert}}
 ```
 
-**Send alerts based on status code:**
+**Send alerts to a specific Slack channel based on failed step using a variable shortcut:**
 
 ```handlebars
-{{#is_exact_match "synthetics.attributes.result.response.statusCode" "500"}}
-@notify-slack-backend
-{{/is_exact_match}}
+{{!
+This alert uses the `{{synthetics.failed_step}}` object which is a variable shortcut that points to the relevant step data contained in `{{synthetics.attributes.result.steps}}`.
+If the test triggers an alert for Browser or Mobile tests and if the failed step's description field matches Checkout, notify the recipient.
+}}
+{{#is_alert}}
+  {{#is_match "synthetics.failed_step.description" "Checkout"}}@notify-slack-payments{{/is_match}}
+{{/is_alert}}
 ```
 
 **Set different alert priorities:**
 
 ```handlebars
-{{#if synthetics.failed_step.name}}
-{{override_priority "P2"}}
-{{else}}
-{{override_priority "P4"}}
-{{/if}}
+{{!
+If a test triggers an alert for a multistep API test, loop through each step and find the failed step.
+If the step's name matches the staging domain, set the priority to P2. Otherwise, set it to P4.
+}}
+{{#is_alert}}send a message to thang @[email protected] 
+  {{#each synthetics.attributes.result.steps}}
+    {{#is_match "status" "failed"}}
+      {{#is_match "name" "stagedomain"}}Stage domain failed. Overriding priority to P2.
+        {{override_priority 'P2'}}
+        {{else}}Dev domain failed. Overriding priority to P4{{override_priority 'P4'}}
+      {{/is_match}}
+    {{/is_match}}
+  {{/each}}
+{{/is_alert}}
+```
+
+**Set different alert priorities using variable shortcut:**
+
+```handlebars
+{{!
+This alert uses the `{{synthetics.failed_step}}` object which is a variable shortcut that points to the relevant step data contained in `{{synthetics.attributes.result.steps}}`.
+If the test triggers an alert for multistep API test and if the failed step's name field matches the domain, override the priority.
+}}
+{{#is_alert}}
+  {{#is_match "synthetics.failed_step.name" "stagedomain"}}Stage domain failed. Overriding priority to P2{{override_priority 'P2'}}
+  {{else}}Dev domain failed. Overriding priority to P4{{override_priority 'P4'}}
+  {{/is_match}}
+{{/is_alert}}
 ```
 
 ## Further Reading
 
-{{< partial name="whats-next/whats-next.html" >}}
+{{< partial name="whats-next/whats-next.html" >}}

content/en/synthetics/notifications/template_variables.md

@@ -52,48 +52,60 @@ Test failed at step {{synthetics.failed_step.name}} with error: {{synthetics.fai
 {{< tabs >}}
 {{% tab "Test Info" %}}
 
-`.test`
-: Info about the test
+`{{synthetics.attributes.test}}`
+: The `test` object contains information about the test like its `name`, `type`, `subtype`, and `id`
 
-`.test.id`
-: Public ID (for example, `abc-def-ghi`)
+`{{synthetics.attributes.test.name}}`
+: The name of the test
 
-`.test.type`
+`{{synthetics.attributes.test.type}}`
 : Test type (for example, `api`)
 
-`.test.subType`
-: Subtype for API tests (for example, `http`)
+`{{synthetics.attributes.test.subType}}`
+: Subtype for API tests (for example, `http`, `dns`, and `multi`)
+
+`{{synthetics.attributes.test.id}}`
+: The test ID is the test's public ID (for example, `abc-def-ghi`)
 
 {{% /tab %}}
 {{% tab "Location" %}}
 
-`.location.id`
+`{{synthetics.attributes.location}}`
+: The `location` object contains information about the location of where the test is run from
+
+`{{synthetics.attributes.location.id}}`
 : Location ID (for example, `aws:eu-central-1`)
 
-`.location.privateLocation`
+`{{synthetics.attributes.location.name}}`
+: Name of the location (for example, `Frankfurt (AWS)`)
+
+`{{synthetics.attributes.location.privateLocation}}`
 : `true` for Private Locations
 
 {{% /tab %}}
 {{% tab "Device" %}}
 
 Applies to browser and mobile tests.
 
-`.device.id`
+`{{synthetics.attributes.device}}`
+: The `device` object contains information about the device on which the test is run on
+
+`{{synthetics.attributes.device.id}}`
 : Device identifier
 
-`.device.name`
+`{{synthetics.attributes.device.name}}`
 : Human-readable device name
 
-`.device.type`
+`{{synthetics.attributes.device.type}}`
 : Device type classification
 
-`.device.resolution.width`, `.device.resolution.height`
+`{{synthetics.attributes.device.width}}`, `{{synthetics.attributes.device.height}}`
 : Screen resolution dimensions
 
-`.device.browser.type`
+`{{synthetics.attributes.device.browser.type}}`
 : Browser type (browser tests only)
 
-`.device.platform.name`, `.device.platform.version`
+`{{synthetics.attributes.device.platform.name}}`, `{{synthetics.attributes.device.platform.version}}`
 : Platform information (mobile tests only)
 
 **Example values:**
@@ -113,23 +125,29 @@ Applies to browser and mobile tests.
 {{% /tab %}}
 {{% tab "Result" %}}
 
-`.result.id`
+`{{synthetics.attributes.result}}`
+: The `result` object contains information about the executed test run
+
+`{{synthetics.attributes.result.id}}`
 : Unique result ID
 
-`.result.status`
-: Test execution status
+`{{synthetics.attributes.result.status}}`
+: Test execution status  (for example, `passed` or `failed`)
 
-`.result.duration`
+`{{synthetics.attributes.result.duration}}`
 : Test duration in milliseconds
 
-`.result.testStartedAt`, `.result.testFinishedAt`, `.result.testTriggeredAt`
+`{{synthetics.attributes.result.testStartedAt}}`, `{{synthetics.attributes.result.testFinishedAt}}`, `{{synthetics.attributes.result.testTriggeredAt}}`
 : Epoch timestamps in milliseconds
 
-`.result.failure.message`
-: Description of failure
+`{{synthetics.attributes.result.failure}}`
+: The `failure` object contains information about why the test failed
 
-`.result.failure.code`
-: Error code
+`{{synthetics.attributes.result.failure.message}}`
+: The failure message
+
+`{{synthetics.attributes.result.failure.code}}`
+: The failure code
 
 **Example values:**
 ```json
@@ -161,16 +179,16 @@ These are local variables configured for API tests or defined outside individual
 
 Located at `{{synthetics.attributes.result.variables.config}}`:
 
-`.name`
+`{{synthetics.attributes.result.variables.config.name}}`
 : Variable name
 
-`.type`
+`{{synthetics.attributes.result.variables.config.type}}`
 : Variable type
 
-`.secure`
+`{{synthetics.attributes.result.variables.config.secure}}`
 : Whether the variable value is obfuscated
 
-`.value`
+`{{synthetics.attributes.result.variables.config.value}}`
 : Variable value (non-obfuscated only)
 
 **Examples:**
@@ -190,18 +208,18 @@ These are extracted variables whose value updates a global variable value.
 
 Available only for **successful test results** and **recovery notifications**.
 
-Located at `result.variables.extracted`:
+Located at `{{synthetics.attributes.result.variables.extracted}}`:
 
-`.id`
+`{{synthetics.attributes.result.variables.extracted.id}}`
 : Global variable ID
 
-`.name`
+`{{synthetics.attributes.result.variables.extracted.name}}`
 : Variable name
 
-`.secure`
+`{{synthetics.attributes.result.variables.extracted.secure}}`
 : Whether the variable value is obfuscated
 
-`.val`
+`{{synthetics.attributes.result.variables.extracted.val}}`
 : Variable value (note: uses `.val`, not `.value`)
 
 **Examples:**
@@ -217,7 +235,7 @@ Located at `result.variables.extracted`:
 {{% /tab %}}
 {{% tab "Step extracted variables" %}}
 
-For tests with steps, step data is contained in `.steps`.
+For tests with steps, step data is contained in `{{synthetics.attributes.result.steps}}`.
 
 `.extractedValue.name`
 : Variable name
@@ -319,7 +337,7 @@ Similar to standard API tests, the variables are listed in the `variables.extrac
 
 **General:**
 
-`.startUrl`
+`{{synthetics.attributes.result.startUrl}}`
 : URL from test configuration
 
 **Steps:**