Skip to content

Audit Event Destinations

Butler SOS can write accepted Audit.qs events to one or more destinations.

Some destinations store event metadata. Others store richer artifacts such as raw object data or rendered screenshots.

Destination Overview

DestinationWhat It StoresHow It Is EnabledBest For
InfluxDBAudit event metadata as time-series pointsauditEvents.destination.type includes influxdbDashboards, alerting, and operational analysis
JSONDedicated JSON files for payload.event.objectDataauditEvents.destination.type includes json and json.objectdata.enable=trueSearchable raw object data and event correlation
ParquetAudit event metadata as columnar Parquet filesauditEvents.destination.type includes parquetBatch analytics with DuckDB, Spark, or Pandas
PNGScreenshot image files downloaded from Qlik Sense URLsauditEvents.destination.screenshots.enable=trueVisual audit trails and screenshot retention
QVDAudit event metadata as QVD filesauditEvents.destination.type includes qvdLoading audit data into Qlik Sense apps

Destination Model

Audit destinations use two patterns:

  • Metadata destinations write one logical row or point per event. This includes InfluxDB, Parquet, and QVD.
  • Artifact destinations write dedicated files derived from the event payload. This includes JSON object-data files and PNG screenshots.

Buffering Model

Not all destinations write data the same way:

  • Buffered destinations: InfluxDB, Parquet, and QVD use maxBatchSize and writeFrequency settings in their metadata config.
  • Immediate-write destinations: JSON object-data files and PNG screenshots are written per event and do not use buffered destination settings.

Object Data Behavior Across Destinations

payload.event.objectData is handled differently depending on destination:

  • The JSON destination can write a dedicated JSON file for the raw object-data payload.
  • InfluxDB, Parquet, and QVD store objectData in their metadata output when it is present, but do not create a separate dedicated object-data dataset.

Screenshot Behavior

Screenshot downloads are configured separately from auditEvents.destination.type.

The PNG destination uses auditEvents.destination.screenshots settings such as authentication mode, allowed download hosts, and storage targets.

Released under the MIT License.