Module passage_pd

Description
Function Index
Function Details

Process Dictionary version of passage.

Copyright © 2017 Takeru Ohta <phjgt308@gmail.com>

Description

Process Dictionary version of passage.

The functions in this module operate on the span which stored in the process dictionary of the calling process.

Examples

  %% Registers `tracer'
  Context = passage_span_context_null,
  Sampler = passage_sampler_all:new(),
  Reporter = passage_reporter_process:new(self(), span),
  ok = passage_tracer_registry:register(tracer, Context, Sampler, Reporter),
 
  %% Starts a root span
  ok = passage_pd:start_span(example_root, [{tracer, tracer}]),
 
  %% Starts a child span
  ok = passage_pd:start_span(example_child),
 
  %% Finishes spans
  passage_pd:finish_span(),  % child
  passage_pd:finish_span(),  % root
 
  %% Receives the finished spans
  receive {span, FinishedChildSpan} -> ok end,
  receive {span, FinishedRootSpan} -> ok end.

Function Index

current_span/0	Returns the current span stored in the process dictionary of the calling process.
finish_span/0	Equivalent to `finish_span([])`.
finish_span/1	Pops the current span from process dictionary and finishes the span.
get_baggage_items/0	Returns the baggage items carried by the current span.
log/1	Equivalent to `log(Fields, [])`.
log/2	Logs the `Fields` to the current span.
set_baggage_items/1	Sets the baggage items of the current span to `Items`.
set_operation_name/1	Sets the operation name of the current span to `OperationName`.
set_tags/1	Sets the tags of the current span to `Tags`.
start_span/1	Equivalent to `start_span(OperationName, [])`.
start_span/2	Starts a span.
with_span/2	Equivalent to `with_span(OperationName, [], Fun)`.
with_span/3	Starts a span enclosing `Fun`.

Function Details

current_span/0

current_span() -> passage:maybe_span()

Returns the current span stored in the process dictionary of the calling process.

finish_span/0

finish_span() -> ok

Equivalent to finish_span([]).

finish_span/1

finish_span(Options::passage:finish_span_options()) -> ok

Pops the current span from process dictionary and finishes the span.

The finished span will be sent an external observer via the reporter associated with the tracer of the span.

get_baggage_items/0

get_baggage_items() -> passage:baggage_items()

Returns the baggage items carried by the current span.

log/1

log(Fields::passage:log_fields()) -> ok

Equivalent to log(Fields, []).

log/2

log(Fields::passage:log_fields(), Options::passage:log_options()) -> ok

Logs the Fields to the current span.

set_baggage_items/1

set_baggage_items(Items::passage:baggage_items()) -> ok

Sets the baggage items of the current span to Items.

Note that the existing items which have different keys with Items are preserved.

See also: Set a baggage item (The OpenTracing Semantic Specification)

set_operation_name/1

set_operation_name(OperationName::passage:operation_name()) -> ok

Sets the operation name of the current span to OperationName.

set_tags/1

set_tags(Tags::passage:tags()) -> ok

Sets the tags of the current span to Tags.

Note that the existing tags which have different keys with Tags are preserved.

start_span/1

start_span(OperationName::passage:operation_name()) -> ok

Equivalent to start_span(OperationName, []).

start_span/2

start_span(OperationName::passage:operation_name(), Options::passage:start_span_options()) -> ok

Starts a span.

The started span will be pushed to the process dictionary of the calling process.

If there is no sampled span references, the value of span will be undefined.

with_span/2

with_span(OperationName::passage:operation_name(), Fun) -> Result

Fun = fun(() -> Result)
Result = term()

Equivalent to with_span(OperationName, [], Fun).

with_span/3

with_span(OperationName::passage:operation_name(), Options::passage:start_span_options(), Fun) -> Result

Fun = fun(() -> Result)
Result = term()

Starts a span enclosing Fun.

Generated by EDoc, Oct 28 2017, 05:08:05.