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