> ## 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.

# Observability

> Logs, metrics, and debugging

This reference covers observability on Suga: viewing logs, monitoring metrics, and debugging issues.

## Logs

Logs have their own reference page. See [Logs](/operate/logs) for structured logging, severity detection, library compatibility, retention, and limitations.

***

## Metrics

Select a service on the canvas and open the **Status** tab in the properties panel. CPU and memory charts appear below the deployment status, broken down per replica.

<Frame>
  <img src="https://mintcdn.com/nitric/iPjPkoE08JIkPQyn/images/metrics.png?fit=max&auto=format&n=iPjPkoE08JIkPQyn&q=85&s=d3be3cd2d2ca62ab7738c5443aee7fd2" alt="Status tab showing CPU and memory usage graphs" width="2914" height="1748" data-path="images/metrics.png" />
</Frame>

### 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 the service being killed, increase memory |
| Growing steadily | Possible memory leak |
| Consistently \< 30% | Over provisioned |

<Warning>
  Memory at 90%+ means the service is at high risk of being killed and restarted. Increase the memory allocation.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.