---
title: "Insights On-Premises: Create a Custom Report"
slug: "insights-on-premises-create-a-custom-report"
updated: 2026-04-12T10:03:34Z
published: 2026-04-12T10:03:34Z
canonical: "support.controlup.com/insights-on-premises-create-a-custom-report"
---

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

# Insights On-Premises: Create a Custom Report

The Insights On-Premises (IOP) platform offers a variety of useful reports and dashboards to monitor your organization's environment. Depending on the needs of your organization, you might want to add your own reports to your IOP dashboard. In the following article, we show you how to create an IOP custom report.

## Prerequisites

- Prepared search query. For query text examples, see [here](/v1/docs/insights-on-premises-create-a-data-usage-report#create-a-data-usage-report-on-a-cluster-iop-server).

## Create a Custom Report

1. From the IOP navigation bar, under **Reports**, click **Search**. ![IOP navigation bar with Search under Reports](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-VMPRX9HV.png)
2. Paste your search query into the search box. ![search query Pasted in search box](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-1YQ5HNUX.png)

Example search query text:

```
| tstats sum(usersessions_max) as session_count
                   dc(computer_name) as computer_count
                   WHERE `computer_base`
                          folder_id=*
                          (totalsessions_avg>0 OR memoryinuse_avg>0)
                    by _time span=5min
   | timechart span=30min eval(round(max(sum_sessions),0)) as "Total Sessions"
                      eval(round(avg(dc_computers),0)) as "Total Computers"
```
3. Make sure to select **Smart Mode**. ![Smart Mode selected](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-UWOQAVNP.png)
4. Click the magnifying icon ![](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-5WRWANH8.png) to run the search query.
5. From the **Save As** dropdown, select **New Dashboard**. ![Save As dropdown showing New Dashboard](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-XL5X2DD1.png)
6. In the **Dashboard Title** field, enter a title for the dashboard.
7. Copy the ID under the **Dashboard Title** and click **Save to Dashboard**. ![ID copied to Dashboard Title and Save to Dashboard selected](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-WQYLQ072.png)
8. The following message appears after the dashboard is successfully created. Click **X** to close the message. ![message ](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-AJNB6ZAI.png)
9. Click **Custom Reports** > **Add report**.
10. Enter a useful **Report Name** and paste the dashboard ID you copied to the end of the **Search URL** field. Click **Subscribe**. ![set Custom Report window](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-HOK4VQ5Z.png)
11. The report is added to the **Custom Reports** section. Click the report. ![Custom Reports section with the new report shown](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-R6SB76L9.png)
12. You can now see all associated events that are the results of your search query: ![my CPU avg report](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-K3JPUVL1.png)

You've created your first custom dashboard that includes one report. You can define as many reports as you want and add them to a dashboard. To limit to specific users only who can view or edit the report, you can further assign permissions to this dashboard.