https://github.com/sam701/slog

Structured logging for Zig
https://github.com/sam701/slog

logging zig-package ziglang

Last synced: 8 months ago
JSON representation

Structured logging for Zig

• Host: GitHub
• URL: https://github.com/sam701/slog
• Owner: sam701
• License: mit
• Created: 2025-05-04T15:10:58.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-06-04T20:40:27.000Z (8 months ago)
• Last Synced: 2025-06-05T02:19:31.995Z (8 months ago)
• Topics: logging, zig-package, ziglang
• Language: Zig
• Homepage:
• Size: 143 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zig - sam701/slog - A configurable, structured logging package for Zig with support for hierarchical loggers. (Logging Processing / Linker)

README

          
# Structured Logging for Zig

[![Zig Docs](https://img.shields.io/badge/docs-zig-%23f7a41d)](https://sam701.github.io/slog)

`slog` is a configurable, structured logging package for Zig with support for hierarchical loggers.

![img](./doc/log-output.png)

## Usage

Add `slog` to your `build.zig.zon`

```

zig fetch --save git+https://github.com/sam701/slog

```

Example code:

```zig

const std = @import("std");

const slog = @import("slog");

pub fn main() !void {

    var log = try slog.initRootLogger(std.heap.page_allocator, .{});

    defer log.deinit();

    var log2 = try log.initChildLogger("mod1");

    var log3 = try log2.initChildLogger("mod2");

    var log4 = try log3.initChildLogger("mod3");

    log.info("Hello slog!", .{ .field1 = "value1", .field2 = "value1", .rate = 30 });

    log2.trace("Hello slog!", .{ .field1 = "value1", .field2 = "value2", .rate = 30 });

    log2.debug("Hello slog!", .{ .field1 = "value1", .field2 = "value3", .rate = 30 });

    log2.info("Hello slog!", .{ .field1 = "value1", .field2 = "value4", .rate = 30e2 });

    log3.warn("Hello slog!", .{ .field1 = "value1", .field2 = "value5", .rate = 30.34534 });

    log3.err("Hello slog!", .{ .field1 = "value1", .field2 = "value6", .rate = 30, .active = true, .metadata = null });

    log4.err("Hello slog!", .{ .field1 = "value1", .field2 = "value6", .rate = 30, .active = true, .metadata = null });

}

```

## Environment Variables

* `ZIG_LOG` - configures log level, e.g. `info,mod1=debug,mod2.mod3=warn`.

* `ZIG_LOG_COLORS` - configures color scheme for text logger, e.g. `timestamp=31;1,logger=33`.

## Dependencies

* [zeit](https://github.com/rockorager/zeit?tab=readme-ov-file) - a great date and time library for Zig