group_stats

Creates, updates, deletes, gets or lists a group_stats resource.

Overview

Name	group_stats
Type	Resource
Id	google.clouderrorreporting.group_stats

Fields

The following fields are returned by SELECT queries:

list

Successful response

Name	Datatype	Description
affectedServices	array	Service contexts with a non-zero error count for the given filter criteria. This list can be truncated if multiple services are affected. Refer to num_affected_services for the total count.
affectedUsersCount	string (int64)	Approximate number of affected users in the given group that match the filter criteria. Users are distinguished by data in the ErrorContext of the individual error events, such as their login name or their remote IP address in case of HTTP requests. The number of affected users can be zero even if the number of errors is non-zero if no data was provided from which the affected user could be deduced. Users are counted based on data in the request context that was provided in the error report. If more users are implicitly affected, such as due to a crash of the whole service, this is not reflected here.
count	string (int64)	Approximate total number of events in the given group that match the filter criteria.
firstSeenTime	string (google-datetime)	Approximate first occurrence that was ever seen for this group and which matches the given filter criteria, ignoring the time_range that was specified in the request.
group	object	Group data that is independent of the filter criteria. (id: ErrorGroup)
lastSeenTime	string (google-datetime)	Approximate last occurrence that was ever seen for this group and which matches the given filter criteria, ignoring the time_range that was specified in the request.
numAffectedServices	integer (int32)	The total number of services with a non-zero error count for the given filter criteria.
representative	object	An arbitrary event that is chosen as representative for the whole group. The representative event is intended to be used as a quick preview for the whole group. Events in the group are usually sufficiently similar to each other such that showing an arbitrary representative provides insight into the characteristics of the group as a whole. (id: ErrorEvent)
timedCounts	array	Approximate number of occurrences over time. Timed counts returned by ListGroups are guaranteed to be: - Inside the requested time interval - Non-overlapping, and - Ordered by ascending time.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	projectsId, locationsId	groupId, serviceFilter.service, serviceFilter.version, serviceFilter.resourceType, timeRange.period, timedCountDuration, alignment, alignmentTime, order, pageSize, pageToken	Lists the specified groups.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
alignment	string
alignmentTime	string (google-datetime)
groupId	string
order	string
pageSize	integer (int32)
pageToken	string
serviceFilter.resourceType	string
serviceFilter.service	string
serviceFilter.version	string
timeRange.period	string
timedCountDuration	string (google-duration)

SELECT examples

list

Lists the specified groups.

SELECT
affectedServices,
affectedUsersCount,
count,
firstSeenTime,
group,
lastSeenTime,
numAffectedServices,
representative,
timedCounts
FROM google.clouderrorreporting.group_stats
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND groupId = '{{ groupId }}'
AND serviceFilter.service = '{{ serviceFilter.service }}'
AND serviceFilter.version = '{{ serviceFilter.version }}'
AND serviceFilter.resourceType = '{{ serviceFilter.resourceType }}'
AND timeRange.period = '{{ timeRange.period }}'
AND timedCountDuration = '{{ timedCountDuration }}'
AND alignment = '{{ alignment }}'
AND alignmentTime = '{{ alignmentTime }}'
AND order = '{{ order }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';