package quipper

Get desktop application:
View/edit binary Protocol Buffers messages

Next tag: 18

• repeated PerfDataProto.PerfFileAttr file_attrs = 1

• repeated PerfDataProto.PerfEvent events = 2

• repeated PerfDataProto.PerfEventType event_types = 10

• optional uint64 timestamp_sec = 3

  Time when quipper generated this perf data / protobuf, given as seconds since the epoch.

• optional PerfDataProto.PerfEventStats stats = 4

  Records some stats about the serialized perf events.

• repeated uint64 metadata_mask = 5

  Bit mask used to determine what metadata has been included. At the moment, only the first number is actually used. See adds_features in perf_reader.cc

• optional PerfDataProto.PerfTracingMetadata tracing_data = 14

• repeated PerfDataProto.PerfBuildID build_ids = 7

• repeated PerfDataProto.PerfUint32Metadata uint32_metadata = 8

• repeated PerfDataProto.PerfUint64Metadata uint64_metadata = 9

• optional PerfDataProto.PerfCPUTopologyMetadata cpu_topology = 11

• repeated PerfDataProto.PerfNodeTopologyMetadata numa_topology = 12

• repeated PerfDataProto.PerfPMUMappingsMetadata pmu_mappings = 15

• repeated PerfDataProto.PerfGroupDescMetadata group_desc = 16

• repeated PerfDataProto.PerfHybridTopologyMetadata hybrid_topology = 17

• optional PerfDataProto.StringMetadata string_metadata = 13

Next tag: 7

Used in: PerfEvent

• optional uint64 aux_offset = 1

  Aux offset.

• optional uint64 aux_size = 2

  Aux size.

• optional bool is_truncated = 3

  Is the record was truncated to fit.

• optional bool is_overwrite = 4

  Does the record contain snapshot from overwrite mode.

• optional bool is_partial = 5

  Does the record contain gaps.

• optional SampleInfo sample_info = 6

  Info about the perf sample containing this event.

Next tag: 9

Used in: PerfEvent

• optional uint32 type = 1

  Error type as defined by the enum auxtrace_error_type_name.

• optional uint32 code = 2

  Intel PT or Intel BTS specific error code.

• optional uint32 cpu = 3

  In per-cpu mode, the cpu this auxtrace error is associated with.

• optional uint32 pid = 4

  Process ID.

• optional uint32 tid = 5

  In per-thread mode, the tid this auxtrace error is associated with.

• optional uint64 ip = 6

  From instruction pointer.

• optional string msg = 7

  Auxtrace error message.

• optional uint64 msg_md5_prefix = 8

  Message's md5 prefix.

Next tag: 8

Used in: PerfEvent

• optional uint64 size = 1

  Size of AUX area tracing buffer.

• optional uint64 offset = 2

  Offset as determined by aux_head / aux_tail members of struct perf_event_mmap_page.

• optional uint64 reference = 3

  Implementation specific reference determined when the data is recorded.

• optional uint32 idx = 4

  Index of AUX area tracing data buffer.

• optional uint32 tid = 5

  In per-thread mode, the tid this buffer is associated with.

• optional uint32 cpu = 6

  In per-cpu mode, the cpu this buffer is associated with.

• optional bytes trace_data = 7

  The trace data.

Next tag: 3

Used in: PerfEvent

• optional uint32 type = 1

  Auxtrace type from the auxtrace_type enum in tools/perf/util/auxtrace.h.

• repeated uint64 unparsed_binary_blob_priv_data = 2

  Private data. WARNING: unparsed_binary_blob_priv_data contains unparsed private data specific to the type stored in the above field. This data is included to support serialization of a perf.data to perf_data.proto and deserialization of a perf_data.proto to perf.data. If this data is used for something other than the aforementioned usecase, this data has to be parsed based on the type. For example: If type == PERF_AUXTRACE_INTEL_PT, unparsed_binary_blob_priv_data contains fields filled by intel_pt_info_fill() function in the file tools/perf/arch/x86/util/intel-pt.c. If type == PERF_AUXTRACE_INTEL_BTS, unparsed_binary_blob_priv_data contains fields filled by intel_bts_info_fill() function in the file tools/perf/arch/x86/util/intel-bts.c. NOTE: Do not read this unparsed data directly. Quipper should be modified to parse the data into a new field before reading. Please contact developers of quipper to add support for parsing this data.

