---
title: "stats"
slug: "stats"
updated: 2024-10-25T10:25:15Z
published: 2024-10-25T10:25:15Z
canonical: "docs.fmad.io/stats"
---

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

# stats

API to retrive various stats about the system

## /api/v1/system/stats/io

Gets statistics on the IO processing of the system, returned in JSON format

#### Address

`/api/v1/system/stats/io`

#### Verb

GET

#### Privilege

ADMIN USER

#### Notes

#### Arguments

| Parameter | Description |
| --- | --- |
| none |  |

### Example

Example of stats piped thur the jq utility

```bash
fmadio@fmadio100v2-228U:$ curl -s -k -u fmadio:**** https://192.168.2.175/api/v1/system/stats/io | jq
{
  "timestamp": "1729851682918884096",
  "ioqueue_active": "0"
}
```

## /api/v1/system/stats/disk

Gets high level stastics about the disks, returned in JSON format

#### Address

`/api/v1/system/stats/disk`

#### Verb

GET

#### Privilege

ADMIN USER

#### Notes

#### Arguments

| Parameter | Description |
| --- | --- |
| none |  |

### Example

Example of stats piped thur the jq utility

```bash
fmadio@fmadio100v2-228U:$ curl -s -k -u fmadio:**** https://192.168.2.175/api/v1/system/stats/disk | jq
{
  "TotalByte": 30725994708992,
  "TotalTB": 30.726,
  "UsedByte": 17109217181696,
  "UsedTB": 17.109,
  "FreeByte": 13616777527296,
  "FreeTB": 13.617
}
```