package tracing
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=1224dbf57bad65a8bcf7de06fb8785155759eafff4940e7c4d909a0a1243dce6
doc/tracing.tracing_zero/Tracing_zero/Destinations/index.html
Module Tracing_zero.DestinationsSource
val direct_file_destination :
?buffer_size:int ->
filename:string ->
unit ->
(module Writer_intf.Destination)Write to a file using synchronous writes, not suitable for low latency applications.
Write to a file in some way with the best available performance.
val fd_destination :
?buffer_size:int ->
fd:Core_unix.File_descr.t ->
unit ->
(module Writer_intf.Destination)Write to a generic file descriptor.
val iobuf_destination :
(Core.read_write, Iobuf.seek) Iobuf.t ->
(module Writer_intf.Destination)Write to a provided Iobuf.t, throws an exception if the buffer runs out of space. After the Destination is closed, sets the window of the Iobuf.t to the data written.
Creates a new buffer, which is reset and reused on every call to next_buf, effectively dropping all the previously-recorded content, as the name suggests. Useful for performance benchmarking or having trace events be ignored without growing an in-memory log.
len is the length of the buffer and can be tuned to simulate different cache characteristics in a benchmark or avoid using much memory when ignoring events.
If touch_memory is true, the memory will be written over to ensure all the memory is paged in, to reduce benchmark variance.
Starts by keeping events in internal memory buffers. After set_destination is called it will copy any buffered events into the new destination upon the next buffer switch, then provide a buffer directly from the newly set destination.