google-cloud-ai_platform-v1 0.60.0 → 0.61.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (135) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/ai_platform/v1/dataset_service/client.rb +43 -20
  4. data/lib/google/cloud/ai_platform/v1/dataset_service/operations.rb +9 -5
  5. data/lib/google/cloud/ai_platform/v1/dataset_service/rest/client.rb +43 -20
  6. data/lib/google/cloud/ai_platform/v1/dataset_service/rest/operations.rb +49 -35
  7. data/lib/google/cloud/ai_platform/v1/dataset_service/rest/service_stub.rb +166 -116
  8. data/lib/google/cloud/ai_platform/v1/deployment_resource_pool_service/client.rb +34 -7
  9. data/lib/google/cloud/ai_platform/v1/deployment_resource_pool_service/operations.rb +9 -5
  10. data/lib/google/cloud/ai_platform/v1/deployment_resource_pool_service/rest/client.rb +33 -7
  11. data/lib/google/cloud/ai_platform/v1/deployment_resource_pool_service/rest/operations.rb +49 -35
  12. data/lib/google/cloud/ai_platform/v1/deployment_resource_pool_service/rest/service_stub.rb +62 -38
  13. data/lib/google/cloud/ai_platform/v1/endpoint_service/client.rb +36 -10
  14. data/lib/google/cloud/ai_platform/v1/endpoint_service/operations.rb +9 -5
  15. data/lib/google/cloud/ai_platform/v1/endpoint_service/rest/client.rb +36 -10
  16. data/lib/google/cloud/ai_platform/v1/endpoint_service/rest/operations.rb +49 -35
  17. data/lib/google/cloud/ai_platform/v1/endpoint_service/rest/service_stub.rb +86 -56
  18. data/lib/google/cloud/ai_platform/v1/evaluation_service/client.rb +29 -2
  19. data/lib/google/cloud/ai_platform/v1/evaluation_service/rest/client.rb +29 -2
  20. data/lib/google/cloud/ai_platform/v1/evaluation_service/rest/service_stub.rb +22 -8
  21. data/lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/client.rb +38 -14
  22. data/lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/operations.rb +9 -5
  23. data/lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/rest/client.rb +38 -14
  24. data/lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/rest/operations.rb +49 -35
  25. data/lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/rest/service_stub.rb +118 -80
  26. data/lib/google/cloud/ai_platform/v1/feature_online_store_service/client.rb +29 -3
  27. data/lib/google/cloud/ai_platform/v1/feature_online_store_service/rest/client.rb +29 -3
  28. data/lib/google/cloud/ai_platform/v1/feature_online_store_service/rest/service_stub.rb +30 -14
  29. data/lib/google/cloud/ai_platform/v1/feature_registry_service/client.rb +38 -12
  30. data/lib/google/cloud/ai_platform/v1/feature_registry_service/operations.rb +9 -5
  31. data/lib/google/cloud/ai_platform/v1/feature_registry_service/rest/client.rb +38 -12
  32. data/lib/google/cloud/ai_platform/v1/feature_registry_service/rest/operations.rb +49 -35
  33. data/lib/google/cloud/ai_platform/v1/feature_registry_service/rest/service_stub.rb +102 -68
  34. data/lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/client.rb +29 -4
  35. data/lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/rest/client.rb +29 -3
  36. data/lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/rest/service_stub.rb +31 -14
  37. data/lib/google/cloud/ai_platform/v1/featurestore_service/client.rb +45 -22
  38. data/lib/google/cloud/ai_platform/v1/featurestore_service/operations.rb +9 -5
  39. data/lib/google/cloud/ai_platform/v1/featurestore_service/rest/client.rb +45 -22
  40. data/lib/google/cloud/ai_platform/v1/featurestore_service/rest/operations.rb +49 -35
  41. data/lib/google/cloud/ai_platform/v1/featurestore_service/rest/service_stub.rb +182 -128
  42. data/lib/google/cloud/ai_platform/v1/gen_ai_tuning_service/client.rb +31 -6
  43. data/lib/google/cloud/ai_platform/v1/gen_ai_tuning_service/operations.rb +9 -5
  44. data/lib/google/cloud/ai_platform/v1/gen_ai_tuning_service/rest/client.rb +31 -6
  45. data/lib/google/cloud/ai_platform/v1/gen_ai_tuning_service/rest/operations.rb +49 -35
  46. data/lib/google/cloud/ai_platform/v1/gen_ai_tuning_service/rest/service_stub.rb +54 -32
  47. data/lib/google/cloud/ai_platform/v1/index_endpoint_service/client.rb +35 -9
  48. data/lib/google/cloud/ai_platform/v1/index_endpoint_service/operations.rb +9 -5
  49. data/lib/google/cloud/ai_platform/v1/index_endpoint_service/rest/client.rb +35 -9
  50. data/lib/google/cloud/ai_platform/v1/index_endpoint_service/rest/operations.rb +49 -35
  51. data/lib/google/cloud/ai_platform/v1/index_endpoint_service/rest/service_stub.rb +78 -50
  52. data/lib/google/cloud/ai_platform/v1/index_service/client.rb +33 -8
  53. data/lib/google/cloud/ai_platform/v1/index_service/operations.rb +9 -5
  54. data/lib/google/cloud/ai_platform/v1/index_service/rest/client.rb +33 -8
  55. data/lib/google/cloud/ai_platform/v1/index_service/rest/operations.rb +49 -35
  56. data/lib/google/cloud/ai_platform/v1/index_service/rest/service_stub.rb +70 -44
  57. data/lib/google/cloud/ai_platform/v1/job_service/client.rb +44 -36
  58. data/lib/google/cloud/ai_platform/v1/job_service/operations.rb +9 -5
  59. data/lib/google/cloud/ai_platform/v1/job_service/rest/client.rb +44 -36
  60. data/lib/google/cloud/ai_platform/v1/job_service/rest/operations.rb +49 -35
  61. data/lib/google/cloud/ai_platform/v1/job_service/rest/service_stub.rb +294 -212
  62. data/lib/google/cloud/ai_platform/v1/llm_utility_service/client.rb +29 -3
  63. data/lib/google/cloud/ai_platform/v1/llm_utility_service/rest/client.rb +29 -3
  64. data/lib/google/cloud/ai_platform/v1/llm_utility_service/rest/service_stub.rb +30 -14
  65. data/lib/google/cloud/ai_platform/v1/match_service/client.rb +29 -3
  66. data/lib/google/cloud/ai_platform/v1/match_service/rest/client.rb +29 -3
  67. data/lib/google/cloud/ai_platform/v1/match_service/rest/service_stub.rb +30 -14
  68. data/lib/google/cloud/ai_platform/v1/metadata_service/client.rb +42 -33
  69. data/lib/google/cloud/ai_platform/v1/metadata_service/operations.rb +9 -5
  70. data/lib/google/cloud/ai_platform/v1/metadata_service/rest/client.rb +42 -33
  71. data/lib/google/cloud/ai_platform/v1/metadata_service/rest/operations.rb +49 -35
  72. data/lib/google/cloud/ai_platform/v1/metadata_service/rest/service_stub.rb +270 -194
  73. data/lib/google/cloud/ai_platform/v1/migration_service/client.rb +31 -3
  74. data/lib/google/cloud/ai_platform/v1/migration_service/operations.rb +9 -5
  75. data/lib/google/cloud/ai_platform/v1/migration_service/rest/client.rb +31 -3
  76. data/lib/google/cloud/ai_platform/v1/migration_service/rest/operations.rb +49 -35
  77. data/lib/google/cloud/ai_platform/v1/migration_service/rest/service_stub.rb +30 -14
  78. data/lib/google/cloud/ai_platform/v1/model_garden_service/client.rb +29 -2
  79. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest/client.rb +29 -2
  80. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest/service_stub.rb +22 -8
  81. data/lib/google/cloud/ai_platform/v1/model_service/client.rb +39 -19
  82. data/lib/google/cloud/ai_platform/v1/model_service/operations.rb +9 -5
  83. data/lib/google/cloud/ai_platform/v1/model_service/rest/client.rb +39 -19
  84. data/lib/google/cloud/ai_platform/v1/model_service/rest/operations.rb +49 -35
  85. data/lib/google/cloud/ai_platform/v1/model_service/rest/service_stub.rb +158 -110
  86. data/lib/google/cloud/ai_platform/v1/notebook_service/client.rb +41 -17
  87. data/lib/google/cloud/ai_platform/v1/notebook_service/operations.rb +9 -5
  88. data/lib/google/cloud/ai_platform/v1/notebook_service/rest/client.rb +41 -17
  89. data/lib/google/cloud/ai_platform/v1/notebook_service/rest/operations.rb +49 -35
  90. data/lib/google/cloud/ai_platform/v1/notebook_service/rest/service_stub.rb +142 -98
  91. data/lib/google/cloud/ai_platform/v1/persistent_resource_service/client.rb +34 -7
  92. data/lib/google/cloud/ai_platform/v1/persistent_resource_service/operations.rb +9 -5
  93. data/lib/google/cloud/ai_platform/v1/persistent_resource_service/rest/client.rb +34 -7
  94. data/lib/google/cloud/ai_platform/v1/persistent_resource_service/rest/operations.rb +49 -35
  95. data/lib/google/cloud/ai_platform/v1/persistent_resource_service/rest/service_stub.rb +62 -38
  96. data/lib/google/cloud/ai_platform/v1/pipeline_service/client.rb +35 -13
  97. data/lib/google/cloud/ai_platform/v1/pipeline_service/operations.rb +9 -5
  98. data/lib/google/cloud/ai_platform/v1/pipeline_service/rest/client.rb +35 -13
  99. data/lib/google/cloud/ai_platform/v1/pipeline_service/rest/operations.rb +49 -35
  100. data/lib/google/cloud/ai_platform/v1/pipeline_service/rest/service_stub.rb +110 -74
  101. data/lib/google/cloud/ai_platform/v1/prediction_service/client.rb +29 -14
  102. data/lib/google/cloud/ai_platform/v1/prediction_service/rest/client.rb +29 -7
  103. data/lib/google/cloud/ai_platform/v1/prediction_service/rest/service_stub.rb +65 -38
  104. data/lib/google/cloud/ai_platform/v1/schedule_service/client.rb +31 -8
  105. data/lib/google/cloud/ai_platform/v1/schedule_service/operations.rb +9 -5
  106. data/lib/google/cloud/ai_platform/v1/schedule_service/rest/client.rb +31 -8
  107. data/lib/google/cloud/ai_platform/v1/schedule_service/rest/operations.rb +49 -35
  108. data/lib/google/cloud/ai_platform/v1/schedule_service/rest/service_stub.rb +70 -44
  109. data/lib/google/cloud/ai_platform/v1/specialist_pool_service/client.rb +33 -6
  110. data/lib/google/cloud/ai_platform/v1/specialist_pool_service/operations.rb +9 -5
  111. data/lib/google/cloud/ai_platform/v1/specialist_pool_service/rest/client.rb +33 -6
  112. data/lib/google/cloud/ai_platform/v1/specialist_pool_service/rest/operations.rb +49 -35
  113. data/lib/google/cloud/ai_platform/v1/specialist_pool_service/rest/service_stub.rb +54 -32
  114. data/lib/google/cloud/ai_platform/v1/tensorboard_service/client.rb +40 -31
  115. data/lib/google/cloud/ai_platform/v1/tensorboard_service/operations.rb +9 -5
  116. data/lib/google/cloud/ai_platform/v1/tensorboard_service/rest/client.rb +40 -30
  117. data/lib/google/cloud/ai_platform/v1/tensorboard_service/rest/operations.rb +49 -35
  118. data/lib/google/cloud/ai_platform/v1/tensorboard_service/rest/service_stub.rb +247 -176
  119. data/lib/google/cloud/ai_platform/v1/version.rb +1 -1
  120. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/client.rb +36 -11
  121. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/operations.rb +9 -5
  122. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/rest/client.rb +36 -11
  123. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/rest/operations.rb +49 -35
  124. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/rest/service_stub.rb +94 -62
  125. data/lib/google/cloud/ai_platform/v1/vertex_rag_service/client.rb +29 -4
  126. data/lib/google/cloud/ai_platform/v1/vertex_rag_service/rest/client.rb +29 -4
  127. data/lib/google/cloud/ai_platform/v1/vertex_rag_service/rest/service_stub.rb +38 -20
  128. data/lib/google/cloud/ai_platform/v1/vizier_service/client.rb +33 -16
  129. data/lib/google/cloud/ai_platform/v1/vizier_service/operations.rb +9 -5
  130. data/lib/google/cloud/ai_platform/v1/vizier_service/rest/client.rb +33 -16
  131. data/lib/google/cloud/ai_platform/v1/vizier_service/rest/operations.rb +49 -35
  132. data/lib/google/cloud/ai_platform/v1/vizier_service/rest/service_stub.rb +134 -92
  133. data/lib/google/cloud/aiplatform/v1/accelerator_type_pb.rb +1 -1
  134. data/proto_docs/google/cloud/aiplatform/v1/accelerator_type.rb +3 -0
  135. metadata +4 -4
