errorreportingpb

type DeleteEventsRequest struct {

	// Required. The resource name of the Google Cloud Platform project. Written
	// as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
	// where `{projectID}` is the [Google Cloud Platform project
	// ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
	// a Cloud region.
	//
	// Examples: `projects/my-project-123`,
	// `projects/my-project-123/locations/global`.
	//
	// For a list of supported locations, see [Supported
	// Regions](https://cloud.google.com/logging/docs/region-support). `global` is
	// the default when unspecified.
	ProjectName string `protobuf:"bytes,1,opt,name=project_name,json=projectName,proto3" json:"project_name,omitempty"`
	// contains filtered or unexported fields
}

type DeleteEventsResponse struct {
	// contains filtered or unexported fields
}

type ErrorContext struct {

	// The HTTP request which was processed when the error was
	// triggered.
	HttpRequest *HttpRequestContext `protobuf:"bytes,1,opt,name=http_request,json=httpRequest,proto3" json:"http_request,omitempty"`
	// The user who caused or was affected by the crash.
	// This can be a user ID, an email address, or an arbitrary token that
	// uniquely identifies the user.
	// When sending an error report, leave this field empty if the user was not
	// logged in. In this case the
	// Error Reporting system will use other data, such as remote IP address, to
	// distinguish affected users. See `affected_users_count` in
	// `ErrorGroupStats`.
	User string `protobuf:"bytes,2,opt,name=user,proto3" json:"user,omitempty"`
	// The location in the source code where the decision was made to
	// report the error, usually the place where it was logged.
	// For a logged exception this would be the source line where the
	// exception is logged, usually close to the place where it was
	// caught.
	ReportLocation *SourceLocation `protobuf:"bytes,3,opt,name=report_location,json=reportLocation,proto3" json:"report_location,omitempty"`
	// contains filtered or unexported fields
}

type ErrorEvent struct {

	// Time when the event occurred as provided in the error report.
	// If the report did not contain a timestamp, the time the error was received
	// by the Error Reporting system is used.
	EventTime *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=event_time,json=eventTime,proto3" json:"event_time,omitempty"`
	// The `ServiceContext` for which this error was reported.
	ServiceContext *ServiceContext `protobuf:"bytes,2,opt,name=service_context,json=serviceContext,proto3" json:"service_context,omitempty"`
	// The stack trace that was reported or logged by the service.
	Message string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
	// Data about the context in which the error occurred.
	Context *ErrorContext `protobuf:"bytes,5,opt,name=context,proto3" json:"context,omitempty"`
	// contains filtered or unexported fields
}

