Audit Logs for Trigger Variable

Overview

Trigger Variables audit logs track all override operations performed on trigger configuration variables. These logs capture when variables are assigned (overridden) at different hierarchical levels (tenant, group, or endpoint) or unassigned (removing override).

Audit Details

Auditable Resource

TRIGGER_VARIABLE

Auditable Actions

ASSIGN: When a variable is overridden with a new value at a specific level
UNASSIGN: When an override is removed, causing the value to be inherited from a higher level in the hierarchy

Common Resource Names (Variables)

Variable Name	Description
ENABLE_TRIGGER	Enable/disable the trigger
PRE_BUFFER	Pre-event recording duration
POST_BUFFER	Post-event recording duration
COOL_DOWN_ENABLED	Enable/disable cool-down period
COOL_DOWN_TIMER	Duration of cool-down period
CHIME	Different Chimes to be played
MEDIA_TYPE	Type of media to record
UPLOAD_STRATEGY	Strategy for uploading recorded media (ON CLOUD or SD_CARD)
ENABLE_TTS	Enable/disable Text-to-Speech

Example Audit Log Entries

Assigning a Variable Override

{
    "auditableResource": "TRIGGER_VARIABLE",
    "auditableAction": "ASSIGN",
    "resourceName": "PRE_BUFFER",
    "additionalMetadata": "{
        \"tenantName\": \"TenantA\",
        \"endpointId\": 1,
        \"deviceSerialNumber\": \"DEVICE123\",
        \"triggerCategoryName\": \"Tailgating\",
        \"targetLevel\": \"ENDPOINT\",
        \"targetLevelName\": \"1\"
    }",
    "previousState": "{\"value\": \"1.5\"}",
    "newState": "{\"value\": \"2.0\"}"
}

Removing a Variable Override

{
    "auditableResource": "TRIGGER_VARIABLE",
    "auditableAction": "UNASSIGN",
    "resourceName": "COOL_DOWN_TIMER",
    "additionalMetadata": "{
        \"tenantName\": \"TenantA\",
        \"endpointId\": 1,
        \"deviceSerialNumber\": \"DEVICE123\",
        \"triggerCategoryName\": \"Tailgating\",
        \"targetLevel\": \"GROUP\",
        \"targetLevelName\": \"GroupA\"
    }",
    "previousState": "{\"value\": \"30\"}",
    "newState": null
}

Additional Metadata Details

The additionalMetadata field contains:

tenantName: Name of the tenant
endpointId: ID of the endpoint (when applicable)
deviceSerialNumber: Serial number of the device
triggerCategoryName: Category of the trigger (e.g., "Tailgating")
targetLevel: Level where override is applied ("TENANT", "GROUP", or "ENDPOINT")
targetLevelName: Name/ID of the specific target level

State Information

previousState: JSON string containing the previous value (null for newly override value)
newState: JSON string containing the new value (null for UNASSIGN)
Values are wrapped in a JSON object with a "value" key
Example: {"value": "2.0"}

Override Hierarchy

When an override is unassigned, the effective value reverts to the nearest defined value in the hierarchy:

Endpoint level
Group level
Tenant level
Parent Tenant Levels ... (if any)
Default system value