Skip to content
Spawnbase Docs

Logging overview

Send JSON log entries, then search them. One ingest call takes a batch; the SDK batches for you (flush ≈5s or 50 entries).

  • Dataset — a named log stream (default if you don’t pick one). Selected with the X-Spawnbase-Dataset header or ?dataset= (query wins). Datasets auto-create on first ingest if your plan has room.
  • Levels — debug, info, warn, error, fatal. On ingest, warning → warn and trace → debug; anything else rejects the batch.
  • Player filters — if metadata carries playerSource/targetSource, the SDK expands it to metadata._playerIdentifiers (license, discord, steam, …). Filtering on it is plain metadata filtering.

Plan caps (datasets / log storage / retention): Free 3 / 5 GB / 15 d · Hobby 5 / 5 GB / 15 d · Pro 50 / 100 GB / 90 d · Network ∞ / 250 GB / 180 d.