google-cloud-error_reporting 0.35.0 → 0.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +2 -1
  3. data/CHANGELOG.md +47 -0
  4. data/CONTRIBUTING.md +2 -2
  5. data/LOGGING.md +1 -1
  6. data/TROUBLESHOOTING.md +2 -8
  7. data/lib/google-cloud-error_reporting.rb +8 -14
  8. data/lib/google/cloud/error_reporting.rb +16 -13
  9. data/lib/google/cloud/error_reporting/async_error_reporter.rb +2 -2
  10. data/lib/google/cloud/error_reporting/credentials.rb +2 -2
  11. data/lib/google/cloud/error_reporting/error_event.rb +14 -18
  12. data/lib/google/cloud/error_reporting/middleware.rb +5 -5
  13. data/lib/google/cloud/error_reporting/rails.rb +2 -2
  14. data/lib/google/cloud/error_reporting/service.rb +15 -36
  15. data/lib/google/cloud/error_reporting/version.rb +1 -1
  16. metadata +13 -74
  17. data/lib/google/cloud/error_reporting/v1beta1.rb +0 -19
  18. data/lib/google/cloud/error_reporting/v1beta1/credentials.rb +0 -41
  19. data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/common.rb +0 -158
  20. data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb +0 -41
  21. data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb +0 -314
  22. data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb +0 -79
  23. data/lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb +0 -91
  24. data/lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb +0 -113
  25. data/lib/google/cloud/error_reporting/v1beta1/error_group_service_client.rb +0 -285
  26. data/lib/google/cloud/error_reporting/v1beta1/error_group_service_client_config.json +0 -36
  27. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service_client.rb +0 -457
  28. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service_client_config.json +0 -41
  29. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service_client.rb +0 -254
  30. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service_client_config.json +0 -31
  31. data/lib/google/devtools/clouderrorreporting/v1beta1/common_pb.rb +0 -64
  32. data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_pb.rb +0 -30
  33. data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_services_pb.rb +0 -50
  34. data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb.rb +0 -116
  35. data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_services_pb.rb +0 -52
  36. data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_pb.rb +0 -38
  37. data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb +0 -55
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module ErrorReporting
19
- VERSION = "0.35.0".freeze
19
+ VERSION = "0.42.0".freeze
20
20
  end
21
21
  end
22
22
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-error_reporting
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.35.0
4
+ version: 0.42.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google Inc
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-03-11 00:00:00.000000000 Z
11
+ date: 2021-03-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-core
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '1.2'
19
+ version: '1.5'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '1.2'
26
+ version: '1.5'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: stackdriver-core
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -39,59 +39,19 @@ dependencies:
39
39
  - !ruby/object:Gem::Version
40
40
  version: '1.3'
41
41
  - !ruby/object:Gem::Dependency
42
- name: google-gax
42
+ name: google-cloud-error_reporting-v1beta1
43
43
  requirement: !ruby/object:Gem::Requirement
44
44
  requirements:
45
45
  - - "~>"
46
46
  - !ruby/object:Gem::Version
47
- version: '1.8'
47
+ version: '0.0'
48
48
  type: :runtime
49
49
  prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
52
  - - "~>"
53
53
  - !ruby/object:Gem::Version
54
- version: '1.8'
55
- - !ruby/object:Gem::Dependency
56
- name: googleapis-common-protos
57
- requirement: !ruby/object:Gem::Requirement
58
- requirements:
59
- - - ">="
60
- - !ruby/object:Gem::Version
61
- version: 1.3.9
62
- - - "<"
63
- - !ruby/object:Gem::Version
64
- version: '2.0'
65
- type: :runtime
66
- prerelease: false
67
- version_requirements: !ruby/object:Gem::Requirement
68
- requirements:
69
- - - ">="
70
- - !ruby/object:Gem::Version
71
- version: 1.3.9
72
- - - "<"
73
- - !ruby/object:Gem::Version
74
- version: '2.0'
75
- - !ruby/object:Gem::Dependency
76
- name: googleapis-common-protos-types
77
- requirement: !ruby/object:Gem::Requirement
78
- requirements:
79
- - - ">="
80
- - !ruby/object:Gem::Version
81
- version: 1.0.4
82
- - - "<"
83
- - !ruby/object:Gem::Version
84
- version: '2.0'
85
- type: :runtime
86
- prerelease: false
87
- version_requirements: !ruby/object:Gem::Requirement
88
- requirements:
89
- - - ">="
90
- - !ruby/object:Gem::Version
91
- version: 1.0.4
92
- - - "<"
93
- - !ruby/object:Gem::Version
94
- version: '2.0'
54
+ version: '0.0'
95
55
  - !ruby/object:Gem::Dependency
