Package com.google.devtools.cloudprofiler.v2

Interface ProfilerServiceGrpc.AsyncService

All Known Implementing Classes:
ProfilerServiceGrpc.ProfilerServiceImplBase
Enclosing class:
ProfilerServiceGrpc
public static interface ProfilerServiceGrpc.AsyncService
 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.__

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    createOfflineProfile(CreateOfflineProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
    CreateOfflineProfile creates a new profile resource in the offline mode.
    default void
    createProfile(CreateProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
    CreateProfile creates a new profile resource in the online mode.
    default void
    updateProfile(UpdateProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
    UpdateProfile updates the profile bytes and labels on the profile resource created in the online mode.

  • Method Details

    • createProfile

      default void createProfile(CreateProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
       CreateProfile creates a new profile resource in the online mode.
 _Direct use of this API is discouraged, please use a [supported
 profiler
 agent](https://cloud.google.com/profiler/docs/about-profiler#profiling_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".

    • createOfflineProfile

      default void createOfflineProfile(CreateOfflineProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
       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](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
 instead for profile collection._

    • updateProfile

      default void updateProfile(UpdateProfileRequest request, io.grpc.stub.StreamObserver<Profile> responseObserver)
       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](https://cloud.google.com/profiler/docs/about-profiler#profiling_agent)
 instead for profile collection._