> ## 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](/reference/logs) for structured logging, severity detection, library compatibility, retention, and limitations.

***

## Metrics

Access metrics from the **Metrics** tab in the service properties panel.

<Frame>
  <img src="https://mintcdn.com/nitric/-A2B3bvNIwKzai_W/images/metrics.png?fit=max&auto=format&n=-A2B3bvNIwKzai_W&q=85&s=d1296b39e1b3bdb501d2f8a9af6efd3b" alt="Metrics tab showing CPU and memory usage graphs" width="2880" height="1620" 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 OOMKilled, increase memory |
| Growing steadily    | Possible memory leak               |
| Consistently \< 30% | Over provisioned                   |

<Warning>
  Memory at 90%+ means high risk of OOMKilled crashes. Increase memory allocation.
</Warning>