@@ -159,14 +159,26 @@ module Google
159
159
  universe_domain: @config.universe_domain,
160
160
  channel_args: @config.channel_args,
161
161
  interceptors: @config.interceptors,
162
- channel_pool_config: @config.channel_pool
162
+ channel_pool_config: @config.channel_pool,
163
+ logger: @config.logger
163
164
  )
164
165
 
166
+ @llm_utility_service_stub.stub_logger&.info do |entry|
167
+ entry.set_system_name
168
+ entry.set_service
169
+ entry.message = "Created client for #{entry.service}"
170
+ entry.set_credentials_fields credentials
171
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
172
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
173
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
174
+ end
175
+
165
176
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
166
177
  config.credentials = credentials
167
178
  config.quota_project = @quota_project_id
168
179
  config.endpoint = @llm_utility_service_stub.endpoint
169
180
  config.universe_domain = @llm_utility_service_stub.universe_domain
181
+ config.logger = @llm_utility_service_stub.logger if config.respond_to? :logger=
170
182
  end
171
183
 
172
184
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -174,6 +186,7 @@ module Google
174
186
  config.quota_project = @quota_project_id
175
187
  config.endpoint = @llm_utility_service_stub.endpoint
176
188
  config.universe_domain = @llm_utility_service_stub.universe_domain
