Enum value maps for ProfileType.
var (
ProfileType_name = map[int32]string{
0: "PROFILE_TYPE_UNSPECIFIED",
1: "CPU",
2: "WALL",
3: "HEAP",
4: "THREADS",
5: "CONTENTION",
6: "PEAK_HEAP",
7: "HEAP_ALLOC",
}
ProfileType_value = map[string]int32{
"PROFILE_TYPE_UNSPECIFIED": 0,
"CPU": 1,
"WALL": 2,
"HEAP": 3,
"THREADS": 4,
"CONTENTION": 5,
"PEAK_HEAP": 6,
"HEAP_ALLOC": 7,
}
)
var File_google_devtools_cloudprofiler_v2_profiler_proto protoreflect.FileDescriptor
func RegisterProfilerServiceServer(s *grpc.Server, srv ProfilerServiceServer)
CreateOfflineProfileRequest describes a profile resource offline creation request.
type CreateOfflineProfileRequest struct {
// Parent project to create the profile in.
Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
// Contents of the profile to create.
Profile *Profile `protobuf:"bytes,2,opt,name=profile,proto3" json:"profile,omitempty"`
// contains filtered or unexported fields
}
func (*CreateOfflineProfileRequest) Descriptor() ([]byte, []int)
Deprecated: Use CreateOfflineProfileRequest.ProtoReflect.Descriptor instead.
func (x *CreateOfflineProfileRequest) GetParent() string
func (x *CreateOfflineProfileRequest) GetProfile() *Profile
func (*CreateOfflineProfileRequest) ProtoMessage()
func (x *CreateOfflineProfileRequest) ProtoReflect() protoreflect.Message
func (x *CreateOfflineProfileRequest) Reset()
func (x *CreateOfflineProfileRequest) String() string
CreateProfileRequest describes a profile resource online creation request. The deployment field must be populated. The profile_type specifies the list of profile types supported by the agent. The creation call will hang until a profile of one of these types needs to be collected.
type CreateProfileRequest struct {
// Parent project to create the profile in.
Parent string `protobuf:"bytes,4,opt,name=parent,proto3" json:"parent,omitempty"`
// Deployment details.
Deployment *Deployment `protobuf:"bytes,1,opt,name=deployment,proto3" json:"deployment,omitempty"`
// One or more profile types that the agent is capable of providing.
ProfileType []ProfileType `protobuf:"varint,2,rep,packed,name=profile_type,json=profileType,proto3,enum=google.devtools.cloudprofiler.v2.ProfileType" json:"profile_type,omitempty"`
// contains filtered or unexported fields
}
func (*CreateProfileRequest) Descriptor() ([]byte, []int)
Deprecated: Use CreateProfileRequest.ProtoReflect.Descriptor instead.
func (x *CreateProfileRequest) GetDeployment() *Deployment
func (x *CreateProfileRequest) GetParent() string
func (x *CreateProfileRequest) GetProfileType() []ProfileType
func (*CreateProfileRequest) ProtoMessage()
func (x *CreateProfileRequest) ProtoReflect() protoreflect.Message
func (x *CreateProfileRequest) Reset()
func (x *CreateProfileRequest) String() string
Deployment contains the deployment identification information.
type Deployment struct {
// Project ID is the ID of a cloud project.
// Validation regex: `^[a-z][-a-z0-9:.]{4,61}[a-z0-9]$`.
ProjectId string `protobuf:"bytes,1,opt,name=project_id,json=projectId,proto3" json:"project_id,omitempty"`
// Target is the service name used to group related deployments:
// * Service name for App Engine Flex / Standard.
// * Cluster and container name for GKE.
// * User-specified string for direct Compute Engine profiling (e.g. Java).
// * Job name for Dataflow.
// Validation regex: `^[a-z0-9]([-a-z0-9_.]{0,253}[a-z0-9])?$`.
Target string `protobuf:"bytes,2,opt,name=target,proto3" json:"target,omitempty"`
// Labels identify the deployment within the user universe and same target.
// Validation regex for label names: `^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$`.
// Value for an individual label must be <= 512 bytes, the total
// size of all label names and values must be <= 1024 bytes.
//
// Label named "language" can be used to record the programming language of
// the profiled deployment. The standard choices for the value include "java",
// "go", "python", "ruby", "nodejs", "php", "dotnet".
//
// For deployments running on Google Cloud Platform, "zone" or "region" label
// should be present describing the deployment location. An example of a zone
// is "us-central1-a", an example of a region is "us-central1" or
// "us-central".
Labels map[string]string `protobuf:"bytes,3,rep,name=labels,proto3" json:"labels,omitempty" protobuf_key:"bytes,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"`
// contains filtered or unexported fields
}
func (*Deployment) Descriptor() ([]byte, []int)
Deprecated: Use Deployment.ProtoReflect.Descriptor instead.
func (x *Deployment) GetLabels() map[string]string
func (x *Deployment) GetProjectId() string
func (x *Deployment) GetTarget() string
func (*Deployment) ProtoMessage()
func (x *Deployment) ProtoReflect() protoreflect.Message
func (x *Deployment) Reset()
func (x *Deployment) String() string
Profile resource.
type Profile struct {
// Output only. Opaque, server-assigned, unique ID for this profile.
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
// Type of profile.
// For offline mode, this must be specified when creating the profile. For
// online mode it is assigned and returned by the server.
ProfileType ProfileType `protobuf:"varint,2,opt,name=profile_type,json=profileType,proto3,enum=google.devtools.cloudprofiler.v2.ProfileType" json:"profile_type,omitempty"`
// Deployment this profile corresponds to.
Deployment *Deployment `protobuf:"bytes,3,opt,name=deployment,proto3" json:"deployment,omitempty"`
// Duration of the profiling session.
// Input (for the offline mode) or output (for the online mode).
// The field represents requested profiling duration. It may slightly differ
// from the effective profiling duration, which is recorded in the profile
// data, in case the profiling can't be stopped immediately (e.g. in case
// stopping the profiling is handled asynchronously).
Duration *durationpb.Duration `protobuf:"bytes,4,opt,name=duration,proto3" json:"duration,omitempty"`
// Input only. Profile bytes, as a gzip compressed serialized proto, the
// format is https://github.com/google/pprof/blob/master/proto/profile.proto.
ProfileBytes []byte `protobuf:"bytes,5,opt,name=profile_bytes,json=profileBytes,proto3" json:"profile_bytes,omitempty"`
// Input only. Labels associated to this specific profile. These labels will
// get merged with the deployment labels for the final data set. See
// documentation on deployment labels for validation rules and limits.
Labels map[string]string `protobuf:"bytes,6,rep,name=labels,proto3" json:"labels,omitempty" protobuf_key:"bytes,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"`
// contains filtered or unexported fields
}
func (*Profile) Descriptor() ([]byte, []int)
Deprecated: Use Profile.ProtoReflect.Descriptor instead.
func (x *Profile) GetDeployment() *Deployment
func (x *Profile) GetDuration() *durationpb.Duration
func (x *Profile) GetLabels() map[string]string
func (x *Profile) GetName() string
func (x *Profile) GetProfileBytes() []byte
func (x *Profile) GetProfileType() ProfileType
func (*Profile) ProtoMessage()
func (x *Profile) ProtoReflect() protoreflect.Message
func (x *Profile) Reset()
func (x *Profile) String() string
ProfileType is type of profiling data. NOTE: the enumeration member names are used (in lowercase) as unique string identifiers of profile types, so they must not be renamed.
type ProfileType int32
const (
// Unspecified profile type.
ProfileType_PROFILE_TYPE_UNSPECIFIED ProfileType = 0
// Thread CPU time sampling.
ProfileType_CPU ProfileType = 1
// Wallclock time sampling. More expensive as stops all threads.
ProfileType_WALL ProfileType = 2
// In-use heap profile. Represents a snapshot of the allocations that are
// live at the time of the profiling.
ProfileType_HEAP ProfileType = 3
// Single-shot collection of all thread stacks.
ProfileType_THREADS ProfileType = 4
// Synchronization contention profile.
ProfileType_CONTENTION ProfileType = 5
// Peak heap profile.
ProfileType_PEAK_HEAP ProfileType = 6
// Heap allocation profile. It represents the aggregation of all allocations
// made over the duration of the profile. All allocations are included,
// including those that might have been freed by the end of the profiling
// interval. The profile is in particular useful for garbage collecting
// languages to understand which parts of the code create most of the garbage
// collection pressure to see if those can be optimized.
ProfileType_HEAP_ALLOC ProfileType = 7
)
func (ProfileType) Descriptor() protoreflect.EnumDescriptor
func (x ProfileType) Enum() *ProfileType
func (ProfileType) EnumDescriptor() ([]byte, []int)
Deprecated: Use ProfileType.Descriptor instead.
func (x ProfileType) Number() protoreflect.EnumNumber
func (x ProfileType) String() string
func (ProfileType) Type() protoreflect.EnumType
ProfilerServiceClient is the client API for ProfilerService service.
For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
type ProfilerServiceClient interface {
// 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".
CreateProfile(ctx context.Context, in *CreateProfileRequest, opts ...grpc.CallOption) (*Profile, error)
// 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.
CreateOfflineProfile(ctx context.Context, in *CreateOfflineProfileRequest, opts ...grpc.CallOption) (*Profile, error)
// 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.
UpdateProfile(ctx context.Context, in *UpdateProfileRequest, opts ...grpc.CallOption) (*Profile, error)
}
func NewProfilerServiceClient(cc grpc.ClientConnInterface) ProfilerServiceClient
ProfilerServiceServer is the server API for ProfilerService service.
type ProfilerServiceServer interface {
// 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".
CreateProfile(context.Context, *CreateProfileRequest) (*Profile, error)
// 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.
CreateOfflineProfile(context.Context, *CreateOfflineProfileRequest) (*Profile, error)
// 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.
UpdateProfile(context.Context, *UpdateProfileRequest) (*Profile, error)
}
UnimplementedProfilerServiceServer can be embedded to have forward compatible implementations.
type UnimplementedProfilerServiceServer struct {
}
func (*UnimplementedProfilerServiceServer) CreateOfflineProfile(context.Context, *CreateOfflineProfileRequest) (*Profile, error)
func (*UnimplementedProfilerServiceServer) CreateProfile(context.Context, *CreateProfileRequest) (*Profile, error)
func (*UnimplementedProfilerServiceServer) UpdateProfile(context.Context, *UpdateProfileRequest) (*Profile, error)
UpdateProfileRequest contains the profile to update.
type UpdateProfileRequest struct {
// Profile to update.
Profile *Profile `protobuf:"bytes,1,opt,name=profile,proto3" json:"profile,omitempty"`
// Field mask used to specify the fields to be overwritten. Currently only
// profile_bytes and labels fields are supported by UpdateProfile, so only
// those fields can be specified in the mask. When no mask is provided, all
// fields are overwritten.
UpdateMask *fieldmaskpb.FieldMask `protobuf:"bytes,2,opt,name=update_mask,json=updateMask,proto3" json:"update_mask,omitempty"`
// contains filtered or unexported fields
}
func (*UpdateProfileRequest) Descriptor() ([]byte, []int)
Deprecated: Use UpdateProfileRequest.ProtoReflect.Descriptor instead.
func (x *UpdateProfileRequest) GetProfile() *Profile
func (x *UpdateProfileRequest) GetUpdateMask() *fieldmaskpb.FieldMask
func (*UpdateProfileRequest) ProtoMessage()
func (x *UpdateProfileRequest) ProtoReflect() protoreflect.Message
func (x *UpdateProfileRequest) Reset()
func (x *UpdateProfileRequest) String() string