google-cloud-logging-v2 0.1.2 → 0.4.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.
- checksums.yaml +4 -4
- data/README.md +64 -0
- data/lib/google/cloud/logging/v2.rb +3 -0
- data/lib/google/cloud/logging/v2/config_service/client.rb +677 -6
- data/lib/google/cloud/logging/v2/config_service/paths.rb +81 -0
- data/lib/google/cloud/logging/v2/logging_service/client.rb +95 -4
- data/lib/google/cloud/logging/v2/metrics_service/client.rb +9 -3
- data/lib/google/cloud/logging/v2/version.rb +1 -1
- data/lib/google/logging/v2/logging_config_pb.rb +55 -0
- data/lib/google/logging/v2/logging_config_services_pb.rb +40 -18
- data/lib/google/logging/v2/logging_metrics_services_pb.rb +5 -5
- data/lib/google/logging/v2/logging_pb.rb +23 -0
- data/lib/google/logging/v2/logging_services_pb.rb +8 -5
- data/proto_docs/google/api/field_behavior.rb +6 -0
- data/proto_docs/google/api/resource.rb +50 -14
- data/proto_docs/google/logging/type/http_request.rb +4 -2
- data/proto_docs/google/logging/v2/logging.rb +99 -0
- data/proto_docs/google/logging/v2/logging_config.rb +215 -8
- data/proto_docs/google/logging/v2/logging_metrics.rb +2 -2
- data/proto_docs/google/protobuf/any.rb +5 -2
- data/proto_docs/google/protobuf/timestamp.rb +10 -1
- metadata +7 -4
@@ -34,15 +34,15 @@ module Google
|
|
34
34
|
self.service_name = 'google.logging.v2.MetricsServiceV2'
|
35
35
|
|
36
36
|
# Lists logs-based metrics.
|
37
|
-
rpc :ListLogMetrics, Google::Cloud::Logging::V2::ListLogMetricsRequest, Google::Cloud::Logging::V2::ListLogMetricsResponse
|
37
|
+
rpc :ListLogMetrics, ::Google::Cloud::Logging::V2::ListLogMetricsRequest, ::Google::Cloud::Logging::V2::ListLogMetricsResponse
|
38
38
|
# Gets a logs-based metric.
|
39
|
-
rpc :GetLogMetric, Google::Cloud::Logging::V2::GetLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
39
|
+
rpc :GetLogMetric, ::Google::Cloud::Logging::V2::GetLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
40
40
|
# Creates a logs-based metric.
|
41
|
-
rpc :CreateLogMetric, Google::Cloud::Logging::V2::CreateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
41
|
+
rpc :CreateLogMetric, ::Google::Cloud::Logging::V2::CreateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
42
42
|
# Creates or updates a logs-based metric.
|
43
|
-
rpc :UpdateLogMetric, Google::Cloud::Logging::V2::UpdateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
43
|
+
rpc :UpdateLogMetric, ::Google::Cloud::Logging::V2::UpdateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
44
44
|
# Deletes a logs-based metric.
|
45
|
-
rpc :DeleteLogMetric, Google::Cloud::Logging::V2::DeleteLogMetricRequest, Google::Protobuf::Empty
|
45
|
+
rpc :DeleteLogMetric, ::Google::Cloud::Logging::V2::DeleteLogMetricRequest, ::Google::Protobuf::Empty
|
46
46
|
end
|
47
47
|
|
48
48
|
Stub = Service.rpc_stub_class
|
@@ -56,11 +56,30 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
56
56
|
optional :parent, :string, 1
|
57
57
|
optional :page_size, :int32, 2
|
58
58
|
optional :page_token, :string, 3
|
59
|
+
repeated :resource_names, :string, 8
|
59
60
|
end
|
60
61
|
add_message "google.logging.v2.ListLogsResponse" do
|
61
62
|
repeated :log_names, :string, 3
|
62
63
|
optional :next_page_token, :string, 2
|
63
64
|
end
|
65
|
+
add_message "google.logging.v2.TailLogEntriesRequest" do
|
66
|
+
repeated :resource_names, :string, 1
|
67
|
+
optional :filter, :string, 2
|
68
|
+
optional :buffer_window, :message, 3, "google.protobuf.Duration"
|
69
|
+
end
|
70
|
+
add_message "google.logging.v2.TailLogEntriesResponse" do
|
71
|
+
repeated :entries, :message, 1, "google.logging.v2.LogEntry"
|
72
|
+
repeated :suppression_info, :message, 2, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo"
|
73
|
+
end
|
74
|
+
add_message "google.logging.v2.TailLogEntriesResponse.SuppressionInfo" do
|
75
|
+
optional :reason, :enum, 1, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason"
|
76
|
+
optional :suppressed_count, :int32, 2
|
77
|
+
end
|
78
|
+
add_enum "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason" do
|
79
|
+
value :REASON_UNSPECIFIED, 0
|
80
|
+
value :RATE_LIMIT, 1
|
81
|
+
value :NOT_CONSUMED, 2
|
82
|
+
end
|
64
83
|
end
|
65
84
|
end
|
66
85
|
|
@@ -78,6 +97,10 @@ module Google
|
|
78
97
|
ListMonitoredResourceDescriptorsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListMonitoredResourceDescriptorsResponse").msgclass
|
79
98
|
ListLogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsRequest").msgclass
|
80
99
|
ListLogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsResponse").msgclass
|
100
|
+
TailLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesRequest").msgclass
|
101
|
+
TailLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse").msgclass
|
102
|
+
TailLogEntriesResponse::SuppressionInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo").msgclass
|
103
|
+
TailLogEntriesResponse::SuppressionInfo::Reason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason").enummodule
|
81
104
|
end
|
82
105
|
end
|
83
106
|
end
|
@@ -37,7 +37,7 @@ module Google
|
|
37
37
|
# entries. Log entries written shortly before the delete operation might not
|
38
38
|
# be deleted. Entries received after the delete operation with a timestamp
|
39
39
|
# before the operation will be deleted.
|
40
|
-
rpc :DeleteLog, Google::Cloud::Logging::V2::DeleteLogRequest, Google::Protobuf::Empty
|
40
|
+
rpc :DeleteLog, ::Google::Cloud::Logging::V2::DeleteLogRequest, ::Google::Protobuf::Empty
|
41
41
|
# Writes log entries to Logging. This API method is the
|
42
42
|
# only way to send log entries to Logging. This method
|
43
43
|
# is used, directly or indirectly, by the Logging agent
|
@@ -45,17 +45,20 @@ module Google
|
|
45
45
|
# A single request may contain log entries for a maximum of 1000
|
46
46
|
# different resources (projects, organizations, billing accounts or
|
47
47
|
# folders)
|
48
|
-
rpc :WriteLogEntries, Google::Cloud::Logging::V2::WriteLogEntriesRequest, Google::Cloud::Logging::V2::WriteLogEntriesResponse
|
48
|
+
rpc :WriteLogEntries, ::Google::Cloud::Logging::V2::WriteLogEntriesRequest, ::Google::Cloud::Logging::V2::WriteLogEntriesResponse
|
49
49
|
# Lists log entries. Use this method to retrieve log entries that originated
|
50
50
|
# from a project/folder/organization/billing account. For ways to export log
|
51
51
|
# entries, see [Exporting
|
52
52
|
# Logs](https://cloud.google.com/logging/docs/export).
|
53
|
-
rpc :ListLogEntries, Google::Cloud::Logging::V2::ListLogEntriesRequest, Google::Cloud::Logging::V2::ListLogEntriesResponse
|
53
|
+
rpc :ListLogEntries, ::Google::Cloud::Logging::V2::ListLogEntriesRequest, ::Google::Cloud::Logging::V2::ListLogEntriesResponse
|
54
54
|
# Lists the descriptors for monitored resource types used by Logging.
|
55
|
-
rpc :ListMonitoredResourceDescriptors, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
|
55
|
+
rpc :ListMonitoredResourceDescriptors, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
|
56
56
|
# Lists the logs in projects, organizations, folders, or billing accounts.
|
57
57
|
# Only logs that have entries are listed.
|
58
|
-
rpc :ListLogs, Google::Cloud::Logging::V2::ListLogsRequest, Google::Cloud::Logging::V2::ListLogsResponse
|
58
|
+
rpc :ListLogs, ::Google::Cloud::Logging::V2::ListLogsRequest, ::Google::Cloud::Logging::V2::ListLogsResponse
|
59
|
+
# Streaming read of log entries as they are ingested. Until the stream is
|
60
|
+
# terminated, it will continue reading logs.
|
61
|
+
rpc :TailLogEntries, stream(::Google::Cloud::Logging::V2::TailLogEntriesRequest), stream(::Google::Cloud::Logging::V2::TailLogEntriesResponse)
|
59
62
|
end
|
60
63
|
|
61
64
|
Stub = Service.rpc_stub_class
|
@@ -54,6 +54,12 @@ module Google
|
|
54
54
|
# This indicates that the field may be set once in a request to create a
|
55
55
|
# resource, but may not be changed thereafter.
|
56
56
|
IMMUTABLE = 5
|
57
|
+
|
58
|
+
# Denotes that a (repeated) field is an unordered list.
|
59
|
+
# This indicates that the service may provide the elements of the list
|
60
|
+
# in any arbitrary order, rather than the order the user originally
|
61
|
+
# provided. Additionally, the list's order may or may not be stable.
|
62
|
+
UNORDERED_LIST = 6
|
57
63
|
end
|
58
64
|
end
|
59
65
|
end
|
@@ -43,12 +43,12 @@ module Google
|
|
43
43
|
#
|
44
44
|
# The ResourceDescriptor Yaml config will look like:
|
45
45
|
#
|
46
|
-
#
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
#
|
51
|
-
#
|
46
|
+
# resources:
|
47
|
+
# - type: "pubsub.googleapis.com/Topic"
|
48
|
+
# name_descriptor:
|
49
|
+
# - pattern: "projects/{project}/topics/{topic}"
|
50
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
51
|
+
# parent_name_extractor: "projects/{project}"
|
52
52
|
#
|
53
53
|
# Sometimes, resources have multiple patterns, typically because they can
|
54
54
|
# live under multiple parents.
|
@@ -183,15 +183,24 @@ module Google
|
|
183
183
|
# }
|
184
184
|
# @!attribute [rw] plural
|
185
185
|
# @return [::String]
|
186
|
-
# The plural name used in the resource name, such as
|
187
|
-
# the name of 'projects/\\{project}'
|
188
|
-
#
|
186
|
+
# The plural name used in the resource name and permission names, such as
|
187
|
+
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
188
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
|
189
|
+
# concept of the `plural` field in k8s CRD spec
|
189
190
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
191
|
+
#
|
192
|
+
# Note: The plural form is required even for singleton resources. See
|
193
|
+
# https://aip.dev/156
|
190
194
|
# @!attribute [rw] singular
|
191
195
|
# @return [::String]
|
192
196
|
# The same concept of the `singular` field in k8s CRD spec
|
193
197
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
194
198
|
# Such as "project" for the `resourcemanager.googleapis.com/Project` type.
|
199
|
+
# @!attribute [rw] style
|
200
|
+
# @return [::Array<::Google::Api::ResourceDescriptor::Style>]
|
201
|
+
# Style flag(s) for this resource.
|
202
|
+
# These indicate that a resource is expected to conform to a given
|
203
|
+
# style. See the specific style flags for additional information.
|
195
204
|
class ResourceDescriptor
|
196
205
|
include ::Google::Protobuf::MessageExts
|
197
206
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -211,6 +220,22 @@ module Google
|
|
211
220
|
# that from being necessary once there are multiple patterns.)
|
212
221
|
FUTURE_MULTI_PATTERN = 2
|
213
222
|
end
|
223
|
+
|
224
|
+
# A flag representing a specific style that a resource claims to conform to.
|
225
|
+
module Style
|
226
|
+
# The unspecified value. Do not use.
|
227
|
+
STYLE_UNSPECIFIED = 0
|
228
|
+
|
229
|
+
# This resource is intended to be "declarative-friendly".
|
230
|
+
#
|
231
|
+
# Declarative-friendly resources must be more strictly consistent, and
|
232
|
+
# setting this to true communicates to tools that this resource should
|
233
|
+
# adhere to declarative-friendly expectations.
|
234
|
+
#
|
235
|
+
# Note: This is used by the API linter (linter.aip.dev) to enable
|
236
|
+
# additional checks.
|
237
|
+
DECLARATIVE_FRIENDLY = 1
|
238
|
+
end
|
214
239
|
end
|
215
240
|
|
216
241
|
# Defines a proto annotation that describes a string field that refers to
|
@@ -226,6 +251,17 @@ module Google
|
|
226
251
|
# type: "pubsub.googleapis.com/Topic"
|
227
252
|
# }];
|
228
253
|
# }
|
254
|
+
#
|
255
|
+
# Occasionally, a field may reference an arbitrary resource. In this case,
|
256
|
+
# APIs use the special value * in their resource reference.
|
257
|
+
#
|
258
|
+
# Example:
|
259
|
+
#
|
260
|
+
# message GetIamPolicyRequest {
|
261
|
+
# string resource = 2 [(google.api.resource_reference) = {
|
262
|
+
# type: "*"
|
263
|
+
# }];
|
264
|
+
# }
|
229
265
|
# @!attribute [rw] child_type
|
230
266
|
# @return [::String]
|
231
267
|
# The resource type of a child collection that the annotated field
|
@@ -234,11 +270,11 @@ module Google
|
|
234
270
|
#
|
235
271
|
# Example:
|
236
272
|
#
|
237
|
-
#
|
238
|
-
#
|
239
|
-
#
|
240
|
-
#
|
241
|
-
#
|
273
|
+
# message ListLogEntriesRequest {
|
274
|
+
# string parent = 1 [(google.api.resource_reference) = {
|
275
|
+
# child_type: "logging.googleapis.com/LogEntry"
|
276
|
+
# };
|
277
|
+
# }
|
242
278
|
class ResourceReference
|
243
279
|
include ::Google::Protobuf::MessageExts
|
244
280
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -52,11 +52,13 @@ module Google
|
|
52
52
|
# @!attribute [rw] remote_ip
|
53
53
|
# @return [::String]
|
54
54
|
# The IP address (IPv4 or IPv6) of the client that issued the HTTP
|
55
|
-
# request.
|
55
|
+
# request. This field can include port information. Examples:
|
56
|
+
# `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
|
56
57
|
# @!attribute [rw] server_ip
|
57
58
|
# @return [::String]
|
58
59
|
# The IP address (IPv4 or IPv6) of the origin server that the request was
|
59
|
-
# sent to.
|
60
|
+
# sent to. This field can include port information. Examples:
|
61
|
+
# `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
|
60
62
|
# @!attribute [rw] referer
|
61
63
|
# @return [::String]
|
62
64
|
# The referer URL of the request, as defined in
|
@@ -169,6 +169,11 @@ module Google
|
|
169
169
|
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
170
170
|
# "folders/[FOLDER_ID]"
|
171
171
|
#
|
172
|
+
# May alternatively be one or more views
|
173
|
+
# projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
174
|
+
# organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
175
|
+
# billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
176
|
+
# folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
172
177
|
#
|
173
178
|
# Projects listed in the `project_ids` field are added to this list.
|
174
179
|
# @!attribute [rw] filter
|
@@ -279,6 +284,19 @@ module Google
|
|
279
284
|
# preceding call to this method. `pageToken` must be the value of
|
280
285
|
# `nextPageToken` from the previous response. The values of other method
|
281
286
|
# parameters should be identical to those in the previous call.
|
287
|
+
# @!attribute [rw] resource_names
|
288
|
+
# @return [::Array<::String>]
|
289
|
+
# Optional. The resource name that owns the logs:
|
290
|
+
# projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
291
|
+
# organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
292
|
+
# billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
293
|
+
# folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
294
|
+
#
|
295
|
+
# To support legacy queries, it could also be:
|
296
|
+
# "projects/[PROJECT_ID]"
|
297
|
+
# "organizations/[ORGANIZATION_ID]"
|
298
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
299
|
+
# "folders/[FOLDER_ID]"
|
282
300
|
class ListLogsRequest
|
283
301
|
include ::Google::Protobuf::MessageExts
|
284
302
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -299,6 +317,87 @@ module Google
|
|
299
317
|
include ::Google::Protobuf::MessageExts
|
300
318
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
301
319
|
end
|
320
|
+
|
321
|
+
# The parameters to `TailLogEntries`.
|
322
|
+
# @!attribute [rw] resource_names
|
323
|
+
# @return [::Array<::String>]
|
324
|
+
# Required. Name of a parent resource from which to retrieve log entries:
|
325
|
+
#
|
326
|
+
# "projects/[PROJECT_ID]"
|
327
|
+
# "organizations/[ORGANIZATION_ID]"
|
328
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
329
|
+
# "folders/[FOLDER_ID]"
|
330
|
+
#
|
331
|
+
# May alternatively be one or more views:
|
332
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
333
|
+
# "organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
334
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
335
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
336
|
+
# @!attribute [rw] filter
|
337
|
+
# @return [::String]
|
338
|
+
# Optional. A filter that chooses which log entries to return. See [Advanced
|
339
|
+
# Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
|
340
|
+
# Only log entries that match the filter are returned. An empty filter
|
341
|
+
# matches all log entries in the resources listed in `resource_names`.
|
342
|
+
# Referencing a parent resource that is not in `resource_names` will cause
|
343
|
+
# the filter to return no results. The maximum length of the filter is 20000
|
344
|
+
# characters.
|
345
|
+
# @!attribute [rw] buffer_window
|
346
|
+
# @return [::Google::Protobuf::Duration]
|
347
|
+
# Optional. The amount of time to buffer log entries at the server before
|
348
|
+
# being returned to prevent out of order results due to late arriving log
|
349
|
+
# entries. Valid values are between 0-60000 milliseconds. Defaults to 2000
|
350
|
+
# milliseconds.
|
351
|
+
class TailLogEntriesRequest
|
352
|
+
include ::Google::Protobuf::MessageExts
|
353
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
354
|
+
end
|
355
|
+
|
356
|
+
# Result returned from `TailLogEntries`.
|
357
|
+
# @!attribute [rw] entries
|
358
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogEntry>]
|
359
|
+
# A list of log entries. Each response in the stream will order entries with
|
360
|
+
# increasing values of `LogEntry.timestamp`. Ordering is not guaranteed
|
361
|
+
# between separate responses.
|
362
|
+
# @!attribute [rw] suppression_info
|
363
|
+
# @return [::Array<::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo>]
|
364
|
+
# If entries that otherwise would have been included in the session were not
|
365
|
+
# sent back to the client, counts of relevant entries omitted from the
|
366
|
+
# session with the reason that they were not included. There will be at most
|
367
|
+
# one of each reason per response. The counts represent the number of
|
368
|
+
# suppressed entries since the last streamed response.
|
369
|
+
class TailLogEntriesResponse
|
370
|
+
include ::Google::Protobuf::MessageExts
|
371
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
372
|
+
|
373
|
+
# Information about entries that were omitted from the session.
|
374
|
+
# @!attribute [rw] reason
|
375
|
+
# @return [::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo::Reason]
|
376
|
+
# The reason that entries were omitted from the session.
|
377
|
+
# @!attribute [rw] suppressed_count
|
378
|
+
# @return [::Integer]
|
379
|
+
# A lower bound on the count of entries omitted due to `reason`.
|
380
|
+
class SuppressionInfo
|
381
|
+
include ::Google::Protobuf::MessageExts
|
382
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
383
|
+
|
384
|
+
# An indicator of why entries were omitted.
|
385
|
+
module Reason
|
386
|
+
# Unexpected default.
|
387
|
+
REASON_UNSPECIFIED = 0
|
388
|
+
|
389
|
+
# Indicates suppression occurred due to relevant entries being
|
390
|
+
# received in excess of rate limits. For quotas and limits, see
|
391
|
+
# [Logging API quotas and
|
392
|
+
# limits](https://cloud.google.com/logging/quotas#api-limits).
|
393
|
+
RATE_LIMIT = 1
|
394
|
+
|
395
|
+
# Indicates suppression occurred due to the client not consuming
|
396
|
+
# responses quickly enough.
|
397
|
+
NOT_CONSUMED = 2
|
398
|
+
end
|
399
|
+
end
|
400
|
+
end
|
302
401
|
end
|
303
402
|
end
|
304
403
|
end
|
@@ -21,7 +21,7 @@ module Google
|
|
21
21
|
module Cloud
|
22
22
|
module Logging
|
23
23
|
module V2
|
24
|
-
# Describes a repository of logs
|
24
|
+
# Describes a repository of logs.
|
25
25
|
# @!attribute [rw] name
|
26
26
|
# @return [::String]
|
27
27
|
# The resource name of the bucket.
|
@@ -29,7 +29,6 @@ module Google
|
|
29
29
|
# "projects/my-project-id/locations/my-location/buckets/my-bucket-id The
|
30
30
|
# supported locations are:
|
31
31
|
# "global"
|
32
|
-
# "us-central1"
|
33
32
|
#
|
34
33
|
# For the location of `global` it is unspecified where logs are actually
|
35
34
|
# stored.
|
@@ -50,6 +49,11 @@ module Google
|
|
50
49
|
# will automatically be deleted. The minimum retention period is 1 day.
|
51
50
|
# If this value is set to zero at bucket creation time, the default time of
|
52
51
|
# 30 days will be used.
|
52
|
+
# @!attribute [rw] locked
|
53
|
+
# @return [::Boolean]
|
54
|
+
# Whether the bucket has been locked.
|
55
|
+
# The retention period on a locked bucket may not be changed.
|
56
|
+
# Locked buckets may only be deleted if they are empty.
|
53
57
|
# @!attribute [r] lifecycle_state
|
54
58
|
# @return [::Google::Cloud::Logging::V2::LifecycleState]
|
55
59
|
# Output only. The bucket lifecycle state.
|
@@ -58,6 +62,36 @@ module Google
|
|
58
62
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
59
63
|
end
|
60
64
|
|
65
|
+
# Describes a view over logs in a bucket.
|
66
|
+
# @!attribute [rw] name
|
67
|
+
# @return [::String]
|
68
|
+
# The resource name of the view.
|
69
|
+
# For example
|
70
|
+
# "projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
|
71
|
+
# @!attribute [rw] description
|
72
|
+
# @return [::String]
|
73
|
+
# Describes this view.
|
74
|
+
# @!attribute [r] create_time
|
75
|
+
# @return [::Google::Protobuf::Timestamp]
|
76
|
+
# Output only. The creation timestamp of the view.
|
77
|
+
# @!attribute [r] update_time
|
78
|
+
# @return [::Google::Protobuf::Timestamp]
|
79
|
+
# Output only. The last update timestamp of the view.
|
80
|
+
# @!attribute [rw] filter
|
81
|
+
# @return [::String]
|
82
|
+
# Filter that restricts which log entries in a bucket are visible in this
|
83
|
+
# view. Filters are restricted to be a logical AND of ==/!= of any of the
|
84
|
+
# following:
|
85
|
+
# originating project/folder/organization/billing account.
|
86
|
+
# resource type
|
87
|
+
# log id
|
88
|
+
# Example: SOURCE("projects/myproject") AND resource.type = "gce_instance"
|
89
|
+
# AND LOG_ID("stdout")
|
90
|
+
class LogView
|
91
|
+
include ::Google::Protobuf::MessageExts
|
92
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
93
|
+
end
|
94
|
+
|
61
95
|
# Describes a sink used to export log entries to one of the following
|
62
96
|
# destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
|
63
97
|
# Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
|
@@ -99,12 +133,17 @@ module Google
|
|
99
133
|
# @return [::Boolean]
|
100
134
|
# Optional. If set to True, then this sink is disabled and it does not
|
101
135
|
# export any log entries.
|
136
|
+
# @!attribute [rw] exclusions
|
137
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogExclusion>]
|
138
|
+
# Optional. Log entries that match any of the exclusion filters will not be exported.
|
139
|
+
# If a log entry is matched by both `filter` and one of `exclusion_filters`
|
140
|
+
# it will not be exported.
|
102
141
|
# @!attribute [rw] output_version_format
|
103
142
|
# @return [::Google::Cloud::Logging::V2::LogSink::VersionFormat]
|
104
143
|
# Deprecated. This field is unused.
|
105
144
|
# @!attribute [r] writer_identity
|
106
145
|
# @return [::String]
|
107
|
-
# Output only. An IAM identity
|
146
|
+
# Output only. An IAM identity—a service account or group—under which Logging
|
108
147
|
# writes the exported log entries to the sink's destination. This field is
|
109
148
|
# set by {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#create_sink sinks.create} and
|
110
149
|
# {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_sink sinks.update} based on the
|
@@ -185,7 +224,7 @@ module Google
|
|
185
224
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
186
225
|
end
|
187
226
|
|
188
|
-
# The parameters to `ListBuckets
|
227
|
+
# The parameters to `ListBuckets`.
|
189
228
|
# @!attribute [rw] parent
|
190
229
|
# @return [::String]
|
191
230
|
# Required. The parent resource whose buckets are to be listed:
|
@@ -214,7 +253,7 @@ module Google
|
|
214
253
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
215
254
|
end
|
216
255
|
|
217
|
-
# The response from ListBuckets
|
256
|
+
# The response from ListBuckets.
|
218
257
|
# @!attribute [rw] buckets
|
219
258
|
# @return [::Array<::Google::Cloud::Logging::V2::LogBucket>]
|
220
259
|
# A list of buckets.
|
@@ -228,7 +267,30 @@ module Google
|
|
228
267
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
229
268
|
end
|
230
269
|
|
231
|
-
# The parameters to `
|
270
|
+
# The parameters to `CreateBucket`.
|
271
|
+
# @!attribute [rw] parent
|
272
|
+
# @return [::String]
|
273
|
+
# Required. The resource in which to create the bucket:
|
274
|
+
#
|
275
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
|
276
|
+
#
|
277
|
+
# Example: `"projects/my-logging-project/locations/global"`
|
278
|
+
# @!attribute [rw] bucket_id
|
279
|
+
# @return [::String]
|
280
|
+
# Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
|
281
|
+
# limited to 100 characters and can include only letters, digits,
|
282
|
+
# underscores, hyphens, and periods.
|
283
|
+
# @!attribute [rw] bucket
|
284
|
+
# @return [::Google::Cloud::Logging::V2::LogBucket]
|
285
|
+
# Required. The new bucket. The region specified in the new bucket must be compliant
|
286
|
+
# with any Location Restriction Org Policy. The name field in the bucket is
|
287
|
+
# ignored.
|
288
|
+
class CreateBucketRequest
|
289
|
+
include ::Google::Protobuf::MessageExts
|
290
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
291
|
+
end
|
292
|
+
|
293
|
+
# The parameters to `UpdateBucket`.
|
232
294
|
# @!attribute [rw] name
|
233
295
|
# @return [::String]
|
234
296
|
# Required. The full resource name of the bucket to update.
|
@@ -260,7 +322,7 @@ module Google
|
|
260
322
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
261
323
|
end
|
262
324
|
|
263
|
-
# The parameters to `GetBucket
|
325
|
+
# The parameters to `GetBucket`.
|
264
326
|
# @!attribute [rw] name
|
265
327
|
# @return [::String]
|
266
328
|
# Required. The resource name of the bucket:
|
@@ -277,6 +339,151 @@ module Google
|
|
277
339
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
278
340
|
end
|
279
341
|
|
342
|
+
# The parameters to `DeleteBucket`.
|
343
|
+
# @!attribute [rw] name
|
344
|
+
# @return [::String]
|
345
|
+
# Required. The full resource name of the bucket to delete.
|
346
|
+
#
|
347
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
348
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
349
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
350
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
351
|
+
#
|
352
|
+
# Example:
|
353
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
|
354
|
+
class DeleteBucketRequest
|
355
|
+
include ::Google::Protobuf::MessageExts
|
356
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
357
|
+
end
|
358
|
+
|
359
|
+
# The parameters to `UndeleteBucket`.
|
360
|
+
# @!attribute [rw] name
|
361
|
+
# @return [::String]
|
362
|
+
# Required. The full resource name of the bucket to undelete.
|
363
|
+
#
|
364
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
365
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
366
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
367
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
368
|
+
#
|
369
|
+
# Example:
|
370
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
|
371
|
+
class UndeleteBucketRequest
|
372
|
+
include ::Google::Protobuf::MessageExts
|
373
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
374
|
+
end
|
375
|
+
|
376
|
+
# The parameters to `ListViews`.
|
377
|
+
# @!attribute [rw] parent
|
378
|
+
# @return [::String]
|
379
|
+
# Required. The bucket whose views are to be listed:
|
380
|
+
#
|
381
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
382
|
+
# @!attribute [rw] page_token
|
383
|
+
# @return [::String]
|
384
|
+
# Optional. If present, then retrieve the next batch of results from the
|
385
|
+
# preceding call to this method. `pageToken` must be the value of
|
386
|
+
# `nextPageToken` from the previous response. The values of other method
|
387
|
+
# parameters should be identical to those in the previous call.
|
388
|
+
# @!attribute [rw] page_size
|
389
|
+
# @return [::Integer]
|
390
|
+
# Optional. The maximum number of results to return from this request.
|
391
|
+
# Non-positive values are ignored. The presence of `nextPageToken` in the
|
392
|
+
# response indicates that more results might be available.
|
393
|
+
class ListViewsRequest
|
394
|
+
include ::Google::Protobuf::MessageExts
|
395
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
396
|
+
end
|
397
|
+
|
398
|
+
# The response from ListViews.
|
399
|
+
# @!attribute [rw] views
|
400
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogView>]
|
401
|
+
# A list of views.
|
402
|
+
# @!attribute [rw] next_page_token
|
403
|
+
# @return [::String]
|
404
|
+
# If there might be more results than appear in this response, then
|
405
|
+
# `nextPageToken` is included. To get the next set of results, call the same
|
406
|
+
# method again using the value of `nextPageToken` as `pageToken`.
|
407
|
+
class ListViewsResponse
|
408
|
+
include ::Google::Protobuf::MessageExts
|
409
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
410
|
+
end
|
411
|
+
|
412
|
+
# The parameters to `CreateView`.
|
413
|
+
# @!attribute [rw] parent
|
414
|
+
# @return [::String]
|
415
|
+
# Required. The bucket in which to create the view
|
416
|
+
#
|
417
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
418
|
+
#
|
419
|
+
# Example:
|
420
|
+
# `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
|
421
|
+
# @!attribute [rw] view_id
|
422
|
+
# @return [::String]
|
423
|
+
# Required. The id to use for this view.
|
424
|
+
# @!attribute [rw] view
|
425
|
+
# @return [::Google::Cloud::Logging::V2::LogView]
|
426
|
+
# Required. The new view.
|
427
|
+
class CreateViewRequest
|
428
|
+
include ::Google::Protobuf::MessageExts
|
429
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
430
|
+
end
|
431
|
+
|
432
|
+
# The parameters to `UpdateView`.
|
433
|
+
# @!attribute [rw] name
|
434
|
+
# @return [::String]
|
435
|
+
# Required. The full resource name of the view to update
|
436
|
+
#
|
437
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
438
|
+
#
|
439
|
+
# Example:
|
440
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
441
|
+
# @!attribute [rw] view
|
442
|
+
# @return [::Google::Cloud::Logging::V2::LogView]
|
443
|
+
# Required. The updated view.
|
444
|
+
# @!attribute [rw] update_mask
|
445
|
+
# @return [::Google::Protobuf::FieldMask]
|
446
|
+
# Optional. Field mask that specifies the fields in `view` that need
|
447
|
+
# an update. A field will be overwritten if, and only if, it is
|
448
|
+
# in the update mask. `name` and output only fields cannot be updated.
|
449
|
+
#
|
450
|
+
# For a detailed `FieldMask` definition, see
|
451
|
+
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
452
|
+
#
|
453
|
+
# Example: `updateMask=filter`.
|
454
|
+
class UpdateViewRequest
|
455
|
+
include ::Google::Protobuf::MessageExts
|
456
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
457
|
+
end
|
458
|
+
|
459
|
+
# The parameters to `GetView`.
|
460
|
+
# @!attribute [rw] name
|
461
|
+
# @return [::String]
|
462
|
+
# Required. The resource name of the policy:
|
463
|
+
#
|
464
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
465
|
+
#
|
466
|
+
# Example:
|
467
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
468
|
+
class GetViewRequest
|
469
|
+
include ::Google::Protobuf::MessageExts
|
470
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
471
|
+
end
|
472
|
+
|
473
|
+
# The parameters to `DeleteView`.
|
474
|
+
# @!attribute [rw] name
|
475
|
+
# @return [::String]
|
476
|
+
# Required. The full resource name of the view to delete:
|
477
|
+
#
|
478
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
479
|
+
#
|
480
|
+
# Example:
|
481
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
482
|
+
class DeleteViewRequest
|
483
|
+
include ::Google::Protobuf::MessageExts
|
484
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
485
|
+
end
|
486
|
+
|
280
487
|
# The parameters to `ListSinks`.
|
281
488
|
# @!attribute [rw] parent
|
282
489
|
# @return [::String]
|
@@ -724,7 +931,7 @@ module Google
|
|
724
931
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
725
932
|
end
|
726
933
|
|
727
|
-
# LogBucket lifecycle states
|
934
|
+
# LogBucket lifecycle states.
|
728
935
|
module LifecycleState
|
729
936
|
# Unspecified state. This is only used/useful for distinguishing
|
730
937
|
# unset values.
|