# The insights dashboard

Product analytics in the dashboard lives under the Explore row of a project. This page says where each
view is, what it reads, and what it will and will not do.

## Where things are

| View | Address | What it is |
| --- | --- | --- |
| Insights | `/org/<org>/<project>/insights` | Build, run, save and share a trend, funnel, retention, paths, stickiness or lifecycle question |
| Cohorts | `/org/<org>/<project>/cohorts` | Saved groups of people or accounts, defined by rules |
| Taxonomy | `/org/<org>/<project>/taxonomy` | Event and property definitions, ingestion filters, actions, canonical metrics, identity |
| Shared insight | `/<locale>/share/insight/<token>` | The read-only page a published link opens |

Internal traffic and identity rules are also reachable from Settings, Projects, Product analytics.

## The address is the view

An insight's question is in the address: `?node=` holds the node as base64url of its key-sorted JSON, the
same form every deep link from an agent or an alert uses, and `?insight=` opens a saved insight by its
short id. A question too long for an address is kept in memory and the page says the link will not
reproduce it; saving it is how to share it.

## What a result says about itself

Next to every chart the panel shows what the answer says about itself: where it was served from, how
complete the data is (the watermark and how closely it reconciled), how many events never reached the
counts (dropped, sampled, held by filters), the minimum group size and how many cells it withheld, and
every reason a number is approximate. A fact the system does not measure is listed as unknown, never
drawn as zero. A cell under the minimum group size is shown as withheld, never as zero and never as a
gap. Every chart has the same numbers in a table.

## Acts that need a person

Publishing a public link, certifying a canonical metric, merging two people and splitting one are acts
for a person on their own session, with a security key or a code. The control is disabled, with the
reason, for a role that lacks it. Saving to share, adding a note, changing a filter or an action and
restoring an identity change are governed writes: they apply at once or answer "waiting for a person"
with a link to the decision.

## Text from outside

Event names, property values, samples, filter names, selectors, annotation text and metric descriptions
were written by an instrumented application, a person or a model. They are drawn as text, samples and
notes are labelled untrusted, and none of them is ever read as an instruction.
