Audit logs

What is the function Audit Log ?

For traceability, technical support troubleshooting and legal reasons the SmartDrive keeps a persistent log of audit-able events on the systems.

An admin or SmartD qualified personal can consult these logs to diagnose problem that can arise in the field.

What are the logged events ?

The logged events are the following:

  • Start-up and shut-down of the system

  • Start-up and shut-down of a service

  • Network connection changes or failures

  • Configuration change

    See new configuration and previous configuration

  • Set point changes

    See new setpoint and previous setpoints

  • Alarm transitions

  • Changes to, or attempts to change, system security settings and controls

    Make sure firewall service start/stop is logged

    Detecting firewall rules modification

    Enabling/Disabling remote SSH access

    Enabling/Disabling remote gRPC access

  • Create/Delete users

  • Log-on attempts (successful or unsuccessful) and logoff

    SSH

    Console

    gRPC session start/end (include authentication failure)

  • Software Update progress events

    Start/end/reboot/power interrupts

    Accept new version

    Revert to backup version

  • Errors (Persistent storage)

  • Boot for backup software

  • Backup configuration events

  • Reset metrics

    Examples: fans, start motor counter...

What is the content of a logged event ?

The event contains the following information:

  • Date/Time (UTC time)

  • Type of Event(see logged events list above)

  • Severity:

    Use standard syslog severities (limits to INFO, WARNING, ERROR, EMERGENCY)

  • Short Message describing the request and response for the request

  • Origin:

    gRPC API, Mobile, WEB, HMI, I/O module, MODBUS, BLE ...

Example of logged event

{

"time": "2022-05-09T19:08:18.000Z",

"event": "EVENT_ALARM",

"severity": "PRIORITY_INFO",

"message": "Alarm Cooling fan 2 fault has been acknowledged by user 1.",

"origin": "ORIGIN_SYSTEM"

},

{

"time": "2022-05-09T19:08:18.000Z",

"event": "EVENT_SETPOINTS_CHANGE",

"severity": "PRIORITY_INFO",

"message": "Alarm service responded to Set Setpoints request with status RESPONSE_STATUS_OK",

"origin": "ORIGIN_GRPC_API"

},

Logged events capacity

The audit log is kept in persistent storage on the SmartDrive and the drive can store up to 250,000 events (or 300MB of data).

The audit log is not affected by the restore factory settings.

The SmartDrive brownout ensures that no audit log events are lost and stored on persistent before the end of the brownout period.

Audit Log Export

Users can export the audit log in JSON format compressed and encrypted via the smartphone app.

The exported file is available and shared via the mobile app.

Go to the Clean Power VFD main menu (click on the ellipsis in the upper right corner of the Smart App screen)

select audit log

select your filter

start the download

JSON file is crreated in the app (phone)

Select share (with your usual sharing interface and function from your Ios or Android device)

Select your preferred app to share the file

and send / share

Tip

when exit the share step, the generated file is deleted from the phone