189
+ config.logger = @llm_utility_service_stub.logger if config.respond_to? :logger=
177
190
  end
178
191
  end
179
192
 
@@ -191,6 +204,15 @@ module Google
191
204
  #
192
205
  attr_reader :iam_policy_client
193
206
 
207
+ ##
208
+ # The logger used for request/response debug logging.
209
+ #
210
+ # @return [Logger]
211
+ #
212
+ def logger
213
+ @llm_utility_service_stub.logger
214
+ end
215
+
194
216
  # Service calls
195
217
 
196
218
  ##
@@ -298,7 +320,6 @@ module Google
298
320
 
299
321
  @llm_utility_service_stub.call_rpc :count_tokens, request, options: options do |response, operation|
300
322
  yield response, operation if block_given?
301
- return response
302
323
  end
303
324
  rescue ::GRPC::BadStatus => e
304
325
  raise ::Google::Cloud::Error.from_error(e)
@@ -395,7 +416,6 @@ module Google
395
416
 
396
417
  @llm_utility_service_stub.call_rpc :compute_tokens, request, options: options do |response, operation|
397
418
  yield response, operation if block_given?
398
- return response
399
419
  end
400
420
  rescue ::GRPC::BadStatus => e
401
421
  raise ::Google::Cloud::Error.from_error(e)
