Documentation Events
5 min read | June 24, 2026
Tutorial

Events

Page content

A event in Astralog is an immutable record of an event that occurred within your infrastructure. Unlike traditional logging systems that rely heavily on full-text indexing (like Elasticsearch), Astralog uses a columnar database (ClickHouse) optimized for fast aggregations and analytical queries over structured data.

  • Asynchronous Ingestion Pipeline: When your application sends a event to the /v1/drain endpoint, it is not written to the database immediately. Astralog buffers events in memory, groups them by project_id and service, and flushes them to an S3-compatible object storage as compressed batches.
  • Bulk Synchronization: A background worker continuously pulls these compressed batches from S3 and performs massive Bulk Inserts into ClickHouse. This guarantees zero data loss during traffic spikes while keeping database CPU usage minimal.