Next tag: 10

Used in: SampleEvent

• optional uint64 from_ip = 1

  Branch source address.

• optional uint64 to_ip = 2

  Branch destination address.

• optional bool mispredicted = 3

  Indicates a mispredicted branch.

• optional bool predicted = 4

  Indicates a predicted branch.

• optional bool in_transaction = 5

  Indicates running in a hardware transaction

• optional bool abort = 6

  Indicates aborting a hardware transaction

• optional uint32 cycles = 7

  Cycle count to last branch

• optional uint32 type = 8

  Branch type.

• optional uint32 spec = 9

  Branch speculation info.

Next tag: 4

Used in: PerfEvent

• optional uint64 id = 1

  Cgroup ID (file handle).

• optional string path = 2

  Cgroup path.

• optional SampleInfo sample_info = 3

  Info about the perf sample containing this event.

Next tag: 7

Used in: PerfEvent

• optional uint32 pid = 1

  Process id.

• optional uint32 tid = 2

  Thread id.

• optional string comm = 3

  Comm string.

• optional uint64 comm_md5_prefix = 4

  Comm string's md5 prefix.

• optional uint64 sample_time = 5

  Time the sample was taken. Deprecated, use |sample_info| instead.

• optional SampleInfo sample_info = 6

  Info about the perf sample containing this event.

Next tag: 5

Used in: PerfEvent

• optional bool is_out = 1

  Indicates whether the context switch is in or out.

• optional uint32 next_prev_pid = 2

  Next (switching out) or previous (switching in) pid.

• optional uint32 next_prev_tid = 3

  Next (switching out) or previous (switching in) tid.

• optional SampleInfo sample_info = 4

  Info about the perf sample containing this event.

Next tag: 4

Used in: PerfEvent

• optional uint32 type = 1

  Type of event.

• optional uint32 misc = 2

• optional uint32 size = 3

  Size of event.

ForkEvent is used for both FORK and EXIT events, which have the same data format. We don't want to call this "ForkOrExitEvent", in case a separate exit event is introduced in the future. Next tag: 12

Used in: PerfEvent

• optional uint32 pid = 1

  Forked process ID.

• optional uint32 ppid = 2

  Parent process ID.

• optional uint32 tid = 3

  Forked process thread ID.

• optional uint32 ptid = 4

  Parent process thread ID.

• optional uint64 fork_time_ns = 5

  Time of fork event in nanoseconds since bootup.

• optional SampleInfo sample_info = 11

  Info about the perf sample containing this event.

Used in: PerfEvent

• repeated IdIndexEventEntry entries = 1

Next tag: 5

Used in: IdIndexEvent

• optional uint64 id = 1

  Perf sample identifier.

• optional uint64 idx = 2

  Index associated with the sample identifier.

• optional uint64 cpu = 3

  CPU associated with the sample identifier.

• optional uint64 tid = 4

  Thread ID associated with the sample identifier.

Next tag: 4

Used in: PerfEvent

• optional uint32 pid = 1

• optional uint32 tid = 2

• optional SampleInfo sample_info = 3

  Info about the perf sample containing this event.

Next tag: 7

Used in: PerfEvent

• optional uint64 addr = 1

  Address of kernel symbol.

• optional uint32 len = 2

  Address length of kernel symbol.

• optional uint32 ksym_type = 3

  Type of the kernel symbol. Currently the following types are available: PERF_RECORD_KSYMBOL_TYPE_BPF. More info in documentation: https://screenshot.googleplex.com/VZsTDGmoGqgHRDJ

