observability.md

Observability & Logging in OrKa

Last Updated: 03 January 2026
Status: 🟢 Current
Related: Debugging | Best Practices | Architecture | INDEX

Redis Stream Logging

Every agent logs its input/output via:

{
  "agent_id": "validate_fact",
  "event_type": "output",
  "timestamp": "...",
  "payload": {
    "input": "...",
    "result": true
  }
}

Streams Used

• orka:memory — general memory log
• orka:{agent_id} — agent-specific stream

Inspecting Logs

Use:

redis-cli xrevrange orka:memory + - COUNT 10

OrKaUI (Tiamat)

• Replay traces
• Highlight branching decisions
• Future: confidence overlays, timeline scrubbing