tracy-client 0.4 · OCaml Package

Bindings to the client

type span = int

val enter : 
  ?cs_depth:int ->
  __FILE__:string ->
  __LINE__:int ->
  ?__FUNCTION__:string ->
  string ->
  span

enter ~__FILE__ ~__LINE__ name enters a span.

parameter __FUNCTION__
if provided, documents the function in which the call occurs (typically you can use __FUNCTION__)

parameter cs_depth
if provided, depth of call stack to capture. Using this parameter makes the capture slower but captures a stack trace.

val set_app_info : string -> unit

Set application information

val add_text : span -> string -> unit

add_text span s annotates the span with text s. This can be called several times on the same span.

val add_text_f : 
  span ->
  ((('a, Stdlib.Format.formatter, unit, unit) Stdlib.format4 -> 'a) -> unit) ->
  unit

Formatted version of add_text.

Usage: add_text_f span (fun k -> k "some %s message! (%d/100)" "formatted" 100).

val add_value : span -> int64 -> unit

add_value span v annotates the span with a numeric value (which should be unsigned).

val set_color : span -> int -> unit

set_color span c sets the color of the span.

c is an integer that represents a color using a RGB triple as follows: 0xRRGGBB.

val with_ : 
  ?cs_depth:int ->
  __FILE__:string ->
  __LINE__:int ->
  ?__FUNCTION__:string ->
  string ->
  (span -> 'a) ->
  'a

Run function within a span. See enter for more details about the parameters.

val exit : span -> unit

Must be called on the same thread as enter

val name_thread : string -> unit

Give a name to the current thread

val message : string -> unit

Send a message

val message_f : 
  ((('a, Stdlib.Format.formatter, unit, unit) Stdlib.format4 -> 'a) -> unit) ->
  unit

Send a formatted message. Usage: message_f (fun k -> k "hello %s %d" "world" 42)

val plot : string -> float -> unit

package tracy-client