google-cloud-dataflow-v1beta3 0.9.1 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/client.rb +27 -2
  4. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/client.rb +27 -2
  5. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/service_stub.rb +22 -8
  6. data/lib/google/cloud/dataflow/v1beta3/jobs/client.rb +29 -8
  7. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/client.rb +27 -7
  8. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/service_stub.rb +62 -38
  9. data/lib/google/cloud/dataflow/v1beta3/messages/client.rb +28 -2
  10. data/lib/google/cloud/dataflow/v1beta3/messages/rest/client.rb +27 -2
  11. data/lib/google/cloud/dataflow/v1beta3/messages/rest/service_stub.rb +22 -8
  12. data/lib/google/cloud/dataflow/v1beta3/metrics/client.rb +29 -4
  13. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/client.rb +29 -4
  14. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/service_stub.rb +38 -20
  15. data/lib/google/cloud/dataflow/v1beta3/snapshots/client.rb +27 -4
  16. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/client.rb +27 -4
  17. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/service_stub.rb +38 -20
  18. data/lib/google/cloud/dataflow/v1beta3/templates_service/client.rb +27 -4
  19. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/client.rb +27 -4
  20. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/service_stub.rb +38 -20
  21. data/lib/google/cloud/dataflow/v1beta3/version.rb +1 -1
  22. data/proto_docs/google/api/client.rb +39 -0
  23. metadata +5 -5
@@ -158,8 +158,28 @@ module Google
158
158
  universe_domain: @config.universe_domain,
159
159
  channel_args: @config.channel_args,
160
160
  interceptors: @config.interceptors,
161
- channel_pool_config: @config.channel_pool
161
+ channel_pool_config: @config.channel_pool,
162
+ logger: @config.logger
162
163
  )
164
+
165
+ @messages_stub.stub_logger&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+ end
175
+
176
+ ##
177
+ # The logger used for request/response debug logging.
178
+ #
179
+ # @return [Logger]
180
+ #
181
+ def logger
182
+ @messages_stub.logger
163
183
  end
164
184
 
165
185
  # Service calls
@@ -283,7 +303,7 @@ module Google
283
303
  @messages_stub.call_rpc :list_job_messages, request, options: options do |response, operation|
284
304
  response = ::Gapic::PagedEnumerable.new @messages_stub, :list_job_messages, request, response, operation, options
285
305
  yield response, operation if block_given?
286
- return response
306
+ throw :response, response
287
307
  end
288
308
  rescue ::GRPC::BadStatus => e
289
309
  raise ::Google::Cloud::Error.from_error(e)
@@ -372,6 +392,11 @@ module Google
372
392
  # default endpoint URL. The default value of nil uses the environment
373
393
  # universe (usually the default "googleapis.com" universe).
374
394
  # @return [::String,nil]
395
+ # @!attribute [rw] logger
396
+ # A custom logger to use for request/response debug logging, or the value
397
+ # `:default` (the default) to construct a default logger, or `nil` to
398
+ # explicitly disable logging.
399
+ # @return [::Logger,:default,nil]
375
400
  #
376
401
  class Configuration
377
402
  extend ::Gapic::Config
@@ -396,6 +421,7 @@ module Google
396
421
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
397
422
  config_attr :quota_project, nil, ::String, nil
398
423
  config_attr :universe_domain, nil, ::String, nil
424
+ config_attr :logger, :default, ::Logger, nil, :default
399
425
 
400
426
  # @private
401
427
  def initialize parent_config = nil
@@ -151,8 +151,28 @@ module Google
151
151
  endpoint: @config.endpoint,
152
152
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
153
153
  universe_domain: @config.universe_domain,
154
- credentials: credentials
154
+ credentials: credentials,
155
+ logger: @config.logger
155
156
  )
157
+
158
+ @messages_stub.logger(stub: true)&.info do |entry|
159
+ entry.set_system_name
160
+ entry.set_service
161
+ entry.message = "Created client for #{entry.service}"
162
+ entry.set_credentials_fields credentials
163
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
164
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
165
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
166
+ end
167
+ end
168
+
169
+ ##
170
+ # The logger used for request/response debug logging.
171
+ #
172
+ # @return [Logger]
173
+ #
174
+ def logger
175
+ @messages_stub.logger
156
176
  end