• optional uint32 flags = 4

  Ksymbol flags. PERF_RECORD_KSYMBOL_FLAGS_UNREGISTER is the only supported flag. More info in documentation: https://screenshot.googleplex.com/VZsTDGmoGqgHRDJ

• optional string name = 5

  Ksymbol name.

• optional SampleInfo sample_info = 6

  Info about the perf sample containing this event.

The kernel collects the number of events it couldn't send in a stretch and when possible sends this number in a PERF_RECORD_LOST event, which is stored in LostEvent. Next tag: 4

Used in: PerfEvent

• optional uint64 id = 1

  ID of the event which has been lost. This should be an id found in a PerfFileAttr.

• optional uint64 lost = 2

  Number of events that were lost.

• optional SampleInfo sample_info = 3

  Info about the perf sample containing this event.

The kernel discards mixed up samples and sends the number in a PERF_RECORD_LOST_SAMPLES event. This event is stored in LostSamplesEvent. Next tag: 3

Used in: PerfEvent

• optional uint64 num_lost = 1

  Number of lost samples.

• optional SampleInfo sample_info = 2

  Info about the perf sample containing this event.

Represents both mmap_event and mmap2_event. Next tag: 18

Used in: PerfEvent

• optional uint32 pid = 1

  Process id.

• optional uint32 tid = 2

  Thread id.

• optional uint64 start = 3

  Start address.

• optional uint64 len = 4

  Length.

• optional uint64 pgoff = 5

  PG Offset.

• optional uint32 maj = 9

  Only in MMAP2 events, information about the mapped inode: Major/minor numbers Note that those the fields maj, min, ino, ino_generation should be unspecified if build_id is set.

• optional uint32 min = 10

• optional uint64 ino = 11

  Inode number and generation.

• optional uint64 ino_generation = 12

• optional string build_id = 17

  Only in MMAP2 events, the build ID of this mmap. The build_id is a HexString representation of the bytes in original perf.data (example value: "af2272facafc97e344e12aff495cbddd00000000"). Note that this field should be unspecified if any of the inode-related fields (maj, min, ino, ino_generation) are set.

• optional uint32 prot = 13

  Protection bits and flags.

• optional uint32 flags = 14

• optional string filename = 6

  Filename.

• optional uint64 filename_md5_prefix = 7

  Filename's md5 prefix.

• optional string root_path = 15

  The root path is defined as the first two levels of directories starting from the root, e.g. /data/app, /system/lib.

• optional uint64 root_path_md5_prefix = 16

  Root path's md5 prefix. It helps to categorize filenames we could not recover by the filename_md5_prefix.

• optional SampleInfo sample_info = 8

  Info about the perf sample containing this event.

Next tag: 5

Used in: PerfEvent

• optional uint32 pid = 1

  PID of the process mapped to these namespaces.

• optional uint32 tid = 2

  TID of the process mapped to these namespaces.

• repeated PerfNamespacesLinkInfo link_info = 3

  Device/inode information per namespace up to NR_NAMESPACES.

• optional SampleInfo sample_info = 4

  Info about the perf sample containing this event.

Next tag: 8

Used in: PerfDataProto

• optional uint32 misc = 1

  Misc field in perf_event_header.

• optional uint32 pid = 2

  Process ID.

• optional bytes build_id_hash = 3

  Build id. Should always contain kBuildIDArraySize bytes of data. perf_reader.h defines kBuildIDArraySize = 20.

• optional string filename = 4

  Filename.

• optional uint64 filename_md5_prefix = 5

  Filename Md5sum prefix.

• optional uint32 size = 6

  Build id size.

• optional bool is_injected = 7

  If the build ID event is injected through a filename -> build ID map of quipper's PerfReader::InjectBuildIDs(), i.e., the Build ID event is not in the original perf.data.

Next tag: 6

Used in: PerfDataProto

• repeated string core_siblings = 1

  Core siblings.

• repeated uint64 core_siblings_md5_prefix = 2

  Core siblings' md5 prefixes.

