Audit Trail

Overview

The Audit Trail feature in the sensor management platform is a system-level traceability tool designed to maintain transparency and accountability across all administrative activities. It provides a clear, timestamped log of key actions taken on sensors or devices, allowing administrators and compliance teams to review changes, identify who made them, and understand the specific technical alterations involved.

---

Key Functions

1. Action Logging

Each entry in the audit log captures the following information:

• Time: The exact date and time the action was performed.

• User: The name and email address of the person who initiated the action.

• Action Type: The nature of the action taken (e.g., attachToDashboard, downlink, upsert).

• Raw Data (Optional): A technical representation of the action, useful for debugging or forensic analysis.

2. Traceability by Sensor or Device

The system logs actions on a per-device basis. This means you can trace all relevant administrative interactions for a specific device, which is particularly useful for investigations, audits, and verifying configurations.

---

Raw Data Panel

An optional Raw Data toggle reveals a JSON-formatted payload for each action. This raw view shows:

• Field-level changes (e.g., upperThreshold, delay, label values)

• Specific settings applied through a downlink

• Configuration context when attaching devices to dashboards

Example:

{
  "label": "Drawer Chiller - Local MZP",
  "alerts": [
    {
      "capability": "temperatureC_SHT",
      "upperThreshold": 8,
      "upperCompliance": 4
    }
  ]
}

This provides clarity on what values were input or modified, and supports technical tracebacks if needed.

---

Use Cases

• Change Tracking: Identify who made specific adjustments and when.

• Compliance Verification: Ensure changes are aligned with food safety or operational protocols.

• Issue Resolution: Use raw data to diagnose configuration issues or troubleshoot sensor behavior.

---

Benefits

• Supports auditability and compliance requirements

• Improves team accountability

• Enables historical traceability for all critical device interactions

---

Summary

The Audit Trail is a crucial administrative tool for maintaining operational integrity. It not only logs what changes have occurred, but also provides visibility into the context, purpose, and users behind each action. Combined with its technical depth via the raw data option, it ensures a full audit capability for high-stakes environments such as food safety monitoring systems.