Merge pull request #506 from SumoLogic/jinkane-SUMO-215188

SUMO-215188 updated documentation for slo and monitors

Author: sumovishal

website/docs/r/monitor.html.markdown

@@ -324,23 +324,23 @@ The following arguments are supported:
 - `type` - (Optional) The type of object model. Valid value:
   - `MonitorsLibraryMonitor`
 - `name` - (Required) The name of the monitor. The name must be alphanumeric.
-- `description` - (Required) The description of the monitor.
+- `description` - (Optional) The description of the monitor.
 - `is_disabled` - (Optional) Whether or not the monitor is disabled. Disabled monitors will not run and will not generate or send notifications.
 - `parent_id` - (Optional) The ID of the Monitor Folder that contains this monitor. Defaults to the root folder.
 - `content_type` - (Optional) The type of the content object. Valid value:
   - `Monitor`
 - `monitor_type` - (Required) The type of monitor. Valid values:
   - `Logs`: A logs query monitor.
   - `Metrics`: A metrics query monitor.
-  - `Slo`: A SLO based monitor  (beta).
+  - `Slo`: A SLO based monitor.
 - `evaluation_delay` - (Optional) Evaluation delay as a string consists of the following elements:
       1. `<number>`: number of time units,
       2. `<time_unit>`: time unit; possible values are: `h` (hour), `m` (minute), `s` (second).
 
       Multiple pairs of `<number><time_unit>` may be provided. For example,
       `2m50s` means 2 minutes and 50 seconds.
 - `slo_id` - (Optional) Identifier of the SLO definition for the monitor. This is only applicable & required for Slo `monitor_type`.
-- `queries` - (Required) All queries from the monitor.
+- `queries` - (Required if `monitor_type` is not `Slo`) All queries from the monitor.
 - `trigger_conditions` - (Required if not using `triggers`) Defines the conditions of when to send notifications. NOTE: `trigger_conditions` supplants the `triggers` argument. 
   - `resolution_window` - The resolution window that the recovery condition must be met in each evaluation that happens within this entire duration before the alert is recovered (resolved). If not specified, the time range of your trigger will be used.
 - `triggers` - (Deprecated) Defines the conditions of when to send notifications.

website/docs/r/slo.html.markdown

@@ -154,7 +154,6 @@ The following arguments are supported:
   , `Other`. Defaults to `Latency`.
 - `service` - (Optional) Name of the service.
 - `application` - (Optional) Name of the application.
-  Defaults to true.
 - `compliance` - (Required) The compliance settings for the SLO.
     - `compliance_type` - (Required) The type of compliance to use. Valid values are `Rolling` or `Calendar`.
     - `target` - (Required) Target percentage for the SLI over the compliance period. Must be a number between 0 and 100.
@@ -171,18 +170,18 @@ The following arguments are supported:
     - [window_based_evaluation](#window_based_evaluation) - Evaluate SLI using successful/total windows.
     - [request_based_evaluation](#request_based_evaluation) - Evaluate SLI based on occurrence of successful
       events / total events over entire compliance period.
+    - [monitor_based_evaluation](#monitor_based_evaluation) - SLIs for Monitor-based SLOs are calculated at a granularity of 1 minute. A minute is treated as unsuccessful if the Monitor threshold is violated at any point of time within that minute.
 
 #### window_based_evaluation
 
-- `size` - (Required) The size of the window to use, minimum of `1m` and maximum of `1h`. Only applicable for Window
-  based evaluation.
+- `size` - (Required) The size of the window to use, minimum of `1m` and maximum of `1h`.
 - `query_type` - (Required) The type of query to use. Valid values are `Metrics` or `Logs`.
 - `threshold` - (Required) Threshold for classifying window as successful or unsuccessful, i.e. the minimum value
   for `(good windows / total windows) * 100`.
 - `op` - (Required) The operator used to define a successful window. Valid values are `LessThan`
   , `LessThanOrEqual`, `GreaterThan`
   , `GreaterThanOrEqual`.
-- `aggregation` - (Optional) Aggregation function applied over each window to arrive at SLI. Valid values are `Avg`
+- `aggregation` - (Required if `query_group_type` is `Threshold`) Aggregation function applied over each window to arrive at SLI. Valid values are `Avg`
   , `Sum`, `Count`, `Max`, `Min` and `p[1-99]`.
 - `queries` - (Required) The queries to use.
     - `query_group_type` - (Required) The type of query. Valid values are `Successful`, `Unsuccessful`, `Total`
@@ -197,8 +196,8 @@ The following arguments are supported:
 #### request_based_evaluation
 
 - `query_type` - (Required) The type of query to use. Valid values are `Metrics` or `Logs`.
-- `threshold` - (Required) Compared against threshold query's raw data points to determine success criteria.
-- `op` - (Required) Comparison function with threshold. Valid values are `LessThan`, `LessThanOrEqual`, `GreaterThan`
+- `threshold` - (Required if `query_group_type` is `Threshold`) Compared against threshold query's raw data points to determine success criteria.
+- `op` - (Required if `query_group_type` is `Threshold`) Comparison function with threshold. Valid values are `LessThan`, `LessThanOrEqual`, `GreaterThan`
   , `GreaterThanOrEqual`.
 - `queries` - (Required) The queries to use.
     - `query_group_type` - (Required) The type of query. Valid values are `Successful`, `Unsuccessful`, `Total`