Class ProfilerServiceGrpc.ProfilerServiceFutureStub (2.42.0)

public static final class ProfilerServiceGrpc.ProfilerServiceFutureStub extends AbstractFutureStub<ProfilerServiceGrpc.ProfilerServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service ProfilerService.

Manage the collection of continuous profiling data provided by profiling agents running in the cloud or by an offline provider of profiling data. The APIs listed in this service are intended for use within our profiler agents only.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > ProfilerServiceGrpc.ProfilerServiceFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected ProfilerServiceGrpc.ProfilerServiceFutureStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
ProfilerServiceGrpc.ProfilerServiceFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

createOfflineProfile(CreateOfflineProfileRequest request)

public ListenableFuture<Profile> createOfflineProfile(CreateOfflineProfileRequest request)

CreateOfflineProfile creates a new profile resource in the offline mode. The client provides the profile to create along with the profile bytes, the server records it. Direct use of this API is discouraged, please use a supported profiler agent instead for profile collection.

Parameter
Name Description
request CreateOfflineProfileRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Profile>

createProfile(CreateProfileRequest request)

public ListenableFuture<Profile> createProfile(CreateProfileRequest request)

CreateProfile creates a new profile resource in the online mode. Direct use of this API is discouraged, please use a supported profiler agent instead for profile collection. The server ensures that the new profiles are created at a constant rate per deployment, so the creation request may hang for some time until the next profile session is available. The request may fail with ABORTED error if the creation is not available within ~1m, the response will indicate the duration of the backoff the client should take before attempting creating a profile again. The backoff duration is returned in google.rpc.RetryInfo extension on the response status. To a gRPC client, the extension will be return as a binary-serialized proto in the trailing metadata item named "google.rpc.retryinfo-bin".

Parameter
Name Description
request CreateProfileRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Profile>

updateProfile(UpdateProfileRequest request)

public ListenableFuture<Profile> updateProfile(UpdateProfileRequest request)

UpdateProfile updates the profile bytes and labels on the profile resource created in the online mode. Updating the bytes for profiles created in the offline mode is currently not supported: the profile content must be provided at the time of the profile creation. Direct use of this API is discouraged, please use a supported profiler agent instead for profile collection.

Parameter
Name Description
request UpdateProfileRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Profile>