96
56
  name: concurrent-ruby
97
57
  requirement: !ruby/object:Gem::Requirement
@@ -112,28 +72,28 @@ dependencies:
112
72
  requirements:
113
73
  - - "~>"
114
74
  - !ruby/object:Gem::Version
115
- version: 1.24.0
75
+ version: 1.25.1
116
76
  type: :development
117
77
  prerelease: false
118
78
  version_requirements: !ruby/object:Gem::Requirement
119
79
  requirements:
120
80
  - - "~>"
121
81
  - !ruby/object:Gem::Version
122
- version: 1.24.0
82
+ version: 1.25.1
123
83
  - !ruby/object:Gem::Dependency
124
84
  name: minitest
125
85
  requirement: !ruby/object:Gem::Requirement
126
86
  requirements:
127
87
  - - "~>"
128
88
  - !ruby/object:Gem::Version
129
- version: '5.10'
89
+ version: '5.14'
130
90
  type: :development
131
91
  prerelease: false
132
92
  version_requirements: !ruby/object:Gem::Requirement
133
93
  requirements:
134
94
  - - "~>"
135
95
  - !ruby/object:Gem::Version
136
- version: '5.10'
96
+ version: '5.14'
137
97
  - !ruby/object:Gem::Dependency
138
98
  name: minitest-autotest
139
99
  requirement: !ruby/object:Gem::Requirement
@@ -287,28 +247,7 @@ files:
287
247
  - lib/google/cloud/error_reporting/project.rb
288
248
  - lib/google/cloud/error_reporting/rails.rb
289
249
  - lib/google/cloud/error_reporting/service.rb
290
- - lib/google/cloud/error_reporting/v1beta1.rb
291
- - lib/google/cloud/error_reporting/v1beta1/credentials.rb
292
- - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/common.rb
293
- - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb
294
- - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb
295
- - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb
296
- - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb
297
- - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb
298
- - lib/google/cloud/error_reporting/v1beta1/error_group_service_client.rb
299
- - lib/google/cloud/error_reporting/v1beta1/error_group_service_client_config.json
300
- - lib/google/cloud/error_reporting/v1beta1/error_stats_service_client.rb
301
- - lib/google/cloud/error_reporting/v1beta1/error_stats_service_client_config.json
302
- - lib/google/cloud/error_reporting/v1beta1/report_errors_service_client.rb
303
- - lib/google/cloud/error_reporting/v1beta1/report_errors_service_client_config.json
304
250
  - lib/google/cloud/error_reporting/version.rb
305
- - lib/google/devtools/clouderrorreporting/v1beta1/common_pb.rb
306
- - lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_pb.rb
307
- - lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_services_pb.rb
308
- - lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb.rb
309
- - lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_services_pb.rb
310
- - lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_pb.rb
311
- - lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb
312
251
  homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-error_reporting
313
252
  licenses:
314
253
  - Apache-2.0
@@ -321,14 +260,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
321
260
  requirements:
322
261
  - - ">="
323
262
  - !ruby/object:Gem::Version
324
- version: '2.4'
263
+ version: '2.5'
325
264
  required_rubygems_version: !ruby/object:Gem::Requirement
326
265
  requirements:
327
266
  - - ">="
328
267
  - !ruby/object:Gem::Version
329
268
  version: '0'
330
269
  requirements: []
331
- rubygems_version: 3.0.6
270
+ rubygems_version: 3.2.13
332
271
  signing_key:
333
272
  specification_version: 4
334
273
  summary: API Client library for Stackdriver Error Reporting
