Live Traffic Alerts: Defining Match Criteria

Every traffic alert supports up to 10 rules that specify which API calls are marked as matches, triggering the alert. An API call is a match only if it satisfies all the criteria in that alert's rules list.


Adding Rules

Add a new rule to an alert by editing the alert and selecting the Rules tab, then selecting Add Rule.


Available Sources

Any rule can match on data in one of three parts of an API call:

  • Request: any part of the HTTP request like headers, JSON or XML content, URL, etc.
  • Response: any part of the HTTP response as well as metadata about the response size and timing information
  • Connection: metadata about the request's connection such as connection status, TLS version, source (gateway, capture, etc.) and destination IP address, and Runscope Location


Match Criteria

When a rule is processed, the Actual Value is comprised of the data located by Source and Property. The Target Value is the value you have entered into the rule editor.

is empty The actual value exists and is an empty string or null.
is not empty The actual value exists and is a value other than an empty string or null.
equals A string comparison of the actual and expected value. Non-string values are cast to a string before comparing. For comparing non-integer numbers, use equals (number).
does not equal A string comparison of the actual and target value.
contains The actual value contains the target value as a substring.
does not contain The target value is not found within the actual value.
has key Checks for the existence of the expected value within a dictionary's keys. The actual value must point to a dictionary (JSON only).
has value Checks a list or dictionary for the existence of the expected value in any of the list or dictionary values. The actual value must point to a JSON list or dictionary (JSON only).
is null Checks that a value for a given JSON key is null.
is a number Validates the actual value is (or can be cast to) a valid numeric value.
less than Validates the actual value is (or can be cast to) a number less than the target value.
less than or equal Validates the actual value is (or can be cast to) a number less than or equal to the target value.
greater than Validates the actual value is (or can be cast to) a number greater than the target value.
greater than or equal Validates the actual value is (or can be cast to) a number greater than or equal to the target value.
equals (number) Validates the actual value is (or can be cast to) a number equal to the target value. This setting performs a numeric comparison: for example, "1.000" would be considered equal to "1".

Next: Notifying Your Team →