157
177
 
158
178
  # Service calls
@@ -262,7 +282,6 @@ module Google
262
282
 
263
283
  @messages_stub.list_job_messages request, options do |result, operation|
264
284
  yield result, operation if block_given?
265
- return result
266
285
  end
267
286
  rescue ::Gapic::Rest::Error => e
268
287
  raise ::Google::Cloud::Error.from_error(e)
@@ -342,6 +361,11 @@ module Google
342
361
  # default endpoint URL. The default value of nil uses the environment
343
362
  # universe (usually the default "googleapis.com" universe).
344
363
  # @return [::String,nil]
364
+ # @!attribute [rw] logger
365
+ # A custom logger to use for request/response debug logging, or the value
366
+ # `:default` (the default) to construct a default logger, or `nil` to
367
+ # explicitly disable logging.
368
+ # @return [::Logger,:default,nil]
345
369
  #
346
370
  class Configuration
347
371
  extend ::Gapic::Config
@@ -363,6 +387,7 @@ module Google
363
387
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
364
388
  config_attr :quota_project, nil, ::String, nil
365
389
  config_attr :universe_domain, nil, ::String, nil
390
+ config_attr :logger, :default, ::Logger, nil, :default
366
391
 
367
392
  # @private
368
393
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the list_job_messages REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "list_job_messages",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::ListJobMessagesResponse.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -158,8 +158,28 @@ module Google
158
158
  universe_domain: @config.universe_domain,
159
159
  channel_args: @config.channel_args,
160
160
  interceptors: @config.interceptors,
161
- channel_pool_config: @config.channel_pool
161
+ channel_pool_config: @config.channel_pool,
162
+ logger: @config.logger
162
163
  )
164
+
165
+ @metrics_stub.stub_logger&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+ end
175
+
176
+ ##
177
+ # The logger used for request/response debug logging.
178
+ #
179
+ # @return [Logger]
180
+ #
181
+ def logger
182
+ @metrics_stub.logger
163
183
  end
164
184
 
165
185
  # Service calls
@@ -265,7 +285,6 @@ module Google
265
285
 
266
286
  @metrics_stub.call_rpc :get_job_metrics, request, options: options do |response, operation|
267
287
  yield response, operation if block_given?
268
- return response
269
288
  end
270
289
  rescue ::GRPC::BadStatus => e
271
290
  raise ::Google::Cloud::Error.from_error(e)
@@ -378,7 +397,7 @@ module Google
378
397
  @metrics_stub.call_rpc :get_job_execution_details, request, options: options do |response, operation|
379
398
  response = ::Gapic::PagedEnumerable.new @metrics_stub, :get_job_execution_details, request, response, operation, options
380
399
  yield response, operation if block_given?
381
- return response
400
+ throw :response, response
382
401
  end
383
402
  rescue ::GRPC::BadStatus => e
384
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -501,7 +520,7 @@ module Google
501
520
  @metrics_stub.call_rpc :get_stage_execution_details, request, options: options do |response, operation|
502
521
  response = ::Gapic::PagedEnumerable.new @metrics_stub, :get_stage_execution_details, request, response, operation, options
503
522
  yield response, operation if block_given?
504
- return response
523
+ throw :response, response
505
524
  end
506
525
  rescue ::GRPC::BadStatus => e
507
526
  raise ::Google::Cloud::Error.from_error(e)
@@ -590,6 +609,11 @@ module Google
590
609
  # default endpoint URL. The default value of nil uses the environment
591
610
  # universe (usually the default "googleapis.com" universe).
592
611
  # @return [::String,nil]
612
+ # @!attribute [rw] logger
613
+ # A custom logger to use for request/response debug logging, or the value
614
+ # `:default` (the default) to construct a default logger, or `nil` to
615
+ # explicitly disable logging.
616
+ # @return [::Logger,:default,nil]
593
617
  #
594
618
  class Configuration
595
619
  extend ::Gapic::Config
@@ -614,6 +638,7 @@ module Google
614
638
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
615
639
  config_attr :quota_project, nil, ::String, nil
616
640
  config_attr :universe_domain, nil, ::String, nil