type ErrorGroup struct {

	// The group resource name.
	// Written as `projects/{projectID}/groups/{group_id}` or
	// `projects/{projectID}/locations/{location}/groups/{group_id}`
	//
	// Examples: `projects/my-project-123/groups/my-group`,
	// `projects/my-project-123/locations/us-central1/groups/my-group`
	//
	// In the group resource name, the `group_id` is a unique identifier for a
	// particular error group. The identifier is derived from key parts of the
	// error-log content and is treated as Service Data. For information about
	// how Service Data is handled, see [Google Cloud Privacy
	// Notice](https://cloud.google.com/terms/cloud-privacy-notice).
	//
	// For a list of supported locations, see [Supported
	// Regions](https://cloud.google.com/logging/docs/region-support). `global` is
	// the default when unspecified.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// An opaque identifier of the group. This field is assigned by the Error
	// Reporting system and always populated.
	//
	// In the group resource name, the `group_id` is a unique identifier for a
	// particular error group. The identifier is derived from key parts of the
	// error-log content and is treated as Service Data. For information about
	// how Service Data is handled, see [Google Cloud Privacy
	// Notice](https://cloud.google.com/terms/cloud-privacy-notice).
	GroupId string `protobuf:"bytes,2,opt,name=group_id,json=groupId,proto3" json:"group_id,omitempty"`
	// Associated tracking issues.
	TrackingIssues []*TrackingIssue `protobuf:"bytes,3,rep,name=tracking_issues,json=trackingIssues,proto3" json:"tracking_issues,omitempty"`
	// Error group's resolution status.
	//
	// An unspecified resolution status will be interpreted as OPEN
	ResolutionStatus ResolutionStatus `` /* 176-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ErrorGroupOrder int32

type ErrorGroupServiceClient interface {
	// Get the specified group.
	GetGroup(ctx context.Context, in *GetGroupRequest, opts ...grpc.CallOption) (*ErrorGroup, error)
	// Replace the data for the specified group.
	// Fails if the group does not exist.
	UpdateGroup(ctx context.Context, in *UpdateGroupRequest, opts ...grpc.CallOption) (*ErrorGroup, error)
}

type ErrorGroupServiceServer interface {
	// Get the specified group.
	GetGroup(context.Context, *GetGroupRequest) (*ErrorGroup, error)
	// Replace the data for the specified group.
	// Fails if the group does not exist.
	UpdateGroup(context.Context, *UpdateGroupRequest) (*ErrorGroup, error)
}

type ErrorGroupStats struct {

	// Group data that is independent of the filter criteria.
	Group *ErrorGroup `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
	// Approximate total number of events in the given group that match
	// the filter criteria.
	Count int64 `protobuf:"varint,2,opt,name=count,proto3" json:"count,omitempty"`
	// Approximate number of affected users in the given group that
	// match the filter criteria.
	// Users are distinguished by data in the [ErrorContext]
	// [google.devtools.clouderrorreporting.v1beta1.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.
	AffectedUsersCount int64 `protobuf:"varint,3,opt,name=affected_users_count,json=affectedUsersCount,proto3" json:"affected_users_count,omitempty"`
	// 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.
	TimedCounts []*TimedCount `protobuf:"bytes,4,rep,name=timed_counts,json=timedCounts,proto3" json:"timed_counts,omitempty"`
	// 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.
	FirstSeenTime *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=first_seen_time,json=firstSeenTime,proto3" json:"first_seen_time,omitempty"`
	// 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.
	LastSeenTime *timestamppb.Timestamp `protobuf:"bytes,6,opt,name=last_seen_time,json=lastSeenTime,proto3" json:"last_seen_time,omitempty"`
	// 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.
	AffectedServices []*ServiceContext `protobuf:"bytes,7,rep,name=affected_services,json=affectedServices,proto3" json:"affected_services,omitempty"`
	// The total number of services with a non-zero error count for the given
	// filter criteria.
	NumAffectedServices int32 `protobuf:"varint,8,opt,name=num_affected_services,json=numAffectedServices,proto3" json:"num_affected_services,omitempty"`
	// 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.
	Representative *ErrorEvent `protobuf:"bytes,9,opt,name=representative,proto3" json:"representative,omitempty"`
	// contains filtered or unexported fields
}

type ErrorStatsServiceClient interface {
	// Lists the specified groups.
	ListGroupStats(ctx context.Context, in *ListGroupStatsRequest, opts ...grpc.CallOption) (*ListGroupStatsResponse, error)
	// Lists the specified events.
	ListEvents(ctx context.Context, in *ListEventsRequest, opts ...grpc.CallOption) (*ListEventsResponse, error)
	// Deletes all error events of a given project.
	DeleteEvents(ctx context.Context, in *DeleteEventsRequest, opts ...grpc.CallOption) (*DeleteEventsResponse, error)
}

type ErrorStatsServiceServer interface {
	// Lists the specified groups.
	ListGroupStats(context.Context, *ListGroupStatsRequest) (*ListGroupStatsResponse, error)
	// Lists the specified events.
	ListEvents(context.Context, *ListEventsRequest) (*ListEventsResponse, error)
	// Deletes all error events of a given project.
	DeleteEvents(context.Context, *DeleteEventsRequest) (*DeleteEventsResponse, error)
}

type GetGroupRequest struct {

	// Required. The group resource name. Written as either
	// `projects/{projectID}/groups/{group_id}` or
	// `projects/{projectID}/locations/{location}/groups/{group_id}`. Call
	// [groupStats.list]
	// [google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
	// to return a list of groups belonging to this project.
	//
	// Examples: `projects/my-project-123/groups/my-group`,
	// `projects/my-project-123/locations/global/groups/my-group`
	//
	// In the group resource name, the `group_id` is a unique identifier for a
	// particular error group. The identifier is derived from key parts of the
	// error-log content and is treated as Service Data. For information about
	// how Service Data is handled, see [Google Cloud Privacy
	// Notice](https://cloud.google.com/terms/cloud-privacy-notice).
	//
	// For a list of supported locations, see [Supported
	// Regions](https://cloud.google.com/logging/docs/region-support). `global` is
	// the default when unspecified.
	GroupName string `protobuf:"bytes,1,opt,name=group_name,json=groupName,proto3" json:"group_name,omitempty"`
	// contains filtered or unexported fields
}

type HttpRequestContext struct {

	// The type of HTTP request, such as `GET`, `POST`, etc.
	Method string `protobuf:"bytes,1,opt,name=method,proto3" json:"method,omitempty"`
	// The URL of the request.
	Url string `protobuf:"bytes,2,opt,name=url,proto3" json:"url,omitempty"`
	// The user agent information that is provided with the request.
	UserAgent string `protobuf:"bytes,3,opt,name=user_agent,json=userAgent,proto3" json:"user_agent,omitempty"`
	// The referrer information that is provided with the request.
	Referrer string `protobuf:"bytes,4,opt,name=referrer,proto3" json:"referrer,omitempty"`
	// The HTTP response status code for the request.
	ResponseStatusCode int32 `protobuf:"varint,5,opt,name=response_status_code,json=responseStatusCode,proto3" json:"response_status_code,omitempty"`
	// The IP address from which the request originated.
	// This can be IPv4, IPv6, or a token which is derived from the
	// IP address, depending on the data that has been provided
	// in the error report.
	RemoteIp string `protobuf:"bytes,6,opt,name=remote_ip,json=remoteIp,proto3" json:"remote_ip,omitempty"`
	// contains filtered or unexported fields
}

type ListEventsRequest struct {

	// Required. The resource name of the Google Cloud Platform project. Written
	// as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
	// where `{projectID}` is the [Google Cloud Platform project
	// ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
	// a Cloud region.
	//
	// Examples: `projects/my-project-123`,
	// `projects/my-project-123/locations/global`.
	//
	// For a list of supported locations, see [Supported
	// Regions](https://cloud.google.com/logging/docs/region-support). `global` is
	// the default when unspecified.
	ProjectName string `protobuf:"bytes,1,opt,name=project_name,json=projectName,proto3" json:"project_name,omitempty"`
	// Required. The group for which events shall be returned.
	// The `group_id` is a unique identifier for a particular error group. The
	// identifier is derived from key parts of the error-log content and is
	// treated as Service Data. For information about how Service Data
	// is handled, see [Google Cloud Privacy
	// Notice](https://cloud.google.com/terms/cloud-privacy-notice).
	GroupId string `protobuf:"bytes,2,opt,name=group_id,json=groupId,proto3" json:"group_id,omitempty"`
	// Optional. List only ErrorGroups which belong to a service context that
	// matches the filter.
	// Data for all service contexts is returned if this field is not specified.
	ServiceFilter *ServiceContextFilter `protobuf:"bytes,3,opt,name=service_filter,json=serviceFilter,proto3" json:"service_filter,omitempty"`
	// Optional. List only data for the given time range.
	// If not set a default time range is used. The field time_range_begin
	// in the response will specify the beginning of this time range.
	TimeRange *QueryTimeRange `protobuf:"bytes,4,opt,name=time_range,json=timeRange,proto3" json:"time_range,omitempty"`
	// Optional. The maximum number of results to return per response.
	PageSize int32 `protobuf:"varint,6,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Optional. A `next_page_token` provided by a previous response.
	PageToken string `protobuf:"bytes,7,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

type ListEventsResponse struct {

	// The error events which match the given request.
	ErrorEvents []*ErrorEvent `protobuf:"bytes,1,rep,name=error_events,json=errorEvents,proto3" json:"error_events,omitempty"`
	// If non-empty, more results are available.
	// Pass this token, along with the same query parameters as the first
	// request, to view the next page of results.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// The timestamp specifies the start time to which the request was restricted.
	TimeRangeBegin *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=time_range_begin,json=timeRangeBegin,proto3" json:"time_range_begin,omitempty"`
	// contains filtered or unexported fields
}

type ListGroupStatsRequest struct {

	// Required. The resource name of the Google Cloud Platform project. Written
	// as `projects/{projectID}` or `projects/{projectNumber}`, where
	// `{projectID}` and `{projectNumber}` can be found in the
	// [Google Cloud console](https://support.google.com/cloud/answer/6158840).
	// It may also include a location, such as
	// `projects/{projectID}/locations/{location}` where `{location}` is a cloud
	// region.
	//
	// Examples: `projects/my-project-123`, `projects/5551234`,
	// `projects/my-project-123/locations/us-central1`,
	// `projects/5551234/locations/us-central1`.
	//
	// For a list of supported locations, see [Supported
	// Regions](https://cloud.google.com/logging/docs/region-support). `global` is
	// the default when unspecified. Use `-` as a wildcard to request group stats
	// from all regions.
	ProjectName string `protobuf:"bytes,1,opt,name=project_name,json=projectName,proto3" json:"project_name,omitempty"`
	// Optional. List all [ErrorGroupStats]
	// [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with these
	// IDs. The `group_id` is a unique identifier for a particular error group.
	// The identifier is derived from key parts of the error-log content and is
	// treated as Service Data. For information about how Service Data
	// is handled, see [Google Cloud Privacy Notice]
	// (https://cloud.google.com/terms/cloud-privacy-notice).
	GroupId []string `protobuf:"bytes,2,rep,name=group_id,json=groupId,proto3" json:"group_id,omitempty"`
	// Optional. List only [ErrorGroupStats]
	// [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] which belong
	// to a service context that matches the filter. Data for all service contexts
	// is returned if this field is not specified.
	ServiceFilter *ServiceContextFilter `protobuf:"bytes,3,opt,name=service_filter,json=serviceFilter,proto3" json:"service_filter,omitempty"`
	// Optional. List data for the given time range.
	// If not set, a default time range is used. The field
	// [time_range_begin]
	// [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
	// in the response will specify the beginning of this time range. Only
	// [ErrorGroupStats]
	// [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with a
	// non-zero count in the given time range are returned, unless the request
	// contains an explicit [group_id]
	// [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
	// list. If a [group_id]
	// [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
	// list is given, also [ErrorGroupStats]
	// [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with zero
	// occurrences are returned.
	TimeRange *QueryTimeRange `protobuf:"bytes,5,opt,name=time_range,json=timeRange,proto3" json:"time_range,omitempty"`
	// Optional. The preferred duration for a single returned [TimedCount]
	// [google.devtools.clouderrorreporting.v1beta1.TimedCount]. If not set, no
	// timed counts are returned.
	TimedCountDuration *durationpb.Duration `protobuf:"bytes,6,opt,name=timed_count_duration,json=timedCountDuration,proto3" json:"timed_count_duration,omitempty"`
	// Optional. The alignment of the timed counts to be returned.
	// Default is `ALIGNMENT_EQUAL_AT_END`.
	Alignment TimedCountAlignment `` /* 141-byte string literal not displayed */
	// Optional. Time where the timed counts shall be aligned if rounded
	// alignment is chosen. Default is 00:00 UTC.
	AlignmentTime *timestamppb.Timestamp `protobuf:"bytes,8,opt,name=alignment_time,json=alignmentTime,proto3" json:"alignment_time,omitempty"`
	// Optional. The sort order in which the results are returned.
	// Default is `COUNT_DESC`.
	Order ErrorGroupOrder `` /* 129-byte string literal not displayed */
	// Optional. The maximum number of results to return per response.
	// Default is 20.
	PageSize int32 `protobuf:"varint,11,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Optional. A [next_page_token]
	// [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.next_page_token]
	// provided by a previous response. To view additional results, pass this
	// token along with the identical query parameters as the first request.
	PageToken string `protobuf:"bytes,12,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

type ListGroupStatsResponse struct {

	// The error group stats which match the given request.
	ErrorGroupStats []*ErrorGroupStats `protobuf:"bytes,1,rep,name=error_group_stats,json=errorGroupStats,proto3" json:"error_group_stats,omitempty"`
	// If non-empty, more results are available.
	// Pass this token, along with the same query parameters as the first
	// request, to view the next page of results.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// The timestamp specifies the start time to which the request was restricted.
	// The start time is set based on the requested time range. It may be adjusted
	// to a later time if a project has exceeded the storage quota and older data