Monitoring

Log Format

Configure in config.yaml:

log_level: "info"     # debug, info, warning, error
log_format: "json"    # json (production) or text (development)

JSON output example:

{
  "timestamp": "2025-01-19T10:30:00Z",
  "level": "INFO",
  "logger": "beam_agent.core.agent",
  "message": "Processing execution",
  "execution_id": "exec-123",
  "node_id": "node-scan-001"
}

Key Log Events

Event	Level	Meaning
Starting queue polling	INFO	Agent is running and listening
Received N messages	INFO	Messages fetched from queue
Processing execution with tool: X	INFO	Tool execution started
Successfully processed execution	INFO	Tool completed, output uploaded
Failed to process execution	ERROR	Tool failed, check error message
Tool 'X' not registered	ERROR	Tool name in workflow doesn't match any registered tool
Published completion event	INFO	Result sent back to NINA

Agent Statistics

Logged on shutdown:

Messages processed: 150
Messages failed: 3
Tools executed: 150
Average execution duration: 2.5 seconds

Debugging

Set log_level: "debug" temporarily to see detailed execution traces. Remember to revert to info after.

Next Steps

• Troubleshooting - Solve common issues
• Configuration - Tune performance settings