641
+ config_attr :logger, :default, ::Logger, nil, :default
617
642
 
618
643
  # @private
619
644
  def initialize parent_config = nil
@@ -151,8 +151,28 @@ module Google
151
151
  endpoint: @config.endpoint,
152
152
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
153
153
  universe_domain: @config.universe_domain,
154
- credentials: credentials
154
+ credentials: credentials,
155
+ logger: @config.logger
155
156
  )
157
+
158
+ @metrics_stub.logger(stub: true)&.info do |entry|
159
+ entry.set_system_name
160
+ entry.set_service
161
+ entry.message = "Created client for #{entry.service}"
162
+ entry.set_credentials_fields credentials
163
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
164
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
165
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
166
+ end
167
+ end
168
+
169
+ ##
170
+ # The logger used for request/response debug logging.
171
+ #
172
+ # @return [Logger]
173
+ #
174
+ def logger
175
+ @metrics_stub.logger
156
176
  end
157
177
 
158
178
  # Service calls
@@ -245,7 +265,6 @@ module Google
245
265
 
246
266
  @metrics_stub.get_job_metrics request, options do |result, operation|
247
267
  yield result, operation if block_given?
248
- return result
249
268
  end
250
269
  rescue ::Gapic::Rest::Error => e
251
270
  raise ::Google::Cloud::Error.from_error(e)
@@ -345,7 +364,7 @@ module Google
345
364
  @metrics_stub.get_job_execution_details request, options do |result, operation|
346
365
  result = ::Gapic::Rest::PagedEnumerable.new @metrics_stub, :get_job_execution_details, "stages", request, result, options
347
366
  yield result, operation if block_given?
348
- return result
367
+ throw :response, result
349
368
  end
350
369
  rescue ::Gapic::Rest::Error => e
351
370
  raise ::Google::Cloud::Error.from_error(e)
@@ -452,7 +471,7 @@ module Google
452
471
  @metrics_stub.get_stage_execution_details request, options do |result, operation|
453
472
  result = ::Gapic::Rest::PagedEnumerable.new @metrics_stub, :get_stage_execution_details, "workers", request, result, options
454
473
  yield result, operation if block_given?
455
- return result
474
+ throw :response, result
456
475
  end
457
476
  rescue ::Gapic::Rest::Error => e
458
477
  raise ::Google::Cloud::Error.from_error(e)
@@ -532,6 +551,11 @@ module Google
532
551
  # default endpoint URL. The default value of nil uses the environment
533
552
  # universe (usually the default "googleapis.com" universe).
534
553
  # @return [::String,nil]
554
+ # @!attribute [rw] logger
555
+ # A custom logger to use for request/response debug logging, or the value
556
+ # `:default` (the default) to construct a default logger, or `nil` to
557
+ # explicitly disable logging.
558
+ # @return [::Logger,:default,nil]
535
559
  #
536
560
  class Configuration
537
561
  extend ::Gapic::Config
@@ -553,6 +577,7 @@ module Google
553
577
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
554
578
  config_attr :quota_project, nil, ::String, nil
555
579
  config_attr :universe_domain, nil, ::String, nil
580
+ config_attr :logger, :default, ::Logger, nil, :default
556
581
 
557
582
  # @private
558
583
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the get_job_metrics REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "get_job_metrics",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::JobMetrics.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "get_job_execution_details",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Dataflow::V1beta3::JobExecutionDetails.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "get_stage_execution_details",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::Dataflow::V1beta3::StageExecutionDetails.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -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
+ @snapshots_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
+ @snapshots_stub.logger
162
182
  end
163
183
 
164
184
  # Service calls
@@ -253,7 +273,6 @@ module Google
253
273
 
254
274
  @snapshots_stub.call_rpc :get_snapshot, request, options: options do |response, operation|
255
275
  yield response, operation if block_given?
256
- return response
257
276
  end
258
277
  rescue ::GRPC::BadStatus => e
259
278
  raise ::Google::Cloud::Error.from_error(e)
@@ -349,7 +368,6 @@ module Google
349
368
 
350
369
  @snapshots_stub.call_rpc :delete_snapshot, request, options: options do |response, operation|
351
370
  yield response, operation if block_given?
352
- return response
353
371
  end