@@ -1,19 +0,0 @@
1
-
2
- # Copyright 2016 Google LLC
3
- #
4
- # Licensed under the Apache License, Version 2.0 (the "License");
5
- # you may not use this file except in compliance with the License.
6
- # You may obtain a copy of the License at
7
- #
8
- # https://www.apache.org/licenses/LICENSE-2.0
9
- #
10
- # Unless required by applicable law or agreed to in writing, software
11
- # distributed under the License is distributed on an "AS IS" BASIS,
12
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- # See the License for the specific language governing permissions and
14
- # limitations under the License.
15
-
16
-
17
- require "google/cloud/error_reporting/v1beta1/error_group_service_client"
18
- require "google/cloud/error_reporting/v1beta1/error_stats_service_client"
19
- require "google/cloud/error_reporting/v1beta1/report_errors_service_client"
@@ -1,41 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- require "googleauth"
17
-
18
- module Google
19
- module Cloud
20
- module ErrorReporting
21
- module V1beta1
22
- class Credentials < Google::Auth::Credentials
23
- SCOPE = [
24
- "https://www.googleapis.com/auth/cloud-platform"
25
- ].freeze
26
- PATH_ENV_VARS = %w(ERROR_REPORTING_CREDENTIALS
27
- ERROR_REPORTING_KEYFILE
28
- GOOGLE_CLOUD_CREDENTIALS
29
- GOOGLE_CLOUD_KEYFILE
30
- GCLOUD_KEYFILE)
31
- JSON_ENV_VARS = %w(ERROR_REPORTING_CREDENTIALS_JSON
32
- ERROR_REPORTING_KEYFILE_JSON
33
- GOOGLE_CLOUD_CREDENTIALS_JSON
34
- GOOGLE_CLOUD_KEYFILE_JSON
35
- GCLOUD_KEYFILE_JSON)
36
- DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
37
- end
38
- end
39
- end
40
- end
41
- end
@@ -1,158 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Devtools
18
- module Clouderrorreporting
19
- module V1beta1
20
- # Description of a group of similar error events.
21
- # @!attribute [rw] name
22
- # @return [String]
23
- # The group resource name.
24
- # Example: <code>projects/my-project-123/groups/my-groupid</code>
25
- # @!attribute [rw] group_id
26
- # @return [String]
27
- # Group IDs are unique for a given project. If the same kind of error
28
- # occurs in different service contexts, it will receive the same group ID.
29
- # @!attribute [rw] tracking_issues
30
- # @return [Array<Google::Devtools::Clouderrorreporting::V1beta1::TrackingIssue>]
31
- # Associated tracking issues.
32
- class ErrorGroup; end
33
-
34
- # Information related to tracking the progress on resolving the error.
35
- # @!attribute [rw] url
36
- # @return [String]
37
- # A URL pointing to a related entry in an issue tracking system.
38
- # Example: https://github.com/user/project/issues/4
39
- class TrackingIssue; end
40
-
41
- # An error event which is returned by the Error Reporting system.
42
- # @!attribute [rw] event_time
43
- # @return [Google::Protobuf::Timestamp]
44
- # Time when the event occurred as provided in the error report.
45
- # If the report did not contain a timestamp, the time the error was received
46
- # by the Error Reporting system is used.
47
- # @!attribute [rw] service_context
48
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ServiceContext]
49
- # The `ServiceContext` for which this error was reported.
50
- # @!attribute [rw] message
51
- # @return [String]
52
- # The stack trace that was reported or logged by the service.
53
- # @!attribute [rw] context
54
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorContext]
55
- # Data about the context in which the error occurred.
56
- class ErrorEvent; end
57
-
58
- # Describes a running service that sends errors.
59
- # Its version changes over time and multiple versions can run in parallel.
60
- # @!attribute [rw] service
61
- # @return [String]
62
- # An identifier of the service, such as the name of the
63
- # executable, job, or Google App Engine service name. This field is expected
64
- # to have a low number of values that are relatively stable over time, as
65
- # opposed to `version`, which can be changed whenever new code is deployed.
66
- #
67
- # Contains the service name for error reports extracted from Google
68
- # App Engine logs or `default` if the App Engine default service is used.
69
- # @!attribute [rw] version
70
- # @return [String]
71
- # Represents the source code version that the developer provided,
72
- # which could represent a version label or a Git SHA-1 hash, for example.
73
- # For App Engine standard environment, the version is set to the version of
74
- # the app.
75
- # @!attribute [rw] resource_type
76
- # @return [String]
77
- # Type of the MonitoredResource. List of possible values:
78
- # https://cloud.google.com/monitoring/api/resources
79
- #
80
- # Value is set automatically for incoming errors and must not be set when
81
- # reporting errors.
82
- class ServiceContext; end
83
-
84
- # A description of the context in which an error occurred.
85
- # This data should be provided by the application when reporting an error,
86
- # unless the
87
- # error report has been generated automatically from Google App Engine logs.
88
- # @!attribute [rw] http_request
89
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::HttpRequestContext]
90
- # The HTTP request which was processed when the error was
91
- # triggered.
92
- # @!attribute [rw] user
93
- # @return [String]
94
- # The user who caused or was affected by the crash.
95
- # This can be a user ID, an email address, or an arbitrary token that
96
- # uniquely identifies the user.
97
- # When sending an error report, leave this field empty if the user was not
98
- # logged in. In this case the
99
- # Error Reporting system will use other data, such as remote IP address, to
100
- # distinguish affected users. See `affected_users_count` in
101
- # `ErrorGroupStats`.
102
- # @!attribute [rw] report_location
103
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::SourceLocation]
104
- # The location in the source code where the decision was made to
105
- # report the error, usually the place where it was logged.
106
- # For a logged exception this would be the source line where the
107
- # exception is logged, usually close to the place where it was
108
- # caught.
109
- class ErrorContext; end
110
-
111
- # HTTP request data that is related to a reported error.
112
- # This data should be provided by the application when reporting an error,
113
- # unless the
114
- # error report has been generated automatically from Google App Engine logs.
115
- # @!attribute [rw] method
116
- # @return [String]
117
- # The type of HTTP request, such as `GET`, `POST`, etc.
118
- # @!attribute [rw] url
119
- # @return [String]
120
- # The URL of the request.
121
- # @!attribute [rw] user_agent
122
- # @return [String]
123
- # The user agent information that is provided with the request.
124
- # @!attribute [rw] referrer
125
- # @return [String]
126
- # The referrer information that is provided with the request.
127
- # @!attribute [rw] response_status_code
128
- # @return [Integer]
129
- # The HTTP response status code for the request.
130
- # @!attribute [rw] remote_ip
131
- # @return [String]
132
- # The IP address from which the request originated.
133
- # This can be IPv4, IPv6, or a token which is derived from the
134
- # IP address, depending on the data that has been provided
135
- # in the error report.
136
- class HttpRequestContext; end
137
-
138
- # Indicates a location in the source code of the service for which errors are
139
- # reported. `functionName` must be provided by the application when reporting
140
- # an error, unless the error report contains a `message` with a supported
141
- # exception stack trace. All fields are optional for the later case.
142
- # @!attribute [rw] file_path
143
- # @return [String]
144
- # The source code filename, which can include a truncated relative
145
- # path, or a full path from a production machine.
146
- # @!attribute [rw] line_number
147
- # @return [Integer]
148
- # 1-based. 0 indicates that the line number is unknown.
149
- # @!attribute [rw] function_name
150
- # @return [String]
151
- # Human-readable name of a function or method.
152
- # The value can include optional context like the class or package name.
153
- # For example, `my.package.MyClass.method` in case of Java.
154
- class SourceLocation; end
155
- end
156
- end
157
- end
158
- end
@@ -1,41 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Devtools
18
- module Clouderrorreporting
19
- module V1beta1
20
- # A request to return an individual group.
21
- # @!attribute [rw] group_name
22
- # @return [String]
23
- # Required. The group resource name. Written as
24
- # <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
25
- # Call
26
- # <a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
27
- # <code>groupStats.list</code></a> to return a list of groups belonging to
28
- # this project.
29
- #
30
- # Example: <code>projects/my-project-123/groups/my-group</code>
31
- class GetGroupRequest; end
32
-
33
- # A request to replace the existing data for the given group.
34
- # @!attribute [rw] group
35
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
36
- # Required. The group which replaces the resource on the server.
37
- class UpdateGroupRequest; end
38
- end
39
- end
40
- end
41
- end
@@ -1,314 +0,0 @@
1
- # Copyright 2020 Google LLC
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # https://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
-
16
- module Google
17
- module Devtools
18
- module Clouderrorreporting
19
- module V1beta1
20
- # Specifies a set of `ErrorGroupStats` to return.
21
- # @!attribute [rw] project_name
22
- # @return [String]
23
- # Required. The resource name of the Google Cloud Platform project. Written
24
- # as <code>projects/</code> plus the
25
- # <a href="https://support.google.com/cloud/answer/6158840">Google Cloud
26
- # Platform project ID</a>.
27
- #
28
- # Example: <code>projects/my-project-123</code>.
29
- # @!attribute [rw] group_id
30
- # @return [Array<String>]
31
- # Optional. List all <code>ErrorGroupStats</code> with these IDs.
32
- # @!attribute [rw] service_filter
33
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ServiceContextFilter]
34
- # Optional. List only <code>ErrorGroupStats</code> which belong to a service
35
- # context that matches the filter.
36
- # Data for all service contexts is returned if this field is not specified.
37
- # @!attribute [rw] time_range
38
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
39
- # Optional. List data for the given time range.
40
- # If not set, a default time range is used. The field
41
- # <code>time_range_begin</code> in the response will specify the beginning
42
- # of this time range.
43
- # Only <code>ErrorGroupStats</code> with a non-zero count in the given time
44
- # range are returned, unless the request contains an explicit
45
- # <code>group_id</code> list. If a <code>group_id</code> list is given, also
46
- # <code>ErrorGroupStats</code> with zero occurrences are returned.
47
- # @!attribute [rw] timed_count_duration
48
- # @return [Google::Protobuf::Duration]
49
- # Optional. The preferred duration for a single returned `TimedCount`.
50
- # If not set, no timed counts are returned.
51
- # @!attribute [rw] alignment
52
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::TimedCountAlignment]
53
- # Optional. The alignment of the timed counts to be returned.
54
- # Default is `ALIGNMENT_EQUAL_AT_END`.
55
- # @!attribute [rw] alignment_time
56
- # @return [Google::Protobuf::Timestamp]
57
- # Optional. Time where the timed counts shall be aligned if rounded
58
- # alignment is chosen. Default is 00:00 UTC.
59
- # @!attribute [rw] order
60
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupOrder]
61
- # Optional. The sort order in which the results are returned.
62
- # Default is `COUNT_DESC`.
63
- # @!attribute [rw] page_size
64
- # @return [Integer]
65
- # Optional. The maximum number of results to return per response.
66
- # Default is 20.
67
- # @!attribute [rw] page_token
68
- # @return [String]
69
- # Optional. A `next_page_token` provided by a previous response. To view
70
- # additional results, pass this token along with the identical query
71
- # parameters as the first request.
72
- class ListGroupStatsRequest; end
73
-
74
- # Contains a set of requested error group stats.
75
- # @!attribute [rw] error_group_stats
76
- # @return [Array<Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats>]
77
- # The error group stats which match the given request.
78
- # @!attribute [rw] next_page_token
79
- # @return [String]
80
- # If non-empty, more results are available.
81
- # Pass this token, along with the same query parameters as the first
82
- # request, to view the next page of results.
83
- # @!attribute [rw] time_range_begin
84
- # @return [Google::Protobuf::Timestamp]
85
- # The timestamp specifies the start time to which the request was restricted.
86
- # The start time is set based on the requested time range. It may be adjusted
87
- # to a later time if a project has exceeded the storage quota and older data
88
- # has been deleted.
89
- class ListGroupStatsResponse; end
90
-
91
- # Data extracted for a specific group based on certain filter criteria,
92
- # such as a given time period and/or service filter.
93
- # @!attribute [rw] group
94
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
95
- # Group data that is independent of the filter criteria.
96
- # @!attribute [rw] count
97
- # @return [Integer]
98
- # Approximate total number of events in the given group that match
99
- # the filter criteria.
100
- # @!attribute [rw] affected_users_count
101
- # @return [Integer]
102
- # Approximate number of affected users in the given group that
103
- # match the filter criteria.
104
- # Users are distinguished by data in the `ErrorContext` of the
105
- # individual error events, such as their login name or their remote
106
- # IP address in case of HTTP requests.
107
- # The number of affected users can be zero even if the number of
108
- # errors is non-zero if no data was provided from which the
109
- # affected user could be deduced.
110
- # Users are counted based on data in the request
111
- # context that was provided in the error report. If more users are
112
- # implicitly affected, such as due to a crash of the whole service,
113
- # this is not reflected here.
114
- # @!attribute [rw] timed_counts
115
- # @return [Array<Google::Devtools::Clouderrorreporting::V1beta1::TimedCount>]
116
- # Approximate number of occurrences over time.
117
- # Timed counts returned by ListGroups are guaranteed to be:
118
- #
119
- # * Inside the requested time interval
120
- # * Non-overlapping, and
121
- # * Ordered by ascending time.
122
- # @!attribute [rw] first_seen_time
123
- # @return [Google::Protobuf::Timestamp]
124
- # Approximate first occurrence that was ever seen for this group
125
- # and which matches the given filter criteria, ignoring the
126
- # time_range that was specified in the request.
127
- # @!attribute [rw] last_seen_time
128
- # @return [Google::Protobuf::Timestamp]
129
- # Approximate last occurrence that was ever seen for this group and
130
- # which matches the given filter criteria, ignoring the time_range
131
- # that was specified in the request.
132
- # @!attribute [rw] affected_services
133
- # @return [Array<Google::Devtools::Clouderrorreporting::V1beta1::ServiceContext>]
134
- # Service contexts with a non-zero error count for the given filter
135
- # criteria. This list can be truncated if multiple services are affected.
136
- # Refer to `num_affected_services` for the total count.
137
- # @!attribute [rw] num_affected_services
138
- # @return [Integer]
139
- # The total number of services with a non-zero error count for the given
140
- # filter criteria.
141
- # @!attribute [rw] representative
142
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent]
143
- # An arbitrary event that is chosen as representative for the whole group.
144
- # The representative event is intended to be used as a quick preview for
145
- # the whole group. Events in the group are usually sufficiently similar
146
- # to each other such that showing an arbitrary representative provides
147
- # insight into the characteristics of the group as a whole.
148
- class ErrorGroupStats; end
149
-
150
- # The number of errors in a given time period.
151
- # All numbers are approximate since the error events are sampled
152
- # before counting them.
153
- # @!attribute [rw] count
154
- # @return [Integer]
155
- # Approximate number of occurrences in the given time period.
156
- # @!attribute [rw] start_time
157
- # @return [Google::Protobuf::Timestamp]
158
- # Start of the time period to which `count` refers (included).
159
- # @!attribute [rw] end_time
160
- # @return [Google::Protobuf::Timestamp]
161
- # End of the time period to which `count` refers (excluded).
162
- class TimedCount; end
163
-
164
- # Specifies a set of error events to return.
165
- # @!attribute [rw] project_name
166
- # @return [String]
167
- # Required. The resource name of the Google Cloud Platform project. Written
168
- # as `projects/` plus the
169
- # [Google Cloud Platform project
170
- # ID](https://support.google.com/cloud/answer/6158840).
171
- # Example: `projects/my-project-123`.
172
- # @!attribute [rw] group_id
173
- # @return [String]
174
- # Required. The group for which events shall be returned.
175
- # @!attribute [rw] service_filter
176
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::ServiceContextFilter]
177
- # Optional. List only ErrorGroups which belong to a service context that
178
- # matches the filter.
179
- # Data for all service contexts is returned if this field is not specified.
180
- # @!attribute [rw] time_range
181
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange]
182
- # Optional. List only data for the given time range.
183
- # If not set a default time range is used. The field time_range_begin
184
- # in the response will specify the beginning of this time range.
185
- # @!attribute [rw] page_size
186
- # @return [Integer]
187
- # Optional. The maximum number of results to return per response.
188
- # @!attribute [rw] page_token
189
- # @return [String]
190
- # Optional. A `next_page_token` provided by a previous response.
191
- class ListEventsRequest; end
192
-
193
- # Contains a set of requested error events.
194
- # @!attribute [rw] error_events
195
- # @return [Array<Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent>]
196
- # The error events which match the given request.
197
- # @!attribute [rw] next_page_token
198
- # @return [String]
199
- # If non-empty, more results are available.
200
- # Pass this token, along with the same query parameters as the first
201
- # request, to view the next page of results.
202
- # @!attribute [rw] time_range_begin
203
- # @return [Google::Protobuf::Timestamp]
204
- # The timestamp specifies the start time to which the request was restricted.
205
- class ListEventsResponse; end
206
-
207
- # Requests might be rejected or the resulting timed count durations might be
208
- # adjusted for lower durations.
209
- # @!attribute [rw] period
210
- # @return [Google::Devtools::Clouderrorreporting::V1beta1::QueryTimeRange::Period]
211
- # Restricts the query to the specified time range.
212
- class QueryTimeRange
213
- # The supported time ranges.
214
- module Period
215
- # Do not use.
216
- PERIOD_UNSPECIFIED = 0
217
-
218
- # Retrieve data for the last hour.
219
- # Recommended minimum timed count duration: 1 min.
220
- PERIOD_1_HOUR = 1
221
-
222
- # Retrieve data for the last 6 hours.
223
- # Recommended minimum timed count duration: 10 min.
224
- PERIOD_6_HOURS = 2
225
-
226
- # Retrieve data for the last day.
227
- # Recommended minimum timed count duration: 1 hour.
228
- PERIOD_1_DAY = 3
229
-
230
- # Retrieve data for the last week.
231
- # Recommended minimum timed count duration: 6 hours.
232
- PERIOD_1_WEEK = 4
233
-
234
- # Retrieve data for the last 30 days.
235
- # Recommended minimum timed count duration: 1 day.
236
- PERIOD_30_DAYS = 5
237
- end
238
- end
239
-
240
- # Specifies criteria for filtering a subset of service contexts.
241
- # The fields in the filter correspond to the fields in `ServiceContext`.
242
- # Only exact, case-sensitive matches are supported.
243
- # If a field is unset or empty, it matches arbitrary values.
244
- # @!attribute [rw] service
245
- # @return [String]
246
- # Optional. The exact value to match against
247
- # [`ServiceContext.service`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service).
248
- # @!attribute [rw] version
249
- # @return [String]
250
- # Optional. The exact value to match against
251
- # [`ServiceContext.version`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version).
252
- # @!attribute [rw] resource_type
253
- # @return [String]
254
- # Optional. The exact value to match against
255
- # [`ServiceContext.resource_type`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
256
- class ServiceContextFilter; end
257
-
258
- # Deletes all events in the project.
259
- # @!attribute [rw] project_name
260
- # @return [String]
261
- # Required. The resource name of the Google Cloud Platform project. Written
262
- # as `projects/` plus the
263
- # [Google Cloud Platform project
264
- # ID](https://support.google.com/cloud/answer/6158840).
265
- # Example: `projects/my-project-123`.
266
- class DeleteEventsRequest; end
267
-
268
- # Response message for deleting error events.
269
- class DeleteEventsResponse; end
270
-
271
- # A sorting order of error groups.
272
- module ErrorGroupOrder
273
- # No group order specified.
274
- GROUP_ORDER_UNSPECIFIED = 0
275
-
276
- # Total count of errors in the given time window in descending order.
277
- COUNT_DESC = 1
278
-
279
- # Timestamp when the group was last seen in the given time window
280
- # in descending order.
281
- LAST_SEEN_DESC = 2
282
-
283
- # Timestamp when the group was created in descending order.
284
- CREATED_DESC = 3
285
-
286
- # Number of affected users in the given time window in descending order.
287
- AFFECTED_USERS_DESC = 4
288
- end
289
-
290
- # Specifies how the time periods of error group counts are aligned.
291
- module TimedCountAlignment
292
- # No alignment specified.
293
- ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0
294
-
295
- # The time periods shall be consecutive, have width equal to the
296
- # requested duration, and be aligned at the `alignment_time` provided in
297
- # the request.
298
- # The `alignment_time` does not have to be inside the query period but
299
- # even if it is outside, only time periods are returned which overlap
300
- # with the query period.
301
- # A rounded alignment will typically result in a
302
- # different size of the first or the last time period.
303
- ALIGNMENT_EQUAL_ROUNDED = 1
304
-
305
- # The time periods shall be consecutive, have width equal to the
306
- # requested duration, and be aligned at the end of the requested time
307
- # period. This can result in a different size of the
308
- # first time period.
309
- ALIGNMENT_EQUAL_AT_END = 2
310
- end
311
- end
312
- end
313
- end
314
- end