This is the staging instance of ATR, for testing only. The production server is at releases.apache.org.

7.24. Application logs

Up: 7. Developer guide

Prev: 7.23. File handling

Next: 8. Admin dashboards

Sections:

Inventory

Relative paths below are inside STATE_DIR. Storage interface and Authentication security describe the audit log in more detail.

Log Destination Format Use
Audit log audit/daily/YYYY-MM-DD.jsonl JSON Lines Authentication events, storage writes and submitted keys
Release audit audit/releases/PROJECT/VERSION.jsonl JSON Lines One release's audit entries, compiled when it is finalised
Requests logs/requests.log JSON Lines HTTP request summaries without query strings, correlated with audit entries by request ID
Server output Standard error, captured with Hypercorn output in hypercorn/logs/hypercorn.log by start-atr.sh. Launch errors from the script go to the container output Mixed JSON and plain text Operational messages and errors with tracebacks, at LOG_LEVEL
Route timings logs/route-performance.log Text How long each route takes, summarised in Admin → System → Performance
Worker log logs/atr-worker.log JSON Lines Task progress, failures with tracebacks, and integrity check findings
Worker crashes and output logs/atr-worker-error.log. Raw output is discarded unless debug capture in manager is switched on, which writes logs/worker_TIMESTAMP_PID.log Text Errors that stop a worker, and debugging
Recurring tasks logs/tasks.log JSON Lines Successful runs of recurring tasks such as maintenance and audit sealing
Task history task table in database/atr.db SQLite rows Other tasks, with arguments, timings, results and errors, shown in Admin → System → Recent tasks
Key import logs/keys-import.log Text Output of each keys_import.py run, shown in Admin → Database → Update keys
Recent logs Memory, the last 100 server log lines, development only Text Shown at /admin/logs
Sent email logs/sent-email-dev.log, development only Text Email that development instances log instead of sending
Frontend proxy Set by the proxy, not by ATR Set by the proxy Requests and errors seen by the proxy