@@ -484,6 +504,11 @@ module Google
484
504
  # default endpoint URL. The default value of nil uses the environment
485
505
  # universe (usually the default "googleapis.com" universe).
486
506
  # @return [::String,nil]
507
+ # @!attribute [rw] logger
508
+ # A custom logger to use for request/response debug logging, or the value
509
+ # `:default` (the default) to construct a default logger, or `nil` to
510
+ # explicitly disable logging.
511
+ # @return [::Logger,:default,nil]
487
512
  #
488
513
  class Configuration
489
514
  extend ::Gapic::Config
@@ -508,6 +533,7 @@ module Google
508
533
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
509
534
  config_attr :quota_project, nil, ::String, nil
510
535
  config_attr :universe_domain, nil, ::String, nil
536
+ config_attr :logger, :default, ::Logger, nil, :default
511
537
 
512
538
  # @private
513
539
  def initialize parent_config = nil
@@ -152,15 +152,27 @@ module Google
152
152
  endpoint: @config.endpoint,
153
153
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
154
154
  universe_domain: @config.universe_domain,
155
- credentials: credentials
155
+ credentials: credentials,
156
+ logger: @config.logger
156
157
  )
157
158
 
159
+ @llm_utility_service_stub.logger(stub: true)&.info do |entry|
160
+ entry.set_system_name
161
+ entry.set_service
162
+ entry.message = "Created client for #{entry.service}"
163
+ entry.set_credentials_fields credentials
164
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
165
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
166
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
167
+ end
168
+
158
169
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
159
170
  config.credentials = credentials
