val collector :
+Trace_fuchsia (trace-fuchsia.Trace_fuchsia)
Module Trace_fuchsia
Fuchsia trace collector.
This provides a collector for traces that emits data into a file using the compact binary Fuchsia trace format. This reduces the tracing overhead compared to trace-tef, at the expense of simplicity.
val collector :
out:[ `File of string| `Stderr| `Stdout ]->unit ->
- Trace_core.collector
Make a collector that writes into the given output. See setup for more details.
type output = [
| `Stdout
| `Stderr
| `File of string
]
Output for tracing.
`Stdout will enable tracing and print events on stdout
`Stderr will enable tracing and print events on stderr
`File "foo" will enable tracing and print events into file named "foo"
`Env will enable tracing if the environment variable "TRACE" is set.
If it's set to "1", then the file is "trace.fxt".
If it's set to "stdout", then logging happens on stdout (since 0.2)
If it's set to "stderr", then logging happens on stdout (since 0.2)
Otherwise, if it's set to a non empty string, the value is taken to be the file path into which to write.
val with_setup : ?out:[ output| `Env ]->unit ->(unit ->'a)->'a
with_setup () f (optionally) sets a collector up, calls f(), and makes sure to shutdown before exiting.
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Argument/index.html b/trace-fuchsia/Trace_fuchsia_write/Argument/index.html
deleted file mode 100644
index 480eeaf..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Argument/index.html
+++ /dev/null
@@ -1,19 +0,0 @@
-
-Argument (trace-fuchsia.Trace_fuchsia_write.Argument)
Module Trace_fuchsia_write.Argument
type'a t = string * [< user_data| `Kid of int ]as 'a
val check_valid : 'a-> unit
val is_i32_ : int -> bool
val size_word :
- [< `Bool of bool & 'a
- | `Float of float & 'b
- | `Int of int
- | `Kid of int & 'c
- | `None
- | `String of string ]
- t->
- int
val encode :
- Buf.t->
- [< `Bool of bool & 'a
- | `Float of float & 'b
- | `Int of int
- | `Kid of int & 'c
- | `None
- | `String of string ]
- t->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Arguments/index.html b/trace-fuchsia/Trace_fuchsia_write/Arguments/index.html
deleted file mode 100644
index 50fa497..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Arguments/index.html
+++ /dev/null
@@ -1,35 +0,0 @@
-
-Arguments (trace-fuchsia.Trace_fuchsia_write.Arguments)
val len :
- [< `Bool of bool
- | `Float of float
- | `Int of int
- | `Kid of int
- | `None
- | `String of string ]
- t->
- int
val check_valid :
- [< `Bool of bool
- | `Float of float
- | `Int of int
- | `Kid of int
- | `None
- | `String of string ]
- t->
- unit
val size_word :
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- t->
- int
val encode :
- Buf.t->
- [< `Bool of bool & 'a & 'b & 'c
- | `Float of float & 'd & 'e & 'f
- | `Int of int
- | `Kid of int & 'g & 'h & 'i
- | `None
- | `String of string ]
- t->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Buf/index.html b/trace-fuchsia/Trace_fuchsia_write/Buf/index.html
deleted file mode 100644
index 4e45874..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Buf/index.html
+++ /dev/null
@@ -1,2 +0,0 @@
-
-Buf (trace-fuchsia.Trace_fuchsia_write.Buf)
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Async_begin/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Async_begin/index.html
deleted file mode 100644
index 59e235f..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Async_begin/index.html
+++ /dev/null
@@ -1,29 +0,0 @@
-
-Async_begin (trace-fuchsia.Trace_fuchsia_write.Event.Async_begin)
Module Event.Async_begin
type=5
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- async_id:int ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Async_end/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Async_end/index.html
deleted file mode 100644
index 90ef4d8..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Async_end/index.html
+++ /dev/null
@@ -1,29 +0,0 @@
-
-Async_end (trace-fuchsia.Trace_fuchsia_write.Event.Async_end)
Module Event.Async_end
type=7
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- async_id:int ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Counter/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Counter/index.html
deleted file mode 100644
index 8ef25ce..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Counter/index.html
+++ /dev/null
@@ -1,28 +0,0 @@
-
-Counter (trace-fuchsia.Trace_fuchsia_write.Event.Counter)
Module Event.Counter
type=1
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_begin/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Duration_begin/index.html
deleted file mode 100644
index a7a18f5..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_begin/index.html
+++ /dev/null
@@ -1,28 +0,0 @@
-
-Duration_begin (trace-fuchsia.Trace_fuchsia_write.Event.Duration_begin)
Module Event.Duration_begin
type=2
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_complete/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Duration_complete/index.html
deleted file mode 100644
index c0e4101..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_complete/index.html
+++ /dev/null
@@ -1,29 +0,0 @@
-
-Duration_complete (trace-fuchsia.Trace_fuchsia_write.Event.Duration_complete)
Module Event.Duration_complete
type=4
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- end_time_ns:int64 ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_end/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Duration_end/index.html
deleted file mode 100644
index 34dbd6f..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Duration_end/index.html
+++ /dev/null
@@ -1,28 +0,0 @@
-
-Duration_end (trace-fuchsia.Trace_fuchsia_write.Event.Duration_end)
Module Event.Duration_end
type=3
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/Instant/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/Instant/index.html
deleted file mode 100644
index 9a897ed..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/Instant/index.html
+++ /dev/null
@@ -1,28 +0,0 @@
-
-Instant (trace-fuchsia.Trace_fuchsia_write.Event.Instant)
Module Event.Instant
type=0
val size_word :
- name:string ->
- t_ref:Thread_ref.t->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
val encode :
- Output.t->
- name:string ->
- t_ref:Thread_ref.t->
- time_ns:int64 ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd & 'e & 'f & 'g
- | `Float of float & 'h & 'i & 'j & 'k & 'l & 'm & 'n
- | `Int of int
- | `Kid of int & 'o & 'p & 'q & 'r & 's & 't & 'u
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- unit
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Event/index.html b/trace-fuchsia/Trace_fuchsia_write/Event/index.html
deleted file mode 100644
index fa86666..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Event/index.html
+++ /dev/null
@@ -1,2 +0,0 @@
-
-Event (trace-fuchsia.Trace_fuchsia_write.Event)
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Kernel_object/index.html b/trace-fuchsia/Trace_fuchsia_write/Kernel_object/index.html
deleted file mode 100644
index 66caca8..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Kernel_object/index.html
+++ /dev/null
@@ -1,27 +0,0 @@
-
-Kernel_object (trace-fuchsia.Trace_fuchsia_write.Kernel_object)
Module Trace_fuchsia_write.Kernel_object
record type = 7
val size_word :
- name:string ->
- args:
- [< `Bool of bool & 'a & 'b & 'c & 'd
- | `Float of float & 'e & 'f & 'g & 'h
- | `Int of int
- | `Kid of int & 'i & 'j & 'k & 'l
- | `None
- | `String of string ]
- Arguments.t->
- unit ->
- int
\ No newline at end of file
diff --git a/trace-fuchsia/Trace_fuchsia_write/Util/index.html b/trace-fuchsia/Trace_fuchsia_write/Util/index.html
deleted file mode 100644
index 5b842e7..0000000
--- a/trace-fuchsia/Trace_fuchsia_write/Util/index.html
+++ /dev/null
@@ -1,2 +0,0 @@
-
-Util (trace-fuchsia.Trace_fuchsia_write.Util)
Module Trace_fuchsia_write.Util
val missing_to_round : int -> int
How many bytes are missing for n to be a multiple of 8
val round_to_word : int -> int
Round up to a multiple of 8
\ No newline at end of file
diff --git a/trace/Trace_core/Collector/index.html b/trace/Trace_core/Collector/index.html
deleted file mode 100644
index 015d582..0000000
--- a/trace/Trace_core/Collector/index.html
+++ /dev/null
@@ -1,2 +0,0 @@
-
-Collector (trace.Trace_core.Collector)
Module Trace_core.Collector
A global collector.
The collector, if present, is responsible for collecting messages and spans, and storing them, recording them, forward them, or offering them to other services and processes.
val dummy_span : int64
val dummy_explicit_span : Trace_core__.Types.explicit_span
\ No newline at end of file
diff --git a/trace/Trace_core/Collector/module-type-S/index.html b/trace/Trace_core/Collector/module-type-S/index.html
deleted file mode 100644
index 254f00b..0000000
--- a/trace/Trace_core/Collector/module-type-S/index.html
+++ /dev/null
@@ -1,95 +0,0 @@
-
-S (trace.Trace_core.Collector.S)
Module type Collector.S
Signature for a collector.
This is only relevant to implementors of tracing backends; to instrument your code you only need to look at the Trace module.
val with_span :
- __FUNCTION__:string option->
- __FILE__:string ->
- __LINE__:int ->
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- (int64 ->'a)->
- 'a
Run the function in a new span.
This replaces the previous enter_span and exit_span which were too flexible to be efficient to implement in async contexts.
since 0.3
val enter_span :
- __FUNCTION__:string option->
- __FILE__:string ->
- __LINE__:int ->
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- int64
Enter a new implicit span. For many uses cases, with_span will be easier to use.
since NEXT_RELEASE
val exit_span : int64 -> unit
Exit span. This should be called on the same thread as the corresponding enter_span, and nest properly with other calls to enter/exit_span and with_span.
since NEXT_RELEASE
val enter_manual_span :
- parent:Trace_core__.Types.explicit_span option->
- flavor:[ `Sync | `Async ] option->
- __FUNCTION__:string option->
- __FILE__:string ->
- __LINE__:int ->
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- Trace_core__.Types.explicit_span
Enter an explicit span. Surrounding scope, if any, is provided by parent, and this function can store as much metadata as it wants in the hmap in the explicit_span's meta field.
This means that the collector doesn't need to implement contextual storage mapping span to scopes, metadata, etc. on its side; everything can be transmitted in the explicit_span.
since 0.3
val exit_manual_span : Trace_core__.Types.explicit_span-> unit
Exit an explicit span.
since 0.3
val add_data_to_span :
- int64 ->
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- unit
since Adds data to the current span.
0.4
val add_data_to_manual_span :
- Trace_core__.Types.explicit_span->
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- unit
Adds data to the given span.
since 0.4
val message :
- ?span:int64 ->
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- unit
Emit a message with associated metadata.
val name_thread : string -> unit
Give a name to the current thread.
val name_process : string -> unit
Give a name to the current process.
val counter_int :
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- int ->
- unit
Integer counter.
val counter_float :
- data:
- (string
- * [ `Int of int
- | `String of string
- | `Bool of bool
- | `Float of float
- | `None ])
- list->
- string ->
- float ->
- unit
Float counter.
val shutdown : unit -> unit
Shutdown collector, possibly waiting for it to finish sending data.
\ No newline at end of file
diff --git a/trace/Trace_core/Meta_map/Key/index.html b/trace/Trace_core/Meta_map/Key/index.html
deleted file mode 100644
index 727dd7f..0000000
--- a/trace/Trace_core/Meta_map/Key/index.html
+++ /dev/null
@@ -1,2 +0,0 @@
-
-Key (trace.Trace_core.Meta_map.Key)
Module Meta_map.Key
Keys with a type witness.
type'a t
A key of type 'a t is used to access the portion of the map or table that associates keys of type 'a to values.
Make a new key. This is generative, so calling create () twice with the same return type will produce incompatible keys that cannot see each other's bindings.