====== 3DM Publisher Logging ======

3DM Publisher offers 3 logging levels, configurable from the Console System page : 
  * No logging
  * File logging
  * Database logging

Usage pages in the Console are only available when at least File logging is active.

Some logging events can only be stored in a database, so need ''Database Logging'' to work.
  * Viewer Report a Problem
  * Viewer Photo Annotations Sidebar
  * Viewer Telemetry

Viewer Telemetry needs to be explicitly enabled from the Console System page.

===== Server Uptime =====

Table: ''log_publisher_up_time''

Logs the uptime of the server, every 5 minutes.

===== Server Throughput =====

Table: ''log_publisher_throughput''

Logs the amount of data that passed through the server (HTTP and WebSocket traffic combined) in bytes.
A record is logged every 5 minutes.

===== Publication Monitoring Events =====

Table: ''log_publisher_publication_events''

This table contains events that are valuable to an administrator. 
  * Failure to Create Guest session due to publication limit reached
  * Failure to Create Guest session due to server limit reached
  * Login failure due to Wrong credentials
  * Login failure due to No permission
  * Publication session threshold warning reached
  * Server session threshold warning reached

Session threshold warnings can be configured in the Console System page.

===== Publication Logins =====

Table: ''log_publisher_publication_logins''

On Publication login, a record is saved here with Publication and User context.  
Also includes the guest session pressure at login time (on server level and publication level).

===== Publication Sessions =====

Table: ''log_publisher_publication_sessions''

On session close, a record is saved here with conclusive information on the session that just completed.
Includes session context information like username, IP, publication.

===== Viewer Report a Problem Reports =====

Table: ''log_publisher_report''

When a user sends a problem report on a photo the server, it is stored here. 

===== Viewer Photo Annotation Sidebar =====

Table: ''log_publisher_photo_annotation''

When the user interacts with the Photo Annotation sidebar and creates or edits annotations, they end up in this table. 

===== Viewer Telemetry =====

Table: ''log_publisher_telemetry_events''

Since version 26.2.0, you can enable Viewer Telemetry logging from the Console.\\ Once enabled, viewers that open after the setting was set to true, will post the following information : 
  * Open Workspace Timing
  * Open Resource Timing