> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/administration/monitoring-resource-usage.md).

# Resource monitoring

Resource monitoring tracks how your organisation, Spaces, and users consume the resources allocated to a resource pool: Nuvolos Compute Units (NCUs), file system storage, resting storage, and Credits. The monitoring dashboard is available to all users, but what you can see depends on your [role](/concepts/roles-secrets-and-identity/roles.md).

{% hint style="info" %}
For the financial picture - pricing, budgets, transferring Credits - see [Billing › Resource pools and budgets](/billing/resource-pools-and-budgets.md).
{% endhint %}

**Who can access resource monitoring:**

* **All users** can view a basic overview and credit usage if they:
  * Manage the resource pool, or
  * Have an Instance Editor or space administrator role in a space within the resource pool
* **Resource pool managers** can review activity across all their managed resource pools and drill down to the space level
* **Space administrators** can review activity within the spaces they manage

## The monitoring dashboard

The dashboard is reached from **Account & Settings → Resources** in the top right corner of the screen.

### Dashboard layout

The monitoring dashboard has three components:

1. The **resource context selector** is on the top of your screen. Clicking on the drop-down shows you all resource pools you have access to.
2. The **content selector tabs** let you choose between reviewing different aspects of the resource pool utilisation selected in the resource selector.
3. The **data view** shows you the data as defined by the resource context and content choice.

### Drilling down using the resource pool context selector

On the Plan utilization, Credit utilization, and Inventory tabs (but not Overview), you can drill down through three levels:

* **Resource pool level** (default): Contains all resource pools you have permission to view.
* **Organization level**: Organisations directly linked to the resource pool, or containing Spaces linked to it. Resource pool managers see all matching organisations; other users see only organisations with Spaces where they have space administrator or Instance Editor roles.
* **Space level**: Spaces in the selected organisation linked to the selected resource pool. Resource pool managers see all Spaces; other users see only Spaces where they are space administrators or Instance Editors

### Time range

By default, reports show the current month. Different time windows can be selected, up to a maximum of one year. Clicking **DETAILS** on the Overview context tab sets the time window to the current subscription period. The time range selector appears on Plan utilization and Credit utilization tabs; the Overview tab has no time range selector.

## Privacy considerations and redaction

Nuvolos takes privacy seriously when it comes to usage monitoring. Only the essential identifying information is displayed; certain object names are redacted depending on the viewer's role.

**Drill-down menu:**

* Resource pool and organization names are never redacted
* Space names are shown only to users who are space administrators or Instance Editors in that Space. Other Spaces appear with a numerical identifier - usage data is still visible, but the content remains hidden.

**Plan and credit utilization tabs:**

The donut charts on these tabs show resource distribution at each level, with the following redaction rules:

* **At the resource pool level** - no redaction.
* **At the organisation level** - Spaces are redacted unless you are a space administrator or Instance Editor in them.
* **At the Space level** **(NCU and Credit charts, drilling to user email)** - resource pool managers and space administrators see no redaction; Instance Editors see all emails redacted except their own.
* **At the Space level (filesystem utilization, drilling to Instance)** - resource pool managers see Instance names redacted unless they are also a space administrator or Instance Editor in that Instance; space administrators see no redaction; Instance Editors see all Instances redacted except those where they are an editor.

## The Overview tab

The Overview tab summarises high-level information for the selected resource pool.

**Subscription tiles**

* **NCU capacity** - total NCU hours that can be used during the subscription period.
* **File system capacity** - total file system quota in the subscription.

**Credit balance**

The Credit balance tile shows the current balance, broken down into three components: the initial balance of the pool, the total of all top-ups during its history, and the total Credits used.

Resource pool managers can transfer Credits to other pools they manage by clicking the bank note icon in the top right corner of the Credit Balance card. For details, see [Billing › Resource pools and budgets](/billing/resource-pools-and-budgets.md).

**Enable additional services**

Resource pool managers can enable additional services on the Overview page.

