Referencia Zigspire-zig (SDK consumido)

zig/src/trace.zig

Declaraciones públicas de zig/src/trace.zig (spire-zig (SDK consumido)).

ImplementadoSin versión del tren todavía· generada desde apps/docs/generated/zig/spire.json

Página generada desde spire@spire-0.2.0-XvnrRek1BgCX4Bh8miuITCQgkn0FqeQrYYE3goFfDcQd (zig/src/root.zig). No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

Contexto de traza W3C (traceparent v00) para el sobre v2.

El campo ya viaja dentro de la región firmada del sobre (flag b2, 55 bytes; ENVELOPE_V2.md §2.1). Este módulo sólo ayuda a construirlo y derivarlo: no cambia el formato ni la versión del sobre. Cada emisor pone su propio span (child) y firma; nadie reescribe un sobre recibido. Los valores son ids aleatorios, sin PII ni tracestate/baggage.

trace.Traceparent

const · línea 14

pub const Traceparent = [LEN]u8

Sin ///.

trace.FLAG_SAMPLED

const · línea 17

pub const FLAG_SAMPLED: u8 = 0x01

Flag W3C "sampled".

trace.Parsed

type · línea 19

pub const Parsed = struct

Sin ///.

trace.Parsed.sampled

fn · línea 24

pub fn sampled(p: Parsed) bool

Sin ///.

trace.parse

fn · línea 30

pub fn parse(s: []const u8) ?Parsed

null si no es un traceparent v00 válido (mismas reglas que el sobre).

trace.format

fn · línea 42

pub fn format(p: Parsed) Traceparent

00-<trace>-<span>-<flags> en minúsculas.

trace.child

fn · línea 64

pub fn child(parent: Parsed) Parsed

Span hijo: mismo trace id y flags, span id aleatorio nuevo.

trace.newRoot

fn · línea 69

pub fn newRoot(sampled: bool) Parsed

Traza nueva (raíz).

trace.childOf

fn · línea 79

pub fn childOf(parent: []const u8) ?Traceparent

traceparent de un span hijo del recibido, o null si el recibido no es válido.