Syslog, CDR, SDR and Debug Parameters
The syslog, CDR
Syslog, CDR
Parameter |
Description |
|||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Syslog |
||||||||||||||||||||||||||||||||||||||||||||||
'Enable Syslog' configure troubleshoot > syslog > syslog [EnableSyslog] |
Determines whether the device sends logs and error messages (e.g., CDRs) generated by the device to a syslog server.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog Interface' configure troubleshoot > syslog > syslog-interface [SyslogInterface] |
Assigns an IP Interface from the IP Interfaces table (see Configuring IP Network Interfaces) for communication with the primary syslog server. By default, the OAMP interface is used. Note: The IP address version (IPv4 or IPv6) of the IP Interface and the syslog server's address must be the same. |
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog Server IP' configure troubleshoot > syslog > syslog-ip [SyslogServerIP] |
Defines the address (IP address or FQDN) of the computer on which the primary syslog server is running. The syslog server is an application designed to collect the logs and error messages generated by the device. The default IP address is 0.0.0.0. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog Server Port' configure troubleshoot > syslog > syslog-port [SyslogServerPort] |
Defines the UDP port of the primary syslog server. The valid range is 0 to 65,535. The default port is 514. Note: To configure secondary syslog servers, see Configuring Secondary Syslog Servers. |
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog Protocol' configure troubleshoot > syslog > syslog-protocol [SyslogProtocol] |
Defines the transport protocol for communicating with the primary syslog server.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog TLS Context' configure troubleshoot > syslog > syslog-tls-context-name [SyslogTLSContext] |
Assigns a TLS Context when the TLS transport protocol is used for communication with the syslog server (primary and secondary servers). For configuring TLS Contexts, see Configuring TLS Certificate Contexts. |
|||||||||||||||||||||||||||||||||||||||||||||
'Log Severity Level' log-level [SyslogLogLevel] |
Defines the minimum severity level of messages included in the syslog message that is generated by the device. The specified severity level and all higher severity levels are included in the syslog message. For example, if you configure the parameter to Alert, the syslog will include messages with Alert severity level and messages with Emergency severity level. The severity levels are listed below from highest to lowest severity.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
[EnableConsoleLog] |
Enables the device to send the syslog messages to the serial console (over the device's physical serial interface). This may be useful, for example, if you no longer have network access to the device and you would like to perform diagnostics.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Persistent Log Size' configure troubleshoot > syslog > system-persistent-log-size [SystemPersistentLogSize] |
Defines the maximum size (in kilobytes) of each persistent system log file, after which log rotation occurs. The valid value range is 10 to 2,000 KB. The default is 1,024 KB. For more information on persistent logging, see Configuring and Viewing Persistent Logging Storage. |
|||||||||||||||||||||||||||||||||||||||||||||
'Persistent Log Period' configure troubleshoot > syslog > system-persistent-log-period [SystemPersistentLogPeriod] |
Defines the maximum age (in minutes) of each persistent system log file, after which log rotation occurs. The valid value range is 0 to 71,582. The default is 0 (unlimited). For more information on persistent logging, see Configuring and Viewing Persistent Logging Storage. |
|||||||||||||||||||||||||||||||||||||||||||||
HTTP Client Requests and Response |
||||||||||||||||||||||||||||||||||||||||||||||
configure troubleshoot > logging settings > enable-http-client-dbg-msg [EnableHttpClientDbgMsg] |
Enables the device to log (syslog) HTTP requests and responses (like CURL's verbose data) received from HTTP clients.
Note: To log only specific HTTP clients (based on URL filters), see the [HTTPLogFilter] parameter. |
|||||||||||||||||||||||||||||||||||||||||||||
configure troubleshoot > logging settings > http-log-filter [HTTPLogFilter] |
Defines the HTTP clients whose requests and responses you want the device to log, based on the presence of specific strings within their URLs. The valid value is a string of up to 256 characters. You can configure the parameter with multiple strings, where each string is separated by a space (e.g., 'url1 url2 url3'). The value must be enclosed by single quotation marks (' '). The default is an empty string (' '), which means that the device logs requests and responses from all HTTP clients. Note: To enable the logging of HTTP client requests and responses, see the [EnableHttpClientDbgMsg] parameter. |
|||||||||||||||||||||||||||||||||||||||||||||
CDR |
||||||||||||||||||||||||||||||||||||||||||||||
'CDR Syslog Server IP Address' configure troubleshoot > cdr > cdr-srvr-ip-adrr [CDRSyslogServerIP] |
Defines the address (IPv4 or IPv6, or FQDN) of the syslog server to where the device sends the CDRs. By default, no address is defined. If not configured, the device sends the CDRs (with the syslog messages) to the syslog server configured by the [SyslogServerIP] parameter. If you configure an address for the [CDRSyslogServerIP] parameter, the device sends the CDRs only to this CDR syslog server and not to the syslog server configured by the [SyslogServerIP] parameter. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Call-End CDR SIP Reasons Filter' configure troubleshoot > cdr > call-end-cdr-sip-reasons-filter [CallEndCDRSIPReasonsFilter] |
Defines SIP release cause codes that if received for the call, the devicedoesn't sent Call-End CDRs for the call. The valid value is 300 through to 699. You can configure the parameter with multiple codes using a comma to separate them (e.g., 301,400,404). You can also use "xx" to denote a range (e.g., 3xx). |
|||||||||||||||||||||||||||||||||||||||||||||
'Call-End CDR Zero Duration Filter' configure troubleshoot > cdr > call-end-cdr-zero-duration-filter [CallEndCDRZeroDurationFilter] |
Enables the device to not send Call-End CDRs if the call's duration is zero (0).
|
|||||||||||||||||||||||||||||||||||||||||||||
'CDR Report Level' configure troubleshoot > cdr > cdr-report-level [CDRReportLevel] |
Enables signaling-related CDRs to be sent to a syslog server and defines the call stage at which they are sent.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Media CDR Report Level' configure troubleshoot > cdr > media-cdr-rprt-level [MediaCDRReportLevel] |
Enables media-related CDRs of SBC calls to be sent to a syslog server and defines the call stage at which they are sent.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'REST CDR Report Level' configure system > cdr > rest-cdr-report-level [RestCdrReportLevel] |
Enables signaling-related CDRs to be sent to a REST server and defines the call stage at which they are sent.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'REST CDR HTTP Server' configure system > cdr > rest-cdr-http-server [RestCdrHttpServer] |
Defines the REST server (configured in the Remote Web Services table) to where the device sends CDRs through REST API. The valid value is a string (i.e., name of the REST server). By default, no value is defined. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Call Success SIP Reasons' configure troubleshoot > cdr > call-success-sip-reasons [CallSuccessSIPReasons] |
Defines the SIP response code that you want the device to consider as a call success, which is indicated by the optional 'Call Success' field in the sent CDR. This parameter overrides the device's default behavior of how it considers calls a success or failure based on SIP responses. The valid value is string of up to 128 characters to represent SIP response codes (e.g., 404). You can configure the parameter with multiple response codes, whereby each code is separated by a comma without spaces before or after (e.g., 404,408,406). You can also configure a range of responses using the "xx" wildcard (e.g., 4xx,502). By default, no value is defined. Note: If an overlap of a SIP response occurs between the configured 'Call Success SIP Reasons' and 'Call Failure SIP Reasons' parameters, the device uses the parameter that is configured with the specific response code, instead of the parameter configured with the range ("xx"). For example, if you configure the 'Call Success SIP Reasons' parameter with "404,5xx" and the 'Call Failure SIP Reasons' parameter with "502", for 502 responses, the device uses the settings of the 'Call Failure SIP Reasons' parameter only. In other words, a call with SIP response code 502 is considered as a call failure. |
|||||||||||||||||||||||||||||||||||||||||||||
'Call Failure SIP Reasons' call-failure-sip-reasons [CallFailureSIPReasons] |
Defines the SIP response codes that you want the device to consider as call failure, which is indicated by the optional 'Call Success' field in the sent CDR. This parameter overrides the device's default behavior of how it considers calls a success or failure based on SIP responses. The valid value is string of up to 128 characters to represent SIP response codes (e.g., 486). You can configure the parameter with multiple response codes, whereby each code is separated by a comma without spaces before or after (e.g., 486,408,406). You can also configure a range of responses using the "xx" wildcard (e.g., 4xx,502). By default, no value is defined. Note: If an overlap of a SIP response occurs between the configured 'Call Success SIP Reasons' and 'Call Failure SIP Reasons' parameters, the device uses the parameter that is configured with the specific response code, instead of the parameter configured with the range ("xx"). For example, if you configure the 'Call Success SIP Reasons' parameter with "486,5xx" and the 'Call Failure SIP Reasons' parameter with "502", for 502 responses, the device uses the settings of the 'Call Failure SIP Reasons' parameter only. In other words, a call with SIP response code 502 is considered as a call failure. |
|||||||||||||||||||||||||||||||||||||||||||||
'Call Success Internal Reasons' call-success-internal-reasons [CallSuccessInternalReasons] |
Defines the internal response codes (generated by the device) that you want the device to consider as call success, which is indicated by the optional 'Call Success' field in the sent CDR. This parameter overrides the device's default behavior of how it considers calls a success or failure based on internally responses. The valid value is string of up to 128 characters to represent internal response codes (e.g., 851). You can configure the parameter with multiple response codes, whereby each code is separated by a comma without spaces before or after (e.g., 851,320). You can also configure a range of responses using the "xx" wildcard (e.g., 8xx,320). By default, no value is defined. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Call Failure Internal Reasons' call-failure-internal-reasons [CallFailureInternalReasons] |
Defines the internal response codes (generated by the device) that you want the device to consider as call failure, which is indicated by the optional 'Call Success' field in the sent CDR. This parameter overrides the device's default behavior of how it considers calls a success or failure based on internally responses. The valid value is string of up to 128 characters to represent internal response codes (e.g., 851). You can configure the parameter with multiple response codes, whereby each code is separated by a comma without spaces before or after (e.g., 851,320). You can also configure a range of responses using the "xx" wildcard (e.g., 8xx,320). By default, no value is defined. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'No User Response Before Connect' no-user-response-before-connect [NoUserResponseBeforeConnectSuccess] |
Defines if the device considers a call as a success or failure when the internal response (generated by the device) "GWAPP_NO_USER_RESPONDING" (18) is received before call connect (SIP 200 OK).
|
|||||||||||||||||||||||||||||||||||||||||||||
'No User Response After Connect' no-user-response-after-connect [NoUserResponseAfterConnectSuccess] |
Defines if the device considers a call as a success or failure when the internal response (generated by the device) "GWAPP_NO_USER_RESPONDING" (18) is received after call connect (SIP 200 OK).
|
|||||||||||||||||||||||||||||||||||||||||||||
'Call Transferred before Connect' call-transferred-before-connect [CallTransferredBeforeConnectSuccess] |
Defines if the device considers a call as a success or failure when the internal response (generated by the device) "RELEASE_BECAUSE_CALL_TRANSFERRED" (807) is generated before call connect (SIP 200 OK).
|
|||||||||||||||||||||||||||||||||||||||||||||
'Call Transferred after Connect' call-transferred-after-connect [CallTransferredAfterConnectSuccess] |
Defines if the device considers a call as a success or failure when the internal response (generated by the device) "RELEASE_BECAUSE_CALL_TRANSFERRED" (807) is generated after call connect (SIP 200 OK).
|
|||||||||||||||||||||||||||||||||||||||||||||
'VoIP Debug Level' configure troubleshoot > syslog > debug-level [GwDebugLevel] |
Enables syslog debug reporting and logging level.
|
|||||||||||||||||||||||||||||||||||||||||||||
configure system > cdr > non-call-cdr-rprt [EnableNonCallCdr] |
Enables creation of CDR messages for non-call SIP dialogs (such as SUBSCRIBE, OPTIONS, and REGISTER).
|
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog Optimization' configure troubleshoot > syslog > syslog-optimization [SyslogOptimization] |
Enables the device to accumulate and bundle multiple debug messages into a single UDP packet and then send it to a syslog server. The benefit of this feature is that it reduces the number of UDP syslog packets, thereby improving (optimizing) CPU utilization.
Note: The size of the bundled message is configured by the [MaxBundleSyslogLength] parameter. |
|||||||||||||||||||||||||||||||||||||||||||||
configure voip > gateway digital settings > mx-syslog-lgth [MaxBundleSyslogLength] |
Defines the maximum size (in bytes) threshold of logged syslog messages bundled into a single UDP packet, after which they are sent to a syslog server. The valid value range is 0 to 1220 (where 0 indicates that no bundling occurs). The default is 1220. Note: The parameter is applicable only if the [GWDebugLevel] parameter is enabled. |
|||||||||||||||||||||||||||||||||||||||||||||
'Syslog CPU Protection' configure troubleshoot > syslog > syslog-cpu-protection [SyslogCpuProtection] |
Enables the protection of the device's CPU resources during debug reporting, ensuring voice traffic is unaffected. If CPU resources drop (i.e., high CPU usage) to a critical level (threshold), the device automatically lowers the debug level to free up CPU resources that were required for the previous debug-level functionality. When sufficient CPU resources become available again, the device increases the debug level. The threshold is configured by the 'Debug Level High Threshold' parameter (see below).
|
|||||||||||||||||||||||||||||||||||||||||||||
'Debug Level High Threshold' configure troubleshoot > syslog > debug-level-high-threshold [DebugLevelHighThreshold] |
Defines the threshold (in percentage) for automatically switching to a different debug level, depending on CPU usage. The parameter is applicable only if the 'syslog CPU Protection' parameter is enabled. The valid value is 0 to 100. The default is 90. The debug level is changed upon the following scenarios:
For example, assume that the threshold is set to 70% and the Debug Level to Detailed (5). When CPU usage reaches 70%, the debug level is reduced to Basic (1). When CPU usage increases by 5% or more than the threshold (i.e., greater than 75%), the debug level is disabled - No Debug (0). When the CPU usage decreases to 5% less than the threshold (e.g., 65%), the debug level is increased to Basic (1). When the CPU usage decreases to 20% less than the threshold (e.g., 50%), the debug level changes to Detailed (5). Note: The device doesn't increase the debug level to a level that is higher than what you configured for the 'Debug Level' parameter. |
|||||||||||||||||||||||||||||||||||||||||||||
configure troubleshoot > cdr > time-zone-format [TimeZoneFormat] |
Defines the time zone that is displayed with the timestamp in CDRs. The timestamp appears in the CDR fields "Setup Time", "Connect Time", and "Release Time". The valid value is a string of up to six characters. The default is UTC. For example, if you configure the parameter TimeZoneFormat = GMT+11, the timestamp in CDRs are generated with the following time zone display: 17:47:45.411 GMT+11 Sun Jan 03 2018 Note: The time zone is only for display purposes; it doesn't configure the actual time zone. |
|||||||||||||||||||||||||||||||||||||||||||||
configure troubleshoot > cdr > call-duration-units [CallDurationUnits] |
Defines the unit of measurement for call duration ("Duration" field) in CDRs generated by the device.
The parameter applies to CDRs for syslog, RADIUS, local-device storage, and CDR history displayed in the Web interface. |
|||||||||||||||||||||||||||||||||||||||||||||
'CDR Syslog Sequence Number' configure system > cdr > cdr-seq-num [CDRSyslogSeqNum] |
Enables or disables the inclusion of the sequence number (S=) in CDR Syslog messages.
|
|||||||||||||||||||||||||||||||||||||||||||||
configure voip > sip-definition settings > send-acsessionid [SendAcSessionIDHeader] |
Enables the use of the Global Session ID in SIP messages (AC-Session-ID header), which is a unique identifier of the call session, even if it traverses multiple devices.
For more information, see Enabling Same Call Session ID over Multiple Devices. |
|||||||||||||||||||||||||||||||||||||||||||||
'Activity Types to Report via Activity Log Messages' configure troubleshoot > activity-log [ActivityListToLog] |
Defines the operations (activities) performed in the Web interface that are reported to a syslog server.
Note: For the ini file parameter, enclose values in single quotation marks. To configure the ini file parameter with multiple values, use a comma-separated list, for example: ActivityListToLog = 'PVC', 'AFL', 'DR'. |
|||||||||||||||||||||||||||||||||||||||||||||
'Incremental INI Activity Logs Max Number' configure troubleshoot > max-ini-activity-logs [MaxINIActivityLog] |
Defines the maximum number of lines of parameters from the loaded incremental ini file to log for the Activity Types to Report feature. The parameter is applicable when you configure the [ActivityListToLog] parameter to also include the INI value. The valid value is 0 to 2,000. The default is 1,000. Note: The maximum number of lines doesn't count empty lines or lines containing only comments. |
|||||||||||||||||||||||||||||||||||||||||||||
[EnableParametersMonitoring] |
Enables the monitoring, through syslog messages, of parameters that are modified on-the-fly.
|
|||||||||||||||||||||||||||||||||||||||||||||
'Destination IP Address' configure troubleshoot > logging settings > dbg-rec-dest-ip [DebugRecordingDestIP] |
Defines the IP address (IPv4 or IPv6) of the server for capturing debug recording. |
|||||||||||||||||||||||||||||||||||||||||||||
'Destination Port' configure troubleshoot > logging settings > dbg-rec-dest-port [DebugRecordingDestPort] |
Defines the UDP port of the server for capturing debug recording. The default is 925. |
|||||||||||||||||||||||||||||||||||||||||||||
'Maximum duration' configure troubleshoot > logging settings > dbg-rec-timeout [DebugRecordingTimeout] |
Defines the maximum duration (in minutes) for the debug recording process. When this timer expires, the device automatically stops debug recording (unless you've explicitly stopped it before the timer expires, as described in Starting and Stopping Debug Recording). The valid value is 1 to 10,080 (7 days). The default is 60 (1 hour). Note: If debug recording is currently running (i.e., was started), the device resets the debug recording timer upon the following:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Start' / 'Stop' configure troubleshoot > logging-settings > dbg-rec-status [DebugRecordingStatus] |
Starts or stops debug recording. For more information on starting and stopping debug recording, see Starting and Stopping Debug Recording. Note: The CLI command also displays the current debug recording status (Started or Stopped), and resets the debug recording timer (configured by the [DebugRecordingTimeout] parameter). |
|||||||||||||||||||||||||||||||||||||||||||||
'Interface Name' configure troubleshoot > logging settings > dbg-rec-int-name [DebugRecordingIpInterfaceName] |
Defines the IP Interface through which the device sends captured traffic to the debug server. The valid value is the name of the IP Interface, as configured in the IP Interfaces table (see Configuring IP Network Interfaces). The default is the OAMP interface. |
|||||||||||||||||||||||||||||||||||||||||||||
'Enable Core Dump' enable-core-dump [EnableCoreDump] |
Enables the automatic generation of a Core Dump file upon a device crash.
|
|||||||||||||||||||||||||||||||||||||||||||||
'Core Dump Destination IP' core-dump-dest-ip [CoreDumpDestIP] |
Defines the IP address of the remote server where you want the device to send the Core Dump file. By default, no IP address is defined. |
|||||||||||||||||||||||||||||||||||||||||||||
'Call Flow Report Mode' call-flow-report [CallFlowReportMode] |
Enables the device to send SIP call messages to OVOC so that OVOC can display SIP call dialog sessions as SIP call flow diagrams.
For more information, see Enabling SIP Call Flow Diagrams in OVOC. |
|||||||||||||||||||||||||||||||||||||||||||||
configure troubleshoot > syslog > system-log-size [SystemLogSize] |
Defines the maximum size (in kilobytes) of the system log file. The valid value range is 10 to 2000 KB. The default is To view the logged information in this file, use the CLI command show system log. |
|||||||||||||||||||||||||||||||||||||||||||||
[PLThresholdLevelsPerMille] |
Defines packet-loss percentage ranges that are used in sent syslog messages to report packet loss in incoming media streams (RTP) in 15-second intervals. The valid value range is 1 to 1,000. The default is 5, 10, 20, 50. The syntax for configuring the parameter is: PLThresholdLevelsPerMille = Level1, Level2, Level3, Level4 Where the levels represent the following ranges in the syslog:
For example (using default values): PLThresholdLevelsPerMille = 5,10,20,50 Therefore, the ranges are:
For more information, see Packet Loss Indication in Syslog. |
|||||||||||||||||||||||||||||||||||||||||||||
SDR Parameters (For more information, see Session Detail Records.) |
||||||||||||||||||||||||||||||||||||||||||||||
'SDR Record Type' configure troubleshoot > sdr > sdr-record-type [SDRRecordType] |
Defines the type of SDRs to generate for syslog or local storage.
|
|||||||||||||||||||||||||||||||||||||||||||||
'First Intermediate Interval' configure troubleshoot > sdr > sdr-first-inter-interval [SDRFirstIntermediateInterval] |
Defines the time (in minutes) of the call at which the device generates the first Intermediate SDR. The valid value is 0 to 20. The default is 0 (i.e., not generated). For more information, see Configuring Intervals for Intermediate SDRs. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Periodic Intermediate Interval' configure troubleshoot > sdr > sdr-inter-interval [SDRIntermediateInterval] |
Defines the time (in minutes) between each Intermediate SDR that the device generates during the call. The valid value is 30 to 90. The default is 60 (i.e., every hour). For more information, see Configuring Intervals for Intermediate SDRs. Note: The parameter is applicable only to Intermediate SDRs (i.e., 'SDR Record Type' or 'REST SDR Record Type' parameters are configured to any value that includes "INTERMEDIATE"). |
|||||||||||||||||||||||||||||||||||||||||||||
'SDR Syslog' configure troubleshoot > sdr > sdr-syslog [SDRSyslog] |
Enables the device to send SDRs to a syslog server.
|
|||||||||||||||||||||||||||||||||||||||||||||
'SDR Server Address' configure troubleshoot > sdr > sdr-srvr-ip-adrr [SDRServerIpAddress] |
Defines the address (IPv4 or IPv6 address, or FQDN) of the syslog server to where the device sends the SDRs. By default, no value is defined. |
|||||||||||||||||||||||||||||||||||||||||||||
'SDR Server Sequence Number' configure troubleshoot > sdr > sdr-seq-num [SDRSyslogSeqNum] |
Enables the inclusion of a sequence number (S=) in SDR Syslog messages.
|
|||||||||||||||||||||||||||||||||||||||||||||
'SDR REST' configure troubleshoot > sdr > sdr-rest [SDRRest] |
Enables the device to send SDRs to an HTTP-based REST server, using its REST API.
|
|||||||||||||||||||||||||||||||||||||||||||||
'REST SDR Record Type' configure troubleshoot > sdr > rest-sdr-record-type [RESTSDRRecordType] |
Defines the SDR type(s) to generate for sending to a REST server.
|
|||||||||||||||||||||||||||||||||||||||||||||
'REST SDR HTTP Server Name' configure troubleshoot > sdr > rest-sdr-http-servers [RESTSDRHttpServers] |
Defines the name of the REST server (configured in the Remote Web Services table) to where the device sends SDRs. By default, no value is defined. |
|||||||||||||||||||||||||||||||||||||||||||||
'Local Storage' configure troubleshoot > sdr > local-storage [SDRLocalStorage] |
Enables the device to store generated SDRs locally.
|
|||||||||||||||||||||||||||||||||||||||||||||
'File Size' configure troubleshoot > sdr > file-size [SDRLocalMaxFileSize] |
Defines the size (in kilobytes) of each locally stored SDR file (before compression). When the Current file reaches this size, the device creates a file containing all the SDRs from the Current file. The valid value is 1,024 to 1,048,567. The default is 10,240. Note: SDR file creation works together with the 'Rotation Period' parameter, whereby the file is created as soon as one of the parameter's ('File Size' or 'Rotation Period') settings are fulfilled (whichever occurs first). For example, if the 'File Size' parameter is 100 and 'Rotation Period' is 60, and the file size reaches 100 kbytes after only 30 minutes, the device creates the file. |
|||||||||||||||||||||||||||||||||||||||||||||
'Number of Files' configure troubleshoot > sdr > files-num [SDRLocalMaxNumOfFiles] |
Defines the maximum number of locally stored SDR files. If the maximum number is reached and a new file is created, the oldest file is deleted to make space for the new file (i.e., FIFO). The valid value is 2 to 65,535. The default is 5. |
|||||||||||||||||||||||||||||||||||||||||||||
'File Name' configure troubleshoot > sdr > file-name [SDRLocalFileName] |
Defines the filename for locally stored SDRs, using format specifiers. The valid value is a string of up to 63 characters. The default is SDR__%y.%m.%d-%H.%M.%S_%qqqqq.csv, where:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Rotation Period' configure troubleshoot > sdr > rotation-period [SDRLocalInterval] |
Defines how often (in minutes) the device creates a new file for locally stored SDRs. For example, if configured to 60, every hour it creates a file containing all the SDRs from the Current file. The valid value is 2 to 1,440. The default is 60. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Compression Format' configure troubleshoot > sdr > compression-format [SDRLocalCompression] |
Defines the file compression format for locally stored SDR files.
Note: If you modify the parameter, the selected file format is applied to all existing SDR files (in addition to future files). |
|||||||||||||||||||||||||||||||||||||||||||||
'SDR Servers Send Period' configure troubleshoot > sdr > sdr-servers-send-period [SDRServersSendPeriod] |
Defines the periodic interval (in seconds) when the device checks if a locally stored SDR file is available for sending to the remote server. For example, if you configure the parameter to 10, the device checks for a file every 10 seconds. If there is a file, it sends it to the server. The valid value is 0 to 60. The default is 1. A value of 0 means that the device doesn't send any SDR files to the server. |
|||||||||||||||||||||||||||||||||||||||||||||
'SDR Servers Bulk Size' configure troubleshoot > sdr > sdr-servers-bulk-size [SDRServersBulkSize] |
Defines the maximum number of locally stored SDR files (i.e., batch of files) that the device sends to the remote server in each file transfer operation. The valid value is 1 to 20. The default is 10. |
|||||||||||||||||||||||||||||||||||||||||||||
CDR Local Storage |
||||||||||||||||||||||||||||||||||||||||||||||
'File Size' configure troubleshoot > cdr > file-size [CDRLocalMaxFileSize] |
Defines the size (in kilobytes) of each locally stored CDR file The valid value is Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Number of Files' configure troubleshoot > cdr > files-num [CDRLocalMaxNumOfFiles] |
Defines the maximum number of locally stored CDR files. If the maximum number is reached and a new file is created, the oldest file is deleted to make space for the new file (i.e., FIFO). The valid value is 2 to
Note: The parameter is applicable only to local storage of CDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'Rotation Period' configure troubleshoot > cdr > rotation-period [CDRLocalInterval] |
Defines how often (in minutes) the device creates a new CDR file for locally stored CDRs. For example, if configured to 60, every hour it creates a CDR file containing all the CDRs from the Current file. The valid value is 2 to 1440. The default is 60. Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'Compression Format' configure troubleshoot > cdr > compression-format [CDRLocalCompression] |
Defines the file compression format for locally stored CDR files.
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||
'CDR File Name' configure troubleshoot > cdr > cdr-file-name [CDRLocalFileName] |
Defines the CDR filename for locally stored CDRs, using format specifiers. The valid value is a string of up to 63 characters. The default is CDR__%y.%m.%d-%H.%M.%S_%qqqqq.csv, where:
For more information, see Storing CDRs Locally on the Device. Note: The parameter is applicable only to local storage of CDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'CDR Servers Send Period' configure troubleshoot > cdr > cdr-servers-send-period [CDRServersSendPeriod] |
Defines the periodic interval (in seconds) when the device checks if a locally stored CDR file is available for sending to the remote CDR server. For example, if you configure the parameter to 10, the devicechecks for a CDR file every 10 seconds. If there is a file, it sends it to the server. The valid value is 0 to 60. The default is 1. A value of 0 means that the device doesn't send any CDR files to the server. Note: The parameter is applicable only to local storage of CDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'CDR Servers Bulk Size' configure troubleshoot > cdr > cdr-servers-bulk-size [CDRServersBulkSize] |
Defines the maximum number of locally stored CDR files (i.e., batch of files) that the device sends to the remote server in each transfer operation. The valid value is 1 to 20. The default is 10. Note: The parameter is applicable only to local storage of CDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
Local Storage of Debug Recording Files (For more information, see Storing Debug Recording Files on Device.) |
||||||||||||||||||||||||||||||||||||||||||||||
'Local Storage' configure troubleshoot > logging settings > dbg-rec-local-storage [DebugRecordingLocalStorage] |
Enables local storage of debug recording files.
Note: If you disable local storage (i.e., parameter configured to Disable), the device deletes all stored debug recording files. In addition, it no longer reserves storage space previously allocated for debug recording files. |
|||||||||||||||||||||||||||||||||||||||||||||
'Recording' configure troubleshoot > logging settings > dbg-rec-local-storage-recording [DebugRecordingLocalStorageRecording] |
Starts debug recording file creation and local storage.
|
|||||||||||||||||||||||||||||||||||||||||||||
'File Size' configure troubleshoot > logging settings > dbg-rec-local-storage-file-size [DebugRecordingLocalStorageFileSize] |
Defines the maximum size (in megabytes) of the debug recording file (compressed). When the Current file reaches this size, the device creates a file. However, if the 'Rotation Period' parameter is reached before the file has reached this maximum size, the file is created. The valid value is 0 to 100. The default is 50. |
|||||||||||||||||||||||||||||||||||||||||||||
'Number of Files' configure troubleshoot > logging settings > dbg-rec-local-storage-files-count [DebugRecordingLocalStorageFilesCount] |
Defines the maximum number of debug recording files that can be stored locally. Depending on the configuration of the 'File Mode' parameter, if this maximum is reached, a new file replaces the oldest file (i.e., FIFO) or the device stops debug recording. The valid value is 0 to 1,000. The default is 20. |
|||||||||||||||||||||||||||||||||||||||||||||
'File Mode' configure troubleshoot > logging settings > dbg-rec-local-storage-mode [DebugRecordingLocalStorageMode] |
Defines the file creation method when the number of maximum files is reached (as configured by the 'Number of Files' parameter).
|
|||||||||||||||||||||||||||||||||||||||||||||
'Rotation Period' configure troubleshoot > logging settings > dbg-rec-local-storage-rotation-period [DebugRecordingLocalStorageRotationPeriod] |
Defines the periodic duration (in minutes) of how often a debug recording file is created from the Current file (even if empty). For example, if configured to 60, a file is created every hour (or before if the maximum size is reached). The valid value is 1 to 1,440 (i.e., 24 hours). The default is 1. |
|||||||||||||||||||||||||||||||||||||||||||||
IP Trace Filters (For more information, see Filtering IP Network Traces by Ethernet Port, Ethernet Group or VLAN.) |
||||||||||||||||||||||||||||||||||||||||||||||
'Recording Mode' configure troubleshoot > logging settings > dbg-rec-ip-trace-entity [DebugRecordingIpTraceEntity] |
Defines the filtering of IP traces for log filtering rules (in the Logging Filters table) whose 'Filter Type' parameter is configured to IP Trace.
|
|||||||||||||||||||||||||||||||||||||||||||||
'Physical Ethernet Port' configure troubleshoot > logging settings > dbg-rec-ip-trace-phy-port [DebugRecordingIpTracePhysicalPort_IpTracePhyPort] |
Filters IP traces by a specific Ethernet port. |
|||||||||||||||||||||||||||||||||||||||||||||
'Ethernet Group' configure troubleshoot > logging settings > dbg-rec-ip-trace-eth-group [DebugRecordingIpTraceEthGroup] |
Filters IP traces by a specific Ethernet Group. |
|||||||||||||||||||||||||||||||||||||||||||||
'VLAN ID' configure troubleshoot > logging settings > dbg-rec-ip-trace-vlan-id [DebugRecordingIpTraceVlanId_IpTraceVlanId] |
Filters IP traces by a specific VLAN ID. |
|||||||||||||||||||||||||||||||||||||||||||||
PII Masking (GDPR) |
||||||||||||||||||||||||||||||||||||||||||||||
'Mask Digits' configure voip > sip-definition settings > pii-mask-digits [PIIMaskDigits] |
Enables the masking of DTMF and other digits detected by the device in the generated syslog messages and debug recording.
For more information, see Masking Digits in Syslog Messages. |
|||||||||||||||||||||||||||||||||||||||||||||
'Mask PII in CDRs' configure voip > sip-definition settings > pii-mask-private-info-in-cdrs [PIIMaskPrivateInfoInCDRs]
|
Enables the masking of personally identifiable information (PII) in CDRs
For more information, see Masking PII in CDRs and SDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'Number of Unmasked Characters in PII' configure voip > sip-definition settings > pii-number-of-unmasked-chars [PIINumberOfUnmaskedChars] |
Defines the number of characters in the PII element to show when the 'Mask PII in CDRs' parameter is configured to Mask PII in Detailed Records. The rest of the characters are masked (each by an asterisk sign). The valid value is 0 to 255. The default is 0 (masks all characters). For more information, see Masking PII in CDRs and SDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'Location in PII of Unmasked Characters' configure voip > sip-definition settings > pii-unmasked-chars-location [PIIUnmaskedCharsLocation]
|
Defines from where in the PII element to show the number of characters specified by the 'Number of Unmasked Characters in PII' parameters, when the Mask Private Information in CDRs' parameter is configured to Mask PII in Detailed Records.
For more information, see Masking PII in CDRs and SDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'Mask PII in QoE CDRs for OVOC' configure voip > sip-definition settings > pii-mask-private-info-for-ovoc [PIIMaskPrivateInfoForOVOC] |
Enables the PII masking (with asterisks) of phone numbers, URI user parts, and display names in CDRs that the device sends to OVOC.
For more information, see Masking PII in CDRs and SDRs. |
|||||||||||||||||||||||||||||||||||||||||||||
'Mask URI Host Part in CDRs' configure voip > sip-definition settings > pii-mask-host [PIIMaskHost] |
Enables the PII masking (with asterisks) of URI host parts (including IP addresses) in CDRs that the device sends to Web, CLI, syslog, REST, RADIUS, and Local Storage (depending on which targets are anonymized by the 'Mask PII in CDRs' parameter), or to OVOC if the 'Mask PII in QoE CDRs for OVOC' parameter is enabled.
For more information, see Masking PII in CDRs and SDRs. |