Logging
Both Workers and Load Balancer include a built-in logging system for monitoring, debugging, and auditing.
Where are logs stored?
- In-memory: Logs are kept in memory (RAM) up to a configurable limit (
MAX_LOGSin your.env). - /logs endpoint: You can retrieve the latest logs via the
/logsendpoint (requires authentication). - Console: All logs are also printed to the standard output (console), so you can collect them with Docker, systemd, or any log aggregation tool.
How to access logs
- Worker:
GET /logs(requiresAuthorization: <AUTH_KEY>orx-lb-auth: <LB_AUTH_KEY>)
- Load Balancer:
GET /logs(requires the Load Balancer'sLB_AUTH_KEYin theAuthorizationheader)- The dashboard can also display logs for each Worker.
Log levels and methods
You can use the following methods in your code (imported from @andera-top/worker-core/dist/utils/logger for Workers, or from ./utils/logger for the Load Balancer):
log(...)– Info-level logs (default)warn(...)– Warningserror(...)– Errorsdebug(...)– Debug-level logs (if enabled)
Example usage in a Worker function:
import { log, warn, error, debug } from '@andera-top/worker-core/dist/utils/logger'
log('[MYFUNC]', 'Function started')
warn('[MYFUNC]', 'This is a warning')
error('[MYFUNC]', 'Something went wrong')
debug('[MYFUNC]', 'Debug details:', { foo: 42 })
Log configuration
- Log level: Set
LOG_LEVELin your.envto control verbosity (debug,info,warn,error). Any other value stops the Worker at startup. - Max logs: Set
MAX_LOGS(a positive integer) to control how many log lines are kept in memory (default: 1000).
What gets logged
- Errors passed to a logging method are written as their name, message and code only, without stack traces or serialized properties, so credentials carried by error objects (for example HTTP client request headers) do not reach
/logs. - Other objects are serialized as JSON. Do not log secrets or sensitive inputs yourself.
- Function results are logged unless the function sets
logResult: false(see Functions).
Best practices
- Use log levels appropriately:
logfor normal events,warnfor recoverable issues,errorfor failures,debugfor detailed troubleshooting. - Use clear prefixes (e.g.,
[MYFUNC],[SERVICE]) to make logs easy to filter. - Aggregate logs with your favorite tool (Docker, systemd, ELK, etc.) for long-term storage and analysis.