zflai

Zflai is a fast-logging framework for Zshell (ZSH) designed to add logging capabilities to scripts with minimal performance overhead. It solves the common problem where logging significantly slows down script execution, especially for large workloads, by employing a background process that handles data storage asynchronously.

Key Features

• Background Logging Process — Uses a background process started via substitution, with fast file descriptor communication to minimize script slowdown.
• Multiple Backend Support — Stores logs in files, SQLite3, MySQL, or ElasticSearch after configurable intervals.
• Automatic Process Management — The background process shuts down after idle time and respawns when needed, preventing unnecessary process duplication.
• Table Definitions — Allows defining tables with SQL-like types that are created automatically on first use with any backend.
• Hook System — Supports configurable hooks for actions like opening or closing connections, with shell command execution.
• Configuration via Zstyle — Customizable settings for keep-alive time and storage intervals using ZSH's zstyle mechanism.

Philosophy

Zflai prioritizes performance and flexibility, enabling feature-rich logging to databases without the typical execution time penalties, making it suitable for all shells and scripts.