How figures are computed
Where each figure in ShipVitals comes from, how fresh it is, and how to check it yourself. A figure never hides what it leaves out, and every card can explain itself.
Where figures come from
- Source
- Connections
- What it brings
- What each service's API reports: billing, revenue, usage, CI runs, with read-only access where the service has it
- Guide
- Connect a service
- Source
- Forwarded invoices
- What it brings
- A cost line per confirmed bill, for services with no API
- Source
- Entered by hand, or sent by you
- What it brings
- Obligations, and a CSV you import (Import a CSV)
- Source
- Estimates
- What it brings
- A cost worked out as plan price × usage
- Guide
- Costs and budgets
- Source
- CI uploads
- What it brings
- Test results, shown in a project's health
- Source
- Pushed metrics
- What it brings
- Aggregates your own servers send, such as active users
- Guide
- Push metrics
- Source
- ShipVitals' own checks
- What it brings
- Uptime, TLS and registration of the domains it watches, browser checks, and checks on your runners
- Guide
- Run checks
| Source | What it brings | Guide |
|---|---|---|
| Connections | What each service's API reports: billing, revenue, usage, CI runs, with read-only access where the service has it | Connect a service |
| Forwarded invoices | A cost line per confirmed bill, for services with no API | Forward invoices by email |
| Entered by hand, or sent by you | Obligations, and a CSV you import (Import a CSV) | Expiries and the calendar, All services |
| Estimates | A cost worked out as plan price × usage | Costs and budgets |
| CI uploads | Test results, shown in a project's health | Send test results and your own metrics |
| Pushed metrics | Aggregates your own servers send, such as active users | Push metrics |
| ShipVitals' own checks | Uptime, TLS and registration of the domains it watches, browser checks, and checks on your runners | Run checks |
ShipVitals adds no analytics of its own: usage comes from a connected service or from what you push.
Source tags on cost lines
On the Costs tab, each line's Source says how sure it is:
- Tag
API- It says
- "From the provider's billing API"
- Tag
EST- It says
- "Estimated: plan price × usage"
- Tag
INV- It says
- "From an invoice"
- Tag
MAN- It says
- "Entered by hand"
| Tag | It says |
|---|---|
API | "From the provider's billing API" |
EST | "Estimated: plan price × usage" |
INV | "From an invoice" |
MAN | "Entered by hand" |
A confirmed invoice replaces that service's estimate for the same month, so the cost isn't counted twice. When a fifth or more of a card's figure is estimated, the card shows EST and how much ("Includes $310 estimated (EST)"). Each line's Class, Variable, Fixed or Mixed, comes from the source until you set it: see Cost classes.
How often data syncs
- Plan
- Free
- Sync
- Daily
- Plan
- Indie
- Sync
- Hourly
- Plan
- Studio
- Sync
- Every 15 minutes
- Plan
- Agency
- Sync
- Every 15 minutes
- Plan
- Beta (private beta)
- Sync
- Hourly
| Plan | Sync |
|---|---|
| Free | Daily |
| Indie | Hourly |
| Studio | Every 15 minutes |
| Agency | Every 15 minutes |
| Beta (private beta) | Hourly |
The plan also sets how much history shows. When the period is longer, the view bar says so: "History starts Oct 8 · Free keeps 30 days". See Plans and billing and /pricing.
What a card tells you
The line at the end of the view bar says how fresh the figures are: "Updated 03:39 AM · Costs complete through Nov 3". The date shows only when a source is behind. On a card:
- You see
- "—"
- It means
- Nothing is known, or the amount is hidden from you. Never 0.
- You see
- "so far"
- It means
- The period isn't over yet.
- You see
- "Complete through Nov 3 · later days so far"
- It means
- Every source is complete through Nov 3. The total also counts what the sources ahead have reported for later days, which can still change.
- You see
- "Complete through Nov 3 · includes $64.00 from later days so far"
- It means
- On the Costs card: how much of the total those later days add. It equals the chart's days after Nov 3.
- You see
- "Costs from 8 of 12 projects"
- It means
- Some projects have no source yet; the figure counts only the others.
- You see
- "Stale since 09:14 · …"
- It means
- The source stopped reporting. The figure is the last known one, muted.
- You see
- "Backfilling older history · through 2025-03"
- It means
- Older months are still loading.
- You see
- "First full period ends Nov 24"
- It means
- A source is too new for a full period, so a change isn't meant yet.
| You see | It means |
|---|---|
| "—" | Nothing is known, or the amount is hidden from you. Never 0. |
| "so far" | The period isn't over yet. |
| "Complete through Nov 3 · later days so far" | Every source is complete through Nov 3. The total also counts what the sources ahead have reported for later days, which can still change. |
| "Complete through Nov 3 · includes $64.00 from later days so far" | On the Costs card: how much of the total those later days add. It equals the chart's days after Nov 3. |
| "Costs from 8 of 12 projects" | Some projects have no source yet; the figure counts only the others. |
| "Stale since 09:14 · …" | The source stopped reporting. The figure is the last known one, muted. |
| "Backfilling older history · through 2025-03" | Older months are still loading. |
| "First full period ends Nov 24" | A source is too new for a full period, so a change isn't meant yet. |
What Explain shows
Press a card, or tab to it and press e. The sheet lists What it is, How it was computed (the sum with its numbers), What it's made of (usually one row per project, with Unallocated and Not yet split), Coverage and freshness, Conversions and See the rows →. See Explain a figure.
Shared costs
A resource that serves several projects is Shared. Its split has a Method:
- Equal: the same share each.
- Fixed %: a share per project. When the shares add up to less than 100%, the rest goes to Unallocated.
- Usage-weighted: by what the service measures, such as messages sent per project.
A split applies from today, or to past months too if you tick Apply to past months too. On Costs, Allocation names the share, such as "40% of Upstash · fixed share". See Split a shared resource.
Currencies
A figure that includes a conversion reads "≈" in Explain's title, and Conversions lists the rates used. Amounts in a currency with no rate yet are left out until one is in: "EUR amounts not converted: no rate."
Revenue without your customers' details
ShipVitals stores revenue totals, not customers. It never stores your customers' names, emails or card details: revenue is counted against a hashed customer id. See /security.
Check a figure yourself
- Press the card for Explain, then See the rows → for the rows behind it.
- Press the freshness line for Sources: each source and how far it's complete ("Stripe · through Nov 4").
- Press Show as table under a chart, or Table actions → Export CSV on the projects table. See Read a chart.
- Read the same figure through the API,
GET /api/v1/public/portfolio?period=30d, with a read-only token. Amounts come in the currency's minor units. See Call the REST API.