Skip to main content
Version: Nightly

Events

The greptime_private.events table stores events recorded while GreptimeDB runs. It helps operators inspect DDL changes and background procedures without searching service logs.

GreptimeDB writes event records asynchronously on a best-effort basis. Records are normally flushed every five seconds, so a recent operation might not be visible immediately. Event recording should not be treated as the operation's success acknowledgement.

Configure event recording​

See Event recording for configuration options and the event types supported by standalone, Frontend, and Metasrv.

Query events​

The table is created when the first event is recorded. If no event has been recorded yet, or event recording is disabled, this query returns a table-not-found error.

Start with a bounded query while investigating a recent operation:

SELECT timestamp, type
FROM greptime_private.events
WHERE timestamp >= now() - INTERVAL '1' hour
ORDER BY timestamp DESC
LIMIT 20;

Use the following pages for focused queries and event details: