google-cloud-profiler-v2 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 716fb3f3f491283d7ba21a56eb7a3d18df375df341652532bbb1565b09a6496e
4
- data.tar.gz: dc677f58ec3c3c8786bc462e3fb76cf43b6009d25c71382f8c8004ea469ca71e
3
+ metadata.gz: aa00cb0ecdd5ffff1b01fda61974173811b76db4dc549e5f09dea1aa9f2d439c
4
+ data.tar.gz: 13b07aa88e30f32ecdccf37569691392f295628cd72c00da312271491fe7da10
5
5
  SHA512:
6
- metadata.gz: 753cdc171cf5660bcebfa7978464bbcf23468fea579b8ee9b78fe5be6df1179a6a2491bbabb69d07c82f18b4292ea2ad8ac2c5a79d57e85fd3385975bbf66f4c
7
- data.tar.gz: dd53a4f1b9592b414f8216d54105406db51690a31c4d045c30047c4c9d2c4fdb1752f98b51b81b2771bee9caaa7d77411039b6e38b6624a39de2d1a9cc62bc2b
6
+ metadata.gz: f4e1f9883a2822aecb9520af25d8dd415017be7086a88f834b86bc5cd52c50fc7d3197353db9c083809f28dd176e5758135071ef95cbaf8ac55d754c03867fd2
7
+ data.tar.gz: b8b4003e035e27a0f399a66339e0d9ed60ec23314bc6f02dfd36ed938ca0ae48cb85a4839666266c6a2209b08c7ba18f031dcc87021289c8fc8ba3692e56b844
data/README.md CHANGED
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -35,6 +35,8 @@ module Google
35
35
  # * Profiles can be created in either online or offline mode, see below.
36
36
  #
37
37
  class Client
38
+ include Paths
39
+
38
40
  # @private
39
41
  attr_reader :profiler_service_stub
40
42
 
@@ -67,12 +69,12 @@ module Google
67
69
  end
68
70
  default_config = Client::Configuration.new parent_config
69
71
 
70
- default_config.timeout = 30.0
72
+ default_config.timeout = 60.0
71
73
  default_config.retry_policy = {
72
74
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
73
75
  }
74
76
 
75
- default_config.rpcs.create_profile.timeout = 3600.0
77
+ default_config.rpcs.create_profile.timeout = 3610.0
76
78
 
77
79
  default_config.rpcs.create_offline_profile.timeout = 30.0
78
80
 
@@ -370,7 +372,7 @@ module Google
370
372
  # the default parameter values, pass an empty Hash as a request object (see above).
371
373
  #
372
374
  # @param profile [::Google::Cloud::Profiler::V2::Profile, ::Hash]
373
- # Profile to update
375
+ # Profile to update.
374
376
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
375
377
  # Field mask used to specify the fields to be overwritten. Currently only
376
378
  # profile_bytes and labels fields are supported by UpdateProfile, so only
@@ -479,9 +481,9 @@ module Google
479
481
  # * (`String`) The path to a service account key file in JSON format
480
482
  # * (`Hash`) A service account key as a Hash
481
483
  # * (`Google::Auth::Credentials`) A googleauth credentials object
482
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
484
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
483
485
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
484
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
486
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
485
487
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
486
488
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
487
489
  # * (`nil`) indicating no credentials
@@ -0,0 +1,64 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Profiler
23
+ module V2
24
+ module ProfilerService
25
+ # Path helper methods for the ProfilerService API.
26
+ module Paths
27
+ ##
28
+ # Create a fully-qualified Profile resource string.
29
+ #
30
+ # The resource will be in the following format:
31
+ #
32
+ # `projects/{project}/profiles/{profile}`
33
+ #
34
+ # @param project [String]
35
+ # @param profile [String]
36
+ #
37
+ # @return [::String]
38
+ def profile_path project:, profile:
39
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
40
+
41
+ "projects/#{project}/profiles/#{profile}"
42
+ end
43
+
44
+ ##
45
+ # Create a fully-qualified Project resource string.
46
+ #
47
+ # The resource will be in the following format:
48
+ #
49
+ # `projects/{project}`
50
+ #
51
+ # @param project [String]
52
+ #
53
+ # @return [::String]
54
+ def project_path project:
55
+ "projects/#{project}"
56
+ end
57
+
58
+ extend self
59
+ end
60
+ end
61
+ end
62
+ end
63
+ end
64
+ end
@@ -37,6 +37,8 @@ module Google
37
37
  # * Profiles can be created in either online or offline mode, see below.
38
38
  #
39
39
  class Client
