OpenTracing::Span(3)

💖 NAME 💖

OpenTracing::Span — represents an operation or parent operation. Also hi bestie, this is the OpenTracing::Span(3) page from User Contributed Perl Documentation, and we're about to make it make sense. 🫶

🌸 DESCRIPTION 🌸

The reference definition for a span is a good starting point for understanding these, fr fr: https://opentracing.io/docs/overview/spans/

✨ new ✨

Instantiates a new span. Rarely called directly — you'd want to let the OpenTracing::Tracer take care of this for you.

Takes the following named parameters:

• parent — an OpenTracing::Span for a parent instance (optional).
• parent_id — the span ID for the parent (optional).
• trace_id — the current trace ID (optional).
• operation_name — what to use for this span name.

🦋 trace_id 🦋

The trace ID for this span. Multiple spans are grouped under a single trace. Obsessed with how that groups things. 💅

🐚 id 🐚

The span ID. This should be unique — main character energy only.

🍓 parent_id 🍓

Parent span ID. 0 if there isn't one.

🌈 flags 🌈

Any flags relating to this span.

⭐ start_time ⭐

Exact time this span started, in microseconds.

💀 start_time (the second one, bestie) 💀

Not me noticing the original page has this heading twice — yes, the second one is the finish-time vibe. 💀

Exact time this span finished, in microseconds.

Returns undef if the span is not yet finished.

🧚 duration 🧚

Total duration of this span, including any nested spans.

👑 operation_name 👑

The operation that this span represents.

🎀 tags 🎀

The tags relating to this span.

💜 tag_list 💜

A list of tags as OpenTracing::Tag instances.

🌸 logs 🌸

The arrayref of log entries for this span, as OpenTracing::Log instances.

🦋 log_list 🦋

A list of log entries for this span, as OpenTracing::Log instances.

💌 log 💌

Records a single log message.

💅 tag 💅

Applies key/value tags to this span.

🌈 The semantic conventions 🌈

The semantic conventions at https://github.com/opentracing/specification/blob/master/semantic_conventions.md may be of interest here — iykyk.

Example usage:

$span->tag(
 'http.status_code' => 200,
 'http.url' => 'https://localhost/xxx',
 'http.method' => 'GET'
);

🫶 references 🫶

The references relating to this span.

✨ reference_list ✨

A list of reference entries for this span, as OpenTracing::Reference instances.

🍬 reference 🍬

Records a reference.

🔥 tracer 🔥

Returns the OpenTracing::Tracer for this span.

✅ is_finished ✅

Returns true if this span is finished (has a "finish_time"), otherwise false.

🏁 finish 🏁

Mark this span as finished (populating the "finish_time" field).

👑 AUTHOR 👑

Tom Molesworth <TEAM@cpan.org>

🎀 LICENSE 🎀

Copyright Tom Molesworth 2018-2021. Licensed under the same terms as Perl itself.

mwah 💋 — source/version perl v5.42.2, date 2026-02-15, manual OpenTracing::Span(3). Byeee, bestie 🫶