> For the complete documentation index, see [llms.txt](https://docs.oobeya.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oobeya.io/alerts-and-notifications/how-to-retrieve-resource-utilization-data.md).

# How to Retrieve Resource Utilization Data

### **Real-Time Resource Utilization Monitoring**

You can use the following commands to check the resource usage of your system or containers in real time. These commands will provide information about CPU, memory, disk, and container resource usage.

#### **1. Memory Usage**

Use the `free -m` command to view the system’s memory usage in megabytes (MB).

```bash
free -m
```

* **Total**: The total amount of memory.
* **Used**: The memory currently in use.
* **Free**: Memory that is available.

#### **2. Disk Usage**

Use the `df -h` command to check disk space usage.

```bash
df -h
```

* This will display disk usage in a human-readable format (GB or MB), showing the used and available space for each mounted filesystem.

#### **3. Docker Containers Resource Usage**

To monitor the resource usage of running Docker containers, use the `docker stats` command.

```bash
docker stats
```

* This will show real-time CPU, memory, network, and disk metrics for each container.

#### **4. CPU and Memory Usage of Processes**

To monitor the CPU and memory usage of processes running on your system, use the `top` command.

```bash
top
```

* This provides real-time information about which processes are consuming the most resources on your system.

***

### **Resource Utilization Over A Specific Period**

If you're looking to track resource usage over a specific period (e.g., a week or month), we recommend setting up a monitoring system. If you’re already using a monitoring tool (such as Azure Monitor, Elastic APM, or Prometheus), we’d be happy to assist you in configuring it to gather the necessary data.

***

### **Need Further Assistance?**

If you need more help setting up or configuring your monitoring system, feel free to reach out to our support team. We're here to assist you with any questions or technical details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.oobeya.io/alerts-and-notifications/how-to-retrieve-resource-utilization-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.