> For the complete documentation index, see [llms.txt](https://docs.flopsar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flopsar.com/7/user-guide/observing-and-diagnosing/dashboards.md).

# Dashboards

Dashboards are a live, filtered view of the traffic you care about. Open them from **Home → Dashboards**. Each dashboard is a named collection of **charts**; each chart is a named set of **matching rules**. Charts refresh on a rolling time window and can jump straight into [Data Analysis](/7/user-guide/observing-and-diagnosing/data-analysis.md) for the same slice of data.

You need the **Edit filters** permission. There is no separate Filters or Services page: `/filters` redirects here, and management (dashboards, charts, and rules) is in this view.

{% hint style="info" %}
**Screenshot placeholder:** Workstation → Home → Dashboards. Dashboard selector, gear for management, two-column grid of live chart cards.
{% endhint %}

## How the pieces fit

```
Dashboard  →  Charts  →  Rules
```

* **Dashboard** — a named layout you watch as a unit (for example a product area or environment). Select it from the **Dashboard** dropdown.
* **Chart** — one panel on that layout. Its name is also the saved filter you can pick in Data Browser and Data Analysis.
* **Rule** — a set of matching conditions. A chart matches an invocation if **any** of its rules match (OR). A rule matches only if **all** of its conditions match (AND).

```
Chart = Rule1 OR Rule2 OR … OR RuleN
Rule  = Condition1 AND Condition2 AND … AND ConditionN
```

Charts that are not on any dashboard still exist. They appear under **Not on a dashboard** in the manager and remain available as saved filters in Analytics.

## Watching a dashboard

Select a dashboard. Its charts appear in a two-column grid. Drag a chart by the handle at the top of the card to reorder the layout (order is remembered in the browser).

Each card shows:

* **Execution time** — percentile bands (5–95%, 10–90%, 25–75%) and the **median**
* **Count** — invocations in the current window
* **Errors** — invocations that threw in that window
* Two plots — execution-time distribution and request count over time

Charts refresh about every **30 seconds**. The rolling window is **15–60 minutes** in 5-minute steps; set it in the manager (gear) next to **Time window**.

From a card you can:

* **Analyze** — open [Data Analysis](/7/user-guide/observing-and-diagnosing/data-analysis.md) for that chart over the current window
* **Remove** — take the chart off this dashboard only; the chart definition stays

If no dashboard is selected, or the selected dashboard has no charts, the page asks you to pick a dashboard or open settings.

{% hint style="info" %}
**Screenshot placeholder:** A dashboard chart card with percentile legend, median, count, errors, and the two plots.
{% endhint %}

## Managing dashboards, charts, and rules

Open the gear next to the dashboard selector. The dialog is three columns: **Dashboards → Charts → Rules**.

{% hint style="info" %}
**Screenshot placeholder:** Manage dialog with Dashboards, Charts, and Rules columns; time-window selector in the header.
{% endhint %}

### Dashboards

Create a dashboard with **+**, rename it, or delete it. Search filters the list by name.

**Not on a dashboard** lists charts that are not assigned to any dashboard. You cannot rename that row; it is only a bucket for unassigned charts.

### Charts

Select a dashboard (or **Not on a dashboard**) to see its charts. From there you can:

* **New chart** — create a chart and add its first rule
* **Add existing chart** — attach a chart that already exists (only charts that are eligible; see below)
* **Rename** a chart (renames it everywhere, including saved filters in Analytics)
* **Remove from dashboard** — unassign without deleting the definition
* **Delete chart** — remove the chart and all of its rules

A chart is **eligible** for a dashboard (and for Data Analysis as a saved filter) when every rule specifies an **application**, and all rules on that chart use the **same** application. Otherwise the list shows **Needs one application**.

Export and import charts as JSON from the header of the manager (download / upload). Import adds chart definitions; you still assign them to dashboards as needed.

### Rules

Select a chart to list its rules. Each rule can constrain:

* **Application** — required for dashboards and for Data Analysis saved filters
* **Instance** — agent instance, as a pattern (contains, starts with, exact, or regex)
* **Thread**
* **Class** and **Method**
* **Exception** — one or more types (OR), or **Any exception**
* **Parameters** — one or more key/value pairs; values use the same pattern kinds. Several pairs on one rule are combined with AND.

Add, edit, or delete rules from that column. A chart with no rules matches nothing.

{% hint style="warning" %}
Removing a chart from a dashboard does not delete it. Deleting a chart does. Charts used as saved filters in Analytics keep working until you delete them.
{% endhint %}

## Reuse in Analytics

Named charts appear in the Data Browser and Data Analysis search forms as **Filters**. Choosing one applies that chart’s rules and hides the manual condition fields. For Data Analysis, only eligible charts (single application on every rule) are offered. See [Data Browser](/7/user-guide/observing-and-diagnosing/data-browser.md) and [Data Analysis](/7/user-guide/observing-and-diagnosing/data-analysis.md).

Dashboards do **not** change what the agent records. What is captured is still decided by the monitoring profile and [instrumentation](/7/user-guide/setting-up-monitoring/instrumentation.md). Dashboards only select and display already recorded invocations.

## Related

* [Live View](/7/user-guide/observing-and-diagnosing/live-view.md) — unfiltered real-time traffic per application
* [Setting Up Monitoring](/7/user-guide/setting-up-monitoring.md) — profiles, instrumentation, and data masking