@spec async((() -> any())) :: Task.t()

Drop-in replacement for Task.async/1 that propagates the process' span context.

Does NOT start a new span for what's inside. Consider with_child_span/3.

@spec async(module(), atom(), [term()]) :: Task.t()

Drop-in replacement for Task.async/3 that propagates the process' span context.

Does NOT start a new span for what's inside. Consider with_child_span/3.

@spec await(Task.t(), :infinity | pos_integer()) :: term()

Drop-in replacement for Task.await/2.

Wrap the given block in a child span with the given label/name and optional attributes.

Sets Logger.metadata/0 with Opencensus.Logger.set_logger_metadata/0 after changing the span context tracked in the process dictionary.

No attributes:

with_child_span "child_span" do
  :do_something
end

with_child_span "child_span", %{} do
  :do_something
end

Custom attributes:

with_child_span "child_span", [:module, :function, %{"custom_id" => "xxx"}] do
  :do_something
end

Automatic insertion of the module, file, line, or function:

with_child_span "child_span", [:module, :function, %{}] do
  :do_something
end

Collapsing multiple attribute maps (last wins):

with_child_span "child_span", [:function, %{"a" => "b", "c" => "d"}, %{"c" => "e"}] do
  :do_something
end