> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aieev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Monitor container metrics and runtime logs

AirCloud provides monitoring at two levels: **Project Monitoring** and **Container Monitoring**.

## Project Monitoring

From the Project sidebar, open **Monitoring** to view metrics for all containers within the Project.

If the Project contains multiple containers, their metrics are displayed together on the same chart with separate legends for comparison.

<img src="https://mintcdn.com/aieev-723717ca/dkFBRWuZs0kiNAeQ/images/project-monitoring-eng942.png?fit=max&auto=format&n=dkFBRWuZs0kiNAeQ&q=85&s=fe3d3a6cb60391cfff5233454318fcfe" alt="Project Monitoring Eng942" width="2740" height="1904" data-path="images/project-monitoring-eng942.png" />

### Filters and Display Options

| Option                  | Description                                                                   |
| ----------------------- | ----------------------------------------------------------------------------- |
| **Container**           | Display metrics for a specific container only.                                |
| **Metric**              | Select the metrics to display.                                                |
| **Project / Container** | Switch between aggregated project metrics and per-container metrics.          |
| **Date Range**          | Select the time range to view.                                                |
| **Time Interval**       | Choose the aggregation interval (for example, **1 minute** or **5 minutes**). |
| **Auto Refresh**        | Enable or disable automatic updates.                                          |

## Container Monitoring

From an individual container page, open **Monitoring** to view detailed metrics for that container.

Use the metric selector in the upper-right corner to customize the dashboard and display only the metrics you need.

<img src="https://mintcdn.com/aieev-723717ca/dkFBRWuZs0kiNAeQ/images/runtime-endpoint-eng.png?fit=max&auto=format&n=dkFBRWuZs0kiNAeQ&q=85&s=3c1dc6916078428c8e0afd30df5dc4d7" alt="Runtime Endpoint Eng" width="2740" height="1904" data-path="images/runtime-endpoint-eng.png" />

### Available Metrics

| Metric                             | Description                                      |
| ---------------------------------- | ------------------------------------------------ |
| **GPU Memory Usage**               | GPU VRAM usage (MiB).                            |
| **GPU Utilization**                | GPU utilization (%).                             |
| **CPU Utilization**                | CPU utilization (%).                             |
| **Memory Usage**                   | System memory usage (GB).                        |
| **Network Traffic**                | Total inbound and outbound network traffic (GB). |
| **Network Throughput**             | Real-time network throughput (KB/s).             |
| **Active Replicas**                | Number of currently running Replicas.            |
| **HTTP Requests per Second (QPS)** | Number of HTTP requests processed per second.    |
| **HTTP P90 Latency**               | 90th percentile HTTP response latency.           |
| **HTTP Errors per Second**         | Number of HTTP error responses per second.       |
| **Request Count**                  | Number of requests over time.                    |
| **Total Requests**                 | Cumulative request count.                        |
| **Task Errors**                    | Number of processing errors.                     |

## Container Runtime Logs

From the **Runtime Logs** page of a container, you can view logs for both running and terminated Replicas, organized by date.

<img src="https://mintcdn.com/aieev-723717ca/dkFBRWuZs0kiNAeQ/images/runtime-log-eng.png?fit=max&auto=format&n=dkFBRWuZs0kiNAeQ&q=85&s=1ff3083878886219d2448800e7d2f424" alt="Runtime Log Eng" width="5480" height="3808" data-path="images/runtime-log-eng.png" />

Select a Replica and log file from the left panel to display its contents.

| Filter                    | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| **Replica / File Search** | Quickly find a specific Replica or log file.                 |
| **Time Range**            | Display logs within a specific time range.                   |
| **Keyword Search**        | Search log contents using plain text or regular expressions. |
| **Source Filter**         | Display logs from all sources or only selected sources.      |
| **View Options**          | Customize how logs are displayed.                            |

* View logs from both **Running** and **Terminated** Replicas.
* Browse log files organized by date.
* Click **Download All Logs** to download all available log files.

<Note>
  If a deployment fails or behaves unexpectedly, checking the runtime logs is usually the fastest way to identify the cause. Runtime logs are retained for a period of time even after a container has stopped.
</Note>

## Related Documentation

<Columns cols={2}>
  <Card title="Troubleshooting" icon="wrench" href="/docs/air-container/troubleshooting" cta="View Guide" arrow="true">
    Learn how to diagnose common deployment and operational issues.
  </Card>

  <Card title="Autoscaling and Scheduled Scaling" icon="activity" href="/docs/air-container/autoscaling-and-scheduling" cta="View Guide" arrow="true">
    Learn how Replica counts change with Autoscaling and Scheduled Scaling.
  </Card>
</Columns>