Documentation | Single version Service version

Camera events

Introduction Video sources Recording Camera events Statistics API FAQ

Below you can see list of fields that each video analytics event contains:

event_id
type - (Line crossed, etc.)
time - local time
timestamp - time since the beginning of the video playback (in seconds)
channel_id
channel_name
object_id - id of the object that initiated the event
origin - (Unknown, Pedestrian, Vehicle)
source_id - line or zone id the event is associated with
source_name - line or zone name the event is associated with
snapshot_path - path to the event snapshot file, if any
recording_path - path to the event video recording path, if any
video_file_name - name of the video file in case of Video File or Video Folder channel type
video_file_time - time of the event relative to the beginning of video file in case of Video File or Video Folder channel type

Profiles

Advanced settings allow you to configure analytics profile (or detection profile).
Profiles allow you to tune very specific settings of video analytics, such as motion detector sensitivity, etc. which will suit the current camera scene. There are multiple sets profiles by default: for overhead (which are best with ceiling mounted cameras) and for tilted cameras.
Use low or very low sensitivity profiles if you have a lot of obstructions in your scene (like shadows or tree branches).
Use high sensitivity profiles if objects are skipped and not detected.
Use queue counting profile if you want to track people in line from overhead camera.

It's recommended to use the Overhead profiles together with overhead camera - this will improve the counting accuracy (in case you use Camlytics Single for counting).

If you have a premium license you can inquire for the customized profile tuned specifically for your scene. Profiles are distributed as files with *.preset extension. Extended set of profiles is available for premium users.

Export

Camera events are especially useful when you can export them. In order to do that you can either request the .csv spreadsheet in statistics manager or, if you want it in real time, make use of our API.

Daily reports

If you wish to receive by email the aggregated data on each event type and on each event source ("Line 1" was crossed 1982 times, "Line 2" was crossed 983 times, etc.) with a breakdown by hours, you can opt into daily reports. In order to start receiving those, you need to enable Aggregated reports in the channel Events settings and configure the Emails and Reports sections in Global settings. In addition to that you will receive the Zone histograms report if you have any zones configured.