• repeated string thread_siblings = 3

  Thread siblings.

• repeated uint64 thread_siblings_md5_prefix = 4

  Thread siblings' md5 prefixes.

• repeated PerfCPUTopologyMetadata.CPU available_cpus = 5

Core ID and Socket ID per CPU.

Used in: PerfCPUTopologyMetadata

• optional uint32 core_id = 1

  Core ID

• optional uint32 socket_id = 2

  Socket ID

Next tag: 27

Used in: PerfDataProto

• optional EventHeader header = 1

• oneof event_type

  • MMapEvent mmap_event = 2

  • SampleEvent sample_event = 3

  • CommEvent comm_event = 4

  • ForkEvent fork_event = 5

    FORK and EXIT events are structurally identical. They only differ by the event type. But using two distinct fields allows us to differentiate between them without having to check the event type under |header|.

  • ForkEvent exit_event = 9

  • LostEvent lost_event = 6

  • ThrottleEvent throttle_event = 7

  • ReadEvent read_event = 8

  • AuxEvent aux_event = 11

  • ItraceStartEvent itrace_start_event = 13

  • LostSamplesEvent lost_samples_event = 14

  • ContextSwitchEvent context_switch_event = 15

  • NamespacesEvent namespaces_event = 16

  • AuxtraceInfoEvent auxtrace_info_event = 18

  • AuxtraceEvent auxtrace_event = 12

  • AuxtraceErrorEvent auxtrace_error_event = 19

  • IdIndexEvent id_index_event = 26

  • ThreadMapEvent thread_map_event = 20

  • TimeConvEvent time_conv_event = 17

  • StatConfigEvent stat_config_event = 21

  • StatEvent stat_event = 22

  • StatRoundEvent stat_round_event = 23

  • CgroupEvent cgroup_event = 24

  • KsymbolEvent ksymbol_event = 25

• optional uint64 timestamp = 10

  Time after boot in nanoseconds corresponding to the event.

Perf event attribute. Stores the event description. This data structure is defined in the linux kernel: $kernel/include/uapi/linux/perf_event.h. Next tag: 48

Used in: PerfFileAttr

• optional uint32 type = 1

  Type of the event. Type is an enumeration and can be one of the values described at: $kernel/include/linux/perf_event.h. Example types are: PERF_TYPE_HARDWARE PERF_TYPE_SOFTWARE, etc.

• optional uint32 size = 2

  Size of the event data in bytes.

• optional uint64 config = 3

  The config stores the CPU-specific counter information.

• optional uint64 sample_period = 4

  Sample period of the event. Indicates how often the event is triggered in terms of # of events. After |sample_period| events, an event will be recorded and stored.

• optional uint64 sample_freq = 5

  Sample frequency of the event. Indicates how often the event is triggered in terms of # per second. The kernel will try to record |sample_freq| events per second.

• optional uint64 sample_type = 6

  Sample type is a bitfield that records attributes of the sample. Example, whether an entire callchain was recorded, etc.

• optional uint64 read_format = 7

  Bitfield that indicates whether reads on the counter will return the total time enabled and total time running.

• optional bool disabled = 8

  Indicates whether the counter starts off disabled.

• optional bool inherit = 9

  Indicates whether child processes inherit the counter.

• optional bool pinned = 10

  Indicates whether the counter is pinned to a particular CPU.

• optional bool exclusive = 11

  Indicates whether this counter's group has exclusive access to the CPU's counters.

• optional bool exclude_user = 12

  The following bits restrict events to be counted when the CPU is in user, kernel, hypervisor or idle modes.

• optional bool exclude_kernel = 13

• optional bool exclude_hv = 14

• optional bool exclude_idle = 15

• optional bool mmap = 16

  Indicates whether mmap events should be recorded.

• optional bool comm = 17

  Indicates whether process comm information should be recorded upon process creation.

• optional bool freq = 18

  Indicates that we are in frequency mode, not period mode.

