zig-tracer

Generic tracing library for Zig, supports multiple backends.

Usage

in your program:

const std = @import("std");
const tracer = @import("tracer");
const nfs = @import("nfs");
pub const build_options = @import("build_options");

pub const tracer_impl = tracer.spall; // see 'Backends' section below

pub fn main() !void {
    try tracer.init(.{});
    defer tracer.deinit();

    // main loop
    while (true) {
        try tracer.init_thread(.{nfs.cwd()});
        defer tracer.deinit_thread();

        handler();
    }
}

fn handler() void {
    const t = tracer.trace(@src());
    defer t.end();
}

Backends

• none this is the default and causes tracing calls to become a no-op so that tracer can be added to libraries transparently
• log uses std.log to print on function entrance.
• chrome writes a json file in the chrome://tracing format described here and here.
• spall writes a binary file compatible with the Spall profiler.
• more? feel free to open an issue with requests!

Any custom backend may also be used that defines the following functions:

• pub fn init() !void
• pub fn deinit() void
• pub fn init_thread(dir: std.fs.Dir) !void
• pub fn deinit_thread() void
• pub inline fn trace_begin(ctx: tracer.Ctx, comptime ifmt: []const u8, iargs: anytype) void
• pub inline fn trace_end(ctx: tracer.Ctx) void