In Confluence: how long a page has been in its status

In Confluence, Statuswatch asks the question it asks in Jira, of a page: how long has it been in its status? In review for three working days is a different thing from In review since Friday afternoon, and Confluence shows neither. Statuswatch for Confluence comes with the same app; install it on Confluence as well as on Jira.

On the page#

Beside the author, the byline shows the page's status and how long it has had it, for example "In review · 3d 2h". Click it for every status the page has had, the time in each and the number of stays, and the line that says from when this is known.

What Statuswatch can and cannot know#

Confluence keeps a page's current status and the moment it was set, and no history: every older version of a page answers with today's status. So:

• The current stay is known from the day you install, however long it has already lasted.
• Earlier stays are known from the day Statuswatch began watching. It records each change from then on: the status's name and the moment, nothing else. The popup says "Known since …" so that the log is never mistaken for the page's whole life.
• A status set on a draft counts from the moment the page is published, because that is when Confluence says it was set.
• Live Docs tell apps nothing when their status changes. For those only the current stay is shown.

The space page#

Under Space apps → Statuswatch: every page in the space that has a status, the one that has waited longest first, with a filter by status. Once the space has five finished stays in a status, a page that has been in it unusually long says so, judged against the space's own history. The list is built as you, from what you may see: a restricted page appears to nobody who cannot open it. It shows up to 200 pages.

The dashboard, under Apps#

Under Apps → Statuswatch in Confluence is the same kind of page the project has in Jira, for one space at a time. Choose a space; it lists the spaces in which Statuswatch has seen a page with a status, and only those you may see. Four figures head the page: "Pages with a status", "Status changes" in the period, "Longest in its status" and "Unusually long now"; hover over a figure for what it counts. Below them, "Typical stay per status" draws every stay that ended in the period as a dot, with a tick at their median, "In a status now", which is a list to choose from and can be narrowed to "Unusually long now", also by clicking that figure at the top, draws every page's current stay as a larger dot among the finished stays of its status, with the same tick; a dot names its page and opens it in a new tab when that page is one you may see, and is a dot and a duration otherwise, and "Week by week" shows how a status has moved. The period is the last 7, 30 or 90 days, or your own dates.

The typical stay is counted over every page in the space, including pages you may not see, because a moment names nobody. Titles are only ever shown for pages you can open. When a status has fewer than five finished stays the page says "Too little history to say whether these are unusual" and names the status, instead of calling nothing unusual.

Working hours#

A space counts in calendar time until a space admin chooses otherwise under Space settings → Integrations → Statuswatch: "Count in" offers the working hours of every Jira project that has them switched on in its Statuswatch settings. The hours are borrowed, not copied. They are kept once, in Jira, so a holiday added there applies here the same day, and there is no second calendar to fall out of step. A space whose team has no Jira project can point at any project whose hours fit.

Permissions and data#

In Confluence the app only reads: a page's status, the pages of a space by status, the titles of pages it has recorded (through a search, as you), the names of the spaces it has recorded pages in, and whether you may administer the space before it saves the setting. It writes nothing to Confluence. What it stores is, per page, status names and moments, and per space, which Jira project's hours it borrows. No titles, no authors, no content.