1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="monitoring_v3.html">Cloud Monitoring API</a> . <a href="monitoring_v3.services.html">services</a> . <a href="monitoring_v3.services.serviceLevelObjectives.html">serviceLevelObjectives</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#create">create(parent, body=None, serviceLevelObjectiveId=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Create a ServiceLevelObjective for the given Service.</p> 83<p class="toc_element"> 84 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p> 85<p class="firstline">Delete the given ServiceLevelObjective.</p> 86<p class="toc_element"> 87 <code><a href="#get">get(name, view=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Get a ServiceLevelObjective by name.</p> 89<p class="toc_element"> 90 <code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p> 91<p class="firstline">List the ServiceLevelObjectives for the given Service.</p> 92<p class="toc_element"> 93 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 94<p class="firstline">Retrieves the next page of results.</p> 95<p class="toc_element"> 96 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> 97<p class="firstline">Update the given ServiceLevelObjective.</p> 98<h3>Method Details</h3> 99<div class="method"> 100 <code class="details" id="close">close()</code> 101 <pre>Close httplib2 connections.</pre> 102</div> 103 104<div class="method"> 105 <code class="details" id="create">create(parent, body=None, serviceLevelObjectiveId=None, x__xgafv=None)</code> 106 <pre>Create a ServiceLevelObjective for the given Service. 107 108Args: 109 parent: string, Required. Resource name of the parent Service. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID] (required) 110 body: object, The request body. 111 The object takes the form of: 112 113{ # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 114 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 115 "displayName": "A String", # Name used for UI elements listing this SLO. 116 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 117 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 118 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 119 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 120 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 121 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 122 }, 123 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 124 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 125 }, 126 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 127 "A String", 128 ], 129 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 130 "A String", 131 ], 132 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 133 "A String", 134 ], 135 }, 136 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 137 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 138 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 139 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 140 "max": 3.14, # Range maximum. 141 "min": 3.14, # Range minimum. 142 }, 143 }, 144 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 145 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 146 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 147 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 148 }, 149 }, 150 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 151 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 152 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 153 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 154 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 155 }, 156 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 157 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 158 }, 159 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 160 "A String", 161 ], 162 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 163 "A String", 164 ], 165 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 166 "A String", 167 ], 168 }, 169 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 170 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 171 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 172 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 173 "max": 3.14, # Range maximum. 174 "min": 3.14, # Range minimum. 175 }, 176 }, 177 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 178 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 179 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 180 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 181 }, 182 }, 183 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 184 }, 185 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 186 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 187 "max": 3.14, # Range maximum. 188 "min": 3.14, # Range minimum. 189 }, 190 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 191 }, 192 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 193 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 194 "max": 3.14, # Range maximum. 195 "min": 3.14, # Range minimum. 196 }, 197 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 198 }, 199 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 200 }, 201 }, 202 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 203 "a_key": "A String", 204 }, 205} 206 207 serviceLevelObjectiveId: string, Optional. The ServiceLevelObjective id to use for this ServiceLevelObjective. If omitted, an id will be generated instead. Must match the pattern [a-z0-9\-]+ 208 x__xgafv: string, V1 error format. 209 Allowed values 210 1 - v1 error format 211 2 - v2 error format 212 213Returns: 214 An object of the form: 215 216 { # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 217 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 218 "displayName": "A String", # Name used for UI elements listing this SLO. 219 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 220 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 221 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 222 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 223 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 224 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 225 }, 226 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 227 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 228 }, 229 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 230 "A String", 231 ], 232 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 233 "A String", 234 ], 235 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 236 "A String", 237 ], 238 }, 239 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 240 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 241 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 242 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 243 "max": 3.14, # Range maximum. 244 "min": 3.14, # Range minimum. 245 }, 246 }, 247 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 248 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 249 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 250 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 251 }, 252 }, 253 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 254 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 255 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 256 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 257 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 258 }, 259 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 260 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 261 }, 262 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 263 "A String", 264 ], 265 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 266 "A String", 267 ], 268 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 269 "A String", 270 ], 271 }, 272 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 273 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 274 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 275 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 276 "max": 3.14, # Range maximum. 277 "min": 3.14, # Range minimum. 278 }, 279 }, 280 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 281 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 282 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 283 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 284 }, 285 }, 286 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 287 }, 288 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 289 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 290 "max": 3.14, # Range maximum. 291 "min": 3.14, # Range minimum. 292 }, 293 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 294 }, 295 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 296 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 297 "max": 3.14, # Range maximum. 298 "min": 3.14, # Range minimum. 299 }, 300 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 301 }, 302 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 303 }, 304 }, 305 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 306 "a_key": "A String", 307 }, 308}</pre> 309</div> 310 311<div class="method"> 312 <code class="details" id="delete">delete(name, x__xgafv=None)</code> 313 <pre>Delete the given ServiceLevelObjective. 314 315Args: 316 name: string, Required. Resource name of the ServiceLevelObjective to delete. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] (required) 317 x__xgafv: string, V1 error format. 318 Allowed values 319 1 - v1 error format 320 2 - v2 error format 321 322Returns: 323 An object of the form: 324 325 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for Empty is empty JSON object {}. 326}</pre> 327</div> 328 329<div class="method"> 330 <code class="details" id="get">get(name, view=None, x__xgafv=None)</code> 331 <pre>Get a ServiceLevelObjective by name. 332 333Args: 334 name: string, Required. Resource name of the ServiceLevelObjective to get. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] (required) 335 view: string, View of the ServiceLevelObjective to return. If DEFAULT, return the ServiceLevelObjective as originally defined. If EXPLICIT and the ServiceLevelObjective is defined in terms of a BasicSli, replace the BasicSli with a RequestBasedSli spelling out how the SLI is computed. 336 Allowed values 337 VIEW_UNSPECIFIED - Same as FULL. 338 FULL - Return the embedded ServiceLevelIndicator in the form in which it was defined. If it was defined using a BasicSli, return that BasicSli. 339 EXPLICIT - For ServiceLevelIndicators using BasicSli articulation, instead return the ServiceLevelIndicator with its mode of computation fully spelled out as a RequestBasedSli. For ServiceLevelIndicators using RequestBasedSli or WindowsBasedSli, return the ServiceLevelIndicator as it was provided. 340 x__xgafv: string, V1 error format. 341 Allowed values 342 1 - v1 error format 343 2 - v2 error format 344 345Returns: 346 An object of the form: 347 348 { # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 349 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 350 "displayName": "A String", # Name used for UI elements listing this SLO. 351 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 352 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 353 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 354 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 355 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 356 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 357 }, 358 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 359 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 360 }, 361 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 362 "A String", 363 ], 364 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 365 "A String", 366 ], 367 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 368 "A String", 369 ], 370 }, 371 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 372 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 373 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 374 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 375 "max": 3.14, # Range maximum. 376 "min": 3.14, # Range minimum. 377 }, 378 }, 379 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 380 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 381 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 382 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 383 }, 384 }, 385 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 386 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 387 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 388 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 389 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 390 }, 391 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 392 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 393 }, 394 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 395 "A String", 396 ], 397 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 398 "A String", 399 ], 400 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 401 "A String", 402 ], 403 }, 404 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 405 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 406 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 407 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 408 "max": 3.14, # Range maximum. 409 "min": 3.14, # Range minimum. 410 }, 411 }, 412 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 413 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 414 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 415 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 416 }, 417 }, 418 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 419 }, 420 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 421 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 422 "max": 3.14, # Range maximum. 423 "min": 3.14, # Range minimum. 424 }, 425 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 426 }, 427 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 428 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 429 "max": 3.14, # Range maximum. 430 "min": 3.14, # Range minimum. 431 }, 432 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 433 }, 434 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 435 }, 436 }, 437 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 438 "a_key": "A String", 439 }, 440}</pre> 441</div> 442 443<div class="method"> 444 <code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code> 445 <pre>List the ServiceLevelObjectives for the given Service. 446 447Args: 448 parent: string, Required. Resource name of the parent containing the listed SLOs, either a project or a Monitoring Workspace. The formats are: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID] workspaces/[HOST_PROJECT_ID_OR_NUMBER]/services/- (required) 449 filter: string, A filter specifying what ServiceLevelObjectives to return. 450 pageSize: integer, A non-negative number that is the maximum number of results to return. When 0, use default page size. 451 pageToken: string, If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call. 452 view: string, View of the ServiceLevelObjectives to return. If DEFAULT, return each ServiceLevelObjective as originally defined. If EXPLICIT and the ServiceLevelObjective is defined in terms of a BasicSli, replace the BasicSli with a RequestBasedSli spelling out how the SLI is computed. 453 Allowed values 454 VIEW_UNSPECIFIED - Same as FULL. 455 FULL - Return the embedded ServiceLevelIndicator in the form in which it was defined. If it was defined using a BasicSli, return that BasicSli. 456 EXPLICIT - For ServiceLevelIndicators using BasicSli articulation, instead return the ServiceLevelIndicator with its mode of computation fully spelled out as a RequestBasedSli. For ServiceLevelIndicators using RequestBasedSli or WindowsBasedSli, return the ServiceLevelIndicator as it was provided. 457 x__xgafv: string, V1 error format. 458 Allowed values 459 1 - v1 error format 460 2 - v2 error format 461 462Returns: 463 An object of the form: 464 465 { # The ListServiceLevelObjectives response. 466 "nextPageToken": "A String", # If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as page_token in the next call to this method. 467 "serviceLevelObjectives": [ # The ServiceLevelObjectives matching the specified filter. 468 { # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 469 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 470 "displayName": "A String", # Name used for UI elements listing this SLO. 471 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 472 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 473 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 474 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 475 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 476 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 477 }, 478 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 479 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 480 }, 481 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 482 "A String", 483 ], 484 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 485 "A String", 486 ], 487 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 488 "A String", 489 ], 490 }, 491 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 492 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 493 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 494 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 495 "max": 3.14, # Range maximum. 496 "min": 3.14, # Range minimum. 497 }, 498 }, 499 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 500 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 501 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 502 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 503 }, 504 }, 505 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 506 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 507 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 508 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 509 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 510 }, 511 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 512 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 513 }, 514 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 515 "A String", 516 ], 517 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 518 "A String", 519 ], 520 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 521 "A String", 522 ], 523 }, 524 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 525 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 526 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 527 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 528 "max": 3.14, # Range maximum. 529 "min": 3.14, # Range minimum. 530 }, 531 }, 532 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 533 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 534 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 535 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 536 }, 537 }, 538 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 539 }, 540 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 541 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 542 "max": 3.14, # Range maximum. 543 "min": 3.14, # Range minimum. 544 }, 545 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 546 }, 547 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 548 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 549 "max": 3.14, # Range maximum. 550 "min": 3.14, # Range minimum. 551 }, 552 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 553 }, 554 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 555 }, 556 }, 557 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 558 "a_key": "A String", 559 }, 560 }, 561 ], 562}</pre> 563</div> 564 565<div class="method"> 566 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 567 <pre>Retrieves the next page of results. 568 569Args: 570 previous_request: The request for the previous page. (required) 571 previous_response: The response from the request for the previous page. (required) 572 573Returns: 574 A request object that you can call 'execute()' on to request the next 575 page. Returns None if there are no more items in the collection. 576 </pre> 577</div> 578 579<div class="method"> 580 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> 581 <pre>Update the given ServiceLevelObjective. 582 583Args: 584 name: string, Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] (required) 585 body: object, The request body. 586 The object takes the form of: 587 588{ # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 589 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 590 "displayName": "A String", # Name used for UI elements listing this SLO. 591 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 592 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 593 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 594 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 595 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 596 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 597 }, 598 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 599 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 600 }, 601 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 602 "A String", 603 ], 604 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 605 "A String", 606 ], 607 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 608 "A String", 609 ], 610 }, 611 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 612 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 613 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 614 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 615 "max": 3.14, # Range maximum. 616 "min": 3.14, # Range minimum. 617 }, 618 }, 619 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 620 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 621 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 622 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 623 }, 624 }, 625 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 626 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 627 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 628 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 629 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 630 }, 631 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 632 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 633 }, 634 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 635 "A String", 636 ], 637 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 638 "A String", 639 ], 640 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 641 "A String", 642 ], 643 }, 644 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 645 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 646 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 647 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 648 "max": 3.14, # Range maximum. 649 "min": 3.14, # Range minimum. 650 }, 651 }, 652 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 653 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 654 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 655 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 656 }, 657 }, 658 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 659 }, 660 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 661 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 662 "max": 3.14, # Range maximum. 663 "min": 3.14, # Range minimum. 664 }, 665 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 666 }, 667 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 668 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 669 "max": 3.14, # Range maximum. 670 "min": 3.14, # Range minimum. 671 }, 672 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 673 }, 674 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 675 }, 676 }, 677 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 678 "a_key": "A String", 679 }, 680} 681 682 updateMask: string, A set of field paths defining which fields to use for the update. 683 x__xgafv: string, V1 error format. 684 Allowed values 685 1 - v1 error format 686 2 - v2 error format 687 688Returns: 689 An object of the form: 690 691 { # A Service-Level Objective (SLO) describes a level of desired good service. It consists of a service-level indicator (SLI), a performance goal, and a period over which the objective is to be evaluated against that goal. The SLO can use SLIs defined in a number of different manners. Typical SLOs might include "99% of requests in each rolling week have latency below 200 milliseconds" or "99.5% of requests in each calendar month return successfully." 692 "calendarPeriod": "A String", # A calendar period, semantically "since the start of the current ". At this time, only DAY, WEEK, FORTNIGHT, and MONTH are supported. 693 "displayName": "A String", # Name used for UI elements listing this SLO. 694 "goal": 3.14, # The fraction of service that must be good in order for this objective to be met. 0 < goal <= 0.999. 695 "name": "A String", # Resource name for this ServiceLevelObjective. The format is: projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME] 696 "rollingPeriod": "A String", # A rolling time period, semantically "in the past ". Must be an integer multiple of 1 day no larger than 30 days. 697 "serviceLevelIndicator": { # A Service-Level Indicator (SLI) describes the "performance" of a service. For some services, the SLI is well-defined. In such cases, the SLI can be described easily by referencing the well-known SLI and providing the needed parameters. Alternatively, a "custom" SLI can be defined with a query to the underlying metric store. An SLI is defined to be good_service / total_service over any queried time interval. The value of performance always falls into the range 0 <= performance <= 1. A custom SLI describes how to compute this ratio, whether this is by dividing values from a pair of time series, cutting a Distribution into good and bad counts, or counting time windows in which the service complies with a criterion. For separation of concerns, a single Service-Level Indicator measures performance for only one aspect of service quality, such as fraction of successful queries or fast-enough queries. # The definition of good service, used to measure and calculate the quality of the Service's performance with respect to a single aspect of service quality. 698 "basicSli": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # Basic SLI on a well-known service type. 699 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 700 }, 701 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 702 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 703 }, 704 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 705 "A String", 706 ], 707 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 708 "A String", 709 ], 710 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 711 "A String", 712 ], 713 }, 714 "requestBased": { # Service Level Indicators for which atomic units of service are counted directly. # Request-based SLIs 715 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 716 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 717 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 718 "max": 3.14, # Range maximum. 719 "min": 3.14, # Range minimum. 720 }, 721 }, 722 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 723 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 724 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 725 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 726 }, 727 }, 728 "windowsBased": { # A WindowsBasedSli defines good_service as the count of time windows for which the provided service was of good quality. Criteria for determining if service was good are embedded in the window_criterion. # Windows-based SLIs 729 "goodBadMetricFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries with ValueType = BOOL. The window is good if any true values appear in the window. 730 "goodTotalRatioThreshold": { # A PerformanceThreshold is used when each window is good when that window has a sufficiently high performance. # A window is good if its performance is high enough. 731 "basicSliPerformance": { # An SLI measuring performance on a well-known service type. Performance will be computed on the basis of pre-defined metrics. The type of the service_resource determines the metrics to use and the service_resource.labels and metric_labels are used to construct a monitoring filter to filter that metric down to just the data relevant to this service. # BasicSli to evaluate to judge window quality. 732 "availability": { # Future parameters for the availability SLI. # Good service is defined to be the count of requests made to this service that return successfully. 733 }, 734 "latency": { # Parameters for a latency threshold SLI. # Good service is defined to be the count of requests made to this service that are fast enough with respect to latency.threshold. 735 "threshold": "A String", # Good service is defined to be the count of requests made to this service that return in no more than threshold. 736 }, 737 "location": [ # OPTIONAL: The set of locations to which this SLI is relevant. Telemetry from other locations will not be used to calculate performance for this SLI. If omitted, this SLI applies to all locations in which the Service has activity. For service types that don't support breaking down by location, setting this field will result in an error. 738 "A String", 739 ], 740 "method": [ # OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from other methods will not be used to calculate performance for this SLI. If omitted, this SLI applies to all the Service's methods. For service types that don't support breaking down by method, setting this field will result in an error. 741 "A String", 742 ], 743 "version": [ # OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry from other API versions will not be used to calculate performance for this SLI. If omitted, this SLI applies to all API versions. For service types that don't support breaking down by version, setting this field will result in an error. 744 "A String", 745 ], 746 }, 747 "performance": { # Service Level Indicators for which atomic units of service are counted directly. # RequestBasedSli to evaluate to judge window quality. 748 "distributionCut": { # A DistributionCut defines a TimeSeries and thresholds used for measuring good service and total service. The TimeSeries must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. The computed good_service will be the estimated count of values in the Distribution that fall within the specified min and max. # distribution_cut is used when good_service is a count of values aggregated in a Distribution that fall into a good range. The total_service is the total count of all values aggregated in the Distribution. 749 "distributionFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries aggregating values. Must have ValueType = DISTRIBUTION and MetricKind = DELTA or MetricKind = CUMULATIVE. 750 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 751 "max": 3.14, # Range maximum. 752 "min": 3.14, # Range minimum. 753 }, 754 }, 755 "goodTotalRatio": { # A TimeSeriesRatio specifies two TimeSeries to use for computing the good_service / total_service ratio. The specified TimeSeries must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. The TimeSeriesRatio must specify exactly two of good, bad, and total, and the relationship good_service + bad_service = total_service will be assumed. # good_total_ratio is used when the ratio of good_service to total_service is computed from two TimeSeries. 756 "badServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying bad service, either demanded service that was not provided or demanded service that was of inadequate quality. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 757 "goodServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying good service provided. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 758 "totalServiceFilter": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying a TimeSeries quantifying total demanded service. Must have ValueType = DOUBLE or ValueType = INT64 and must have MetricKind = DELTA or MetricKind = CUMULATIVE. 759 }, 760 }, 761 "threshold": 3.14, # If window performance >= threshold, the window is counted as good. 762 }, 763 "metricMeanInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, averaged across returned streams. 764 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 765 "max": 3.14, # Range maximum. 766 "min": 3.14, # Range minimum. 767 }, 768 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 769 }, 770 "metricSumInRange": { # A MetricRange is used when each window is good when the value x of a single TimeSeries satisfies range.min <= x <= range.max. The provided TimeSeries must have ValueType = INT64 or ValueType = DOUBLE and MetricKind = GAUGE. # A window is good if the metric's value is in a good range, summed across returned streams. 771 "range": { # Range of numerical values within min and max. # Range of values considered "good." For a one-sided range, set one bound to an infinite value. 772 "max": 3.14, # Range maximum. 773 "min": 3.14, # Range minimum. 774 }, 775 "timeSeries": "A String", # A monitoring filter (https://cloud.google.com/monitoring/api/v3/filters) specifying the TimeSeries to use for evaluating window quality. 776 }, 777 "windowPeriod": "A String", # Duration over which window quality is evaluated. Must be an integer fraction of a day and at least 60s. 778 }, 779 }, 780 "userLabels": { # Labels which have been used to annotate the service-level objective. Label keys must start with a letter. Label keys and values may contain lowercase letters, numbers, underscores, and dashes. Label keys and values have a maximum length of 63 characters, and must be less than 128 bytes in size. Up to 64 label entries may be stored. For labels which do not have a semantic value, the empty string may be supplied for the label value. 781 "a_key": "A String", 782 }, 783}</pre> 784</div> 785 786</body></html>