Server logs

Server logs are a live, decrypted feed of what your app is doing on the edge: Programmable Agent runs and database writes, streamed into the developer portal as they happen. There’s nothing to install and no SDK call — it’s a portal feature you read with your developer session.

Note

Logs are server-blind. The stream rides one of your app’s own end-to-end-encrypted Spaces: the edge seals each event into the log Space, and the relay only ever stores ciphertext. Only you — signed in as the app’s owner — can decrypt it. There’s no app key to copy and nothing to rotate per browser; ownership of the app is the only credential.

Opening the logs

In the developer portal, open an app and click the developer tools button (the wrench, bottom-right on every app page). The Server logs panel connects automatically and starts streaming.

Use the Environment toggle (Live / Test) to switch between the activity of your production and test deployments — they’re separate streams, just like your per-environment keys. It defaults to Live; switch to Test when your app is running on a test key.

What shows up

Each entry is a structured event with a level (info, success, warn, error), a source, a message, and an optional detail line:

Source	Examples
agent	an agent reply, with its model, the tools it called and tokens spent
db	a row inserted, updated, or deleted

The panel keeps the most recent activity in view and highlights errors, so it’s the fastest way to confirm an agent actually replied. The platform does not yet write entries for serverless function runs or request errors, so a function won’t appear here; return the details you need from the function itself.

Retention

The log stream is a ring buffer: it keeps the most recent 1,000 events per environment and trims the oldest automatically, so it stays bounded and clears itself over time. It’s built for live debugging and recent history, not long-term archival — if you need durable records, write them to your app database.

Tip

Because logs are stored E2E-encrypted against your account, the space they use counts toward your storage usage like any other Space — the ring buffer keeps that footprint small.