---
title: "Get current resource usage"
method: GET
path: "/v1/projects/{project_id}/metrics/summary"
tags: ["Logs, Metrics & Events"]
---

# Get current resource usage

`GET /v1/projects/{project_id}/metrics/summary`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/projects/{project_id}/metrics/summary`
- Auth: HTTP bearer

Returns the app's current CPU and memory usage per instance, and the usage of each of its disks. Team permission: any project permission.

## Path parameters

- `project_id` string, required

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Response `200`

Current usage.

- object
  - `cpuUsage` InstantMetric[]: CPU usage as a fraction of the app's CPU limit (for example `0.25`).
    - `applet` string: The instance the value belongs to.
    - `value` unknown[]: `[timestamp, value]`. The timestamp is in Unix seconds; the value is a string.
      - unknown
  - `memoryUsage` InstantMetric[]: Memory usage in bytes.
    - `applet` string: The instance the value belongs to.
    - `value` unknown[]: `[timestamp, value]`. The timestamp is in Unix seconds; the value is a string.
      - unknown
  - `disksUsage` object[]
    - `name` string: The disk's name.
    - `size` string: The disk's size.
    - `usage` string: Used space, in percent.
    - `reportedAt` number: When the usage was measured, in Unix seconds.

## Other responses

- `400`: `teamID` isn't a valid ID.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this app (`no_permission`).
- `404`: The app doesn't exist.
- `503`: The data is temporarily unavailable. Try again later.

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)