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

# Custom Dashboard

> Build custom analytics dashboards in Netra to monitor AI cost, latency, and quality. Create charts, apply filters, set time ranges, and share with your team.

Custom Dashboards enable you to create tailored analytics views that surface the metrics most important to your team. Whether you're tracking costs across tenants, monitoring latency for specific models, or analyzing error rates by environment, custom dashboards give you the flexibility to visualize your data exactly how you need it.

<CardGroup cols={2}>
  <Card title="Real-time Insights" icon="bolt">
    Monitor your AI application's performance with live-updating widgets and configurable refresh intervals.
  </Card>

  <Card title="Flexible Visualization" icon="chart-pie">
    Choose from 6 chart types to display your data in the most meaningful way for your use case.
  </Card>

  <Card title="Dimensional Analysis" icon="layer-group">
    Segment data by environment, user, session, or tenant to uncover patterns and anomalies.
  </Card>

  <Card title="Reusable Widgets" icon="puzzle-piece">
    Create widgets once and add them to multiple dashboards for consistent reporting across teams.
  </Card>
</CardGroup>

***

## Accessing Custom Dashboards

<Steps>
  <Step title="Navigate to Organization Analytics">
    Click the profile icon in the top-right corner and select **Organization Analytics**
  </Step>

  <Step title="Open Custom Section">
    In the left navigation panel, click on **Custom**
  </Step>

  <Step title="Choose Your View">
    Select either **Custom Dashboards** to view dashboards or **Widgets** to manage individual widgets
  </Step>
</Steps>

***

## Dashboard Management

The Custom Dashboards tab displays all your dashboards with key information:

| Column            | Description            |
| ----------------- | ---------------------- |
| **Name**          | Dashboard identifier   |
| **Description**   | Purpose and contents   |
| **Created**       | Creation timestamp     |
| **Last Modified** | Most recent update     |
| **Actions**       | Edit, clone, or delete |

<Frame>
  <img src="https://mintcdn.com/netra/hTm20ddSCP9TtT6W/images/customdash1.png?fit=max&auto=format&n=hTm20ddSCP9TtT6W&q=85&s=1473339731800b38d64684102a1243b6" alt="Dashboard list view" width="1902" height="900" data-path="images/customdash1.png" />
</Frame>

### Creating a New Dashboard

<Steps>
  <Step title="Initiate Creation">
    Click **Create Dashboard** in the top-right corner of the Custom Dashboards tab
  </Step>

  <Step title="Configure Details">
    Enter a descriptive **name** and **description** for your dashboard
  </Step>

  <Step title="Create Dashboard">
    Click **Create Dashboard** to confirm, or **Cancel** to abort
  </Step>

  <Step title="Add Widgets">
    Click **Add Widget** to open the widget selector
  </Step>

  <Step title="Select Widgets">
    Check the boxes next to the widgets you want to include
  </Step>

  <Step title="Confirm Selection">
    Click **Add Selected Widget** to add them to your dashboard
  </Step>
</Steps>

<Tip>
  Use the **Create New Widget** button in the widget selector to quickly create a new widget without leaving the dashboard editor.
</Tip>

### Dashboard Actions

| Action     | Description                                         |
| ---------- | --------------------------------------------------- |
| **Edit**   | Modify dashboard name, description, and widgets     |
| **Clone**  | Create a copy of the dashboard with all its widgets |
| **Delete** | Permanently remove the dashboard                    |

***

## Widget Management

Widgets are the building blocks of your dashboards. Create them once and reuse them across multiple dashboards.

<Frame>
  <img src="https://mintcdn.com/netra/hTm20ddSCP9TtT6W/images/widget1.png?fit=max&auto=format&n=hTm20ddSCP9TtT6W&q=85&s=d77ccc9b151b00a28207b8a9a467bfc9" alt="Widget list view" width="1892" height="882" data-path="images/widget1.png" />
</Frame>

### Creating a New Widget

Click **Create Widget** to open the configuration page with two sections:

* **Left panel** - Configuration options
* **Right panel** - Live preview

