google-cloud-monitoring-v3 1.0.1 → 1.2.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +30 -20
- data/lib/google/cloud/monitoring/v3/alert_policy_service/client.rb +38 -15
- data/lib/google/cloud/monitoring/v3/group_service/client.rb +29 -7
- data/lib/google/cloud/monitoring/v3/metric_service/client.rb +30 -10
- data/lib/google/cloud/monitoring/v3/notification_channel_service/client.rb +39 -21
- data/lib/google/cloud/monitoring/v3/query_service/client.rb +28 -2
- data/lib/google/cloud/monitoring/v3/service_monitoring_service/client.rb +29 -11
- data/lib/google/cloud/monitoring/v3/snooze_service/client.rb +28 -5
- data/lib/google/cloud/monitoring/v3/uptime_check_service/client.rb +29 -7
- data/lib/google/cloud/monitoring/v3/version.rb +1 -1
- data/lib/google/monitoring/v3/alert_pb.rb +2 -1
- data/lib/google/monitoring/v3/alert_service_pb.rb +1 -1
- data/lib/google/monitoring/v3/notification_pb.rb +2 -1
- data/lib/google/monitoring/v3/notification_service_pb.rb +1 -1
- data/lib/google/monitoring/v3/snooze_pb.rb +1 -1
- data/proto_docs/google/api/client.rb +39 -0
- data/proto_docs/google/api/metric.rb +18 -0
- data/proto_docs/google/monitoring/v3/alert.rb +39 -20
- data/proto_docs/google/monitoring/v3/alert_service.rb +10 -9
- data/proto_docs/google/monitoring/v3/notification.rb +1 -1
- data/proto_docs/google/monitoring/v3/notification_service.rb +10 -10
- data/proto_docs/google/monitoring/v3/snooze.rb +1 -1
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 4be5ac1912b41c8aab4d67be4962d856d925567e327a755948149fe4892d3577
|
4
|
+
data.tar.gz: 74e022ab43e924a6900386f69ff40ca2201423c6008de345f06a39b73d41e895
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9af069883b3e5184bed83308502be8aead3f6180fda6d909b5df9b72f31ceba18ab5a02a12f7ba0c2fbda5a0442bc1202abd303747e00c717e6a72ca14f5ae62
|
7
|
+
data.tar.gz: 31d6108c7be91eb2c22cb2dd6498eb640b10bf004157704ebb941047211296fab7ca9b68568b374905483c51322842bf8dae11665cf532672f45ea9110cd3efe
|
data/README.md
CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
|
|
43
43
|
See also the [Product Documentation](https://cloud.google.com/monitoring)
|
44
44
|
for general usage information.
|
45
45
|
|
46
|
-
##
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
46
|
+
## Debug Logging
|
47
|
+
|
48
|
+
This library comes with opt-in Debug Logging that can help you troubleshoot
|
49
|
+
your application's integration with the API. When logging is activated, key
|
50
|
+
events such as requests and responses, along with data payloads and metadata
|
51
|
+
such as headers and client configuration, are logged to the standard error
|
52
|
+
stream.
|
53
|
+
|
54
|
+
**WARNING:** Client Library Debug Logging includes your data payloads in
|
55
|
+
plaintext, which could include sensitive data such as PII for yourself or your
|
56
|
+
customers, private keys, or other security data that could be compromising if
|
57
|
+
leaked. Always practice good data hygiene with your application logs, and follow
|
58
|
+
the principle of least access. Google also recommends that Client Library Debug
|
59
|
+
Logging be enabled only temporarily during active debugging, and not used
|
60
|
+
permanently in production.
|
61
|
+
|
62
|
+
To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
|
63
|
+
to the value `all`. Alternatively, you can set the value to a comma-delimited
|
64
|
+
list of client library gem names. This will select the default logging behavior,
|
65
|
+
which writes logs to the standard error stream. On a local workstation, this may
|
66
|
+
result in logs appearing on the console. When running on a Google Cloud hosting
|
67
|
+
service such as [Google Cloud Run](https://cloud.google.com/run), this generally
|
68
|
+
results in logs appearing alongside your application logs in the
|
69
|
+
[Google Cloud Logging](https://cloud.google.com/logging/) service.
|
70
|
+
|
71
|
+
You can customize logging by modifying the `logger` configuration when
|
72
|
+
constructing a client object. For example:
|
55
73
|
|
56
74
|
```ruby
|
75
|
+
require "google/cloud/monitoring/v3"
|
57
76
|
require "logger"
|
58
77
|
|
59
|
-
|
60
|
-
|
61
|
-
def logger
|
62
|
-
LOGGER
|
63
|
-
end
|
64
|
-
end
|
65
|
-
|
66
|
-
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
67
|
-
module GRPC
|
68
|
-
extend MyLogger
|
78
|
+
client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
|
79
|
+
config.logger = Logger.new "my-app.log"
|
69
80
|
end
|
70
81
|
```
|
71
82
|
|
72
|
-
|
73
83
|
## Google Cloud Samples
|
74
84
|
|
75
85
|
To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
|
@@ -184,8 +184,28 @@ module Google
|
|
184
184
|
universe_domain: @config.universe_domain,
|
185
185
|
channel_args: @config.channel_args,
|
186
186
|
interceptors: @config.interceptors,
|
187
|
-
channel_pool_config: @config.channel_pool
|
187
|
+
channel_pool_config: @config.channel_pool,
|
188
|
+
logger: @config.logger
|
188
189
|
)
|
190
|
+
|
191
|
+
@alert_policy_service_stub.stub_logger&.info do |entry|
|
192
|
+
entry.set_system_name
|
193
|
+
entry.set_service
|
194
|
+
entry.message = "Created client for #{entry.service}"
|
195
|
+
entry.set_credentials_fields credentials
|
196
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
197
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
198
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
199
|
+
end
|
200
|
+
end
|
201
|
+
|
202
|
+
##
|
203
|
+
# The logger used for request/response debug logging.
|
204
|
+
#
|
205
|
+
# @return [Logger]
|
206
|
+
#
|
207
|
+
def logger
|
208
|
+
@alert_policy_service_stub.logger
|
189
209
|
end
|
190
210
|
|
191
211
|
# Service calls
|
@@ -221,24 +241,25 @@ module Google
|
|
221
241
|
# {::Google::Cloud::Monitoring::V3::AlertPolicyService::Client#get_alert_policy GetAlertPolicy}
|
222
242
|
# operation, instead.
|
223
243
|
# @param filter [::String]
|
224
|
-
# If provided, this field specifies the criteria that must be met
|
225
|
-
# alert policies to be included in the response.
|
244
|
+
# Optional. If provided, this field specifies the criteria that must be met
|
245
|
+
# by alert policies to be included in the response.
|
226
246
|
#
|
227
247
|
# For more details, see [sorting and
|
228
248
|
# filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
|
229
249
|
# @param order_by [::String]
|
230
|
-
# A comma-separated list of fields by which to sort the result.
|
231
|
-
# the same set of field references as the `filter` field. Entries
|
232
|
-
# prefixed with a minus sign to sort by the field in descending order.
|
250
|
+
# Optional. A comma-separated list of fields by which to sort the result.
|
251
|
+
# Supports the same set of field references as the `filter` field. Entries
|
252
|
+
# can be prefixed with a minus sign to sort by the field in descending order.
|
233
253
|
#
|
234
254
|
# For more details, see [sorting and
|
235
255
|
# filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
|
236
256
|
# @param page_size [::Integer]
|
237
|
-
# The maximum number of results to return in a single response.
|
257
|
+
# Optional. The maximum number of results to return in a single response.
|
238
258
|
# @param page_token [::String]
|
239
|
-
# If this field is not empty then it must contain the
|
240
|
-
# returned by a previous call to this method. Using
|
241
|
-
# method to return more results from the previous
|
259
|
+
# Optional. If this field is not empty then it must contain the
|
260
|
+
# `nextPageToken` value returned by a previous call to this method. Using
|
261
|
+
# this field causes the method to return more results from the previous
|
262
|
+
# method call.
|
242
263
|
#
|
243
264
|
# @yield [response, operation] Access the result along with the RPC operation
|
244
265
|
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Monitoring::V3::AlertPolicy>]
|
@@ -304,7 +325,7 @@ module Google
|
|
304
325
|
@alert_policy_service_stub.call_rpc :list_alert_policies, request, options: options do |response, operation|
|
305
326
|
response = ::Gapic::PagedEnumerable.new @alert_policy_service_stub, :list_alert_policies, request, response, operation, options
|
306
327
|
yield response, operation if block_given?
|
307
|
-
|
328
|
+
throw :response, response
|
308
329
|
end
|
309
330
|
rescue ::GRPC::BadStatus => e
|
310
331
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -392,7 +413,6 @@ module Google
|
|
392
413
|
|
393
414
|
@alert_policy_service_stub.call_rpc :get_alert_policy, request, options: options do |response, operation|
|
394
415
|
yield response, operation if block_given?
|
395
|
-
return response
|
396
416
|
end
|
397
417
|
rescue ::GRPC::BadStatus => e
|
398
418
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -498,7 +518,6 @@ module Google
|
|
498
518
|
|
499
519
|
@alert_policy_service_stub.call_rpc :create_alert_policy, request, options: options do |response, operation|
|
500
520
|
yield response, operation if block_given?
|
501
|
-
return response
|
502
521
|
end
|
503
522
|
rescue ::GRPC::BadStatus => e
|
504
523
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -592,7 +611,6 @@ module Google
|
|
592
611
|
|
593
612
|
@alert_policy_service_stub.call_rpc :delete_alert_policy, request, options: options do |response, operation|
|
594
613
|
yield response, operation if block_given?
|
595
|
-
return response
|
596
614
|
end
|
597
615
|
rescue ::GRPC::BadStatus => e
|
598
616
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -710,7 +728,6 @@ module Google
|
|
710
728
|
|
711
729
|
@alert_policy_service_stub.call_rpc :update_alert_policy, request, options: options do |response, operation|
|
712
730
|
yield response, operation if block_given?
|
713
|
-
return response
|
714
731
|
end
|
715
732
|
rescue ::GRPC::BadStatus => e
|
716
733
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -799,6 +816,11 @@ module Google
|
|
799
816
|
# default endpoint URL. The default value of nil uses the environment
|
800
817
|
# universe (usually the default "googleapis.com" universe).
|
801
818
|
# @return [::String,nil]
|
819
|
+
# @!attribute [rw] logger
|
820
|
+
# A custom logger to use for request/response debug logging, or the value
|
821
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
822
|
+
# explicitly disable logging.
|
823
|
+
# @return [::Logger,:default,nil]
|
802
824
|
#
|
803
825
|
class Configuration
|
804
826
|
extend ::Gapic::Config
|
@@ -823,6 +845,7 @@ module Google
|
|
823
845
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
824
846
|
config_attr :quota_project, nil, ::String, nil
|
825
847
|
config_attr :universe_domain, nil, ::String, nil
|
848
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
826
849
|
|
827
850
|
# @private
|
828
851
|
def initialize parent_config = nil
|
@@ -195,8 +195,28 @@ module Google
|
|
195
195
|
universe_domain: @config.universe_domain,
|
196
196
|
channel_args: @config.channel_args,
|
197
197
|
interceptors: @config.interceptors,
|
198
|
-
channel_pool_config: @config.channel_pool
|
198
|
+
channel_pool_config: @config.channel_pool,
|
199
|
+
logger: @config.logger
|
199
200
|
)
|
201
|
+
|
202
|
+
@group_service_stub.stub_logger&.info do |entry|
|
203
|
+
entry.set_system_name
|
204
|
+
entry.set_service
|
205
|
+
entry.message = "Created client for #{entry.service}"
|
206
|
+
entry.set_credentials_fields credentials
|
207
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
208
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
209
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
210
|
+
end
|
211
|
+
end
|
212
|
+
|
213
|
+
##
|
214
|
+
# The logger used for request/response debug logging.
|
215
|
+
#
|
216
|
+
# @return [Logger]
|
217
|
+
#
|
218
|
+
def logger
|
219
|
+
@group_service_stub.logger
|
200
220
|
end
|
201
221
|
|
202
222
|
# Service calls
|
@@ -320,7 +340,7 @@ module Google
|
|
320
340
|
@group_service_stub.call_rpc :list_groups, request, options: options do |response, operation|
|
321
341
|
response = ::Gapic::PagedEnumerable.new @group_service_stub, :list_groups, request, response, operation, options
|
322
342
|
yield response, operation if block_given?
|
323
|
-
|
343
|
+
throw :response, response
|
324
344
|
end
|
325
345
|
rescue ::GRPC::BadStatus => e
|
326
346
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -408,7 +428,6 @@ module Google
|
|
408
428
|
|
409
429
|
@group_service_stub.call_rpc :get_group, request, options: options do |response, operation|
|
410
430
|
yield response, operation if block_given?
|
411
|
-
return response
|
412
431
|
end
|
413
432
|
rescue ::GRPC::BadStatus => e
|
414
433
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -503,7 +522,6 @@ module Google
|
|
503
522
|
|
504
523
|
@group_service_stub.call_rpc :create_group, request, options: options do |response, operation|
|
505
524
|
yield response, operation if block_given?
|
506
|
-
return response
|
507
525
|
end
|
508
526
|
rescue ::GRPC::BadStatus => e
|
509
527
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -594,7 +612,6 @@ module Google
|
|
594
612
|
|
595
613
|
@group_service_stub.call_rpc :update_group, request, options: options do |response, operation|
|
596
614
|
yield response, operation if block_given?
|
597
|
-
return response
|
598
615
|
end
|
599
616
|
rescue ::GRPC::BadStatus => e
|
600
617
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -686,7 +703,6 @@ module Google
|
|
686
703
|
|
687
704
|
@group_service_stub.call_rpc :delete_group, request, options: options do |response, operation|
|
688
705
|
yield response, operation if block_given?
|
689
|
-
return response
|
690
706
|
end
|
691
707
|
rescue ::GRPC::BadStatus => e
|
692
708
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -799,7 +815,7 @@ module Google
|
|
799
815
|
@group_service_stub.call_rpc :list_group_members, request, options: options do |response, operation|
|
800
816
|
response = ::Gapic::PagedEnumerable.new @group_service_stub, :list_group_members, request, response, operation, options
|
801
817
|
yield response, operation if block_given?
|
802
|
-
|
818
|
+
throw :response, response
|
803
819
|
end
|
804
820
|
rescue ::GRPC::BadStatus => e
|
805
821
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -888,6 +904,11 @@ module Google
|
|
888
904
|
# default endpoint URL. The default value of nil uses the environment
|
889
905
|
# universe (usually the default "googleapis.com" universe).
|
890
906
|
# @return [::String,nil]
|
907
|
+
# @!attribute [rw] logger
|
908
|
+
# A custom logger to use for request/response debug logging, or the value
|
909
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
910
|
+
# explicitly disable logging.
|
911
|
+
# @return [::Logger,:default,nil]
|
891
912
|
#
|
892
913
|
class Configuration
|
893
914
|
extend ::Gapic::Config
|
@@ -912,6 +933,7 @@ module Google
|
|
912
933
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
913
934
|
config_attr :quota_project, nil, ::String, nil
|
914
935
|
config_attr :universe_domain, nil, ::String, nil
|
936
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
915
937
|
|
916
938
|
# @private
|
917
939
|
def initialize parent_config = nil
|
@@ -192,8 +192,28 @@ module Google
|
|
192
192
|
universe_domain: @config.universe_domain,
|
193
193
|
channel_args: @config.channel_args,
|
194
194
|
interceptors: @config.interceptors,
|
195
|
-
channel_pool_config: @config.channel_pool
|
195
|
+
channel_pool_config: @config.channel_pool,
|
196
|
+
logger: @config.logger
|
196
197
|
)
|
198
|
+
|
199
|
+
@metric_service_stub.stub_logger&.info do |entry|
|
200
|
+
entry.set_system_name
|
201
|
+
entry.set_service
|
202
|
+
entry.message = "Created client for #{entry.service}"
|
203
|
+
entry.set_credentials_fields credentials
|
204
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
205
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
206
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
207
|
+
end
|
208
|
+
end
|
209
|
+
|
210
|
+
##
|
211
|
+
# The logger used for request/response debug logging.
|
212
|
+
#
|
213
|
+
# @return [Logger]
|
214
|
+
#
|
215
|
+
def logger
|
216
|
+
@metric_service_stub.logger
|
197
217
|
end
|
198
218
|
|
199
219
|
# Service calls
|
@@ -300,7 +320,7 @@ module Google
|
|
300
320
|
@metric_service_stub.call_rpc :list_monitored_resource_descriptors, request, options: options do |response, operation|
|
301
321
|
response = ::Gapic::PagedEnumerable.new @metric_service_stub, :list_monitored_resource_descriptors, request, response, operation, options
|
302
322
|
yield response, operation if block_given?
|
303
|
-
|
323
|
+
throw :response, response
|
304
324
|
end
|
305
325
|
rescue ::GRPC::BadStatus => e
|
306
326
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -391,7 +411,6 @@ module Google
|
|
391
411
|
|
392
412
|
@metric_service_stub.call_rpc :get_monitored_resource_descriptor, request, options: options do |response, operation|
|
393
413
|
yield response, operation if block_given?
|
394
|
-
return response
|
395
414
|
end
|
396
415
|
rescue ::GRPC::BadStatus => e
|
397
416
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -503,7 +522,7 @@ module Google
|
|
503
522
|
@metric_service_stub.call_rpc :list_metric_descriptors, request, options: options do |response, operation|
|
504
523
|
response = ::Gapic::PagedEnumerable.new @metric_service_stub, :list_metric_descriptors, request, response, operation, options
|
505
524
|
yield response, operation if block_given?
|
506
|
-
|
525
|
+
throw :response, response
|
507
526
|
end
|
508
527
|
rescue ::GRPC::BadStatus => e
|
509
528
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -595,7 +614,6 @@ module Google
|
|
595
614
|
|
596
615
|
@metric_service_stub.call_rpc :get_metric_descriptor, request, options: options do |response, operation|
|
597
616
|
yield response, operation if block_given?
|
598
|
-
return response
|
599
617
|
end
|
600
618
|
rescue ::GRPC::BadStatus => e
|
601
619
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -693,7 +711,6 @@ module Google
|
|
693
711
|
|
694
712
|
@metric_service_stub.call_rpc :create_metric_descriptor, request, options: options do |response, operation|
|
695
713
|
yield response, operation if block_given?
|
696
|
-
return response
|
697
714
|
end
|
698
715
|
rescue ::GRPC::BadStatus => e
|
699
716
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -787,7 +804,6 @@ module Google
|
|
787
804
|
|
788
805
|
@metric_service_stub.call_rpc :delete_metric_descriptor, request, options: options do |response, operation|
|
789
806
|
yield response, operation if block_given?
|
790
|
-
return response
|
791
807
|
end
|
792
808
|
rescue ::GRPC::BadStatus => e
|
793
809
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -921,7 +937,7 @@ module Google
|
|
921
937
|
@metric_service_stub.call_rpc :list_time_series, request, options: options do |response, operation|
|
922
938
|
response = ::Gapic::PagedEnumerable.new @metric_service_stub, :list_time_series, request, response, operation, options
|
923
939
|
yield response, operation if block_given?
|
924
|
-
|
940
|
+
throw :response, response
|
925
941
|
end
|
926
942
|
rescue ::GRPC::BadStatus => e
|
927
943
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1025,7 +1041,6 @@ module Google
|
|
1025
1041
|
|
1026
1042
|
@metric_service_stub.call_rpc :create_time_series, request, options: options do |response, operation|
|
1027
1043
|
yield response, operation if block_given?
|
1028
|
-
return response
|
1029
1044
|
end
|
1030
1045
|
rescue ::GRPC::BadStatus => e
|
1031
1046
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1131,7 +1146,6 @@ module Google
|
|
1131
1146
|
|
1132
1147
|
@metric_service_stub.call_rpc :create_service_time_series, request, options: options do |response, operation|
|
1133
1148
|
yield response, operation if block_given?
|
1134
|
-
return response
|
1135
1149
|
end
|
1136
1150
|
rescue ::GRPC::BadStatus => e
|
1137
1151
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1220,6 +1234,11 @@ module Google
|
|
1220
1234
|
# default endpoint URL. The default value of nil uses the environment
|
1221
1235
|
# universe (usually the default "googleapis.com" universe).
|
1222
1236
|
# @return [::String,nil]
|
1237
|
+
# @!attribute [rw] logger
|
1238
|
+
# A custom logger to use for request/response debug logging, or the value
|
1239
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1240
|
+
# explicitly disable logging.
|
1241
|
+
# @return [::Logger,:default,nil]
|
1223
1242
|
#
|
1224
1243
|
class Configuration
|
1225
1244
|
extend ::Gapic::Config
|
@@ -1244,6 +1263,7 @@ module Google
|
|
1244
1263
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
1245
1264
|
config_attr :quota_project, nil, ::String, nil
|
1246
1265
|
config_attr :universe_domain, nil, ::String, nil
|
1266
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1247
1267
|
|
1248
1268
|
# @private
|
1249
1269
|
def initialize parent_config = nil
|
@@ -199,8 +199,28 @@ module Google
|
|
199
199
|
universe_domain: @config.universe_domain,
|
200
200
|
channel_args: @config.channel_args,
|
201
201
|
interceptors: @config.interceptors,
|
202
|
-
channel_pool_config: @config.channel_pool
|
202
|
+
channel_pool_config: @config.channel_pool,
|
203
|
+
logger: @config.logger
|
203
204
|
)
|
205
|
+
|
206
|
+
@notification_channel_service_stub.stub_logger&.info do |entry|
|
207
|
+
entry.set_system_name
|
208
|
+
entry.set_service
|
209
|
+
entry.message = "Created client for #{entry.service}"
|
210
|
+
entry.set_credentials_fields credentials
|
211
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
212
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
213
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
214
|
+
end
|
215
|
+
end
|
216
|
+
|
217
|
+
##
|
218
|
+
# The logger used for request/response debug logging.
|
219
|
+
#
|
220
|
+
# @return [Logger]
|
221
|
+
#
|
222
|
+
def logger
|
223
|
+
@notification_channel_service_stub.logger
|
204
224
|
end
|
205
225
|
|
206
226
|
# Service calls
|
@@ -309,7 +329,7 @@ module Google
|
|
309
329
|
@notification_channel_service_stub.call_rpc :list_notification_channel_descriptors, request, options: options do |response, operation|
|
310
330
|
response = ::Gapic::PagedEnumerable.new @notification_channel_service_stub, :list_notification_channel_descriptors, request, response, operation, options
|
311
331
|
yield response, operation if block_given?
|
312
|
-
|
332
|
+
throw :response, response
|
313
333
|
end
|
314
334
|
rescue ::GRPC::BadStatus => e
|
315
335
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -398,7 +418,6 @@ module Google
|
|
398
418
|
|
399
419
|
@notification_channel_service_stub.call_rpc :get_notification_channel_descriptor, request, options: options do |response, operation|
|
400
420
|
yield response, operation if block_given?
|
401
|
-
return response
|
402
421
|
end
|
403
422
|
rescue ::GRPC::BadStatus => e
|
404
423
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -438,24 +457,24 @@ module Google
|
|
438
457
|
# {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#get_notification_channel `GetNotificationChannel`}
|
439
458
|
# operation.
|
440
459
|
# @param filter [::String]
|
441
|
-
# If provided, this field specifies the criteria that must be met
|
442
|
-
# notification channels to be included in the response.
|
460
|
+
# Optional. If provided, this field specifies the criteria that must be met
|
461
|
+
# by notification channels to be included in the response.
|
443
462
|
#
|
444
463
|
# For more details, see [sorting and
|
445
464
|
# filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
|
446
465
|
# @param order_by [::String]
|
447
|
-
# A comma-separated list of fields by which to sort the result.
|
448
|
-
# the same set of fields as in `filter`. Entries can be prefixed
|
449
|
-
# a minus sign to sort in descending rather than ascending order.
|
466
|
+
# Optional. A comma-separated list of fields by which to sort the result.
|
467
|
+
# Supports the same set of fields as in `filter`. Entries can be prefixed
|
468
|
+
# with a minus sign to sort in descending rather than ascending order.
|
450
469
|
#
|
451
470
|
# For more details, see [sorting and
|
452
471
|
# filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
|
453
472
|
# @param page_size [::Integer]
|
454
|
-
# The maximum number of results to return in a single response. If
|
473
|
+
# Optional. The maximum number of results to return in a single response. If
|
455
474
|
# not set to a positive number, a reasonable value will be chosen by the
|
456
475
|
# service.
|
457
476
|
# @param page_token [::String]
|
458
|
-
# If non-empty, `page_token` must contain a value returned as the
|
477
|
+
# Optional. If non-empty, `page_token` must contain a value returned as the
|
459
478
|
# `next_page_token` in a previous response to request the next set
|
460
479
|
# of results.
|
461
480
|
#
|
@@ -523,7 +542,7 @@ module Google
|
|
523
542
|
@notification_channel_service_stub.call_rpc :list_notification_channels, request, options: options do |response, operation|
|
524
543
|
response = ::Gapic::PagedEnumerable.new @notification_channel_service_stub, :list_notification_channels, request, response, operation, options
|
525
544
|
yield response, operation if block_given?
|
526
|
-
|
545
|
+
throw :response, response
|
527
546
|
end
|
528
547
|
rescue ::GRPC::BadStatus => e
|
529
548
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -615,7 +634,6 @@ module Google
|
|
615
634
|
|
616
635
|
@notification_channel_service_stub.call_rpc :get_notification_channel, request, options: options do |response, operation|
|
617
636
|
yield response, operation if block_given?
|
618
|
-
return response
|
619
637
|
end
|
620
638
|
rescue ::GRPC::BadStatus => e
|
621
639
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -718,7 +736,6 @@ module Google
|
|
718
736
|
|
719
737
|
@notification_channel_service_stub.call_rpc :create_notification_channel, request, options: options do |response, operation|
|
720
738
|
yield response, operation if block_given?
|
721
|
-
return response
|
722
739
|
end
|
723
740
|
rescue ::GRPC::BadStatus => e
|
724
741
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -749,7 +766,7 @@ module Google
|
|
749
766
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
750
767
|
#
|
751
768
|
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
752
|
-
# The fields to update.
|
769
|
+
# Optional. The fields to update.
|
753
770
|
# @param notification_channel [::Google::Cloud::Monitoring::V3::NotificationChannel, ::Hash]
|
754
771
|
# Required. A description of the changes to be applied to the specified
|
755
772
|
# notification channel. The description must provide a definition for
|
@@ -815,7 +832,6 @@ module Google
|
|
815
832
|
|
816
833
|
@notification_channel_service_stub.call_rpc :update_notification_channel, request, options: options do |response, operation|
|
817
834
|
yield response, operation if block_given?
|
818
|
-
return response
|
819
835
|
end
|
820
836
|
rescue ::GRPC::BadStatus => e
|
821
837
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -851,8 +867,8 @@ module Google
|
|
851
867
|
# @param force [::Boolean]
|
852
868
|
# If true, the notification channel will be deleted regardless of its
|
853
869
|
# use in alert policies (the policies will be updated to remove the
|
854
|
-
# channel). If false,
|
855
|
-
#
|
870
|
+
# channel). If false, this operation will fail if the notification channel
|
871
|
+
# is referenced by existing alerting policies.
|
856
872
|
#
|
857
873
|
# @yield [response, operation] Access the result along with the RPC operation
|
858
874
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -913,7 +929,6 @@ module Google
|
|
913
929
|
|
914
930
|
@notification_channel_service_stub.call_rpc :delete_notification_channel, request, options: options do |response, operation|
|
915
931
|
yield response, operation if block_given?
|
916
|
-
return response
|
917
932
|
end
|
918
933
|
rescue ::GRPC::BadStatus => e
|
919
934
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1000,7 +1015,6 @@ module Google
|
|
1000
1015
|
|
1001
1016
|
@notification_channel_service_stub.call_rpc :send_notification_channel_verification_code, request, options: options do |response, operation|
|
1002
1017
|
yield response, operation if block_given?
|
1003
|
-
return response
|
1004
1018
|
end
|
1005
1019
|
rescue ::GRPC::BadStatus => e
|
1006
1020
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1118,7 +1132,6 @@ module Google
|
|
1118
1132
|
|
1119
1133
|
@notification_channel_service_stub.call_rpc :get_notification_channel_verification_code, request, options: options do |response, operation|
|
1120
1134
|
yield response, operation if block_given?
|
1121
|
-
return response
|
1122
1135
|
end
|
1123
1136
|
rescue ::GRPC::BadStatus => e
|
1124
1137
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1214,7 +1227,6 @@ module Google
|
|
1214
1227
|
|
1215
1228
|
@notification_channel_service_stub.call_rpc :verify_notification_channel, request, options: options do |response, operation|
|
1216
1229
|
yield response, operation if block_given?
|
1217
|
-
return response
|
1218
1230
|
end
|
1219
1231
|
rescue ::GRPC::BadStatus => e
|
1220
1232
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1303,6 +1315,11 @@ module Google
|
|
1303
1315
|
# default endpoint URL. The default value of nil uses the environment
|
1304
1316
|
# universe (usually the default "googleapis.com" universe).
|
1305
1317
|
# @return [::String,nil]
|
1318
|
+
# @!attribute [rw] logger
|
1319
|
+
# A custom logger to use for request/response debug logging, or the value
|
1320
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1321
|
+
# explicitly disable logging.
|
1322
|
+
# @return [::Logger,:default,nil]
|
1306
1323
|
#
|
1307
1324
|
class Configuration
|
1308
1325
|
extend ::Gapic::Config
|
@@ -1327,6 +1344,7 @@ module Google
|
|
1327
1344
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
1328
1345
|
config_attr :quota_project, nil, ::String, nil
|
1329
1346
|
config_attr :universe_domain, nil, ::String, nil
|
1347
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1330
1348
|
|
1331
1349
|
# @private
|
1332
1350
|
def initialize parent_config = nil
|
@@ -157,8 +157,28 @@ module Google
|
|
157
157
|
universe_domain: @config.universe_domain,
|
158
158
|
channel_args: @config.channel_args,
|
159
159
|
interceptors: @config.interceptors,
|
160
|
-
channel_pool_config: @config.channel_pool
|
160
|
+
channel_pool_config: @config.channel_pool,
|
161
|
+
logger: @config.logger
|
161
162
|
)
|
163
|
+
|
164
|
+
@query_service_stub.stub_logger&.info do |entry|
|
165
|
+
entry.set_system_name
|
166
|
+
entry.set_service
|
167
|
+
entry.message = "Created client for #{entry.service}"
|
168
|
+
entry.set_credentials_fields credentials
|
169
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
170
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
171
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
172
|
+
end
|
173
|
+
end
|
174
|
+
|
175
|
+
##
|
176
|
+
# The logger used for request/response debug logging.
|
177
|
+
#
|
178
|
+
# @return [Logger]
|
179
|
+
#
|
180
|
+
def logger
|
181
|
+
@query_service_stub.logger
|
162
182
|
end
|
163
183
|
|
164
184
|
# Service calls
|
@@ -262,7 +282,7 @@ module Google
|
|
262
282
|
@query_service_stub.call_rpc :query_time_series, request, options: options do |response, operation|
|
263
283
|
response = ::Gapic::PagedEnumerable.new @query_service_stub, :query_time_series, request, response, operation, options
|
264
284
|
yield response, operation if block_given?
|
265
|
-
|
285
|
+
throw :response, response
|
266
286
|
end
|
267
287
|
rescue ::GRPC::BadStatus => e
|
268
288
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -351,6 +371,11 @@ module Google
|
|
351
371
|
# default endpoint URL. The default value of nil uses the environment
|
352
372
|
# universe (usually the default "googleapis.com" universe).
|
353
373
|
# @return [::String,nil]
|
374
|
+
# @!attribute [rw] logger
|
375
|
+
# A custom logger to use for request/response debug logging, or the value
|
376
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
377
|
+
# explicitly disable logging.
|
378
|
+
# @return [::Logger,:default,nil]
|
354
379
|
#
|
355
380
|
class Configuration
|
356
381
|
extend ::Gapic::Config
|
@@ -375,6 +400,7 @@ module Google
|
|
375
400
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
376
401
|
config_attr :quota_project, nil, ::String, nil
|
377
402
|
config_attr :universe_domain, nil, ::String, nil
|
403
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
378
404
|
|
379
405
|
# @private
|
380
406
|
def initialize parent_config = nil
|