Attach an Alarm Report to a Notification

Attach a PDF alarm report to an email notification so that recipients receive it automatically when an alarm is raised. Uses the Reports in Notifications feature.

Create a report template designed for alarm events. The Originator entity alias automatically resolves to the entity that triggered the alarm.

1. Navigate to Monitor ⇾ Reports ⇾ Templates.
2. Click + Add report template ⇾ Create new report template.
3. Configure:
   • Name: New alarm
   • Format: PDF
   • Type: Report
4. Click Add.
5. In the opened Report Builder, add an Alarm table component:
   • In the Alarm source section, click Create new and configure an entity alias:
     • Filter type: Originator entity
     • Default originator entity: Device
   • Alarm filter: Active
6. Add any additional components (charts, device info, etc.).
7. Save the template.

1. Navigate to Monitor ⇾ Notifications ⇾ Templates.
2. Open the default New alarm notification template, or create a new one.
3. Add the Email delivery method (Mail server must be configured).
4. Enable Attach report.
5. Report template: select the New alarm template created in Step 1.
6. User: specify the account whose data access permissions are used to generate the report (e.g. johndoe@thingsboard.io — Tenant Administrator).
7. Click Next.
8. Enter the subject and message for the email.
9. Save the template.

1. Configure an alarm rule on a device (e.g. trigger when temperature > 25).
2. Publish telemetry that exceeds the threshold to create an alarm.
3. Verify that a notification appears in the Web UI.
4. Check the recipient’s email inbox — the message should include the PDF attachment.

Component	Configuration
Notification template	New alarm notification — Email delivery, Attach report enabled
Report template	New alarm — Alarm table using Originator entity alias, active alarm filter
User account	Tenant Administrator (full data access)
Delivery	Email with PDF attached, Web UI notification (no attachment)

Use this pattern for any event-driven report: replace the alarm rule with any notification trigger supported by the Notification system.