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="clouderrorreporting_v1beta1.html">Stackdriver Error Reporting API</a> . <a href="clouderrorreporting_v1beta1.projects.html">projects</a> . <a href="clouderrorreporting_v1beta1.projects.groupStats.html">groupStats</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#list">list(projectName, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, serviceFilter_resourceType=None, timedCountDuration=None, timeRange_period=None, serviceFilter_version=None, pageToken=None, serviceFilter_service=None, groupId=None, order=None)</a></code></p> 79<p class="firstline">Lists the specified groups.</p> 80<p class="toc_element"> 81 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 82<p class="firstline">Retrieves the next page of results.</p> 83<h3>Method Details</h3> 84<div class="method"> 85 <code class="details" id="list">list(projectName, alignmentTime=None, pageSize=None, x__xgafv=None, alignment=None, serviceFilter_resourceType=None, timedCountDuration=None, timeRange_period=None, serviceFilter_version=None, pageToken=None, serviceFilter_service=None, groupId=None, order=None)</code> 86 <pre>Lists the specified groups. 87 88Args: 89 projectName: string, [Required] The resource name of the Google Cloud Platform project. Written 90as <code>projects/</code> plus the 91<a href="https://support.google.com/cloud/answer/6158840">Google Cloud 92Platform project ID</a>. 93 94Example: <code>projects/my-project-123</code>. (required) 95 alignmentTime: string, [Optional] Time where the timed counts shall be aligned if rounded 96alignment is chosen. Default is 00:00 UTC. 97 pageSize: integer, [Optional] The maximum number of results to return per response. 98Default is 20. 99 x__xgafv: string, V1 error format. 100 Allowed values 101 1 - v1 error format 102 2 - v2 error format 103 alignment: string, [Optional] The alignment of the timed counts to be returned. 104Default is `ALIGNMENT_EQUAL_AT_END`. 105 serviceFilter_resourceType: string, [Optional] The exact value to match against 106[`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type). 107 timedCountDuration: string, [Optional] The preferred duration for a single returned `TimedCount`. 108If not set, no timed counts are returned. 109 timeRange_period: string, Restricts the query to the specified time range. 110 serviceFilter_version: string, [Optional] The exact value to match against 111[`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version). 112 pageToken: string, [Optional] A `next_page_token` provided by a previous response. To view 113additional results, pass this token along with the identical query 114parameters as the first request. 115 serviceFilter_service: string, [Optional] The exact value to match against 116[`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service). 117 groupId: string, [Optional] List all <code>ErrorGroupStats</code> with these IDs. (repeated) 118 order: string, [Optional] The sort order in which the results are returned. 119Default is `COUNT_DESC`. 120 121Returns: 122 An object of the form: 123 124 { # Contains a set of requested error group stats. 125 "nextPageToken": "A String", # If non-empty, more results are available. 126 # Pass this token, along with the same query parameters as the first 127 # request, to view the next page of results. 128 "errorGroupStats": [ # The error group stats which match the given request. 129 { # Data extracted for a specific group based on certain filter criteria, 130 # such as a given time period and/or service filter. 131 "count": "A String", # Approximate total number of events in the given group that match 132 # the filter criteria. 133 "firstSeenTime": "A String", # Approximate first occurrence that was ever seen for this group 134 # and which matches the given filter criteria, ignoring the 135 # time_range that was specified in the request. 136 "affectedUsersCount": "A String", # Approximate number of affected users in the given group that 137 # match the filter criteria. 138 # Users are distinguished by data in the `ErrorContext` of the 139 # individual error events, such as their login name or their remote 140 # IP address in case of HTTP requests. 141 # The number of affected users can be zero even if the number of 142 # errors is non-zero if no data was provided from which the 143 # affected user could be deduced. 144 # Users are counted based on data in the request 145 # context that was provided in the error report. If more users are 146 # implicitly affected, such as due to a crash of the whole service, 147 # this is not reflected here. 148 "group": { # Description of a group of similar error events. # Group data that is independent of the filter criteria. 149 "trackingIssues": [ # Associated tracking issues. 150 { # Information related to tracking the progress on resolving the error. 151 "url": "A String", # A URL pointing to a related entry in an issue tracking system. 152 # Example: https://github.com/user/project/issues/4 153 }, 154 ], 155 "groupId": "A String", # Group IDs are unique for a given project. If the same kind of error 156 # occurs in different service contexts, it will receive the same group ID. 157 "name": "A String", # The group resource name. 158 # Example: <code>projects/my-project-123/groups/my-groupid</code> 159 }, 160 "timedCounts": [ # Approximate number of occurrences over time. 161 # Timed counts returned by ListGroups are guaranteed to be: 162 # 163 # - Inside the requested time interval 164 # - Non-overlapping, and 165 # - Ordered by ascending time. 166 { # The number of errors in a given time period. 167 # All numbers are approximate since the error events are sampled 168 # before counting them. 169 "count": "A String", # Approximate number of occurrences in the given time period. 170 "endTime": "A String", # End of the time period to which `count` refers (excluded). 171 "startTime": "A String", # Start of the time period to which `count` refers (included). 172 }, 173 ], 174 "lastSeenTime": "A String", # Approximate last occurrence that was ever seen for this group and 175 # which matches the given filter criteria, ignoring the time_range 176 # that was specified in the request. 177 "representative": { # An error event which is returned by the Error Reporting system. # An arbitrary event that is chosen as representative for the whole group. 178 # The representative event is intended to be used as a quick preview for 179 # the whole group. Events in the group are usually sufficiently similar 180 # to each other such that showing an arbitrary representative provides 181 # insight into the characteristics of the group as a whole. 182 "serviceContext": { # Describes a running service that sends errors. # The `ServiceContext` for which this error was reported. 183 # Its version changes over time and multiple versions can run in parallel. 184 "resourceType": "A String", # Type of the MonitoredResource. List of possible values: 185 # https://cloud.google.com/monitoring/api/resources 186 # 187 # Value is set automatically for incoming errors and must not be set when 188 # reporting errors. 189 "version": "A String", # Represents the source code version that the developer provided, 190 # which could represent a version label or a Git SHA-1 hash, for example. 191 # For App Engine standard environment, the version is set to the version of 192 # the app. 193 "service": "A String", # An identifier of the service, such as the name of the 194 # executable, job, or Google App Engine service name. This field is expected 195 # to have a low number of values that are relatively stable over time, as 196 # opposed to `version`, which can be changed whenever new code is deployed. 197 # 198 # Contains the service name for error reports extracted from Google 199 # App Engine logs or `default` if the App Engine default service is used. 200 }, 201 "eventTime": "A String", # Time when the event occurred as provided in the error report. 202 # If the report did not contain a timestamp, the time the error was received 203 # by the Error Reporting system is used. 204 "message": "A String", # The stack trace that was reported or logged by the service. 205 "context": { # A description of the context in which an error occurred. # Data about the context in which the error occurred. 206 # This data should be provided by the application when reporting an error, 207 # unless the 208 # error report has been generated automatically from Google App Engine logs. 209 "httpRequest": { # HTTP request data that is related to a reported error. # The HTTP request which was processed when the error was 210 # triggered. 211 # This data should be provided by the application when reporting an error, 212 # unless the 213 # error report has been generated automatically from Google App Engine logs. 214 "responseStatusCode": 42, # The HTTP response status code for the request. 215 "url": "A String", # The URL of the request. 216 "referrer": "A String", # The referrer information that is provided with the request. 217 "remoteIp": "A String", # The IP address from which the request originated. 218 # This can be IPv4, IPv6, or a token which is derived from the 219 # IP address, depending on the data that has been provided 220 # in the error report. 221 "userAgent": "A String", # The user agent information that is provided with the request. 222 "method": "A String", # The type of HTTP request, such as `GET`, `POST`, etc. 223 }, 224 "sourceReferences": [ # Source code that was used to build the executable which has 225 # caused the given error message. 226 { # A reference to a particular snapshot of the source tree used to build and 227 # deploy an application. 228 "revisionId": "A String", # The canonical and persistent identifier of the deployed revision. 229 # Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b" 230 "repository": "A String", # Optional. A URI string identifying the repository. 231 # Example: "https://github.com/GoogleCloudPlatform/kubernetes.git" 232 }, 233 ], 234 "reportLocation": { # Indicates a location in the source code of the service for which errors are # The location in the source code where the decision was made to 235 # report the error, usually the place where it was logged. 236 # For a logged exception this would be the source line where the 237 # exception is logged, usually close to the place where it was 238 # caught. 239 # reported. `functionName` must be provided by the application when reporting 240 # an error, unless the error report contains a `message` with a supported 241 # exception stack trace. All fields are optional for the later case. 242 "lineNumber": 42, # 1-based. 0 indicates that the line number is unknown. 243 "functionName": "A String", # Human-readable name of a function or method. 244 # The value can include optional context like the class or package name. 245 # For example, `my.package.MyClass.method` in case of Java. 246 "filePath": "A String", # The source code filename, which can include a truncated relative 247 # path, or a full path from a production machine. 248 }, 249 "user": "A String", # The user who caused or was affected by the crash. 250 # This can be a user ID, an email address, or an arbitrary token that 251 # uniquely identifies the user. 252 # When sending an error report, leave this field empty if the user was not 253 # logged in. In this case the 254 # Error Reporting system will use other data, such as remote IP address, to 255 # distinguish affected users. See `affected_users_count` in 256 # `ErrorGroupStats`. 257 }, 258 }, 259 "numAffectedServices": 42, # The total number of services with a non-zero error count for the given 260 # filter criteria. 261 "affectedServices": [ # Service contexts with a non-zero error count for the given filter 262 # criteria. This list can be truncated if multiple services are affected. 263 # Refer to `num_affected_services` for the total count. 264 { # Describes a running service that sends errors. 265 # Its version changes over time and multiple versions can run in parallel. 266 "resourceType": "A String", # Type of the MonitoredResource. List of possible values: 267 # https://cloud.google.com/monitoring/api/resources 268 # 269 # Value is set automatically for incoming errors and must not be set when 270 # reporting errors. 271 "version": "A String", # Represents the source code version that the developer provided, 272 # which could represent a version label or a Git SHA-1 hash, for example. 273 # For App Engine standard environment, the version is set to the version of 274 # the app. 275 "service": "A String", # An identifier of the service, such as the name of the 276 # executable, job, or Google App Engine service name. This field is expected 277 # to have a low number of values that are relatively stable over time, as 278 # opposed to `version`, which can be changed whenever new code is deployed. 279 # 280 # Contains the service name for error reports extracted from Google 281 # App Engine logs or `default` if the App Engine default service is used. 282 }, 283 ], 284 }, 285 ], 286 "timeRangeBegin": "A String", # The timestamp specifies the start time to which the request was restricted. 287 # The start time is set based on the requested time range. It may be adjusted 288 # to a later time if a project has exceeded the storage quota and older data 289 # has been deleted. 290 }</pre> 291</div> 292 293<div class="method"> 294 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 295 <pre>Retrieves the next page of results. 296 297Args: 298 previous_request: The request for the previous page. (required) 299 previous_response: The response from the request for the previous page. (required) 300 301Returns: 302 A request object that you can call 'execute()' on to request the next 303 page. Returns None if there are no more items in the collection. 304 </pre> 305</div> 306 307</body></html>