abzhaw/log-management

Log Management

Structured Logger Pattern

type LogLevel = 'debug' | 'info' | 'warn' | 'error';

function createLogger(service: string) {
  return {
    log: (level: LogLevel, msg: string, meta?: object) => {
      const entry = {
        ts: new Date().toISOString(),
        service,
        level,
        msg,
        ...meta,
      };
      console[level === 'debug' ? 'log' : level](JSON.stringify(entry));
    },
    info:  (msg: string, meta?: object) => this.log('info', msg, meta),
    warn:  (msg: string, meta?: object) => this.log('warn', msg, meta),
    error: (msg: string, meta?: object) => this.log('error', msg, meta),
  };
}

const log = createLogger('bridge');
log.info('Server started', { port: 3001 });
log.error('Failed to process message', { messageId: '123', err: e.message });

PM2 Log Commands

pm2 logs                          # tail all services
pm2 logs bridge --lines 100       # last 100 lines for one service
pm2 logs bridge --nostream        # print without tailing
pm2 flush                         # clear all PM2 logs
pm2 logs --err                    # stderr only

Log File Locations

~/.pm2/logs/<name>-out.log        # PM2 managed stdout
~/.pm2/logs/<name>-error.log      # PM2 managed stderr
~/juliaz_agents/logs/startup.log  # boot startup log
~/juliaz_agents/logs/launchagent.log  # LaunchAgent output
~/juliaz_agents/adhd-agent/memory/adhd_loop.log
~/juliaz_agents/security-agent/memory/

Log Rotation (PM2 module)

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 7
pm2 set pm2-logrotate:compress true