← Docs

Agent logs & retention

Every connected agent ships its recent output to Keikaku, so you can read an agent's logs right in the portal — no docker logs needed. Logs are kept on a rolling window you control.

Logs in the portal

Open the app → Agents → click an agent. The Logs section shows the most recent lines (newest at the bottom), refreshing on demand. Use:

• Refresh to pull the latest lines;
• Download all to save the full retained log as a text file.

A freshly connected agent starts shipping within about 30 seconds; if you see “No logs shipped yet”, give it a moment.

Retention (server side)

We can't keep logs forever, so storage is rolling: old lines are pruned by age and a per-agent line cap. The default is 7 days. Change it per agent from the Keep for dropdown in the Logs section (1–90 days).

Local logs (on the agent)

The agent also keeps a buffer of its own output in memory for its local dashboard (http://localhost:9170). Under Logs there you can set how many lines to keep in memory (default 500). This is separate from — and in addition to — the server-side retention above.

From MCP

Use get_agent_logs to read an agent's recent logs and set_agent_log_retention to change how many days the server keeps them.