DataMosaicDocs · Concepts
The Overview
The workspace at a glance — a board of tiles showing checks, workflows and monitors, arranged once for everyone in it.
Overview, at the top of the sidebar, is where the workspace is read at a glance: which Checks agree, which do not, which have stopped running, and how the workflows and monitors are doing.
It is a board of tiles. Each tile shows one thing (the whole workspace, one check, one workflow or one monitor) in one way. There is one board per workspace and everyone in it sees the same one. Viewers read it; editors arrange it.
#The board as it starts
Until somebody changes it, the board shows three tiles, in this order:
The four numbers, in one strip:
| Number | What it counts |
|---|---|
| Checks agreeing | How many checks agree on their last run, out of all of them, with a band showing how the rest split: differ, failed or stale, no runs |
| Rows matched | The share of rows that match, across the latest run of every check |
| Rows out of agreement | Rows that differ or are missing, split into the two, with how many are new and how many cleared since the run before |
| Runs passed | The share of runs in the period that passed |
Runs per day: every check's runs, passed and failed, a bar a day, with the average run time and the last failure.
Checks: every check, worst first, with its status, rows matched, rows out of agreement, a trend over its last runs, and when it last ran. Selecting one opens the published check on its last run if it is published, without running anything again, or opens it inside Mosaic if not.
#What each status means
| Status | Means |
|---|---|
| Stale | A schedule was due and did not fire. The figures beside it are from the run before, and it says when the missed run was due |
| Failed | The last run failed, or breached a Rule |
| Differs | The last run found differences, or exceptions are still open |
| Agrees | The last run found nothing out of agreement |
| No runs | It has never run, or not in the period |
Stale outranks everything. A check that has quietly stopped running is a worse problem than one that disagrees, because nobody knows what is in it. A missed schedule is a fact about today, so it counts whatever period is chosen.
#The period and the checks
Two filters sit above the board.
Period: today, the last 7, 14, 30 or 90 days, or a custom range of up to 366 days. It scopes the workspace and check tiles. The workspace's time zone decides which day a run counts towards.
Checks: all of them, or the ones you tick. It narrows the workspace tiles only. A tile about one check is about that check whatever is ticked.
Workflow and monitor tiles show things as they are now, apart from a workflow's Stat, which follows the period. Monitor tiles read their monitor again every 30 seconds.
#Tiles
| About | Can be shown as |
|---|---|
| Workspace: every check, together | The four numbers · Stat · Runs per day · Checks table |
| A check | Status: agrees or differs, rows out of agreement, open exceptions · Stat · Runs per day |
| A workflow | Status: active or not, its last run, how its recent runs went · Stat · Last runs |
| A monitor | Counts: 412 Online, 3 Offline · Stat · What needs attention: only the red and amber rows, worst first · Table |
#Stat
A Stat is one figure, large, with a line under it.
| About | Figures |
|---|---|
| Workspace | Checks agreeing · Checks needing attention · Rows matched · Rows out of agreement · Runs passed · Runs · Runs failed · Average run time · Open exceptions · Critical exceptions |
| A check | Rows out of agreement · Rows matched · Rows compared · Open exceptions · Runs passed · Runs · Runs failed · Average run time · Since its last run |
| A workflow | Runs succeeded · Runs · Runs failed · Average run time · Since its last run |
| A monitor | In a red state · In an amber state · In a green state · Share in green · Rows |
A figure that counts runs is set against the period just before, of the same length: vs yesterday, vs the 7 days before. A change for the better is green and a change for the worse is amber; more runs is neither. Run time is compared as a percentage. A workflow's figures are worked out from its newest 500 runs, and say so when the period reaches further back than that.
#Arranging the board
Edit turns the board into its editing mode, and says Everyone in this workspace sees this Overview. Each tile gets a bar of its own:
- Move: drag it by its grip, or press ← and →.
- Width: a quarter, half, three quarters or the whole row. Tiles in a row stretch to the same height.
- Change: what it is about, how it is shown, its figure, its heading.
- Remove.
Add tile opens the picker: choose what it is about on the left, then Show it as, the Figure for a Stat, the Width, and a Heading if the name will not do. Save keeps the board (Ctrl+S works too) and Cancel leaves it as it was.
Reset to default puts back the three tiles the board starts with, for everyone in the workspace.
A tile whose check, workflow or monitor has been deleted says so: This check is no longer here. It may be in the bin. Restore it from the bin and the tile comes back.