feat: structured auth logging for log-based analytics #23

New issue

Open

opened 2026-04-16 13:07:12 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-16 13:07:12 -07:00

Owner

Summary

Add structured auth-type logging to API endpoints so traffic can be analysed by log parsing rather than relying entirely on web analytics.

What Snipe did (reference implementation)

def _auth_label(user_id: str) -> str:
    """Classify user_id → local/anon/guest/authed — no PII."""
    if user_id == "local": return "local"
    if user_id == "anonymous": return "anon"
    if user_id.startswith("guest:"): return "guest"
    return "authed"

Add logging.basicConfig(level=logging.INFO, format="%(levelname)s:%(name)s: %(message)s") so app-level logs appear in docker logs.

Endpoints to instrument

Session bootstrap: log auth= + tier= on every call.
Dialer/IVR actions: log auth=, tier=, target agency/queue.

Reference

Circuit-Forge/snipe@873b9a1 — working implementation.

## Summary Add structured auth-type logging to API endpoints so traffic can be analysed by log parsing rather than relying entirely on web analytics. ## What Snipe did (reference implementation) ```python def _auth_label(user_id: str) -> str: """Classify user_id → local/anon/guest/authed — no PII.""" if user_id == "local": return "local" if user_id == "anonymous": return "anon" if user_id.startswith("guest:"): return "guest" return "authed" ``` Add `logging.basicConfig(level=logging.INFO, format="%(levelname)s:%(name)s: %(message)s")` so app-level logs appear in `docker logs`. ## Endpoints to instrument - **Session bootstrap**: log `auth=` + `tier=` on every call. - **Dialer/IVR actions**: log `auth=`, `tier=`, target agency/queue. ## Reference Circuit-Forge/snipe@873b9a1 — working implementation.

No labels

backlog

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Circuit-Forge/osprey#23

No description provided.