perfetto-protos
Version:
Perfetto protos exposed via protobuf-es for browser and node
408 lines • 13.3 kB
TypeScript
import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
import type { Message } from "@bufbuild/protobuf";
/**
* Describes the file protos/third_party/pprof/profile.proto.
*/
export declare const file_protos_third_party_pprof_profile: GenFile;
/**
* @generated from message perfetto.third_party.perftools.profiles.Profile
*/
export type Profile = Message<"perfetto.third_party.perftools.profiles.Profile"> & {
/**
* A description of the samples associated with each Sample.value.
* For a cpu profile this might be:
* [["cpu","nanoseconds"]] or [["wall","seconds"]] or [["syscall","count"]]
* For a heap profile, this might be:
* [["allocations","count"], ["space","bytes"]],
* If one of the values represents the number of events represented
* by the sample, by convention it should be at index 0 and use
* sample_type.unit == "count".
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.ValueType sample_type = 1;
*/
sampleType: ValueType[];
/**
* The set of samples recorded in this profile.
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Sample sample = 2;
*/
sample: Sample[];
/**
* Mapping from address ranges to the image/binary/library mapped
* into that address range. mapping[0] will be the main binary.
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Mapping mapping = 3;
*/
mapping: Mapping[];
/**
* Useful program location
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Location location = 4;
*/
location: Location[];
/**
* Functions referenced by locations
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Function function = 5;
*/
function: Function[];
/**
* A common table for strings referenced by various messages.
* string_table[0] must always be "".
*
* @generated from field: repeated string string_table = 6;
*/
stringTable: string[];
/**
* frames with Function.function_name fully matching the following
* regexp will be dropped from the samples, along with their successors.
* Index into string table.
*
* @generated from field: int64 drop_frames = 7;
*/
dropFrames: bigint;
/**
* frames with Function.function_name fully matching the following
* regexp will be kept, even if it matches drop_functions.
* Index into string table.
*
* @generated from field: int64 keep_frames = 8;
*/
keepFrames: bigint;
/**
* Time of collection (UTC) represented as nanoseconds past the epoch.
*
* @generated from field: int64 time_nanos = 9;
*/
timeNanos: bigint;
/**
* Duration of the profile, if a duration makes sense.
*
* @generated from field: int64 duration_nanos = 10;
*/
durationNanos: bigint;
/**
* The kind of events between sampled ocurrences.
* e.g [ "cpu","cycles" ] or [ "heap","bytes" ]
*
* @generated from field: perfetto.third_party.perftools.profiles.ValueType period_type = 11;
*/
periodType?: ValueType;
/**
* The number of events between sampled occurrences.
*
* @generated from field: int64 period = 12;
*/
period: bigint;
/**
* Freeform text associated to the profile.
* Indices into string table.
*
* @generated from field: repeated int64 comment = 13;
*/
comment: bigint[];
/**
* Index into the string table of the type of the preferred sample
* value. If unset, clients should default to the last sample value.
*
* @generated from field: int64 default_sample_type = 14;
*/
defaultSampleType: bigint;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Profile.
* Use `create(ProfileSchema)` to create a new message.
*/
export declare const ProfileSchema: GenMessage<Profile>;
/**
* ValueType describes the semantics and measurement units of a value.
*
* @generated from message perfetto.third_party.perftools.profiles.ValueType
*/
export type ValueType = Message<"perfetto.third_party.perftools.profiles.ValueType"> & {
/**
* Index into string table.
*
* @generated from field: int64 type = 1;
*/
type: bigint;
/**
* Index into string table.
*
* @generated from field: int64 unit = 2;
*/
unit: bigint;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.ValueType.
* Use `create(ValueTypeSchema)` to create a new message.
*/
export declare const ValueTypeSchema: GenMessage<ValueType>;
/**
* Each Sample records values encountered in some program
* context. The program context is typically a stack trace, perhaps
* augmented with auxiliary information like the thread-id, some
* indicator of a higher level request being handled etc.
*
* @generated from message perfetto.third_party.perftools.profiles.Sample
*/
export type Sample = Message<"perfetto.third_party.perftools.profiles.Sample"> & {
/**
* The ids recorded here correspond to a Profile.location.id.
* The leaf is at location_id[0].
*
* @generated from field: repeated uint64 location_id = 1;
*/
locationId: bigint[];
/**
* The type and unit of each value is defined by the corresponding
* entry in Profile.sample_type. All samples must have the same
* number of values, the same as the length of Profile.sample_type.
* When aggregating multiple samples into a single sample, the
* result has a list of values that is the elemntwise sum of the
* lists of the originals.
*
* @generated from field: repeated int64 value = 2;
*/
value: bigint[];
/**
* label includes additional context for this sample. It can include
* things like a thread id, allocation size, etc
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Label label = 3;
*/
label: Label[];
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Sample.
* Use `create(SampleSchema)` to create a new message.
*/
export declare const SampleSchema: GenMessage<Sample>;
/**
* @generated from message perfetto.third_party.perftools.profiles.Label
*/
export type Label = Message<"perfetto.third_party.perftools.profiles.Label"> & {
/**
* Index into string table
*
* @generated from field: int64 key = 1;
*/
key: bigint;
/**
* Index into string table
*
* @generated from field: int64 str = 2;
*/
str: bigint;
/**
* @generated from field: int64 num = 3;
*/
num: bigint;
/**
* Index into string table
*
* @generated from field: int64 num_unit = 4;
*/
numUnit: bigint;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Label.
* Use `create(LabelSchema)` to create a new message.
*/
export declare const LabelSchema: GenMessage<Label>;
/**
* @generated from message perfetto.third_party.perftools.profiles.Mapping
*/
export type Mapping = Message<"perfetto.third_party.perftools.profiles.Mapping"> & {
/**
* Unique nonzero id for the mapping.
*
* @generated from field: uint64 id = 1;
*/
id: bigint;
/**
* Address at which the binary (or DLL) is loaded into memory.
*
* @generated from field: uint64 memory_start = 2;
*/
memoryStart: bigint;
/**
* The limit of the address range occupied by this mapping.
*
* @generated from field: uint64 memory_limit = 3;
*/
memoryLimit: bigint;
/**
* Offset in the binary that corresponds to the first mapped address.
*
* @generated from field: uint64 file_offset = 4;
*/
fileOffset: bigint;
/**
* The object this entry is loaded from. This can be a filename on
* disk for the main binary and shared libraries, or virtual
* abstractions like "[vdso]".
* Index into string table
*
* @generated from field: int64 filename = 5;
*/
filename: bigint;
/**
* A string that uniquely identifies a particular program version
* with high probability. E.g., for binaries generated by GNU tools,
* it could be the contents of the .note.gnu.build-id field.
* Index into string table
*
* @generated from field: int64 build_id = 6;
*/
buildId: bigint;
/**
* The following fields indicate the resolution of symbolic info.
*
* @generated from field: bool has_functions = 7;
*/
hasFunctions: boolean;
/**
* @generated from field: bool has_filenames = 8;
*/
hasFilenames: boolean;
/**
* @generated from field: bool has_line_numbers = 9;
*/
hasLineNumbers: boolean;
/**
* @generated from field: bool has_inline_frames = 10;
*/
hasInlineFrames: boolean;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Mapping.
* Use `create(MappingSchema)` to create a new message.
*/
export declare const MappingSchema: GenMessage<Mapping>;
/**
* Describes function and line table debug information.
*
* @generated from message perfetto.third_party.perftools.profiles.Location
*/
export type Location = Message<"perfetto.third_party.perftools.profiles.Location"> & {
/**
* Unique nonzero id for the location. A profile could use
* instruction addresses or any integer sequence as ids.
*
* @generated from field: uint64 id = 1;
*/
id: bigint;
/**
* The id of the corresponding profile.Mapping for this location.
* It can be unset if the mapping is unknown or not applicable for
* this profile type.
*
* @generated from field: uint64 mapping_id = 2;
*/
mappingId: bigint;
/**
* The instruction address for this location, if available. It
* should be within [Mapping.memory_start...Mapping.memory_limit]
* for the corresponding mapping. A non-leaf address may be in the
* middle of a call instruction. It is up to display tools to find
* the beginning of the instruction if necessary.
*
* @generated from field: uint64 address = 3;
*/
address: bigint;
/**
* Multiple line indicates this location has inlined functions,
* where the last entry represents the caller into which the
* preceding entries were inlined.
*
* E.g., if memcpy() is inlined into printf:
* line[0].function_name == "memcpy"
* line[1].function_name == "printf"
*
* @generated from field: repeated perfetto.third_party.perftools.profiles.Line line = 4;
*/
line: Line[];
/**
* Provides an indication that multiple symbols map to this location's
* address, for example due to identical code folding by the linker. In that
* case the line information above represents one of the multiple
* symbols. This field must be recomputed when the symbolization state of the
* profile changes.
*
* @generated from field: bool is_folded = 5;
*/
isFolded: boolean;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Location.
* Use `create(LocationSchema)` to create a new message.
*/
export declare const LocationSchema: GenMessage<Location>;
/**
* @generated from message perfetto.third_party.perftools.profiles.Line
*/
export type Line = Message<"perfetto.third_party.perftools.profiles.Line"> & {
/**
* The id of the corresponding profile.Function for this line.
*
* @generated from field: uint64 function_id = 1;
*/
functionId: bigint;
/**
* Line number in source code.
*
* @generated from field: int64 line = 2;
*/
line: bigint;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Line.
* Use `create(LineSchema)` to create a new message.
*/
export declare const LineSchema: GenMessage<Line>;
/**
* @generated from message perfetto.third_party.perftools.profiles.Function
*/
export type Function = Message<"perfetto.third_party.perftools.profiles.Function"> & {
/**
* Unique nonzero id for the function.
*
* @generated from field: uint64 id = 1;
*/
id: bigint;
/**
* Name of the function, in human-readable form if available.
* Index into string table
*
* @generated from field: int64 name = 2;
*/
name: bigint;
/**
* Name of the function, as identified by the system.
* For instance, it can be a C++ mangled name.
* Index into string table
*
* @generated from field: int64 system_name = 3;
*/
systemName: bigint;
/**
* Source file containing the function.
* Index into string table
*
* @generated from field: int64 filename = 4;
*/
filename: bigint;
/**
* Line number in source file.
*
* @generated from field: int64 start_line = 5;
*/
startLine: bigint;
};
/**
* Describes the message perfetto.third_party.perftools.profiles.Function.
* Use `create(FunctionSchema)` to create a new message.
*/
export declare const FunctionSchema: GenMessage<Function>;
//# sourceMappingURL=profile_pb.d.ts.map