Reports
Generate PDF reports that summarise temperature data, alarm conditions, and alerts for a device over a time period. Reports can be triggered manually, automatically by an alert rule, or on a schedule.
What a report contains
Each temperature report is a multi-page PDF with:
- Header — Device name/ID, report ID, and the date range covered.
- Temperature chart — A time-series graph of temperature readings with high and low alarm limits marked.
- Statistics — Min, max, mean, median, and Mean Kinetic Temperature (MKT) for the period.
- Alarm information — Whether an alarm occurred, the high/low limits, time spent above or below limits, excursion count, and percentage of time in excursion.
- Alerts during period — A table of any alerts that fired for the device during the report window, showing severity, type, status, and message.
- Footer — "Generated by Blecon Track" with a timestamp and link to blecon.net on every page.
Report configurations
Before generating reports, create a report configuration that defines the parameters. Go to Reports > Report Settings to manage configurations.
A report configuration includes:
- Report type — Currently
temperature. - High and low alarm limits — Temperature thresholds in Celsius. Readings outside these limits are flagged as excursions.
- Time range — How far back to include data (e.g., last 24 hours, last 7 days).
You can create multiple configurations for different use cases — for example, one for cold-chain monitoring with tight limits and another for ambient warehouse tracking.
Generating reports
There are three ways to generate a report:
Manual generation
On the Reports page, or from an asset's detail view, trigger a report manually. Select the device and report configuration, and the report is generated in the background.
Rule-triggered reports
Any alert rule can be linked to a report configuration. When the rule fires (e.g., a device enters a geofence, temperature exceeds a threshold, or a device goes inactive), a report is automatically generated for the device that triggered the alert.
To set this up:
- Create a report configuration in Reports > Report Settings.
- When creating or editing an alert rule, select a report configuration from the dropdown.
- When that rule triggers, a report is generated automatically.
This is useful for compliance workflows — for example, generating a temperature report every time a cold-chain device enters a delivery zone.
Scheduled reports
Use the scheduled_report rule type to generate reports on a recurring schedule. This rule type requires a report configuration and runs at the configured interval, generating a report for each matching device.
Viewing and downloading reports
The Reports page shows all generated reports for the workspace. You can filter by status:
| Status | Meaning |
|---|---|
| Generating | Report is being created in the background |
| Completed | Report is ready to download |
| Failed | Report generation encountered an error |
Click Download on a completed report to get the PDF.
Notifications
When a report is generated by a rule or schedule, notifications are sent through the same channels configured on the triggering rule — email and webhook channels. The notification includes a link to download the report.