google-cloud-logging-v2 0.5.1 → 0.5.5
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/AUTHENTICATION.md +8 -8
- data/README.md +1 -1
- data/lib/google/cloud/logging/v2/config_service/client.rb +590 -157
- data/lib/google/cloud/logging/v2/logging_service/client.rb +175 -73
- data/lib/google/cloud/logging/v2/metrics_service/client.rb +155 -73
- data/lib/google/cloud/logging/v2/version.rb +1 -1
- data/lib/google/logging/v2/log_entry_pb.rb +2 -2
- data/lib/google/logging/v2/logging_config_pb.rb +2 -2
- data/lib/google/logging/v2/logging_metrics_pb.rb +2 -2
- data/lib/google/logging/v2/logging_pb.rb +2 -2
- data/proto_docs/google/api/distribution.rb +2 -2
- data/proto_docs/google/api/field_behavior.rb +7 -1
- data/proto_docs/google/api/launch_stage.rb +71 -0
- data/proto_docs/google/api/metric.rb +109 -36
- data/proto_docs/google/api/monitored_resource.rb +7 -6
- metadata +5 -6
- data/lib/google/logging/type/http_request_pb.rb +0 -38
- data/lib/google/logging/type/log_severity_pb.rb +0 -31
@@ -41,13 +41,12 @@ module Google
|
|
41
41
|
# See {::Google::Cloud::Logging::V2::LoggingService::Client::Configuration}
|
42
42
|
# for a description of the configuration fields.
|
43
43
|
#
|
44
|
-
#
|
44
|
+
# @example
|
45
45
|
#
|
46
|
-
#
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
# end
|
46
|
+
# # Modify the configuration for all LoggingService clients
|
47
|
+
# ::Google::Cloud::Logging::V2::LoggingService::Client.configure do |config|
|
48
|
+
# config.timeout = 10.0
|
49
|
+
# end
|
51
50
|
#
|
52
51
|
# @yield [config] Configure the Client client.
|
53
52
|
# @yieldparam config [Client::Configuration]
|
@@ -67,50 +66,32 @@ module Google
|
|
67
66
|
|
68
67
|
default_config.rpcs.delete_log.timeout = 60.0
|
69
68
|
default_config.rpcs.delete_log.retry_policy = {
|
70
|
-
initial_delay: 0.1,
|
71
|
-
max_delay: 60.0,
|
72
|
-
multiplier: 1.3,
|
73
|
-
retry_codes: [4, 13, 14]
|
69
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
74
70
|
}
|
75
71
|
|
76
72
|
default_config.rpcs.write_log_entries.timeout = 60.0
|
77
73
|
default_config.rpcs.write_log_entries.retry_policy = {
|
78
|
-
initial_delay: 0.1,
|
79
|
-
max_delay: 60.0,
|
80
|
-
multiplier: 1.3,
|
81
|
-
retry_codes: [4, 13, 14]
|
74
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
82
75
|
}
|
83
76
|
|
84
77
|
default_config.rpcs.list_log_entries.timeout = 60.0
|
85
78
|
default_config.rpcs.list_log_entries.retry_policy = {
|
86
|
-
initial_delay: 0.1,
|
87
|
-
max_delay: 60.0,
|
88
|
-
multiplier: 1.3,
|
89
|
-
retry_codes: [4, 13, 14]
|
79
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
90
80
|
}
|
91
81
|
|
92
82
|
default_config.rpcs.list_monitored_resource_descriptors.timeout = 60.0
|
93
83
|
default_config.rpcs.list_monitored_resource_descriptors.retry_policy = {
|
94
|
-
initial_delay: 0.1,
|
95
|
-
max_delay: 60.0,
|
96
|
-
multiplier: 1.3,
|
97
|
-
retry_codes: [4, 13, 14]
|
84
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
98
85
|
}
|
99
86
|
|
100
87
|
default_config.rpcs.list_logs.timeout = 60.0
|
101
88
|
default_config.rpcs.list_logs.retry_policy = {
|
102
|
-
initial_delay: 0.1,
|
103
|
-
max_delay: 60.0,
|
104
|
-
multiplier: 1.3,
|
105
|
-
retry_codes: [4, 13, 14]
|
89
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
106
90
|
}
|
107
91
|
|
108
92
|
default_config.rpcs.tail_log_entries.timeout = 3600.0
|
109
93
|
default_config.rpcs.tail_log_entries.retry_policy = {
|
110
|
-
initial_delay: 0.1,
|
111
|
-
max_delay: 60.0,
|
112
|
-
multiplier: 1.3,
|
113
|
-
retry_codes: [4, 13, 14]
|
94
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
|
114
95
|
}
|
115
96
|
|
116
97
|
default_config
|
@@ -142,19 +123,15 @@ module Google
|
|
142
123
|
##
|
143
124
|
# Create a new LoggingService client object.
|
144
125
|
#
|
145
|
-
#
|
146
|
-
#
|
147
|
-
# To create a new LoggingService client with the default
|
148
|
-
# configuration:
|
149
|
-
#
|
150
|
-
# client = ::Google::Cloud::Logging::V2::LoggingService::Client.new
|
126
|
+
# @example
|
151
127
|
#
|
152
|
-
#
|
153
|
-
#
|
128
|
+
# # Create a client using the default configuration
|
129
|
+
# client = ::Google::Cloud::Logging::V2::LoggingService::Client.new
|
154
130
|
#
|
155
|
-
#
|
156
|
-
#
|
157
|
-
#
|
131
|
+
# # Create a client using a custom configuration
|
132
|
+
# client = ::Google::Cloud::Logging::V2::LoggingService::Client.new do |config|
|
133
|
+
# config.timeout = 10.0
|
134
|
+
# end
|
158
135
|
#
|
159
136
|
# @yield [config] Configure the LoggingService client.
|
160
137
|
# @yieldparam config [Client::Configuration]
|
@@ -174,14 +151,13 @@ module Google
|
|
174
151
|
|
175
152
|
# Create credentials
|
176
153
|
credentials = @config.credentials
|
177
|
-
# Use self-signed JWT if the
|
154
|
+
# Use self-signed JWT if the endpoint is unchanged from default,
|
178
155
|
# but only if the default endpoint does not have a region prefix.
|
179
|
-
enable_self_signed_jwt = @config.
|
180
|
-
@config.endpoint == Client.configure.endpoint &&
|
156
|
+
enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
|
181
157
|
!@config.endpoint.split(".").first.include?("-")
|
182
158
|
credentials ||= Credentials.default scope: @config.scope,
|
183
159
|
enable_self_signed_jwt: enable_self_signed_jwt
|
184
|
-
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
160
|
+
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
185
161
|
credentials = Credentials.new credentials, scope: @config.scope
|
186
162
|
end
|
187
163
|
@quota_project_id = @config.quota_project
|
@@ -241,6 +217,21 @@ module Google
|
|
241
217
|
#
|
242
218
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
243
219
|
#
|
220
|
+
# @example Basic example
|
221
|
+
# require "google/cloud/logging/v2"
|
222
|
+
#
|
223
|
+
# # Create a client object. The client can be reused for multiple calls.
|
224
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
225
|
+
#
|
226
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
227
|
+
# request = Google::Cloud::Logging::V2::DeleteLogRequest.new
|
228
|
+
#
|
229
|
+
# # Call the delete_log method.
|
230
|
+
# result = client.delete_log request
|
231
|
+
#
|
232
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
233
|
+
# p result
|
234
|
+
#
|
244
235
|
def delete_log request, options = nil
|
245
236
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
246
237
|
|
@@ -258,16 +249,20 @@ module Google
|
|
258
249
|
gapic_version: ::Google::Cloud::Logging::V2::VERSION
|
259
250
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
260
251
|
|
261
|
-
header_params = {
|
262
|
-
|
263
|
-
|
252
|
+
header_params = {}
|
253
|
+
if request.log_name
|
254
|
+
header_params["log_name"] = request.log_name
|
255
|
+
end
|
256
|
+
|
264
257
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
265
258
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
266
259
|
|
267
260
|
options.apply_defaults timeout: @config.rpcs.delete_log.timeout,
|
268
261
|
metadata: metadata,
|
269
262
|
retry_policy: @config.rpcs.delete_log.retry_policy
|
270
|
-
|
263
|
+
|
264
|
+
options.apply_defaults timeout: @config.timeout,
|
265
|
+
metadata: @config.metadata,
|
271
266
|
retry_policy: @config.retry_policy
|
272
267
|
|
273
268
|
@logging_service_stub.call_rpc :delete_log, request, options: options do |response, operation|
|
@@ -378,6 +373,21 @@ module Google
|
|
378
373
|
#
|
379
374
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
380
375
|
#
|
376
|
+
# @example Basic example
|
377
|
+
# require "google/cloud/logging/v2"
|
378
|
+
#
|
379
|
+
# # Create a client object. The client can be reused for multiple calls.
|
380
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
381
|
+
#
|
382
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
383
|
+
# request = Google::Cloud::Logging::V2::WriteLogEntriesRequest.new
|
384
|
+
#
|
385
|
+
# # Call the write_log_entries method.
|
386
|
+
# result = client.write_log_entries request
|
387
|
+
#
|
388
|
+
# # The returned object is of type Google::Cloud::Logging::V2::WriteLogEntriesResponse.
|
389
|
+
# p result
|
390
|
+
#
|
381
391
|
def write_log_entries request, options = nil
|
382
392
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
383
393
|
|
@@ -398,7 +408,9 @@ module Google
|
|
398
408
|
options.apply_defaults timeout: @config.rpcs.write_log_entries.timeout,
|
399
409
|
metadata: metadata,
|
400
410
|
retry_policy: @config.rpcs.write_log_entries.retry_policy
|
401
|
-
|
411
|
+
|
412
|
+
options.apply_defaults timeout: @config.timeout,
|
413
|
+
metadata: @config.metadata,
|
402
414
|
retry_policy: @config.retry_policy
|
403
415
|
|
404
416
|
@logging_service_stub.call_rpc :write_log_entries, request, options: options do |response, operation|
|
@@ -480,6 +492,27 @@ module Google
|
|
480
492
|
#
|
481
493
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
482
494
|
#
|
495
|
+
# @example Basic example
|
496
|
+
# require "google/cloud/logging/v2"
|
497
|
+
#
|
498
|
+
# # Create a client object. The client can be reused for multiple calls.
|
499
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
500
|
+
#
|
501
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
502
|
+
# request = Google::Cloud::Logging::V2::ListLogEntriesRequest.new
|
503
|
+
#
|
504
|
+
# # Call the list_log_entries method.
|
505
|
+
# result = client.list_log_entries request
|
506
|
+
#
|
507
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can
|
508
|
+
# # iterate over all elements by calling #each, and the enumerable
|
509
|
+
# # will lazily make API calls to fetch subsequent pages. Other
|
510
|
+
# # methods are also available for managing paging directly.
|
511
|
+
# result.each do |response|
|
512
|
+
# # Each element is of type ::Google::Cloud::Logging::V2::LogEntry.
|
513
|
+
# p response
|
514
|
+
# end
|
515
|
+
#
|
483
516
|
def list_log_entries request, options = nil
|
484
517
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
485
518
|
|
@@ -500,7 +533,9 @@ module Google
|
|
500
533
|
options.apply_defaults timeout: @config.rpcs.list_log_entries.timeout,
|
501
534
|
metadata: metadata,
|
502
535
|
retry_policy: @config.rpcs.list_log_entries.retry_policy
|
503
|
-
|
536
|
+
|
537
|
+
options.apply_defaults timeout: @config.timeout,
|
538
|
+
metadata: @config.metadata,
|
504
539
|
retry_policy: @config.retry_policy
|
505
540
|
|
506
541
|
@logging_service_stub.call_rpc :list_log_entries, request, options: options do |response, operation|
|
@@ -548,6 +583,27 @@ module Google
|
|
548
583
|
#
|
549
584
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
550
585
|
#
|
586
|
+
# @example Basic example
|
587
|
+
# require "google/cloud/logging/v2"
|
588
|
+
#
|
589
|
+
# # Create a client object. The client can be reused for multiple calls.
|
590
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
591
|
+
#
|
592
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
593
|
+
# request = Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest.new
|
594
|
+
#
|
595
|
+
# # Call the list_monitored_resource_descriptors method.
|
596
|
+
# result = client.list_monitored_resource_descriptors request
|
597
|
+
#
|
598
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can
|
599
|
+
# # iterate over all elements by calling #each, and the enumerable
|
600
|
+
# # will lazily make API calls to fetch subsequent pages. Other
|
601
|
+
# # methods are also available for managing paging directly.
|
602
|
+
# result.each do |response|
|
603
|
+
# # Each element is of type ::Google::Api::MonitoredResourceDescriptor.
|
604
|
+
# p response
|
605
|
+
# end
|
606
|
+
#
|
551
607
|
def list_monitored_resource_descriptors request, options = nil
|
552
608
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
553
609
|
|
@@ -568,7 +624,9 @@ module Google
|
|
568
624
|
options.apply_defaults timeout: @config.rpcs.list_monitored_resource_descriptors.timeout,
|
569
625
|
metadata: metadata,
|
570
626
|
retry_policy: @config.rpcs.list_monitored_resource_descriptors.retry_policy
|
571
|
-
|
627
|
+
|
628
|
+
options.apply_defaults timeout: @config.timeout,
|
629
|
+
metadata: @config.metadata,
|
572
630
|
retry_policy: @config.retry_policy
|
573
631
|
|
574
632
|
@logging_service_stub.call_rpc :list_monitored_resource_descriptors, request, options: options do |response, operation|
|
@@ -636,6 +694,21 @@ module Google
|
|
636
694
|
#
|
637
695
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
638
696
|
#
|
697
|
+
# @example Basic example
|
698
|
+
# require "google/cloud/logging/v2"
|
699
|
+
#
|
700
|
+
# # Create a client object. The client can be reused for multiple calls.
|
701
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
702
|
+
#
|
703
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
704
|
+
# request = Google::Cloud::Logging::V2::ListLogsRequest.new
|
705
|
+
#
|
706
|
+
# # Call the list_logs method.
|
707
|
+
# result = client.list_logs request
|
708
|
+
#
|
709
|
+
# # The returned object is of type Google::Cloud::Logging::V2::ListLogsResponse.
|
710
|
+
# p result
|
711
|
+
#
|
639
712
|
def list_logs request, options = nil
|
640
713
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
641
714
|
|
@@ -653,16 +726,20 @@ module Google
|
|
653
726
|
gapic_version: ::Google::Cloud::Logging::V2::VERSION
|
654
727
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
655
728
|
|
656
|
-
header_params = {
|
657
|
-
|
658
|
-
|
729
|
+
header_params = {}
|
730
|
+
if request.parent
|
731
|
+
header_params["parent"] = request.parent
|
732
|
+
end
|
733
|
+
|
659
734
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
660
735
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
661
736
|
|
662
737
|
options.apply_defaults timeout: @config.rpcs.list_logs.timeout,
|
663
738
|
metadata: metadata,
|
664
739
|
retry_policy: @config.rpcs.list_logs.retry_policy
|
665
|
-
|
740
|
+
|
741
|
+
options.apply_defaults timeout: @config.timeout,
|
742
|
+
metadata: @config.metadata,
|
666
743
|
retry_policy: @config.retry_policy
|
667
744
|
|
668
745
|
@logging_service_stub.call_rpc :list_logs, request, options: options do |response, operation|
|
@@ -690,6 +767,30 @@ module Google
|
|
690
767
|
#
|
691
768
|
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
692
769
|
#
|
770
|
+
# @example Basic example
|
771
|
+
# require "google/cloud/logging/v2"
|
772
|
+
#
|
773
|
+
# # Create a client object. The client can be reused for multiple calls.
|
774
|
+
# client = Google::Cloud::Logging::V2::LoggingService::Client.new
|
775
|
+
#
|
776
|
+
# # Create an input stream
|
777
|
+
# input = Gapic::StreamInput.new
|
778
|
+
#
|
779
|
+
# # Call the tail_log_entries method to start streaming.
|
780
|
+
# output = client.tail_log_entries input
|
781
|
+
#
|
782
|
+
# # Send requests on the stream. For each request, pass in keyword
|
783
|
+
# # arguments to set fields. Be sure to close the stream when done.
|
784
|
+
# input << Google::Cloud::Logging::V2::TailLogEntriesRequest.new
|
785
|
+
# input << Google::Cloud::Logging::V2::TailLogEntriesRequest.new
|
786
|
+
# input.close
|
787
|
+
#
|
788
|
+
# # Handle streamed responses. These may be interleaved with inputs.
|
789
|
+
# # Each response is of type ::Google::Cloud::Logging::V2::TailLogEntriesResponse.
|
790
|
+
# output.each do |response|
|
791
|
+
# p response
|
792
|
+
# end
|
793
|
+
#
|
693
794
|
def tail_log_entries request, options = nil
|
694
795
|
unless request.is_a? ::Enumerable
|
695
796
|
raise ::ArgumentError, "request must be an Enumerable" unless request.respond_to? :to_enum
|
@@ -715,7 +816,9 @@ module Google
|
|
715
816
|
options.apply_defaults timeout: @config.rpcs.tail_log_entries.timeout,
|
716
817
|
metadata: metadata,
|
717
818
|
retry_policy: @config.rpcs.tail_log_entries.retry_policy
|
718
|
-
|
819
|
+
|
820
|
+
options.apply_defaults timeout: @config.timeout,
|
821
|
+
metadata: @config.metadata,
|
719
822
|
retry_policy: @config.retry_policy
|
720
823
|
|
721
824
|
@logging_service_stub.call_rpc :tail_log_entries, request, options: options do |response, operation|
|
@@ -739,22 +842,21 @@ module Google
|
|
739
842
|
# Configuration can be applied globally to all clients, or to a single client
|
740
843
|
# on construction.
|
741
844
|
#
|
742
|
-
#
|
743
|
-
#
|
744
|
-
#
|
745
|
-
# to 20 seconds,
|
746
|
-
#
|
747
|
-
#
|
748
|
-
#
|
749
|
-
#
|
750
|
-
#
|
751
|
-
#
|
752
|
-
#
|
753
|
-
#
|
754
|
-
#
|
755
|
-
#
|
756
|
-
#
|
757
|
-
# end
|
845
|
+
# @example
|
846
|
+
#
|
847
|
+
# # Modify the global config, setting the timeout for
|
848
|
+
# # delete_log to 20 seconds,
|
849
|
+
# # and all remaining timeouts to 10 seconds.
|
850
|
+
# ::Google::Cloud::Logging::V2::LoggingService::Client.configure do |config|
|
851
|
+
# config.timeout = 10.0
|
852
|
+
# config.rpcs.delete_log.timeout = 20.0
|
853
|
+
# end
|
854
|
+
#
|
855
|
+
# # Apply the above configuration only to a new client.
|
856
|
+
# client = ::Google::Cloud::Logging::V2::LoggingService::Client.new do |config|
|
857
|
+
# config.timeout = 10.0
|
858
|
+
# config.rpcs.delete_log.timeout = 20.0
|
859
|
+
# end
|
758
860
|
#
|
759
861
|
# @!attribute [rw] endpoint
|
760
862
|
# The hostname or hostname:port of the service endpoint.
|