40
+ include Paths
41
+
40
42
  # @private
41
43
  attr_reader :profiler_service_stub
42
44
 
@@ -69,12 +71,12 @@ module Google
69
71
  end
70
72
  default_config = Client::Configuration.new parent_config
71
73
 
72
- default_config.timeout = 30.0
74
+ default_config.timeout = 60.0
73
75
  default_config.retry_policy = {
74
76
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
75
77
  }
76
78
 
77
- default_config.rpcs.create_profile.timeout = 3600.0
79
+ default_config.rpcs.create_profile.timeout = 3610.0
78
80
 
79
81
  default_config.rpcs.create_offline_profile.timeout = 30.0
80
82
 
@@ -315,7 +317,7 @@ module Google
315
317
  # the default parameter values, pass an empty Hash as a request object (see above).
316
318
  #
317
319
  # @param profile [::Google::Cloud::Profiler::V2::Profile, ::Hash]
318
- # Profile to update
320
+ # Profile to update.
319
321
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
320
322
  # Field mask used to specify the fields to be overwritten. Currently only
321
323
  # profile_bytes and labels fields are supported by UpdateProfile, so only
@@ -401,9 +403,9 @@ module Google
401
403
  # * (`String`) The path to a service account key file in JSON format
402
404
  # * (`Hash`) A service account key as a Hash
403
405
  # * (`Google::Auth::Credentials`) A googleauth credentials object
404
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
406
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
405
407
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
406
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
408
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
407
409
  # * (`nil`) indicating no credentials
408
410
  # @return [::Object]
409
411
  # @!attribute [rw] scope
@@ -23,6 +23,7 @@ require "gapic/config/method"
23
23
  require "google/cloud/profiler/v2/version"
24
24
 
25
25
  require "google/cloud/profiler/v2/profiler_service/credentials"
26
+ require "google/cloud/profiler/v2/profiler_service/paths"
26
27
  require "google/cloud/profiler/v2/profiler_service/rest/client"
27
28
 
28
29
  module Google
@@ -23,6 +23,7 @@ require "gapic/config/method"
23
23
  require "google/cloud/profiler/v2/version"
24
24
 
25
25
  require "google/cloud/profiler/v2/profiler_service/credentials"
26
+ require "google/cloud/profiler/v2/profiler_service/paths"
26
27
  require "google/cloud/profiler/v2/profiler_service/client"
27
28
  require "google/cloud/profiler/v2/profiler_service/rest"
28
29
 
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Profiler
23
23
  module V2
24
- VERSION = "0.4.0"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -4,9 +4,11 @@
4
4
  require 'google/protobuf'
5
5
 
6
6
  require 'google/api/annotations_pb'
7
+ require 'google/api/client_pb'
8
+ require 'google/api/field_behavior_pb'
9
+ require 'google/api/resource_pb'
7
10
  require 'google/protobuf/duration_pb'
8
11
  require 'google/protobuf/field_mask_pb'
9
- require 'google/api/client_pb'
10
12
 
11
13
  Google::Protobuf::DescriptorPool.generated_pool.build do
12
14
  add_file("google/devtools/cloudprofiler/v2/profiler.proto", :syntax => :proto3) do
@@ -51,6 +51,7 @@ module Google
51
51
  # status. To a gRPC client, the extension will be return as a
52
52
  # binary-serialized proto in the trailing metadata item named
53
53
  # "google.rpc.retryinfo-bin".
54
+ #
54
55
  rpc :CreateProfile, ::Google::Cloud::Profiler::V2::CreateProfileRequest, ::Google::Cloud::Profiler::V2::Profile
55
56
  # CreateOfflineProfile creates a new profile resource in the offline mode.
56
57
  # The client provides the profile to create along with the profile bytes, the
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # An indicator of the behavior of a given field (for example, that a field
23
+ # is required in requests, or given as output but ignored as input).
24
+ # This **does not** change the behavior in protocol buffers itself; it only
25
+ # denotes the behavior and may affect how API tooling handles the field.
26
+ #
27
+ # Note: This enum **may** receive new values in the future.
28
+ module FieldBehavior
29
+ # Conventional default for enums. Do not use this.
30
+ FIELD_BEHAVIOR_UNSPECIFIED = 0
31
+
32
+ # Specifically denotes a field as optional.
33
+ # While all fields in protocol buffers are optional, this may be specified
34
+ # for emphasis if appropriate.
35
+ OPTIONAL = 1
36
+
37
+ # Denotes a field as required.
38
+ # This indicates that the field **must** be provided as part of the request,
39
+ # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
40
+ REQUIRED = 2
41
+
42
+ # Denotes a field as output only.
43
+ # This indicates that the field is provided in responses, but including the
44
+ # field in a request does nothing (the server *must* ignore it and
45
+ # *must not* throw an error as a result of the field's presence).
46
+ OUTPUT_ONLY = 3
47
+
48
+ # Denotes a field as input only.
49
+ # This indicates that the field is provided in requests, and the
50
+ # corresponding field is not included in output.
51
+ INPUT_ONLY = 4
52
+
53
+ # Denotes a field as immutable.
54
+ # This indicates that the field may be set once in a request to create a
55
+ # resource, but may not be changed thereafter.
56
+ IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
69
+ end
70
+ end
71
+ end
@@ -40,7 +40,7 @@ module Google
40
40
  end
