PollTimings class
Cost of one VM timeline poll, split by segment.
All durations are wall-clock microseconds measured on the UI isolate. Two kinds of segment:
- UI-isolate CPU: decodeMicros, parseMicros and dispatchMicros run synchronously on the UI isolate and hold off frame work for their whole length. uiBlockingMicros is their sum.
- Wall time across awaits: rpcMicros and tailMicros include the VM-side work and the transport. The UI isolate is free for most of it, except the part of rpcMicros that is decodeMicros.
Read through Sleuth.lastPollTimings or the lastPoll* keys of
ext.sleuth.diagnose.
- Annotations
-
- @immutable
- @experimental
Constructors
- PollTimings({required int rpcMicros, int? decodeMicros, required int parseMicros, required int dispatchMicros, required int tailMicros, required int eventCount, required int? responseChars, required int duplicatesDropped, required DateTime completedAt, bool windowFallback = false, int dispatchDetectorsMicros = 0, int dispatchCorrelateMicros = 0, int dispatchAggregateMicros = 0, int dispatchOtherMicros = 0, int tailCpuSamplesMicros = 0, int tailAllocationProfileMicros = 0, int tailMemoryMicros = 0})
-
Creates a timings record. Durations and counts are non-negative;
responseCharsanddecodeMicrosare null when the raw response could not be matched to the timeline request.const
Properties
- completedAt → DateTime
-
Wall-clock time the poll finished.
final
- decodeMicros → int?
-
Part of rpcMicros spent on the UI isolate after the raw response
arrived: the JSON decode and
Timelineconstruction that package:vm_service runs before the future completes, plus the resumption of the await. Null when the raw response could not be matched to the request (no wire streams, or a failed RPC).final - dispatchAggregateMicros → int
-
Part of dispatchMicros spent aggregating, ranking and publishing
the issue list.
final
- dispatchCorrelateMicros → int
-
Part of dispatchMicros spent matching the batch to frames and
building the frame verdict.
final
- dispatchDetectorsMicros → int
-
Part of dispatchMicros spent feeding the batch to the detectors
(
processTimelineDataandevaluateNow).final - dispatchMicros → int
-
Time spent in the
onTimelineDatacallback (detector dispatch and issue aggregation). Zero when the batch was not dispatched.final - dispatchOtherMicros → int
-
Rest of dispatchMicros: capture bookkeeping, the export buffers,
and issuing the jank frame's CPU-samples request. The four dispatch
parts sum to dispatchMicros.
final
- duplicatesDropped → int
-
Events this poll skipped because an earlier poll already processed
them.
final
- eventCount → int
-
Raw events returned by the VM in this poll.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- parseMicros → int
-
Timeline parse plus the stale-begin sweep (and, on the first poll of
a session, startup-event extraction).
final
- responseChars → int?
-
Length in characters of the raw
getVMTimelineresponse, or null when it could not be matched to the request.final - rpcMicros → int
-
Await of the
getVMTimelineRPC: wall time covering the VM-side serialization, the transport, and decodeMicros.final - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- tailAllocationProfileMicros → int
-
Part of tailMicros during which a
getAllocationProfilerequest was in flight. Overlaps the other tail parts.final - tailCpuSamplesMicros → int
-
Part of tailMicros during which a
getCpuSamplesrequest (jank frame attribution) was in flight. Overlaps the other tail parts.final - tailMemoryMicros → int
-
Await of the heap
getMemoryUsagesample inside tailMicros.final - tailMicros → int
-
Remaining RPCs of the poll (the timeline clock read that bounds the
fetch window and the heap memory sample).
final
- totalMicros → int
-
Sum of the four top-level segments (decodeMicros is inside
rpcMicros).
no setter
- uiBlockingMicros → int
-
Time the poll held the UI isolate: decodeMicros (when measured)
plus parseMicros and dispatchMicros. Excludes the awaited RPC
and tail time, during which the isolate can run frames. A frame
that needs the isolate during this time is delayed by up to this
much.
no setter
- windowFallback → bool
-
Whether the poll read the whole timeline buffer because the timeline
clock could not bound a window (failed read, or a reading behind the
newest event already seen).
final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toJson(
) → Map< String, Object?> - JSON-encodable form.
-
toString(
) → String -
A string representation of this object.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited