OpenTra...::Zipkin(3)

🦋 OpenTracing::Protocol::Zipkin(3) — the Perl manual page, bestie edition 💅

okay so this is a User Contributed Perl Documentation page for OpenTracing::Protocol::Zipkin(3) and it's literally the support system for the Zipkin v2 JSON representation of OpenTracing data. yes that's a mouthful, no I will not be shortening it, it's iconic. 🎀

---

✨ NAME ✨

OpenTracing::Protocol::Zipkin — support for Zipkin v2 JSON representation of OpenTracing data 🫶

🌸 DESCRIPTION 🌸

See <https://zipkin.io/zipkin-api/#/default/post_spans> for details on the current format. that's the canonical source, go look at it, iykyk 💜

🎀 bytes_from_span

Returns the given data structure as a bytestream containing a JSON UTF-8 representation, as defined by Zipkin, Datadog and other providers. so yeah, it hands you back bytes. bytes with vibes. ⭐

The resulting JSON will have at most the following keys — like, these are the only ones that can show up, no surprise guests:

• "id" — the span ID 🔥
• "traceId" — the trace ID ✨
• "parentId" — this trace's parent ID 🌈
• "localEndpoint" — where this span was running 🎀
• "remoteEndpoint" — the remote connection that this span was involved with 🦋
• "annotations" — any timestamp annotations relating to this span 💖
• "tags" — any key/value pairs relating to this span 👑

🧚 span_from_bytes

Takes a bytestring containing UTF-8-encoded JSON data, and returns a Perl hashref representing a span. that's it, that's the whole thing. bytes in, hashref out, main character energy 💅

ngl the "at most" up there is doing real work — don't go assuming every key is always present, bestie. 🙈

---

💜 AUTHOR 💜

Tom Molesworth "<TEAM@cpan.org>" — thank you king 👑

🌟 LICENSE 🌟

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

1;

---

okay that 1; at the end? that's just Perl being Perl, it has to return true so the module loads. iconic behaviour honestly. 🍓

and that's a wrap, bestie — this page came from perl v5.42.2, dated 2026-02-15, filed under OpenTra...::Zipkin(3). slay, go forth and trace your spans 🧚💖