Observability & Ops
Logging
- Laravel default log channel:
stack(LOG_CHANNEL). - Log location:
storage/logs/laravel.log.
Queue Monitoring
- Tables:
jobs,failed_jobs,job_batches. - Minimum metrics:
- number of failed jobs
- long queue
- retry spike
Operational Dashboards (Recommendations)
| Dashboards | Metrics |
|---|---|
| API Health | p95 latency, 4xx/5xx rates |
| Queues | jobs waiting, failed jobs/hour |
| DB | slow query count, connection saturation |
| Business | number of SPB waiting, PO complaints, payment waiting |
Alerting Rules (Recommendations)
- 5xx errors > 3% for 5 minutes.
- Failed jobs > 20 in 15 minutes.
- Login API failure spike > baseline 2x.
Audit & Security Ops
- Rotation of tokens/API secrets.
- Make sure
APP_DEBUG=falsein prod. - Protect
/api/v1/docendpoint (strong basic auth).
Verification Notes
- Status: Partial
- Scope: Explicit APM integration (Sentry/NewRelic/Datadog) not found in source audit.
- Action: Verify the actual monitoring stack in the deployment environment and update the document.