Skip to main content
The Worlds Platform maintains an internal logging system to track world-specific events and provide an audit trail for agent actions.

Logs service

The LogsService manages logs within a world’s database. Defined in lib/database/world/logs/service.ts, it provides the following capabilities:
  • listByWorld(worldId, limit): Retrieves logs in descending chronological order.
  • listSince(sinceTimestamp, limit): Retrieves logs in ascending order starting from a specific timestamp.

Log levels

The platform utilizes standard log levels to categorize severity and intent: info, warn, error, and debug.

Log triggers

Specific platform events automatically trigger log entries in the world-scoped database for auditing and debugging:
EventWorld ID sourceLevelNotes
World createdNew world idinfoIncludes the world label in metadata.
World updated:worldinfoIncludes the changed fields in metadata.
World deleted:worldinfoCreated before deletion to maintain audit.
SPARQL query:worldinfoIncludes the query type or size.
SPARQL update:worldinfoIncludes the update type.