160
171
  config.quota_project = @quota_project_id
161
172
  config.endpoint = @llm_utility_service_stub.endpoint
162
173
  config.universe_domain = @llm_utility_service_stub.universe_domain
163
174
  config.bindings_override = @config.bindings_override
175
+ config.logger = @llm_utility_service_stub.logger if config.respond_to? :logger=
164
176
  end
165
177
 
166
178
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -169,6 +181,7 @@ module Google
169
181
  config.endpoint = @llm_utility_service_stub.endpoint
170
182
  config.universe_domain = @llm_utility_service_stub.universe_domain
171
183
  config.bindings_override = @config.bindings_override
184
+ config.logger = @llm_utility_service_stub.logger if config.respond_to? :logger=
172
185
  end
173
186
  end
174
187
 
@@ -186,6 +199,15 @@ module Google
186
199
  #
187
200
  attr_reader :iam_policy_client
188
201
 
202
+ ##
203
+ # The logger used for request/response debug logging.
204
+ #
205
+ # @return [Logger]
206
+ #
207
+ def logger
208
+ @llm_utility_service_stub.logger
209
+ end
210
+
189
211
  # Service calls
190
212
 
191
213
  ##
@@ -286,7 +308,6 @@ module Google
286
308
 
287
309
  @llm_utility_service_stub.count_tokens request, options do |result, operation|
288
310
  yield result, operation if block_given?
289
- return result
290
311
  end
291
312
  rescue ::Gapic::Rest::Error => e
292
313
  raise ::Google::Cloud::Error.from_error(e)
@@ -376,7 +397,6 @@ module Google
376
397
 
377
398
  @llm_utility_service_stub.compute_tokens request, options do |result, operation|
378
399
  yield result, operation if block_given?
379
- return result
380
400
  end
381
401
  rescue ::Gapic::Rest::Error => e
382
402
  raise ::Google::Cloud::Error.from_error(e)
@@ -456,6 +476,11 @@ module Google
456
476
  # default endpoint URL. The default value of nil uses the environment
457
477
  # universe (usually the default "googleapis.com" universe).