• optional bool inherit_stat = 19

  Indicates whether we have per-task counts.

• optional bool enable_on_exec = 20

  Indicates whether we enable perf events after an exec() function call.

• optional bool task = 21

  Indicates whether we trace fork/exit.

• optional bool watermark = 22

  Indicates whether we are using a watermark to wake up.

• optional uint32 precise_ip = 23

  CPUs often "skid" when recording events. That means the instruction pointer may not be the same as the one that caused the counter overflow. Indicates the capabilities of the CPU in terms of recording precise instruction pointer.

• optional bool mmap_data = 24

  Indicates whether we have non-exec mmap data.

• optional bool sample_id_all = 25

  If set, all the event types will have the same sample_type.

• optional bool exclude_host = 26

  Indicates whether we are counting events from the host (when running a VM).

• optional bool exclude_guest = 27

  Exclude events that happen on a guest OS.

• optional bool exclude_callchain_kernel = 36

  Exclude kernel callchains.

• optional bool exclude_callchain_user = 37

  Exclude user callchains.

• optional bool mmap2 = 38

  Include mmap2 events that have inode data.

• optional bool comm_exec = 39

  Flag comm events that are due to an exec.

• optional bool use_clockid = 42

  Indicates whether or not to use @clockid for time fields.

• optional bool context_switch = 43

  Include context switch data.

• optional bool write_backward = 44

  Indicates whether ring buffer is written from end to beginning.

• optional bool namespaces = 45

  Include namespace data.

• optional bool cgroup = 46

  Include cgroup data.

• optional bool ksymbol = 47

  Include ksymbol data.

• optional uint32 wakeup_events = 28

  Contains the number of events after which we wake up.

• optional uint32 wakeup_watermark = 29

  Contains the number of bytes after which we wake up.

• optional uint32 bp_type = 30

  Information about the type of the breakpoint.

• optional uint64 bp_addr = 31

  Contains the breakpoint address.

• optional uint64 config1 = 32

  This is an extension of config (see above).

• optional uint64 bp_len = 33

  The length of the breakpoint data in bytes.

• optional uint64 config2 = 34

  This is an extension of config (see above).

• optional uint64 branch_sample_type = 35

  Contains the type of branch, example: user, kernel, call, return, etc.

• optional uint64 sample_regs_user = 40

  Defines set of user regs to dump on samples.

• optional uint32 sample_stack_user = 41

  Defines size of the user stack to dump on samples.

Next tag: 8

Used in: PerfDataProto

• optional uint32 num_events_read = 1

  Total number of events read from perf data.

• optional uint32 num_sample_events = 2

  Total number of various types of events.

• optional uint32 num_mmap_events = 3

• optional uint32 num_fork_events = 4

• optional uint32 num_exit_events = 5

• optional uint32 num_sample_events_mapped = 6

  Number of sample events that were successfully mapped by the address mapper, a quipper module that is used to obscure addresses and convert them to DSO name + offset. Sometimes it fails to process sample events. This field allows us to track the success rate of the address mapper.

• optional bool did_remap = 7

  Whether address remapping was enabled.

Protobuf version of the perf_event_type struct found in perf/util/event.h. Contains the name of the event (such as "cycles" or "branch-misses") and the event id (which is not unique). Next tag: 4

Used in: PerfDataProto

• optional uint64 id = 1

  Event id. This is not unique across event types. The combination of the event id and the type field in PerfEventAttr is unique across event types.

• optional string name = 2

  Event name.

• optional uint64 name_md5_prefix = 3

  Event name's md5 prefix.

Describes a perf.data file attribute. Next tag: 3

Used in: PerfDataProto

• optional PerfEventAttr attr = 1

• repeated uint64 ids = 2

  List of perf file attribute ids. Each id describes an event.

Next tag: 5

Used in: PerfDataProto

• optional string name = 1

  Group name.

• optional uint64 name_md5_prefix = 2

  Group name's md5 prefix.

