Troubleshooting
Symptoms, likely causes, and fixes for common LoggerMan issues.
Logs never appear in the dashboard
- Confirm the active project in the sidebar switcher matches the
projectIdin your app. - Verify
LOGGERMAN_BASE_URLis reachable from the machine sending logs (tunnel URL, not wrong port). - Check the token matches Settings → API keys (regenerating invalidates old tokens).
- Send a test log from Integration — if that works, the issue is in your app env or network, not LoggerMan core.
- Inspect browser or server console for SDK errors (status 401/403/400).
401 or 403 from the API
401 — missing or malformed Authorization header. Ensure Bearer prefix and no extra quotes.
403 — token does not authorize this project ID. Double-check ID and token pair; regenerate if unsure.
Dashboard stuck on “Loading projects…”
Usually a network or sign-in issue — ad blockers, strict firewalls, or an expired session can block the dashboard from loading your projects. Sign out and back in, try another browser or network, then refresh.
Cannot add a team member
The email must belong to an existing LoggerMan user. Ask them to sign up first, then retry. Typos and plus-address aliases must match exactly.
Test log works but app logs do not
- Server vs client: tokens must only run server-side.
- Wrong env file loaded (`.env` vs `.env.local` in Next.js).
- Fire-and-forget without
awaiton serverless — request may terminate early.
Invalid JSON or validation errors (400)
message is required. type and criticality must be allowed enum values. metadata must be a plain object, not a string or array.
Still stuck?
Re-read the Quick start and API reference. Compare your request to a working Integration test log. If the dashboard itself will not load, contact support with your account email and what you already tried from this page.