mark

fun mark(label: String, detail: String? = null)(source)

Marks a moment on the timeline.

Porthole.mark("checkout started")

A flat trace says a 426ms stall happened; a marked one says it happened during "checkout started", which is most of the way to a cause.

Meant for whatever knows the shape of the run. An instrumented test is in the app's process, so a connectedAndroidTest can mark its own steps with no protocol and no coordination; the app can mark its own phases the same way. Costs one event.