• optional uint32 leader_idx = 3

  Group's leader index.

• optional uint32 num_members = 4

  Number of members in the group.

Next tag: 5

Used in: PerfDataProto

• optional string pmu_name = 1

  Name of the PMU device, e.g. software, cpu, cs_etm, etc.

• optional uint64 pmu_name_md5_prefix = 2

• optional string cpus = 3

  A range of cpu numbers returned in various /sys/devices locations. e.g. "0-3", "0,3".

• repeated uint32 cpu_list = 4

  Same content as above, but as a list of numbers for ease of use.

Next tag: 3

Used in: NamespacesEvent

• optional uint64 dev = 1

  ID of device containing file.

• optional uint64 ino = 2

  inode number.

Next tag: 6

Used in: PerfDataProto

• optional uint32 id = 1

  Node id.

• optional uint64 total_memory = 2

  Total memory of the node.

• optional uint64 free_memory = 3

  Free memory of the node.

• optional string cpu_list = 4

  List of CPUs in the node.

• optional uint64 cpu_list_md5_prefix = 5

  CPU list's md5 prefix.

Next tag: 4

Used in: PerfDataProto

• optional uint32 type = 1

  Mapping type.

• optional string name = 2

  Mapping name.

• optional uint64 name_md5_prefix = 3

  Mapping name's md5 prefix.

Next tag: 3

Used in: PerfDataProto

• optional bytes tracing_data = 1

  The trace event metadata.

• optional uint64 tracing_data_md5_prefix = 2

  Trace event metedata Md5sum prefix. Deprecated as md5prefix of blob data is not useful.

Next tag: 3

Used in: PerfDataProto

• optional uint32 type = 1

  Type of metadata, such as nrcpus.

• repeated uint32 data = 2

  uint32 data.

Next tag: 3

Used in: PerfDataProto

• optional uint32 type = 1

  Type of metadata, such as totalmem.

• repeated uint64 data = 2

  uint64 data.

Next tag: 8

Used in: PerfEvent

• optional uint32 pid = 1

  Process ID.

• optional uint32 tid = 2

  Thread ID.

• optional uint64 value = 3

  Value of the event counter when it was queried.

• optional uint64 time_enabled = 4

  Time enabled.

• optional uint64 time_running = 5

  Time running.

• optional uint64 id = 6

  ID.

• optional SampleInfo sample_info = 7

  Info about the perf sample containing this event.

Next tag: 4

Used in: SampleEvent

• optional uint64 time_enabled = 1

• optional uint64 time_running = 2

• repeated ReadInfo.ReadValue read_value = 3

  Based on the value of |PerfEventAttr::read_format & PERF_FORMAT_GROUP|, the read info could contain one or multiple read values and IDs. If the format is non-grouped, the repeated field will have only one entry.

Used in: ReadInfo

• optional uint64 value = 1

• optional uint64 id = 2

• optional uint64 lost = 3

Next tag: 27

Used in: PerfEvent

• optional uint64 ip = 1

  Instruction pointer.

• optional uint32 pid = 2

  Process id.

• optional uint32 tid = 3

  Thread id.

• optional uint64 sample_time_ns = 4

  The time after boot when the sample was recorded, in nanoseconds.

• optional uint64 addr = 5

  The address of the sample.

• optional uint64 id = 6

  The id of the sample.

• optional uint64 stream_id = 7

  The stream id of the sample.

• optional uint64 period = 8

  The period of the sample.

• optional uint32 cpu = 9

  The CPU where the event was recorded.

• optional bytes raw = 21

  The raw data for the event. Historically, the raw data itself was not stored in the perf_data.proto and so it's possible that only raw_size is set in which case the reader should assume all-zero raw data of the specified size. If raw field is present, then len(raw) == raw_size.

• optional uint32 raw_size = 10

• optional ReadInfo read_info = 18

  The read field.

• repeated uint64 callchain = 11

  Sample callchain info.