458
478
  # @return [::String,nil]
479
+ # @!attribute [rw] logger
480
+ # A custom logger to use for request/response debug logging, or the value
481
+ # `:default` (the default) to construct a default logger, or `nil` to
482
+ # explicitly disable logging.
483
+ # @return [::Logger,:default,nil]
459
484
  #
460
485
  class Configuration
461
486
  extend ::Gapic::Config
@@ -484,6 +509,7 @@ module Google
484
509
  # by the host service.
485
510
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
486
511
  config_attr :bindings_override, {}, ::Hash, nil
512
+ config_attr :logger, :default, ::Logger, nil, :default
487
513
 
488
514
  # @private
489
515
  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 count_tokens 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: "count_tokens",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::AIPlatform::V1::CountTokensResponse.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: "compute_tokens",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::AIPlatform::V1::ComputeTokensResponse.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
  ##
@@ -160,14 +160,26 @@ module Google
160
160
  universe_domain: @config.universe_domain,
161
161
  channel_args: @config.channel_args,
162
162
  interceptors: @config.interceptors,
163
- channel_pool_config: @config.channel_pool
163
+ channel_pool_config: @config.channel_pool,
164
+ logger: @config.logger
164
165
  )
165
166
 
167
+ @match_service_stub.stub_logger&.info do |entry|
168
+ entry.set_system_name
169
+ entry.set_service
170
+ entry.message = "Created client for #{entry.service}"
171
+ entry.set_credentials_fields credentials
172
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
173
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
174
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
175
+ end
176
+
166
177
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
167
178
  config.credentials = credentials
168
179
  config.quota_project = @quota_project_id
169
180
  config.endpoint = @match_service_stub.endpoint
170
181
  config.universe_domain = @match_service_stub.universe_domain
182
+ config.logger = @match_service_stub.logger if config.respond_to? :logger=
171
183
  end
172
184
 
173
185
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -175,6 +187,7 @@ module Google
175
187
  config.quota_project = @quota_project_id
176
188
  config.endpoint = @match_service_stub.endpoint
177
189
  config.universe_domain = @match_service_stub.universe_domain
190
+ config.logger = @match_service_stub.logger if config.respond_to? :logger=
178
191
  end
179
192
  end
180
193
 
@@ -192,6 +205,15 @@ module Google
192
205
  #
193
206
  attr_reader :iam_policy_client
194
207
 
208
+ ##
209
+ # The logger used for request/response debug logging.
210
+ #
211
+ # @return [Logger]
212
+ #
213
+ def logger
214
+ @match_service_stub.logger
215
+ end
216
+
195
217
  # Service calls
196
218
 
197
219
  ##
@@ -290,7 +312,6 @@ module Google
290
312
 
291
313
  @match_service_stub.call_rpc :find_neighbors, request, options: options do |response, operation|
292
314
  yield response, operation if block_given?
293
- return response
294
315
  end
295
316
  rescue ::GRPC::BadStatus => e
296
317
  raise ::Google::Cloud::Error.from_error(e)
@@ -383,7 +404,6 @@ module Google
383
404
 
384
405
  @match_service_stub.call_rpc :read_index_datapoints, request, options: options do |response, operation|
385
406
  yield response, operation if block_given?
386
- return response
387
407
  end
388
408
  rescue ::GRPC::BadStatus => e
389
409
  raise ::Google::Cloud::Error.from_error(e)
@@ -472,6 +492,11 @@ module Google
472
492
  # default endpoint URL. The default value of nil uses the environment
473
493
  # universe (usually the default "googleapis.com" universe).
474
494
  # @return [::String,nil]
495
+ # @!attribute [rw] logger
496
+ # A custom logger to use for request/response debug logging, or the value
497
+ # `:default` (the default) to construct a default logger, or `nil` to
498
+ # explicitly disable logging.
499
+ # @return [::Logger,:default,nil]
475
500
  #
476
501
  class Configuration
