package xprof

Get desktop application:
View/edit binary Protocol Buffers messages

• optional CustomCallConfig custom_call_config = 26

Used in: BackendConfig

• bytes body = 1

Used in: TraceDataResponse

• string name = 1

• bool value = 2

A 'device' is a physical entity in the system and is comprised of several resources.

Used in: Trace

• string name = 1

  The name of the device.

• uint64 device_id = 2

  The id of this device, unique in a single trace.

• map<uint64, Resource> resources = 3

  The resources on this device, keyed by resource_id;

Describes a process that appears in the trace.

Used in: TraceMetadata

• string name = 1

• uint32 id = 2

• uint32 sort_index = 3

• repeated Thread threads = 4

A 'resource' generally is a specific computation component on a device. These can range from threads on CPUs to specific arithmetic units on hardware devices.

Used in: Device

• string name = 1

  The name of the resource.

• uint64 resource_id = 2

  The id of the resource. Unique within a device.

Describes a thread that appears in the trace.

Used in: Process

• string name = 1

• uint32 id = 2

• uint32 sort_index = 3

A 'Trace' contains metadata for the individual traces of a system.

• map<uint64, Device> devices = 1

  The devices that this trace has information about. Maps from device_id to more data about the specific device.

• repeated TraceEvent trace_events = 4

  All trace events capturing in the profiling period.

The root response message representing a delta-compressed trace.

• repeated TraceEventSeries complete_events = 1

  Sequence of standard duration events.

• repeated TraceEventSeries counter_events = 2

• repeated TraceEventSeries async_events = 3

  Sequence of asynchronous events.

• optional TraceMetadata metadata = 4

  Trace metadata describing the hierarchy of processes and threads.

• repeated string interned_strings = 5

  A centralized list of strings used throughout the trace data. `name_ref` fields in other messages are indices into this array.

• repeated DetailItem details = 6

  Details for the trace (e.g., flags for the frontend).

• optional uint64 full_timespan_start_ps = 7

  The full timespan of the trace (start time and end time in picoseconds).

• optional uint64 full_timespan_end_ps = 8

Used in: Trace

• uint64 device_id = 1

  The id of the device that this event occurred on. The full dataset should have this device present in the Trace object.

• uint64 resource_id = 2

  The id of the resource that this event occurred on. The full dataset should have this resource present in the Device object of the Trace object. A resource_id is unique on a specific device, but not necessarily within the trace.

• string name = 3

  The name of this trace event.

• uint64 timestamp_ps = 9

  The timestamp that this event occurred at (in picos since tracing started).

• uint64 duration_ps = 10

  The duration of the event in picoseconds if applicable. Events without duration are called instant events.

• map<string, string> args = 11

  Extra arguments that will be displayed in trace view.

Metadata for a specific occurrence of a trace event. This contains optional fields that are not present on every event.

Used in: TraceEventSeries

• uint32 flow_id = 1

• uint32 flow_category = 2

• uint32 group_id = 3

• uint32 serial = 4

• oneof counter_value

  A value associated with the event (e.g., for counter events).

  • double counter_value_double = 5

  • uint64 counter_value_uint64 = 6

Represents a sequence of trace events, grouped by their metadata (e.g., same process, thread, and name). To save space, the timestamps are delta-encoded.

Used in: TraceDataResponse

• optional TraceEventSeriesMetadata metadata = 1

• repeated uint64 deltas = 2

  Delta-encoded start timestamps of the events. The first element is the absolute start timestamp of the first event. Subsequent elements are the time differences from the previous event's timestamp.

• repeated uint64 durations = 3

  The durations of each event in the series. The length of this array should match the length of `deltas`.

• repeated uint32 name_refs = 4

  Optional name references for individual events within this series, pointing to indices in `interned_strings`. Used if events in the series have different names.

• repeated TraceEventMetadata event_metadata = 5

  Metadata for the events in this series.

Metadata identifying a unique series of trace events. A series is typically defined by the process, thread, and the name of the events it contains.

Used in: TraceEventSeries

• uint32 process_id = 1

• uint32 thread_id = 2

• uint32 name_ref = 3

Contains all metadata relating to the processes and threads in the trace.

Used in: TraceDataResponse

• repeated Process processes = 1