Skip to main content

Reports

ION Guard lets you generate detailed reports on security operations, device availability, and site activity.

Access

Navigation path: Side menu → AdministrationReports

The Reports page is available to Platform Admin, Tenant Master, Tenant Admin, and Operator (with the View reports permission). Generating a report, however, requires the Generate reports permission, restricted to Platform Admin, Tenant Master, and Tenant Admin. In addition, each report type has its own minimum profile — which is why an Operator can open the page but does not always find reports available for their profile.

Report types

Reports page with the type selector open

ReportDescription
Alert Response (SLA)Response, acknowledgment, and resolution times for alerts in the period
Beacon AvailabilityUptime and downtime per beacon — identifies problematic devices
Antenna HealthStatus and availability of antennas by zone
Zone OccupancyPresence metrics per zone — how many people/assets in each period
Security IncidentsConsolidated summary of alerts, escalations, and resolutions
Audit TrailLog of all changes made in the system
Device ActivityDetailed log of beacon signals and movements
Restricted Zone EntryRecord of all detected entries into restricted zones
Cold Room ComplianceExposure time and shift compliance — requires the Cold Room module
Which reports appear for you

The list above is the catalog of report types planned in the platform. The reports actually available on your screen depend on three factors:

  • Your profile — each report has a minimum profile (for example, "Audit Trail" requires Tenant Master).
  • Modules enabled on the site — reports such as "Beacon Availability" and "Antenna Health" require the Synapsys module; "Cold Room Compliance" requires the Cold Room module.
  • Handlers implemented in the installed version — the platform shows only the types with processing available in your version.

Generate a report

  1. On the Reports page, select the report type
  2. Set the period:
    • Start date — Default: 30 days ago
    • End date — Default: today
  3. Select the export format. Each report type declares the formats it accepts — the screen shows only those. The platform core reports export in CSV; formats such as XLSX and PDF are offered by reports delivered by the modules that support them:
    • CSV — Ideal for importing into spreadsheets and data analysis
    • XLSX — Formatted Excel spreadsheet
    • PDF — Document for printing and sharing
  4. Click "Generate"
Report-specific filters

Beyond the period, some reports offer additional filters (for example, by zone or by device type). These fields appear dynamically according to the chosen type.

Processing

Reports are generated asynchronously — generation is sent to a processing queue and does not block the interface.

StatusMeaning
PendingIn queue, waiting to be processed
ProcessingBeing generated
CompletedReady for download
FailedError during generation — the error message is displayed

The page automatically polls every 5 seconds while there are pending or processing reports.

Download

When the status is Completed, the actions column shows the download button (the file is served directly by the server) and a View button, which opens the report for review.

Download access

Only the user who requested the report (or a Platform Admin) can download it.

History

The page displays the history of the reports you generated for the current site (paginated, 15 per page), including:

  • Report type
  • Period (start date — end date)
  • Format (CSV, XLSX, PDF)
  • Current status
  • Total rows (when completed)
  • Request date

Automatic cleanup

Old reports are automatically removed by the CleanupOldReportsJob job to free up disk space. Retention follows the policy configured by the administrator.