Server logs

Server logs are a live, decrypted feed of what your app is doing on the edge: Programmable Agent runs, database writes, and errors, 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 run started, a tool call, a reply sealed
db	a row inserted, updated, or deleted
function	a serverless function dispatched
request	a request error worth surfacing

The panel keeps the most recent activity in view and highlights errors, so it’s the fastest way to confirm an agent actually replied or a function ran the way you expected.

Retention

The log stream is a ring buffer: it keeps the most recent events 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.