Version: 1.4.9This documentation is for Spitfire 1.4.9.
Reports and sharing
Run, comparison and monthly SLA reports are downloaded, sent to channels, shared and scheduled from the same Report menu. Every report opens with a short Brief.
Brief card
It sits at the top of an ended run's and comparison's page, and in the SLA card on the Monitors page:
- A coloured label: PASS, BORDERLINE or FAIL.
- A one-sentence verdict and what was measured.
- The comparison with the last one (the baseline or the previous period).
- Likely cause: when the signals point to one, labelled certain or likely.
- What to do.
The same text opens every report format and every channel message.
Download
- Click Report on a run, a comparison or the SLA card.
- Pick a format under Download:
| Format | Run | Comparison | SLA |
|---|---|---|---|
| HTML (new tab) | ✓ | ✓ | ✓ |
| ✓ | ✓ | ✓ | |
| Word document (.docx) | ✓ | ✓ | ✓ |
| CSV | summary and per second | ✓ | ✓ |
| Markdown file (.md) | ✓ | ✓ | ✓ |
| JSON | ✓ | ✓ | ✓ |
| Executive summary (PDF) | ✓ | – | – |
You can also fetch the same report with an API token (works from any folder;
RUN_ID is the id in the run page's address):
curl -s -H "Authorization: Bearer $SPITFIRE_TOKEN" -o report.md \
"https://spitfire.example.com/api/v1/runs/RUN_ID/report?format=md&lang=en"If it worked, report.md starts with the brief.
Send to a channel
Admins see it. A notification channel must exist on Integrations first.
- Report → Send to a channel…
- Channels: tick one or more.
- Formats: PDF by default.
- Language and an optional Note (up to 1000 characters).
- Send.
- The table shows each channel's outcome: files attached, links sent, message sent or failed with the reason.
| Channel | What goes |
|---|---|
| Slack (with a bot token), Telegram, e-mail, Jira | the files attached |
| Teams, other trackers, SMS, JSON webhooks | the brief and share links (7 days) |
The share link made for channels without files shows in the report's Share link… list and is revoked there.
Share a link
- Report → Share link…
- Pick Valid for and Language, click Create link.
- Copy the link right away; it is shown only once.
Details: Reports and share links.
Schedule
A period report goes to channels on its own. Admins manage them on Test → Report schedules; everyone sees the list.
- Click New schedule (or Report → Schedule…: the target comes filled in).
- Name: e.g.
Checkout weekly. - Report on: Test, Group, Tag, Monitors or Monthly SLA; then pick the tests, groups, tags or monitors.
- Period: Daily, Weekly (pick the day) or Monthly (the day of month).
- Hour and Timezone (empty: the installation's, e.g.
Europe/Istanbul). - Channels and Formats.
- Save.
- To try it now, click Send now on the row: each channel's outcome opens.
The list shows the Next send time and the Last send status (sent, partly sent, failed).
| Plan | Schedules |
|---|---|
| Free | 1 |
| Starter | 5 |
| Growth and up | unlimited |
When the plan goes down, schedules above the limit get the paused by plan badge and are not sent until the plan allows them. Scheduled reports don't make share links.