• repeated BranchStackEntry branch_stack = 12

  Branch stack info.

• optional uint64 weight = 15

  Sample weight for special events. Microarchitecture-dependent. On Intel Icelake and older, for load latency events, this is the "total" instruction issue-to-retire latency. On AMD, for IBS collections and load instructions, this is the cache latency.

• optional uint64 data_src = 16

  Sample data source flags.

• optional uint64 transaction = 17

  Sample transaction flags for special events.

• optional uint64 physical_addr = 19

  Physical address of the sample.

• optional uint64 cgroup = 20

  Cgroup id.

• optional uint64 data_page_size = 22

  Data page size

• optional uint64 code_page_size = 23

  Code page size

• optional bool no_hw_idx = 24

  No hw_idx collected in branch_stack.

• optional uint64 branch_stack_hw_idx = 25

  Branch stack hw index, optional field in PERF_SAMPLE_BRANCH_STACK used when PERF_SAMPLE_BRANCH_HW_INDEX is set.

• optional WeightStruct weight_struct = 26

  Weight struct.

This message contains information about a perf sample itself, as opposed to a perf event captured by a sample. Next tag: 7

Used in: AuxEvent, CgroupEvent, CommEvent, ContextSwitchEvent, ForkEvent, ItraceStartEvent, KsymbolEvent, LostEvent, LostSamplesEvent, MMapEvent, NamespacesEvent, ReadEvent, ThrottleEvent

• optional uint32 pid = 1

  Process ID / thread ID from which this sample was taken.

• optional uint32 tid = 2

• optional uint64 sample_time_ns = 3

  Time this sample was taken (NOT the same as an event time). It is the number of nanoseconds since bootup.

• optional uint64 id = 4

  The ID of the sample's event type (cycles, instructions, etc). The event type IDs are defined in PerfFileAttr.

• optional uint32 cpu = 5

  The CPU on which this sample was taken.

• optional uint64 stream_id = 6

  The stream id of the sample.

Next Tag: 2

Used in: PerfEvent

• repeated StatConfigEventEntry data = 1

  Key-value entries representing some fields of the struct perf_stat_config.

Next Tag: 3

Used in: StatConfigEvent

• optional uint64 tag = 1

  An enum value representing a field in the struct perf_stat_config.

• optional uint64 val = 2

  Value of the field represented by the enum value in tag.

Next Tag: 7

Used in: PerfEvent

• optional uint64 id = 1

  Perf sample identifier.

• optional uint32 cpu = 2

  CPU for which the performance statistics was collected.

• optional uint32 thread = 3

  Thread for which the performance statistics was collected.

• optional uint64 value = 4

  Counter value.

• optional uint64 enabled = 5

  Number of times the counter was enabled.

• optional uint64 running = 6

  Number of times the counter was running.

Next Tag: 3

Used in: PerfEvent

• optional uint64 type = 1

  Type is an enumeration defining the type of stat round described at: $kernel/tools/perf/util/event.h. Example types are: PERF_STAT_ROUND_TYPE__INTERVAL PERF_STAT_ROUND_TYPE__FINAL

• optional uint64 time = 2

  Time taken in nanoseconds by the type of stat round.

Next tag: 9

Used in: PerfDataProto

• optional StringMetadata.StringAndMd5sumPrefix hostname = 1

  Name of the machine, e.g. "localhost".

• optional StringMetadata.StringAndMd5sumPrefix kernel_version = 2

  Kernel version, e.g. "3.4.0".

• optional StringMetadata.StringAndMd5sumPrefix perf_version = 3

  Perf version, e.g. "3.4.2642.g0aa604".

• optional StringMetadata.StringAndMd5sumPrefix architecture = 4

  CPU architecture family, e.g. "x86_64".

• optional StringMetadata.StringAndMd5sumPrefix cpu_description = 5

  CPU description, e.g. "Intel(R) Celeron(R) CPU 867 @ 1.30GHz".

