tracing

type Backend string

type EventBufferUsage struct {
	PercentFull float64 `json:"percentFull,omitempty,omitzero"` // A number in range [0..1] that indicates the used size of event buffer as a fraction of its total size.
	EventCount  float64 `json:"eventCount,omitempty,omitzero"`  // An approximate number of events in the trace log.
	Value       float64 `json:"value,omitempty,omitzero"`       // A number in range [0..1] that indicates the used size of event buffer as a fraction of its total size.
}

type EventDataCollected struct {
	Value []jsonv2.Value `json:"value"`
}

type EventTracingComplete struct {
	DataLossOccurred  bool              `json:"dataLossOccurred"`                     // Indicates whether some trace data is known to have been lost, e.g. because the trace ring buffer wrapped around.
	Stream            io.StreamHandle   `json:"stream,omitempty,omitzero"`            // A handle of the stream that holds resulting trace data.
	TraceFormat       StreamFormat      `json:"traceFormat,omitempty,omitzero"`       // Trace data format of returned stream.
	StreamCompression StreamCompression `json:"streamCompression,omitempty,omitzero"` // Compression format of returned stream.
}

type GetCategoriesResult struct {
	Categories []string `json:"categories,omitempty,omitzero"` // A list of supported tracing categories.
}

type GetTrackEventDescriptorResult struct {
	Descriptor []byte `json:"descriptor,omitempty,omitzero"` // Base64-encoded serialized perfetto.protos.TrackEventDescriptor protobuf message.
}

type MemoryDumpConfig map[string]any

type MemoryDumpLevelOfDetail string

type RecordClockSyncMarkerParams struct {
	SyncID string `json:"syncId"` // The ID of this clock sync marker
}

type RequestMemoryDumpParams struct {
	Deterministic *bool                   `json:"deterministic,omitempty,omitzero"` // Enables more deterministic results by forcing garbage collection
	LevelOfDetail MemoryDumpLevelOfDetail `json:"levelOfDetail,omitempty,omitzero"` // Specifies level of details in memory dump. Defaults to "detailed".
}

type RequestMemoryDumpResult struct {
	DumpGUID string `json:"dumpGuid,omitempty,omitzero"` // GUID of the resulting global memory dump.
	Success  bool   `json:"success"`                     // True iff the global memory dump succeeded.
}

type StartParams struct {
	BufferUsageReportingInterval float64           `json:"bufferUsageReportingInterval,omitempty,omitzero"` // If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
	TransferMode                 StartTransferMode `json:"transferMode,omitempty,omitzero"`                 // Whether to report trace events as series of dataCollected events or to save trace to a stream (defaults to ReportEvents).
	StreamFormat                 StreamFormat      `json:"streamFormat,omitempty,omitzero"`                 // Trace data format to use. This only applies when using ReturnAsStream transfer mode (defaults to json).
	StreamCompression            StreamCompression `json:"streamCompression,omitempty,omitzero"`            // Compression format to use. This only applies when using ReturnAsStream transfer mode (defaults to none)
	TraceConfig                  *TraceConfig      `json:"traceConfig,omitempty,omitzero"`
	PerfettoConfig               []byte            `json:"perfettoConfig,omitempty,omitzero"`     // Base64-encoded serialized perfetto.protos.TraceConfig protobuf message When specified, the parameters categories, options, traceConfig are ignored.
	TracingBackend               Backend           `json:"tracingBackend,omitempty,omitzero"`     // Backend type (defaults to auto)
	ScreenshotMaxSize            int64             `json:"screenshotMaxSize,omitempty,omitzero"`  // Maximum width and height (in pixels) of each captured screenshot. Only used when the disabled-by-default-devtools.screenshot category is enabled. Defaults to 500. The combined memory footprint of screenshots (screenshotMaxSize * screenshotMaxSize * 4 * screenshotMaxCount) is clamped to the existing per-session budget.
	ScreenshotMaxCount           int64             `json:"screenshotMaxCount,omitempty,omitzero"` // Maximum number of screenshots captured during a single tracing session. Only used when the disabled-by-default-devtools.screenshot category is enabled. Defaults to 450. Clamped together with screenshotMaxSize to stay within the per-session screenshot memory budget.
}

type StartTransferMode string

type StreamCompression string

type StreamFormat string

type TraceConfig struct {
	RecordMode           TraceConfigRecordMode `json:"recordMode,omitempty,omitzero"`          // Controls how the trace buffer stores data. The default is recordUntilFull.
	TraceBufferSizeInKb  float64               `json:"traceBufferSizeInKb,omitempty,omitzero"` // Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value of 200 MB would be used.
	EnableSampling       bool                  `json:"enableSampling"`                         // Turns on JavaScript stack sampling.
	EnableSystrace       bool                  `json:"enableSystrace"`                         // Turns on system tracing.
	EnableArgumentFilter bool                  `json:"enableArgumentFilter"`                   // Turns on argument filter.
	IncludedCategories   []string              `json:"includedCategories,omitempty,omitzero"`  // Included category filters.
	ExcludedCategories   []string              `json:"excludedCategories,omitempty,omitzero"`  // Excluded category filters.
	SyntheticDelays      []string              `json:"syntheticDelays,omitempty,omitzero"`     // Configuration to synthesize the delays in tracing.
	MemoryDumpConfig     MemoryDumpConfig      `json:"memoryDumpConfig,omitempty,omitzero"`    // Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
}

type TraceConfigRecordMode string