This reference covers observability on Suga: viewing logs, monitoring metrics, and debugging issues.Documentation Index
Fetch the complete documentation index at: https://docs.suga.app/llms.txt
Use this file to discover all available pages before exploring further.
Logs
Access logs from the Logs tab in the service properties panel.Log Retention
Logs are available while your service is running. When services are replaced (during deployments, restarts, or scaling), previous logs are no longer accessible. For long-term log retention, you can stream logs to external services (Datadog, Logtail, Papertrail).Built-in log retention for Pro and Enterprise plans is coming soon.
Metrics
Access metrics from the Metrics tab in the service properties panel.
CPU Usage
Shows CPU cores consumed over time.| Pattern | Interpretation |
|---|---|
| Consistently > 80% | Increase CPU allocation |
| Consistently < 20% | Consider decreasing (save costs) |
| At 100% | Throttled, users experiencing slowness |
Memory Usage
Shows MiB/GiB consumed over time.| Pattern | Interpretation |
|---|---|
| Consistently > 80% | Risk of OOMKilled, increase memory |
| Growing steadily | Possible memory leak |
| Consistently < 30% | Over provisioned |