• optional StringMetadata.StringAndMd5sumPrefix cpu_id = 6

  CPU ID string, with the format: "$VENDOR,$FAMILY,$MODEL,$STEP"

• repeated StringMetadata.StringAndMd5sumPrefix perf_command_line_token = 7

  Command line used to run perf to collect this profile. This is split into string tokens to reflect the way it is stored in the raw perf data. e.g. "perf record -a -- sleep 2" become stored as: { "perf", "record", "-a", "--", "sleep", "2" }

• optional StringMetadata.StringAndMd5sumPrefix perf_command_line_whole = 8

  The command line stored as a single string.

Next tag: 3

Used in: StringMetadata

• optional string value = 1

  The string value.

• optional uint64 value_md5_prefix = 2

  The string value's md5sum prefix.

Next Tag: 2

Used in: PerfEvent

• repeated ThreadMapEventEntry entries = 1

Next Tag: 4

Used in: ThreadMapEvent

• optional uint64 pid = 1

• optional string comm = 2

  Thread name.

• optional uint64 comm_md5_prefix = 3

  Thread name's md5 prefix.

Next tag: 5

Used in: PerfEvent

• optional uint64 time_ns = 1

  Time of throttle event, in nanoseconds since system startup.

• optional uint64 id = 2

  Event ID.

• optional uint64 stream_id = 3

  Stream ID.

• optional SampleInfo sample_info = 4

  Info about the perf sample containing this event.

Time members to convert between TSC and perf time. Next tag: 8

Used in: PerfEvent

• optional uint64 time_shift = 1

  Time shift value.

• optional uint64 time_mult = 2

  Time multiplier.

• optional uint64 time_zero = 3

  Base time.

• optional uint64 time_cycles = 4

  Fields added in perf 5.10.

• optional uint64 time_mask = 5

• optional bool cap_user_time_zero = 6

• optional bool cap_user_time_short = 7

WeightStruct is microarchitecture-dependent field, and represents sample weights for some special events. On Intel Sapphire Rapids and newer, with load latency events, the first field is the cache latency, and the second is the "total" instruction issue-to-retirement latency. On AMD, for IBS collections and only on load instructions, the first field is the cache latency, and the second is the "total" instruction issue-to-retirement latency. Next tag: 4

Used in: SampleEvent

• optional uint32 var1_dw = 1

  First weight factor.

• optional uint32 var2_w = 2

  Second weight factor.

• optional uint32 var3_w = 3

  Third weight factor.

A proto mapping of PerfParserOptions, defined in perf_parser.h. See that definition for detail.

• optional bool do_remap = 1

• optional bool discard_unused_events = 2

• optional float sample_mapping_percentage_threshold = 3

• optional bool sort_events_by_time = 4

• optional bool read_missing_buildids = 5

• optional bool deduce_huge_page_mappings = 6

• optional bool combine_mappings = 7

Next tag: 3

• repeated PerfStatProto.PerfStatLine line = 1

  All lines printed by "perf stat".

• optional string command_line = 2

  The command line used to run "perf stat".

Represents one line of "perf stat" output. Next tag: 4

Used in: PerfStatProto

• optional uint64 time_ms = 1

  Time since the start of the "perf stat" command, in milliseconds. When running "perf stat" and printing the counters at the end, this is the total time taken by the run. Alternatively, "perf stat" can print its stats at regular intervals until the end of the run. For example, if "perf stat" runs for one second and prints at 200-ms intervals, it will print counter values for each event a total of five times. According to "perf stat" usage instructions, the printing interval should be no less than 100 ms.

• optional uint64 count = 2

  Current count value of the event being counted. May be different from the nominal counter value reported by "perf stat", depending on the event. For example, memory access counters are in units of 64 bytes. A counter value of 1024 would represent 65536 bytes, and we would set this field to 65536.

• optional string event_name = 3

  Name of event whose counter is listed on this line. This string should also appear as part of |PerfStatProto::command_line|. "perf stat" will preserve the event name exactly as it is passed in via the command line.