mirror of
https://github.com/ocaml-tracing/ocaml-opentelemetry.git
synced 2026-03-09 04:17:56 -04:00
16 lines
No EOL
8.2 KiB
HTML
16 lines
No EOL
8.2 KiB
HTML
<!DOCTYPE html>
|
||
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Span (opentelemetry.Opentelemetry.Span)</title><link rel="stylesheet" href="../../../odoc.css"/><meta charset="utf-8"/><meta name="generator" content="odoc 2.1.0"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a> – <a href="../../index.html">opentelemetry</a> » <a href="../index.html">Opentelemetry</a> » Span</nav><header class="odoc-preamble"><h1>Module <code><span>Opentelemetry.Span</span></code></h1><p>Spans.</p><p>A Span is the workhorse of traces, it indicates an operation that took place over a given span of time (indicated by start_time and end_time) as part of a hierarchical trace. All spans in a given trace are bound by the use of the same <a href="../Trace_id/index.html#type-t"><code>Trace_id.t</code></a>.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type" id="type-t" class="anchored"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span><span> = <a href="../Proto/Trace/index.html#type-span">Proto.Trace.span</a></span></code></div></div><div class="odoc-spec"><div class="spec type" id="type-id" class="anchored"><a href="#type-id" class="anchor"></a><code><span><span class="keyword">type</span> id</span><span> = <a href="../Span_id/index.html#type-t">Span_id.t</a></span></code></div></div><div class="odoc-spec"><div class="spec type" id="type-kind" class="anchored"><a href="#type-kind" class="anchor"></a><code><span><span class="keyword">type</span> <span class="keyword">nonrec</span> kind</span><span> = <a href="../Proto/Trace/index.html#type-span_span_kind">Proto.Trace.span_span_kind</a></span><span> = </span></code><table><tr id="type-kind.Span_kind_unspecified" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_unspecified" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_unspecified</span></span></code></td></tr><tr id="type-kind.Span_kind_internal" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_internal" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_internal</span></span></code></td></tr><tr id="type-kind.Span_kind_server" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_server" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_server</span></span></code></td></tr><tr id="type-kind.Span_kind_client" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_client" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_client</span></span></code></td></tr><tr id="type-kind.Span_kind_producer" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_producer" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_producer</span></span></code></td></tr><tr id="type-kind.Span_kind_consumer" class="anchored"><td class="def variant constructor"><a href="#type-kind.Span_kind_consumer" class="anchor"></a><code><span>| </span><span><span class="constructor">Span_kind_consumer</span></span></code></td></tr></table></div></div><div class="odoc-spec"><div class="spec type" id="type-status_code" class="anchored"><a href="#type-status_code" class="anchor"></a><code><span><span class="keyword">type</span> <span class="keyword">nonrec</span> status_code</span><span> = <a href="../Proto/Trace/index.html#type-status_status_code">Proto.Trace.status_status_code</a></span><span> = </span></code><table><tr id="type-status_code.Status_code_unset" class="anchored"><td class="def variant constructor"><a href="#type-status_code.Status_code_unset" class="anchor"></a><code><span>| </span><span><span class="constructor">Status_code_unset</span></span></code></td></tr><tr id="type-status_code.Status_code_ok" class="anchored"><td class="def variant constructor"><a href="#type-status_code.Status_code_ok" class="anchor"></a><code><span>| </span><span><span class="constructor">Status_code_ok</span></span></code></td></tr><tr id="type-status_code.Status_code_error" class="anchored"><td class="def variant constructor"><a href="#type-status_code.Status_code_error" class="anchor"></a><code><span>| </span><span><span class="constructor">Status_code_error</span></span></code></td></tr></table></div></div><div class="odoc-spec"><div class="spec type" id="type-status" class="anchored"><a href="#type-status" class="anchor"></a><code><span><span class="keyword">type</span> <span class="keyword">nonrec</span> status</span><span> = <a href="../Proto/Trace/index.html#type-status">Proto.Trace.status</a></span><span> = </span><span>{</span></code><table><tr id="type-status.message" class="anchored"><td class="def record field"><a href="#type-status.message" class="anchor"></a><code><span>message : string;</span></code></td></tr><tr id="type-status.code" class="anchored"><td class="def record field"><a href="#type-status.code" class="anchor"></a><code><span>code : <a href="#type-status_code">status_code</a>;</span></code></td></tr></table><code><span>}</span></code></div></div><div class="odoc-spec"><div class="spec value" id="val-id" class="anchored"><a href="#val-id" class="anchor"></a><code><span><span class="keyword">val</span> id : <span><a href="#type-t">t</a> <span class="arrow">-></span></span> <a href="../Span_id/index.html#type-t">Span_id.t</a></span></code></div></div><div class="odoc-spec"><div class="spec type" id="type-key_value" class="anchored"><a href="#type-key_value" class="anchor"></a><code><span><span class="keyword">type</span> key_value</span><span> =
|
||
string * <span>[ <span>`Int of int</span> <span><span>| `String</span> of string</span> <span><span>| `Bool</span> of bool</span> <span>| `None</span> ]</span></span></code></div></div><div class="odoc-spec"><div class="spec value" id="val-create" class="anchored"><a href="#val-create" class="anchor"></a><code><span><span class="keyword">val</span> create :
|
||
<span>?kind:<a href="#type-kind">kind</a> <span class="arrow">-></span></span>
|
||
<span>?id:<a href="#type-id">id</a> <span class="arrow">-></span></span>
|
||
<span>?trace_state:string <span class="arrow">-></span></span>
|
||
<span>?attrs:<span><a href="#type-key_value">key_value</a> list</span> <span class="arrow">-></span></span>
|
||
<span>?events:<span><a href="../Event/index.html#type-t">Event.t</a> list</span> <span class="arrow">-></span></span>
|
||
<span>?status:<a href="#type-status">status</a> <span class="arrow">-></span></span>
|
||
<span>trace_id:<a href="../Trace_id/index.html#type-t">Trace_id.t</a> <span class="arrow">-></span></span>
|
||
<span>?parent:<a href="#type-id">id</a> <span class="arrow">-></span></span>
|
||
<span>?links:<span><span>(<a href="../Trace_id/index.html#type-t">Trace_id.t</a> * <a href="../Span_id/index.html#type-t">Span_id.t</a> * string)</span> list</span> <span class="arrow">-></span></span>
|
||
<span>start_time:<a href="../Timestamp_ns/index.html#type-t">Timestamp_ns.t</a> <span class="arrow">-></span></span>
|
||
<span>end_time:<a href="../Timestamp_ns/index.html#type-t">Timestamp_ns.t</a> <span class="arrow">-></span></span>
|
||
<span>string <span class="arrow">-></span></span>
|
||
<a href="#type-t">t</a> * <a href="#type-id">id</a></span></code></div><div class="spec-doc"><p><code>create ~trace_id name</code> creates a new span with its unique ID.</p><ul class="at-tags"><li class="parameter"><span class="at-tag">parameter</span> <span class="value">trace_id</span> <p>the trace this belongs to</p></li></ul><ul class="at-tags"><li class="parameter"><span class="at-tag">parameter</span> <span class="value">parent</span> <p>parent span, if any</p></li></ul><ul class="at-tags"><li class="parameter"><span class="at-tag">parameter</span> <span class="value">links</span> <p>list of links to other spans, each with their trace state (see <a href="https://www.w3.org/TR/trace-context/#tracestate-header">w3.org</a>)</p></li></ul></div></div></div></body></html> |