<Steps>
  <Step title="Basic Information">
    | Field           | Description                                   |
    | --------------- | --------------------------------------------- |
    | **Name**        | Unique identifier (no duplicates allowed)     |
    | **Description** | Brief explanation of what the widget displays |
  </Step>

  <Step title="Data Configuration">
    **Widget Scope** - Choose your data source:

    | Scope      | Description                 |
    | ---------- | --------------------------- |
    | **Traces** | Aggregated trace-level data |
    | **Spans**  | Individual span-level data  |

    **Metric** - Select what to measure (options vary by scope)
  </Step>

  <Step title="Select Metric & Aggregation">
    <AccordionGroup>
      <Accordion title="Available Metrics" icon="chart-line">
        | Metric                  | Aggregation Methods                 |
        | ----------------------- | ----------------------------------- |
        | **Error Rate**          | Percentage, Total Count             |
        | **Latency**             | Average, P50, P90, P95, P99, Median |
        | **Request Count**       | Total Count                         |
        | **Total Cost**          | Sum                                 |
        | **Total Tokens**        | Sum                                 |
        | **Time to First Token** | Average, P50, P90, P95, P99         |
        | **Custom**              | Select a custom metric              |
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Choose Chart Type">
    | Chart Type           | Best For                     |
    | -------------------- | ---------------------------- |
    | **Line Time Series** | Trends over time             |
    | **Bar Time Series**  | Periodic comparisons         |
    | **Horizontal Bar**   | Ranking/comparing categories |
    | **Vertical Bar**     | Category comparisons         |
    | **Pie Chart**        | Proportional distribution    |
    | **Big Number**       | Single KPI display           |
  </Step>

  <Step title="Configure Dimensions (Optional)">
    Segment your data by:

    | Dimension       | Use Case                       |
    | --------------- | ------------------------------ |
    | **Environment** | Compare prod vs staging vs dev |
    | **User ID**     | Per-user analysis              |
    | **Session ID**  | Session-level breakdown        |
    | **Tenant ID**   | Multi-tenant comparisons       |
  </Step>

  <Step title="Add Filters (Optional)">
    Narrow down your data with filters:

    <AccordionGroup>
      <Accordion title="Boolean Filters" icon="toggle-on">
        | Filter        | Options      |
        | ------------- | ------------ |
        | **Violation** | True / False |
        | **PII**       | True / False |
        | **Error**     | True / False |
      </Accordion>

      <Accordion title="Selection Filters" icon="list-check">
        | Filter     | Operators        |
        | ---------- | ---------------- |
        | **Models** | Any of / None of |
      </Accordion>

      <Accordion title="Text Filters" icon="font">
        | Filter         | Operators                                                               |
        | -------------- | ----------------------------------------------------------------------- |
        | **Session ID** | Equals / Not equals / Contains                                          |
        | **User ID**    | Equals / Not equals / Contains                                          |
        | **Metadata**   | Equals / Not equals / Contains / Not contains / Starts with / Ends with |
      </Accordion>

      <Accordion title="Numeric Filters" icon="hashtag">
        | Filter         | Operators                                                   |
        | -------------- | ----------------------------------------------------------- |
        | **Latency**    | Greater than / Less than / Greater or equal / Less or equal |
        | **Total Cost** | Greater than / Less than / Greater or equal / Less or equal |
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Preview and Save">
    Review the live preview on the right, then click **Add Widget** to save
  </Step>
</Steps>

<Note>
  The **Widget Preview** section shows a real-time visualization with a date range filter, allowing you to verify your configuration before saving.
</Note>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Name Widgets Descriptively" icon="tag">
    Use clear names like "Daily Cost by Model" instead of "Cost Widget 1" for easier discovery.
  </Card>

  <Card title="Start with Key Metrics" icon="star">
    Begin with 3-5 essential widgets, then expand based on team feedback.
  </Card>

  <Card title="Use Consistent Time Ranges" icon="clock">
    Keep related widgets on the same time range for accurate comparisons.
  </Card>

  <Card title="Group Related Dashboards" icon="folder">
    Create separate dashboards for different concerns (cost, performance, quality).
  </Card>
</CardGroup>

***

## Common Use Cases

<AccordionGroup>
  <Accordion title="Cost Monitoring Dashboard" icon="dollar-sign">
    Track spending across your AI infrastructure:

    * **Total Cost by Model** - Pie chart showing cost distribution across different models
    * **Daily Cost Trend** - Line time series tracking cost over time
    * **Cost by Tenant** - Horizontal bar comparing costs across customers
    * **High-Cost Sessions** - Filter for sessions exceeding cost thresholds

    **Recommended filters:** Total Cost > threshold, grouped by Model or Tenant ID
  </Accordion>

  <Accordion title="Performance Monitoring Dashboard" icon="gauge-high">
    Monitor latency and throughput metrics:

    * **P95 Latency Trend** - Line chart tracking latency percentiles over time
    * **Request Count by Environment** - Bar chart comparing prod vs staging traffic
    * **Time to First Token** - Track streaming response performance
    * **Latency by Model** - Compare response times across different models

    **Recommended filters:** Environment = production, grouped by Model Name
  </Accordion>

  <Accordion title="Quality & Compliance Dashboard" icon="shield-check">
    Track errors, violations, and PII detection:

    * **Error Rate Trend** - Line chart showing error percentage over time
    * **Violation Count** - Big number widget for policy violations
    * **PII Detection by Service** - Bar chart showing PII occurrences
    * **Error Rate by Environment** - Compare error rates across deployments

    **Recommended filters:** Error = true, Violation = true, grouped by Environment
  </Accordion>

  <Accordion title="Tenant Analytics Dashboard" icon="users">
    Multi-tenant usage analysis:

    * **Usage by Tenant** - Horizontal bar showing request distribution
    * **Cost per Tenant** - Track spending by customer
    * **Token Usage Trend** - Monitor token consumption over time
    * **Active Sessions by Tenant** - Compare engagement across customers

    **Recommended filters:** Grouped by Tenant ID, sorted by Total Cost
  </Accordion>
</AccordionGroup>

***

## Next Steps

* [Dashboard Query API](/sdk-reference/dashboard-query/python) - Query dashboard data programmatically
* [Usage, Traces & Spans](/usage/usage-utilities) - Query usage data
* [Sessions](/Observability/Session) - Understand session management
* [Tenants](/Observability/Tenants) - Multi-tenant analytics