Skip to content

Projects

A project maps to one of your applications. When you set projectId: "my-api" in the SDK, the desktop app creates a project called my-api automatically the first time it receives a log.

You don’t register projects. You don’t configure them ahead of time. Just send a log with a projectId and it exists.

Projects appear in the sidebar. You can:

  • Rename them (the projectId from the SDK stays the same, just the display name changes)
  • Move them between workspaces
  • Delete them (deletes all their logs, buckets, and filters)
  • Configure log retention per project

By default, logs are kept forever. You can set a retention period per project:

  • Go to Settings → Projects → [your project]
  • Set Log retention days (e.g., 7 days)
  • Enable Auto-delete old logs

Logs older than the retention period are purged automatically.

You can override the project’s retention period per bucket. Useful when you want to keep error logs longer than debug logs:

  • Go to Settings → Projects → [your project]
  • Set per-bucket retention in the bucket settings section

See Typed Buckets for how buckets work.