Package com.google.devtools.cloudprofiler.v2

Class ProfilerServiceGrpc.ProfilerServiceFutureStub

  • Enclosing class:
    ProfilerServiceGrpc
    public static final class ProfilerServiceGrpc.ProfilerServiceFutureStub
extends io.grpc.stub.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.
 General guidelines:
 * Profiles for a single deployment must be created in ascending time order.
 * Profiles can be created in either online or offline mode, see below.

    • Method Detail

      • createProfile

        public com.google.common.util.concurrent.ListenableFuture<Profile> createProfile​(CreateProfileRequest request)
         CreateProfile creates a new profile resource in the online mode.
 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".

      • createOfflineProfile

        public com.google.common.util.concurrent.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.

      • updateProfile

        public com.google.common.util.concurrent.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.