Activity Logs

The Activity Logs page (/logs) provides a chronological record of important events across the system.

What Gets Logged

Botmarley logs significant events in the following categories:

Category	Examples
Trading	Session started, paused, stopped; actions executed (buy/sell)
Backtest	Backtest started, completed, failed
Account	Account created, verified, balance synced
Portfolio	Portfolio sync triggered, completed
Data	History sync started, completed
System	Server started, task recovered, errors

Log Levels

Level	Color	Meaning
Info	Blue	Normal operations (session started, sync completed)
Warning	Amber	Non-critical issues (stale task recovered, API rate limit)
Error	Red	Failures requiring attention (API error, task failed)

Viewing Logs

The logs page shows the most recent events with:

Timestamp — when the event occurred
Category — which system area generated the log
Event — what happened
Level — severity indicator
Details — additional context (optional)

Filtering

You can filter logs by:

Category — show only trading, backtest, or system events
Level — filter by info, warning, or error
Time range — view logs from a specific period

Activity logs page with filtering controls for log level and category

Log Storage

Activity logs are stored in PostgreSQL and persist across server restarts. They are separate from the structured tracing logs that go to stdout.

Tip

Activity logs are designed for user-facing event tracking. For debugging server issues, check the terminal output where structured tracing logs provide more technical detail.

Common Log Events

Trading Session Logs

[INFO]  trading  session_started   Session "BTC Scalper" started on XBTUSDT
[INFO]  trading  action_executed   BUY 0.001 BTC @ $67,500.00
[INFO]  trading  session_paused    Session "BTC Scalper" paused by user
[INFO]  trading  session_stopped   Session "BTC Scalper" stopped - PnL: +$45.20 (+2.3%)

Error Logs

[ERROR] trading  engine_error      Failed to fetch candles: API timeout
[ERROR] account  sync_failed       Account verification failed: invalid API key
[WARN]  system   task_recovered    Recovered 2 stale tasks from previous crash

Botmarley User Manual