Downcity
AgentStorage

Logs and Debug Files

Which logs and state files to inspect first when an Agent fails

Logs and Debug Files

When an agent behaves incorrectly, the most useful places to inspect first are:

  • city agent status
  • logs under .downcity/
  • daemon state files
  • related session message files
  1. Check command output first.
  2. Then inspect logs and persisted messages under .downcity/.
  3. Only after that consider cleaning stale state.

If you have not narrowed the issue yet, deleting state files or message directories too early usually makes the problem harder to reproduce.

.downcity Layout

The rough responsibility split inside the .downcity directory of an Agent project

Startup Checklist

The most important project and configuration checks before starting an Agent

Table of Contents

Logs and Debug FilesRecommended inspection order