354
372
  rescue ::GRPC::BadStatus => e
355
373
  raise ::Google::Cloud::Error.from_error(e)
@@ -445,7 +463,6 @@ module Google
445
463
 
446
464
  @snapshots_stub.call_rpc :list_snapshots, request, options: options do |response, operation|
447
465
  yield response, operation if block_given?
448
- return response
449
466
  end
450
467
  rescue ::GRPC::BadStatus => e
451
468
  raise ::Google::Cloud::Error.from_error(e)
@@ -534,6 +551,11 @@ module Google
534
551
  # default endpoint URL. The default value of nil uses the environment
535
552
  # universe (usually the default "googleapis.com" universe).
536
553
  # @return [::String,nil]
554
+ # @!attribute [rw] logger
555
+ # A custom logger to use for request/response debug logging, or the value
556
+ # `:default` (the default) to construct a default logger, or `nil` to
557
+ # explicitly disable logging.
558
+ # @return [::Logger,:default,nil]
537
559
  #
538
560
  class Configuration
539
561
  extend ::Gapic::Config
@@ -558,6 +580,7 @@ module Google
558
580
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
559
581
  config_attr :quota_project, nil, ::String, nil
560
582
  config_attr :universe_domain, nil, ::String, nil
583
+ config_attr :logger, :default, ::Logger, nil, :default
561
584
 
562
585
  # @private
563
586
  def initialize parent_config = nil
@@ -150,8 +150,28 @@ module Google
150
150
  endpoint: @config.endpoint,
151
151
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
152
152
  universe_domain: @config.universe_domain,
153
- credentials: credentials
153
+ credentials: credentials,
154
+ logger: @config.logger
154
155
  )
156
+
157
+ @snapshots_stub.logger(stub: true)&.info do |entry|
158
+ entry.set_system_name
159
+ entry.set_service
160
+ entry.message = "Created client for #{entry.service}"
161
+ entry.set_credentials_fields credentials
162
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
163
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
164
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
165
+ end
166
+ end
167
+
168
+ ##
169
+ # The logger used for request/response debug logging.
170
+ #
171
+ # @return [Logger]
172
+ #
173
+ def logger
174
+ @snapshots_stub.logger
155
175
  end
156
176
 
157
177
  # Service calls
@@ -233,7 +253,6 @@ module Google
233
253
 
234
254
  @snapshots_stub.get_snapshot request, options do |result, operation|
235
255
  yield result, operation if block_given?
236
- return result
237
256
  end
238
257
  rescue ::Gapic::Rest::Error => e
239
258
  raise ::Google::Cloud::Error.from_error(e)
@@ -316,7 +335,6 @@ module Google
316
335
 
317
336
  @snapshots_stub.delete_snapshot request, options do |result, operation|
318
337
  yield result, operation if block_given?
319
- return result
320
338
  end
321
339
  rescue ::Gapic::Rest::Error => e
322
340
  raise ::Google::Cloud::Error.from_error(e)
@@ -399,7 +417,6 @@ module Google
399
417
 
400
418
  @snapshots_stub.list_snapshots request, options do |result, operation|
401
419
  yield result, operation if block_given?
402
- return result
403
420
  end
404
421
  rescue ::Gapic::Rest::Error => e
405
422
  raise ::Google::Cloud::Error.from_error(e)
@@ -479,6 +496,11 @@ module Google
479
496
  # default endpoint URL. The default value of nil uses the environment
480
497
  # universe (usually the default "googleapis.com" universe).
481
498
  # @return [::String,nil]
499
+ # @!attribute [rw] logger
500
+ # A custom logger to use for request/response debug logging, or the value
501
+ # `:default` (the default) to construct a default logger, or `nil` to
502
+ # explicitly disable logging.
503
+ # @return [::Logger,:default,nil]
482
504
  #
483
505
  class Configuration
484
506
  extend ::Gapic::Config
@@ -500,6 +522,7 @@ module Google
500
522
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
501
523
  config_attr :quota_project, nil, ::String, nil
502
524
  config_attr :universe_domain, nil, ::String, nil
525
+ config_attr :logger, :default, ::Logger, nil, :default
503
526
 
504
527
  # @private
505
528
  def initialize parent_config = nil