Home

Pudu Log

pudu-lang-log is a structured event logging package for Pudu, written in Pudu. A program writes events through message templates such as "Disk {Disk} is {Percent}% full"; the logger keeps every property as data, enriches and filters the event, and hands it to sinks that write text or JSON to the console, files, the network, memory, or another logger. Writing never fails the program: problems inside the pipeline go to a self-log.

This wiki documents the 0.1.0 API. Every program in it was checked with pudu check and run with pudu run against @chrismichaelps/pudu-lang-log@0.1.0. The versioned design notes live in the repository wiki/ directory.

Reading the book

The chapters follow the order in which you meet the API. New readers should begin with Getting Started, then continue through Parts I–III. The Reference Index lists every module on one page.

Part I — First steps

1. Getting Started
2. Writing Events
3. Configuring Loggers

Part II — Shaping events

4. Enrichment And Context
5. Filtering And Expressions
6. Formatting Output

Part III — Delivering events

7. Sinks
8. Settings
9. Web, Timing, And Bridge
10. Diagnostics And Testing

The Worked Programs appendix collects the complete modules behind every chapter, ready to run.

Repository

• Source
• Release 0.1.0
• Pudu language