41
41
 
42
42
  # CreateOfflineProfileRequest describes a profile resource offline creation
43
- # request. Profile field must be set.
43
+ # request.
44
44
  # @!attribute [rw] parent
45
45
  # @return [::String]
46
46
  # Parent project to create the profile in.
@@ -55,7 +55,7 @@ module Google
55
55
  # UpdateProfileRequest contains the profile to update.
56
56
  # @!attribute [rw] profile
57
57
  # @return [::Google::Cloud::Profiler::V2::Profile]
58
- # Profile to update
58
+ # Profile to update.
59
59
  # @!attribute [rw] update_mask
60
60
  # @return [::Google::Protobuf::FieldMask]
61
61
  # Field mask used to specify the fields to be overwritten. Currently only
@@ -68,7 +68,7 @@ module Google
68
68
  end
69
69
 
70
70
  # Profile resource.
71
- # @!attribute [rw] name
71
+ # @!attribute [r] name
72
72
  # @return [::String]
73
73
  # Output only. Opaque, server-assigned, unique ID for this profile.
74
74
  # @!attribute [rw] profile_type
@@ -94,7 +94,7 @@ module Google
94
94
  # @!attribute [rw] labels
95
95
  # @return [::Google::Protobuf::Map{::String => ::String}]
96
96
  # Input only. Labels associated to this specific profile. These labels will
97
- # get merged with the deployment labels for the final data set. See
97
+ # get merged with the deployment labels for the final data set. See
98
98
  # documentation on deployment labels for validation rules and limits.
99
99
  class Profile
100
100
  include ::Google::Protobuf::MessageExts
@@ -118,11 +118,11 @@ module Google
118
118
  # @!attribute [rw] target
119
119
  # @return [::String]
120
120
  # Target is the service name used to group related deployments:
121
- # * Service name for GAE Flex / Standard.
121
+ # * Service name for App Engine Flex / Standard.
122
122
  # * Cluster and container name for GKE.
123
- # * User-specified string for direct GCE profiling (e.g. Java).
123
+ # * User-specified string for direct Compute Engine profiling (e.g. Java).
124
124
  # * Job name for Dataflow.
125
- # Validation regex: `^[a-z]([-a-z0-9_.]{0,253}[a-z0-9])?$`.
125
+ # Validation regex: `^[a-z0-9]([-a-z0-9_.]{0,253}[a-z0-9])?$`.
126
126
  # @!attribute [rw] labels
127
127
  # @return [::Google::Protobuf::Map{::String => ::String}]
128
128
  # Labels identify the deployment within the user universe and same target.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-profiler-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-03-08 00:00:00.000000000 Z
11
+ date: 2023-03-16 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -177,6 +177,7 @@ files:
177
177
  - lib/google/cloud/profiler/v2/profiler_service.rb
178
178
  - lib/google/cloud/profiler/v2/profiler_service/client.rb
179
179
  - lib/google/cloud/profiler/v2/profiler_service/credentials.rb
180
+ - lib/google/cloud/profiler/v2/profiler_service/paths.rb
180
181
  - lib/google/cloud/profiler/v2/profiler_service/rest.rb
181
182
  - lib/google/cloud/profiler/v2/profiler_service/rest/client.rb
182
183
  - lib/google/cloud/profiler/v2/profiler_service/rest/service_stub.rb
@@ -186,6 +187,7 @@ files:
186
187
  - lib/google/devtools/cloudprofiler/v2/profiler_services_pb.rb
187
188
  - proto_docs/README.md
188
189
  - proto_docs/google/api/client.rb
190
+ - proto_docs/google/api/field_behavior.rb
189
191
  - proto_docs/google/api/launch_stage.rb
190
192
  - proto_docs/google/api/resource.rb
191
193
  - proto_docs/google/devtools/cloudprofiler/v2/profiler.rb