logs
The logs namespace — the engine's Luau API reference for logs.
The logs namespace — 7 functions.
globals/logs/clear
globals/logs/clear() -> boolean
Drop all buffered log entries. Lifetime per-level counts
(logs.count) are preserved.
globals/logs/count
globals/logs/count() -> LogCounts
Aggregate counters for the log ring. Lifetime counts survive
eviction, so errors reflects the total seen even if the lines
have scrolled out of the buffer.
globals/logs/errors
globals/logs/errors(limit: number?) -> { LogEntry }
Most-recent ERROR-level entries (newest first). limit
defaults to 100.
globals/logs/find
globals/logs/find(text: string, limit: number?) -> { LogEntry }
Case-insensitive substring search over log messages. limit
defaults to 200 (keeps the most recent matches).
globals/logs/query
globals/logs/query(opts: LogQueryOpts?) -> { LogEntry }
Query the engine's in-memory log ring. The live alternative
to grepping data/logs/engine-<port>.log.
globals/logs/tail
globals/logs/tail(limit: number?) -> { LogEntry }
Most-recent entries of any level in chronological order.
limit defaults to 100.
globals/logs/warnings
globals/logs/warnings(limit: number?) -> { LogEntry }
Most-recent WARN+ entries (newest first). limit defaults
to 100.