Logging
Owner: Operations
Reviewers: Engineering, Security
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per logging change
Logging Scope
| Source | Purpose |
|---|---|
| Backend API logs | Request handling, errors and operational diagnostics. |
| Activity logs | User and business action traceability. |
| IoT worker logs | Telemetry normalization and cloud ingest diagnostics. |
| Telegraf/MQTT logs | Ingestion troubleshooting. |
| K8s logs/events | Deployment and runtime health. |
Rules
- Do not log secrets or tokens.
- Include identifiers useful for tracing farm/pond/device issues.
- Preserve enough context for incidents without exposing sensitive data.
Open Items
- Centralized log provider.
- Retention policy.
- Access policy.