* [Database access](/concepts/data-integration.md)
* [Credit-based sizes](/administration/space-management/hpc-spaces.md#hpc-integration)
* [Video library](/reference/file-system-and-storage/video-library.md)

At the bottom, you can manage [Large File Storage](/reference/file-system-and-storage/large-file-storage.md) drives.

## The Plan utilization tab

Plan utilization is available only to resource pool managers and shows three views:

* **NCU overview** - Track standard Nuvolos application runs
* **Storage utilization** - Monitor filesystem and resting usage
* **User activity overview** - View user activity patterns

### NCU overview

Track NCU usage over time and by sub-level:

* **Timeline chart**: Daily, weekly, or monthly NCU hours for the selected time range.
* **Donut chart**: Total NCU hours broken down by sub-level (organisations at the pool level, Spaces at the organisation level, users at the Space level).

### Filesystem utilization

Monitor storage usage with these two charts:

* **Timeline**: Shows filesystem utilization in GiB, grouped daily, weekly, or monthly.
* **Donut chart**: Utilisation by sub-level for the most recent date in the time range.

The timeline includes an orange line marking the subscription limit (the total storage included in your subscription, also visible as a single number in the Overview tab). Daily, the system compares your storage footprint against this limit. If you exceed it, overage charges apply daily until resolved.

**Sub-levels represent:**

* Resource pool level: Organizations
* Organization level: Spaces
* Space level: Instances

{% hint style="info" %}
Filesystem utilization reports are only available from July 25, 2022.
{% endhint %}

### Resting storage utilization

Resting storage utilisation follows the same structure as filesystem utilisation. A subscription limit applies if you prepaid for resting capacity. With pure pay-as-you-go, the limit is zero and daily Credit deductions apply based on usage.

{% hint style="info" %}
Resting utilization reports are only available starting January 10, 2025.
{% endhint %}

### User activity overview

Track Application runs over time. The timeline displays daily, weekly, or monthly data based on the selected time range.

## The Credit utilization tab

Everyone with resource pool access can view Credit utilisation, though what you see depends on your role. Three views are available:

1. **By resources**: Total Credit usage grouped by resource type for the selected time range.
   * Click a resource icon to deselect that group; doing so also removes it from the sub-levels chart.
2. **By sub-levels**: Total Credit usage grouped by organisational level.
   * Resource pool level: Organizations
   * Organization level: Spaces
   * Space level: Users
   * Transactions that cannot be mapped to a specific level appear as *orgless*, *spaceless*, or *userless*.
   * Deselect items by clicking the resource icon.
3. **Timeline**: Credit usage over time, grouped daily, weekly, or monthly.
   * Bar colors correspond to resource groups.

## The Inventory tab

The Inventory tab is available only to resource pool managers and provides a detailed, exportable table view of all organisations and Spaces associated with the resource pool.

{% hint style="info" %}
Select the Organisation level in the resource context dropdown to view it.
{% endhint %}

#### Generate CSV reports

Use the Columns button to control which information is shown about each Space, then click Export to CSV to download the displayed information. The export includes all pages and all columns currently shown in the view.

#### Find spaces with custom filters

Built-in filters - Orphaned, Archived, and others - narrow the list of Spaces to common use cases. Filtered lists can be exported to CSV.

#### Identify Spaces over their storage allocation

Sort spaces in the inventory by storage footprint in descending order. Click any row to expand it and see the names and email addresses of the Space's administrators. Multiple rows can be expanded simultaneously, allowing side-by-side comparison. You can then contact the relevant administrators to discuss storage optimisation.

#### Reclaim storage from orphan Spaces

Resource pool managers cannot directly delete objects within an organisation or space - that must be handled by space administrators. The exception is orphan spaces - spaces with no remaining administrator, typically generated when personnel leave an organisation without inviting a successor. Orphan spaces can be deleted by resource pool managers to free the storage they consume.

#### Modify instance quota

Space administrators can [increase their space quota](/reference/file-system-and-storage.md#modifying-quotas) in self-service, with some constraints to avoid runaway costs. Resource pool managers have additional flexibility through administrative tools, given their full view of the resource pool.

**Where to go next**

* For pricing details, per-Credit rates, and overage behaviour, see [Billing › Subscription and Credits](/billing/pricing-structure.md).
* To configure resource pools, budget patterns, and Credit transfers, see [Billing › Resource pools and budgets](/billing/resource-pools-and-budgets.md).
* For a practical cost-control playbook (right-sizing Applications, resting unused Spaces, managing storage), see [Billing › Pricing and cost control](/billing/pricing-and-cost-control.md).
* To rest unused Spaces or wake them when needed, see [Administration › Space management](/administration/space-management.md).
* For the conceptual model of NCUs, Credits, and resource pools, see [Concepts › The hierarchy and resource model](/concepts/nuvolos-basic-concepts.md).