477
502
  extend ::Gapic::Config
@@ -496,6 +521,7 @@ module Google
496
521
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
497
522
  config_attr :quota_project, nil, ::String, nil
498
523
  config_attr :universe_domain, nil, ::String, nil
524
+ config_attr :logger, :default, ::Logger, nil, :default
499
525
 
500
526
  # @private
501
527
  def initialize parent_config = nil
@@ -153,15 +153,27 @@ module Google
153
153
  endpoint: @config.endpoint,
154
154
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
155
155
  universe_domain: @config.universe_domain,
156
- credentials: credentials
156
+ credentials: credentials,
157
+ logger: @config.logger
157
158
  )
158
159
 
160
+ @match_service_stub.logger(stub: true)&.info do |entry|
161
+ entry.set_system_name
162
+ entry.set_service
163
+ entry.message = "Created client for #{entry.service}"
164
+ entry.set_credentials_fields credentials
165
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
166
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
167
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
168
+ end
169
+
159
170
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
160
171
  config.credentials = credentials
161
172
  config.quota_project = @quota_project_id
162
173
  config.endpoint = @match_service_stub.endpoint
163
174
  config.universe_domain = @match_service_stub.universe_domain
164
175
  config.bindings_override = @config.bindings_override
176
+ config.logger = @match_service_stub.logger if config.respond_to? :logger=
165
177
  end
166
178
 
167
179
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -170,6 +182,7 @@ module Google
170
182
  config.endpoint = @match_service_stub.endpoint
171
183
  config.universe_domain = @match_service_stub.universe_domain
172
184
  config.bindings_override = @config.bindings_override
185
+ config.logger = @match_service_stub.logger if config.respond_to? :logger=
173
186
  end
174
187
  end
175
188
 
@@ -187,6 +200,15 @@ module Google
187
200
  #
188
201
  attr_reader :iam_policy_client
189
202
 
203
+ ##
204
+ # The logger used for request/response debug logging.
205
+ #
206
+ # @return [Logger]
207
+ #
208
+ def logger
209
+ @match_service_stub.logger
210
+ end
211
+
190
212
  # Service calls
191
213
 
192
214
  ##
@@ -278,7 +300,6 @@ module Google
278
300
 
279
301
  @match_service_stub.find_neighbors request, options do |result, operation|
280
302
  yield result, operation if block_given?
281
- return result
282
303
  end
283
304
  rescue ::Gapic::Rest::Error => e
284
305
  raise ::Google::Cloud::Error.from_error(e)
@@ -364,7 +385,6 @@ module Google
364
385
 
365
386
  @match_service_stub.read_index_datapoints request, options do |result, operation|
366
387
  yield result, operation if block_given?
367
- return result
368
388
  end
369
389
  rescue ::Gapic::Rest::Error => e
370
390
  raise ::Google::Cloud::Error.from_error(e)
@@ -444,6 +464,11 @@ module Google
444
464
  # default endpoint URL. The default value of nil uses the environment
445
465
  # universe (usually the default "googleapis.com" universe).
446
466
  # @return [::String,nil]
467
+ # @!attribute [rw] logger
468
+ # A custom logger to use for request/response debug logging, or the value
469
+ # `:default` (the default) to construct a default logger, or `nil` to
470
+ # explicitly disable logging.
471
+ # @return [::Logger,:default,nil]
447
472
  #
448
473
  class Configuration
449
474
  extend ::Gapic::Config
@@ -472,6 +497,7 @@ module Google
472
497
  # by the host service.
473
498
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
474
499
  config_attr :bindings_override, {}, ::Hash, nil
500
+ config_attr :logger, :default, ::Logger, nil, :default
475
501
 
476
502
  # @private
477
503
  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 find_neighbors 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: "find_neighbors",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::AIPlatform::V1::FindNeighborsResponse.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: "read_index_datapoints",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::AIPlatform::V1::ReadIndexDatapointsResponse.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
  ##