Filesystem & Ledger

When the configured ledger directory is not writable, the SDK falls back to /tmp/.aurex then memory-only storage.

Agent hint

Use for AUREX_LEDGER_PATH, per_process_ledger, storage_mode file vs memory.

In scope

  • Fallback chain: configured path → /tmp → memory
  • Multi-worker ledger suffix
  • AUREX_WORKER_ID

Out of scope

  • Cloud sync retries — see Cloud Sync Resilience
Python
from aurex_sdk import AurexAuditor, AurexConfig

auditor = AurexAuditor(AurexConfig(
    ledger_path=".aurex/ledger.jsonl",
    storage_mode="file",
    per_process_ledger=True,  # avoids cross-worker contention
))
Node.js
const auditor = AurexAuditor.getInstance({
  ledgerPath: ".aurex/ledger.jsonl",
  perProcessLedger: true,
  maxQueueSize: 10000,
});

See also