# Monitoring resource usage Resource monitoring is available to all users, though what you can view depends on your [role](/administration/roles.md) in relation to the resource pool. **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 You can find the usage monitoring dashboard in the user menu at the top right corner of your screen, under **Resources**. ## General usage 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 You can drill down to sub-levels in the plan, credit utilization and inventory content selector tabs (but not on the overview). Here's how the hierarchy works: **Level structure:** * **Resource pool level** (default): Contains all resource pools you have permission to view. * **Organization level**: Shows organizations directly linked to the resource pool, or organizations containing spaces linked to the resource pool. * Resource pool managers see all matching organizations. * Other users see only organisations with spaces where they're a space administrator or Instance Editor. * **Space level**: Displays spaces in the selected organisation that are linked to the selected resource pool. * Resource pool managers see all spaces. * Other users only see spaces where they're space administrators or Instance Editors. #### Privacy considerations and redaction Nuvolos takes privacy seriously when it comes to usage monitoring. We display only the essential identifying information needed. This means certain object names are redacted on the monitoring dashboard. Here's how it works: **Drill-down menu:** * Resource pool and organization names are never redacted * Space names: * For privacy, we only show space names if you're a space administrator or have an Instance Editor role in that space * Other spaces appear with a numerical identifier * You can still view usage data, but the space content remains hidden **Plan and credit utilization tabs:** The donut charts show how resources are distributed at each level. Depending on your role, some names may be redacted: **At the resource pool level:** * No redaction **At the organization level:** * Spaces are redacted unless you're a space administrator or Instance Editor **At the space level:** * **CU and credit utilization charts** (drill down to user level with email addresses): * Resource pool managers: No redaction * Space administrators: No redaction * Instance Editors: All emails redacted except your own * **Filesystem utilization** (drills down to instance level): * Resource pool managers: Instance names redacted unless you're also a space administrator or Instance Editor in that instance * Space administrators: No redaction * Instance Editors: All instances redacted except those where you're an editor #### Time range By default, the report shows data for the current month, but you can select different time windows (up to 1 year maximum). If you click **DETAILS** on the Overview context tab, the time window selected will be the current subscription window. {% hint style="info" %} The time range appears on the plan or credit utilization context tabs only, as the overview context tab has no time range selector. {% endhint %} ## The OVERVIEW tab The **OVERVIEW** tab summarizes the high-level information about the resource pool selected in the resource context selector. 1. Subscription information * CU capacity shows the total amount of CU hours that can be used during the subscription period. * File system capacity shows the total file system quota in your subscription. 2. Credit balance The credit balance shows your current credit balance and breaks the balance down between three factors: the initial balance of the pool, the total sum of all credit top-ups in the history of the resource pool and the total amount of used credits during the history of the resource pool. If you are a *resource pool manager*, you have the ability to **transfer credits** by clicking in the top right corner of the **Credit Balance** card on the bank note icon. #### Enabling services Resource pool managers can enable additional services on the overview page. * [Database access](/features/database-integration.md) * [Credit-based sizes](/administration/space-management/hpc-spaces.md#hpc-integration) * [Video library](/features/video-library.md) At the bottom, you can manage [Large File Storage](/features/file-system-and-storage/large-file-storage.md) drives. ## Plan utilization view This view is available only to resource pool managers. **Available metrics:** * **CU overview** - Track standard Nuvolos application runs * **Storage utilization** - Monitor filesystem and resting usage * **User activity overview** - View user activity patterns ### CU overview See your CU usage over time and by sub-level: * **Timeline chart**: Shows daily, weekly, or monthly CU hours for the selected time range * **Donut chart**: Breaks down total CU hours by sub-level (organisations for resource pool level, spaces for organisation level, users/emails for space level) #### Filesystem utilization Monitor your storage usage with these two charts: * **Timeline**: Shows filesystem utilization in GiBs, grouped daily, weekly, or monthly * **Donut chart**: Displays utilization by sub-level for the most recent date in your selected time range The timeline includes an orange line showing your **Subscription limit**—the total storage included in your subscription (also visible as a single number in the **Overview** context tab for the current level). Each day, we compare your storage footprint against this limit. If you exceed the limit, overage charges apply daily until resolved. **What the 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 This report follows the same structure as filesystem utilization. Resting storage can also have a Subscription limit if you prepaid for it. With pure pay-as-you-go, your limit is 0 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 with a timeline that displays daily, weekly, or monthly data based on your selected time range. ### Credit utilization view Everyone with resource pool access can view credit utilization, though what you see depends on your role. **Three ways to view credit utilization:** 1. **By resources**: See total credit usage grouped by resource type for your chosen time range * Deselect resource groups by clicking the resource icon (this also removes them from the sub-levels chart) 2. **By sub-levels**: View total credit usage grouped by organizational levels * Resource pool level: Organizations * Organization level: Spaces * Space level: Users * You may see "orgless," "spaceless," or "userless" transactions for usage that can't be mapped to specific levels * Deselect items by clicking the resource icon 3. **Timeline**: Track credit usage over time with daily, weekly, or monthly grouping * Bar colors correspond to resource groups ### Inventory view The inventory view is only available for users that are **resource pool managers** at the resource pool. It provides a detailed table view of all orgs/spaces associated with the resource pool, in an exportable format. {% hint style="info" %} Make sure you select the Organisation level in the resource context selector dropdown when viewing the Inventory screen. {% endhint %} #### Generate CSV reports You can export what you see in the inventory view to CSV for further analysis. Use the **Columns** button to control what information is shown on the screen about the orgs/spaces. Click the **Export to CSV** button to download the displayed information in CSV format. {% hint style="info" %} The **Export to CSV** functionality exports **all pages** with **all the columns shown** in the view. {% endhint %} #### Find spaces with custom filters You can leverage built-in filters like **Orphaned**, **Archived**, etc. to filter the list of spaces according to the most common use cases. You can export the filtered list as well to CSV. #### Identify overusing spaces and notify admins You can sort spaces in the inventory based on their storage footprint in descending order. If you click on any of the rows, it will expand and show the name and email of space administrators. Multiple rows can be expanded at the same time, allowing you to compare details across spaces side by side. You can thus contact the administrators of spaces with large storage footprints to discuss storage optimization. #### Free up space by removing orphan spaces Resource pool managers cannot directly delete objects in an org/space to free up resources; this must be managed by space admins. The only exceptions are spaces with no administrators, also called 'orphan' spaces. Such spaces are generated when personnel leave an organization and do not invite anyone to inherit their spaces. Orphan spaces can be deleted by resource pool managers to free up the storage they consume. #### Modify instance quota Space administrators can [increase their space quota](/features/file-system-and-storage.md#modifying-quotas) in self-service, with some constraints to avoid runaway costs. Resource pool managers have greater flexibility in changing the quota through other administrative tools, as they have a complete overview of the resource pool. --- # Agent Instructions: 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: ``` GET https://docs.nuvolos.com/administration/monitoring-resource-usage.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.