Configure per-call logging settings
This section is OPTIONAL
The header for this section is [log]
| Name | Mandatory | Type | Default | Description |
|---|---|---|---|---|
| directory | no | string | log/callLogs | Directory relative to /opt/blueworx/vr in which to write call logs. |
| archive_directory | no | string | log/callLogs/archive | Directory relative to /opt/blueworx/vr in which to write archived call logs. |
| file_limit | no | integer | 100 | Maximum number of MB to write to any one call log file. Min: 1, Max: 2047 |
| app_log_mode | no | string | FILE | This parameter was introduced in version 7.8.0 Where to send application logging such as major events in the call, applications starting/stopping, output from the <log> tag in VoiceXML or Call Control XML. Files will be generated in the log directory per-call if FILE or BOTH is set, and messages will be sent to a kafka broker if KAFKA or BOTH is set. Valid options are: OFF, FILE, KAFKA, BOTH, CLOUD |
| error_log_mode | no | string | FILE | This parameter was introduced in version 7.8.0 This parameter is deprecated and in the trace section. Where to send error messages in addition to them being sent to the trace. Messages are sent to error_0.out if FILE or BOTH is set, or to a Kafka broker if KAFKA or BOTH is set. Valid options are: OFF, FILE, KAFKA, BOTH, CLOUD |
| trace_log_mode | no | string | FILE | This parameter was introduced in version 7.8.0 This parameter is deprecated and in the trace section. Where to send logging and trace to help debug issues with BVR other than application logging. Trace is appended to files in the log directory if FILE or BOTH is set, and messages will be sent to a kafka broker if KAFKA or BOTH is set. Valid options are: OFF, FILE, KAFKA, BOTH, CLOUD |
| keep_logs | no | boolean | false | Whether to archive application logs or delete them after the call has finished. If set to true they are archived once the call has finished. Note that application logs are only created on the filesystem if the app_log_mode is set to FILE or BOTH. |
| recordings_directory | no | string | log/recordings | This parameter is new in version 7.38.1 Directory relative to /opt/blueworx/vr/log/ in which to put automated call recordings set up with bvr -c |
| max_recordings_length_seconds | no | integer | 1800 | This parameter is new in version 7.38.1 This parameter sets the maximum number of seconds of recording that can occur on an automated call recording set up with bvr -c Min: 60 |