profiling.kt

src/commonMain/kotlin/afield/app/protocol/profiling.kt · 100 lines · cited by Profiling

package afield.app.protocol

import kotlinx.serialization.Serializable

data class CoroutineProfileRequest

@Serializable
data class CoroutineProfileRequest(
    val action: String = "snapshot",
    val seconds: Double = 10.0,
    val after: Long = -1,
    val captureId: String = "",
    val stacks: Boolean = false,
    val stackAfter: Int = -1,
    val frameAfter: Long = -1
)

data class CoroutineProfileLane

@Serializable
data class CoroutineProfileLane(
    val id: Int,
    val boxId: String,
    val boxName: String,
    val strand: String,
    val revision: String,
    val state: String,
    val firstMs: Double,
    val lastMs: Double,
    val label: String = "",
    val kind: String = "resume",
    /** The box property whose source was launched; [revision] fingerprints that source. */
    val property: String = "code",
    /** The fingerprint of [property] as it is now, at export; differs from [revision] once edited. */
    val currentRevision: String = "",
)

data class CoroutineProfileSpan

One scheduled continuation, ending when it returns/yields/suspends; gaps are not CPU work.

@Serializable
data class CoroutineProfileSpan(
    val sequence: Long,
    val lane: Int,
    val frame: Long,
    val startMs: Double,
    val wallMs: Double,
    val cpuMs: Double,
    val allocatedBytes: Long,
    val threadId: Long = -1,
    val selfWallMs: Double = wallMs,
    val selfCpuMs: Double = cpuMs,
    val selfAllocatedBytes: Long = allocatedBytes,
    val depth: Int = 0
)

data class ProfileFrame(val sequence: Long, val lane: Int, val startMs: Double, val wallMs: Double,

A complete application frame interval, not a coroutine resume or a displayed GPU frame.

@Serializable
data class ProfileFrame(val sequence: Long, val lane: Int, val startMs: Double, val wallMs: Double,
    val cpuMs: Double, val allocatedBytes: Long, val targetMs: Double, val allocationGuideBytes: Double)

data class ProfileGcPause(val startMs: Double, val durationMs: Double)

JFR stop-the-world phase timing; separate from collector-wide elapsed counters.

@Serializable
data class ProfileGcPause(val startMs: Double, val durationMs: Double)

data class ProfileStackSample(val timeMs: Double, val threadId: Long, val threadName: String,

Samples are statistical evidence, independent of the exact continuation counters.

@Serializable
data class ProfileStackSample(val timeMs: Double, val threadId: Long, val threadName: String,
    val kind: String, val weight: Long, val stack: List<Int>)

data class ProfileStackFrame(val id: Int, val className: String, val method: String, val line: Int,

@Serializable
data class ProfileStackFrame(val id: Int, val className: String, val method: String, val line: Int,
    val sourceId: Int = -1)

data class ProfileStackSource(val id: Int, val path: String, val code: String,

@Serializable
data class ProfileStackSource(val id: Int, val path: String, val code: String,
    val boxId: String = "", val property: String = "code", val boxCode: String = "")

data class CoroutineProfileSnapshot

@Serializable
data class CoroutineProfileSnapshot(
    val ok: Boolean = true,
    val error: String = "",
    val captureId: String = "",
    val recording: Boolean = false,
    val elapsedMs: Double = 0.0,
    val durationMs: Double = 0.0,
    val oldestSequence: Long = 0,
    val nextSequence: Long = 0,
    val droppedSpans: Long = 0,
    val lanes: List<CoroutineProfileLane> = emptyList(),
    val spans: List<CoroutineProfileSpan> = emptyList(),
    val stackState: String = "off",
    val stackError: String = "",
    val stackSampleCount: Int = 0,
    val stackDropped: Int = 0,
    val stackFrames: List<ProfileStackFrame> = emptyList(),
    val stackSources: List<ProfileStackSource> = emptyList(),
    val stackSamples: List<ProfileStackSample> = emptyList(),
    val frameRecords: List<ProfileFrame> = emptyList(),
    val nextFrameSequence: Long = 0,
    val oldestFrameSequence: Long = 0,
    val gcCollections: Long = 0,
    val gcCollectionMs: Long = 0,
    val gcPauses: List<ProfileGcPause> = emptyList()
)