google-cloud-logging-v2 0.1.3 → 0.5.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/LICENSE.md +188 -190
- data/README.md +66 -2
- data/lib/google/cloud/logging/v2.rb +3 -0
- data/lib/google/cloud/logging/v2/config_service/client.rb +715 -44
- data/lib/google/cloud/logging/v2/config_service/paths.rb +93 -12
- data/lib/google/cloud/logging/v2/logging_service/client.rb +117 -26
- data/lib/google/cloud/logging/v2/logging_service/paths.rb +3 -3
- data/lib/google/cloud/logging/v2/metrics_service/client.rb +28 -22
- 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 +10 -7
@@ -19,14 +19,23 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
19
19
|
optional :create_time, :message, 4, "google.protobuf.Timestamp"
|
20
20
|
optional :update_time, :message, 5, "google.protobuf.Timestamp"
|
21
21
|
optional :retention_days, :int32, 11
|
22
|
+
optional :locked, :bool, 9
|
22
23
|
optional :lifecycle_state, :enum, 12, "google.logging.v2.LifecycleState"
|
23
24
|
end
|
25
|
+
add_message "google.logging.v2.LogView" do
|
26
|
+
optional :name, :string, 1
|
27
|
+
optional :description, :string, 3
|
28
|
+
optional :create_time, :message, 4, "google.protobuf.Timestamp"
|
29
|
+
optional :update_time, :message, 5, "google.protobuf.Timestamp"
|
30
|
+
optional :filter, :string, 7
|
31
|
+
end
|
24
32
|
add_message "google.logging.v2.LogSink" do
|
25
33
|
optional :name, :string, 1
|
26
34
|
optional :destination, :string, 3
|
27
35
|
optional :filter, :string, 5
|
28
36
|
optional :description, :string, 18
|
29
37
|
optional :disabled, :bool, 19
|
38
|
+
repeated :exclusions, :message, 16, "google.logging.v2.LogExclusion"
|
30
39
|
optional :output_version_format, :enum, 6, "google.logging.v2.LogSink.VersionFormat"
|
31
40
|
optional :writer_identity, :string, 8
|
32
41
|
optional :include_children, :bool, 9
|
@@ -54,6 +63,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
54
63
|
repeated :buckets, :message, 1, "google.logging.v2.LogBucket"
|
55
64
|
optional :next_page_token, :string, 2
|
56
65
|
end
|
66
|
+
add_message "google.logging.v2.CreateBucketRequest" do
|
67
|
+
optional :parent, :string, 1
|
68
|
+
optional :bucket_id, :string, 2
|
69
|
+
optional :bucket, :message, 3, "google.logging.v2.LogBucket"
|
70
|
+
end
|
57
71
|
add_message "google.logging.v2.UpdateBucketRequest" do
|
58
72
|
optional :name, :string, 1
|
59
73
|
optional :bucket, :message, 2, "google.logging.v2.LogBucket"
|
@@ -62,6 +76,37 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
62
76
|
add_message "google.logging.v2.GetBucketRequest" do
|
63
77
|
optional :name, :string, 1
|
64
78
|
end
|
79
|
+
add_message "google.logging.v2.DeleteBucketRequest" do
|
80
|
+
optional :name, :string, 1
|
81
|
+
end
|
82
|
+
add_message "google.logging.v2.UndeleteBucketRequest" do
|
83
|
+
optional :name, :string, 1
|
84
|
+
end
|
85
|
+
add_message "google.logging.v2.ListViewsRequest" do
|
86
|
+
optional :parent, :string, 1
|
87
|
+
optional :page_token, :string, 2
|
88
|
+
optional :page_size, :int32, 3
|
89
|
+
end
|
90
|
+
add_message "google.logging.v2.ListViewsResponse" do
|
91
|
+
repeated :views, :message, 1, "google.logging.v2.LogView"
|
92
|
+
optional :next_page_token, :string, 2
|
93
|
+
end
|
94
|
+
add_message "google.logging.v2.CreateViewRequest" do
|
95
|
+
optional :parent, :string, 1
|
96
|
+
optional :view_id, :string, 2
|
97
|
+
optional :view, :message, 3, "google.logging.v2.LogView"
|
98
|
+
end
|
99
|
+
add_message "google.logging.v2.UpdateViewRequest" do
|
100
|
+
optional :name, :string, 1
|
101
|
+
optional :view, :message, 2, "google.logging.v2.LogView"
|
102
|
+
optional :update_mask, :message, 4, "google.protobuf.FieldMask"
|
103
|
+
end
|
104
|
+
add_message "google.logging.v2.GetViewRequest" do
|
105
|
+
optional :name, :string, 1
|
106
|
+
end
|
107
|
+
add_message "google.logging.v2.DeleteViewRequest" do
|
108
|
+
optional :name, :string, 1
|
109
|
+
end
|
65
110
|
add_message "google.logging.v2.ListSinksRequest" do
|
66
111
|
optional :parent, :string, 1
|
67
112
|
optional :page_token, :string, 2
|
@@ -146,13 +191,23 @@ module Google
|
|
146
191
|
module Logging
|
147
192
|
module V2
|
148
193
|
LogBucket = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogBucket").msgclass
|
194
|
+
LogView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogView").msgclass
|
149
195
|
LogSink = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink").msgclass
|
150
196
|
LogSink::VersionFormat = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink.VersionFormat").enummodule
|
151
197
|
BigQueryOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BigQueryOptions").msgclass
|
152
198
|
ListBucketsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsRequest").msgclass
|
153
199
|
ListBucketsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsResponse").msgclass
|
200
|
+
CreateBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateBucketRequest").msgclass
|
154
201
|
UpdateBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateBucketRequest").msgclass
|
155
202
|
GetBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetBucketRequest").msgclass
|
203
|
+
DeleteBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteBucketRequest").msgclass
|
204
|
+
UndeleteBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UndeleteBucketRequest").msgclass
|
205
|
+
ListViewsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListViewsRequest").msgclass
|
206
|
+
ListViewsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListViewsResponse").msgclass
|
207
|
+
CreateViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateViewRequest").msgclass
|
208
|
+
UpdateViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateViewRequest").msgclass
|
209
|
+
GetViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetViewRequest").msgclass
|
210
|
+
DeleteViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteViewRequest").msgclass
|
156
211
|
ListSinksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksRequest").msgclass
|
157
212
|
ListSinksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksResponse").msgclass
|
158
213
|
GetSinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetSinkRequest").msgclass
|
@@ -33,10 +33,13 @@ module Google
|
|
33
33
|
self.unmarshal_class_method = :decode
|
34
34
|
self.service_name = 'google.logging.v2.ConfigServiceV2'
|
35
35
|
|
36
|
-
# Lists buckets
|
37
|
-
rpc :ListBuckets, Google::Cloud::Logging::V2::ListBucketsRequest, Google::Cloud::Logging::V2::ListBucketsResponse
|
38
|
-
# Gets a bucket
|
39
|
-
rpc :GetBucket, Google::Cloud::Logging::V2::GetBucketRequest, Google::Cloud::Logging::V2::LogBucket
|
36
|
+
# Lists buckets.
|
37
|
+
rpc :ListBuckets, ::Google::Cloud::Logging::V2::ListBucketsRequest, ::Google::Cloud::Logging::V2::ListBucketsResponse
|
38
|
+
# Gets a bucket.
|
39
|
+
rpc :GetBucket, ::Google::Cloud::Logging::V2::GetBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
|
40
|
+
# Creates a bucket that can be used to store log entries. Once a bucket has
|
41
|
+
# been created, the region cannot be changed.
|
42
|
+
rpc :CreateBucket, ::Google::Cloud::Logging::V2::CreateBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
|
40
43
|
# Updates a bucket. This method replaces the following fields in the
|
41
44
|
# existing bucket with values from the new bucket: `retention_period`
|
42
45
|
#
|
@@ -47,38 +50,57 @@ module Google
|
|
47
50
|
# will be returned.
|
48
51
|
#
|
49
52
|
# A buckets region may not be modified after it is created.
|
50
|
-
|
51
|
-
|
53
|
+
rpc :UpdateBucket, ::Google::Cloud::Logging::V2::UpdateBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
|
54
|
+
# Deletes a bucket.
|
55
|
+
# Moves the bucket to the DELETE_REQUESTED state. After 7 days, the
|
56
|
+
# bucket will be purged and all logs in the bucket will be permanently
|
57
|
+
# deleted.
|
58
|
+
rpc :DeleteBucket, ::Google::Cloud::Logging::V2::DeleteBucketRequest, ::Google::Protobuf::Empty
|
59
|
+
# Undeletes a bucket. A bucket that has been deleted may be undeleted within
|
60
|
+
# the grace period of 7 days.
|
61
|
+
rpc :UndeleteBucket, ::Google::Cloud::Logging::V2::UndeleteBucketRequest, ::Google::Protobuf::Empty
|
62
|
+
# Lists views on a bucket.
|
63
|
+
rpc :ListViews, ::Google::Cloud::Logging::V2::ListViewsRequest, ::Google::Cloud::Logging::V2::ListViewsResponse
|
64
|
+
# Gets a view.
|
65
|
+
rpc :GetView, ::Google::Cloud::Logging::V2::GetViewRequest, ::Google::Cloud::Logging::V2::LogView
|
66
|
+
# Creates a view over logs in a bucket. A bucket may contain a maximum of
|
67
|
+
# 50 views.
|
68
|
+
rpc :CreateView, ::Google::Cloud::Logging::V2::CreateViewRequest, ::Google::Cloud::Logging::V2::LogView
|
69
|
+
# Updates a view. This method replaces the following fields in the existing
|
70
|
+
# view with values from the new view: `filter`.
|
71
|
+
rpc :UpdateView, ::Google::Cloud::Logging::V2::UpdateViewRequest, ::Google::Cloud::Logging::V2::LogView
|
72
|
+
# Deletes a view from a bucket.
|
73
|
+
rpc :DeleteView, ::Google::Cloud::Logging::V2::DeleteViewRequest, ::Google::Protobuf::Empty
|
52
74
|
# Lists sinks.
|
53
|
-
rpc :ListSinks, Google::Cloud::Logging::V2::ListSinksRequest, Google::Cloud::Logging::V2::ListSinksResponse
|
75
|
+
rpc :ListSinks, ::Google::Cloud::Logging::V2::ListSinksRequest, ::Google::Cloud::Logging::V2::ListSinksResponse
|
54
76
|
# Gets a sink.
|
55
|
-
rpc :GetSink, Google::Cloud::Logging::V2::GetSinkRequest, Google::Cloud::Logging::V2::LogSink
|
77
|
+
rpc :GetSink, ::Google::Cloud::Logging::V2::GetSinkRequest, ::Google::Cloud::Logging::V2::LogSink
|
56
78
|
# Creates a sink that exports specified log entries to a destination. The
|
57
79
|
# export of newly-ingested log entries begins immediately, unless the sink's
|
58
80
|
# `writer_identity` is not permitted to write to the destination. A sink can
|
59
81
|
# export log entries only from the resource owning the sink.
|
60
|
-
rpc :CreateSink, Google::Cloud::Logging::V2::CreateSinkRequest, Google::Cloud::Logging::V2::LogSink
|
82
|
+
rpc :CreateSink, ::Google::Cloud::Logging::V2::CreateSinkRequest, ::Google::Cloud::Logging::V2::LogSink
|
61
83
|
# Updates a sink. This method replaces the following fields in the existing
|
62
84
|
# sink with values from the new sink: `destination`, and `filter`.
|
63
85
|
#
|
64
86
|
# The updated sink might also have a new `writer_identity`; see the
|
65
87
|
# `unique_writer_identity` field.
|
66
|
-
rpc :UpdateSink, Google::Cloud::Logging::V2::UpdateSinkRequest, Google::Cloud::Logging::V2::LogSink
|
88
|
+
rpc :UpdateSink, ::Google::Cloud::Logging::V2::UpdateSinkRequest, ::Google::Cloud::Logging::V2::LogSink
|
67
89
|
# Deletes a sink. If the sink has a unique `writer_identity`, then that
|
68
90
|
# service account is also deleted.
|
69
|
-
rpc :DeleteSink, Google::Cloud::Logging::V2::DeleteSinkRequest, Google::Protobuf::Empty
|
91
|
+
rpc :DeleteSink, ::Google::Cloud::Logging::V2::DeleteSinkRequest, ::Google::Protobuf::Empty
|
70
92
|
# Lists all the exclusions in a parent resource.
|
71
|
-
rpc :ListExclusions, Google::Cloud::Logging::V2::ListExclusionsRequest, Google::Cloud::Logging::V2::ListExclusionsResponse
|
93
|
+
rpc :ListExclusions, ::Google::Cloud::Logging::V2::ListExclusionsRequest, ::Google::Cloud::Logging::V2::ListExclusionsResponse
|
72
94
|
# Gets the description of an exclusion.
|
73
|
-
rpc :GetExclusion, Google::Cloud::Logging::V2::GetExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
|
95
|
+
rpc :GetExclusion, ::Google::Cloud::Logging::V2::GetExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
|
74
96
|
# Creates a new exclusion in a specified parent resource.
|
75
97
|
# Only log entries belonging to that resource can be excluded.
|
76
98
|
# You can have up to 10 exclusions in a resource.
|
77
|
-
rpc :CreateExclusion, Google::Cloud::Logging::V2::CreateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
|
99
|
+
rpc :CreateExclusion, ::Google::Cloud::Logging::V2::CreateExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
|
78
100
|
# Changes one or more properties of an existing exclusion.
|
79
|
-
rpc :UpdateExclusion, Google::Cloud::Logging::V2::UpdateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
|
101
|
+
rpc :UpdateExclusion, ::Google::Cloud::Logging::V2::UpdateExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
|
80
102
|
# Deletes an exclusion.
|
81
|
-
rpc :DeleteExclusion, Google::Cloud::Logging::V2::DeleteExclusionRequest, Google::Protobuf::Empty
|
103
|
+
rpc :DeleteExclusion, ::Google::Cloud::Logging::V2::DeleteExclusionRequest, ::Google::Protobuf::Empty
|
82
104
|
# Gets the Logs Router CMEK settings for the given resource.
|
83
105
|
#
|
84
106
|
# Note: CMEK for the Logs Router can currently only be configured for GCP
|
@@ -88,7 +110,7 @@ module Google
|
|
88
110
|
# See [Enabling CMEK for Logs
|
89
111
|
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
90
112
|
# for more information.
|
91
|
-
rpc :GetCmekSettings, Google::Cloud::Logging::V2::GetCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
|
113
|
+
rpc :GetCmekSettings, ::Google::Cloud::Logging::V2::GetCmekSettingsRequest, ::Google::Cloud::Logging::V2::CmekSettings
|
92
114
|
# Updates the Logs Router CMEK settings for the given resource.
|
93
115
|
#
|
94
116
|
# Note: CMEK for the Logs Router can currently only be configured for GCP
|
@@ -104,7 +126,7 @@ module Google
|
|
104
126
|
# See [Enabling CMEK for Logs
|
105
127
|
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
106
128
|
# for more information.
|
107
|
-
rpc :UpdateCmekSettings, Google::Cloud::Logging::V2::UpdateCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
|
129
|
+
rpc :UpdateCmekSettings, ::Google::Cloud::Logging::V2::UpdateCmekSettingsRequest, ::Google::Cloud::Logging::V2::CmekSettings
|
108
130
|
end
|
109
131
|
|
110
132
|
Stub = Service.rpc_stub_class
|
@@ -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
|