14. Logging & Diagnostics

14.0 Built-in Logging

Version 1.0.0 added explicit logging capability to the app. Log entries are written to Frappe's standard logging infrastructure and can be viewed in:

• Settings > Error Log: for errors and exceptions
• Server log files at frappe-bench/logs/: for detailed trace output

14.1 What Gets Logged

• AuthToken validation failures
• Employee not found (biometric ID with no matching employee)
• JSON parsing errors
• Exceptions during Employee Checkin creation
• Successful punch processing (at DEBUG level)

14.2 Reading Error Logs

In FrappeHR:

1. Go to Settings > Error Log (or search for "Error Log")
2. Filter by Method containing cams_call to isolate integration errors
3. Each error log entry shows the timestamp, error message, and full traceback