Configuring logging
The Log Setting submenu includes two tabs, Local and Remote, that let you:
- set the severity level
- configure which types of log messages to record
- specify where to store the logs
You can configure the FortiVoice unit to store log messages locally (that is, in RAM or to the hard disk), remotely (that is, on a Syslog server or FortiAnalyzer unit), or at both locations.
Your choice of storage location may be affected by several factors, including the following:
- Local logging by itself may not satisfy your requirements for off-site log storage.
- Very frequent logging may cause undue wear when stored on the local hard drive. A low severity threshold is one possible cause of frequent logging. For more information on severity levels, see Log message severity levels.
For information on viewing locally stored log messages, see Viewing log messages.
This section includes the following topics:
- Configuring logging to the hard disk
- Choosing which events to log
- Configuring logging to a Syslog server or FortiAnalyzer unit
Configuring logging to the hard disk
You can store log messages locally on the hard disk of the FortiVoice unit.
To ensure that the local hard disk has sufficient disk space to store new log messages and that it does not overwrite existing logs, you should regularly download backup copies of the oldest log files to your management computer or other storage, and then delete them from the FortiVoice unit. (Alternatively, you could configure logging to a remote host.)
You can view and download these logs from the Log submenu of the Monitor tab. For more information, see Viewing log messages.
For logging accuracy, you should also verify that the FortiVoice unit’s system time is accurate. For details, see Configuring the time and date.
To configure logging to the local hard disk
- Go to Log & Report > Log Setting > Local.
- Select the Enabled option to allow logging to the local hard disk.
- In Log file size, enter the file size limit of the current log file in megabytes (MB). The log file size limit must be between 10 MB and 1000 MB.
- In Log time, enter the time (in days) of file age limit.
- In At hour, enter the hour of the day (24-hour format) when the file rotation should start.
When a log file reaches either the age or size limit, the FortiVoice unit rotates the current log file: that is, it renames the current log file (elog.log) with a file name indicating its sequential relationship to other log files of that type (elog2.log, and so on), then creates a new current log file. For example, if you set the log time to 10 days at hour 23, the log file will be rotated at 23 o’clock of the 10th day.
Large log files may decrease display and search performance.
- From Log level, select the severity level that a log message must equal or exceed in order to be recorded to this storage location.
- From Log options when disk is full, select what the FortiVoice unit will do when the local disk is full and a new log message is caused, either:
- Do not log: Discard all new log messages.
- Overwrite: Delete the oldest log file in order to free disk space, and store the new log message.
- In Logging Policy Configuration, click the arrow to review the options and enable the types of logs that you want to record to this storage location. For details, see Choosing which events to log.
- Click Apply.
Choosing which events to log
Both the local and remote server configuration recognize the following events. Select the check boxes of the events you want to log.
Events logging options
|
System |
Select this check box and then select specific system logs. No system types are logged unless you enable this option.
|
|
Generic |
Select this check box and then select specific events. No event types are logged unless you enable this option.
|
|
Voice |
Logs phone call events. |
|
Fax |
Logs fax events. |
|
DTMF (Enhanced CDR) |
Logs Dual Tone Multi-Frequency events. This option is for local log setting only. |
|
Hotel |
Logs hotel management events, such as guest check-in and check-out. This option is for local log setting only and available if the FortiVoice unit has a hotel license. |
|
Call Center |
Logs call center events, such as IVR and agent events. This option is for local log setting only and available if the FortiVoice unit has a call center license. |
Configuring logging to a Syslog server or FortiAnalyzer unit
Instead of or in addition to logging locally, you can store log messages remotely on a Syslog server or a FortiAnalyzer unit.
You can add a maximum of three remote Syslog servers.
|
|
Logs stored remotely cannot be viewed from the web-based manager of the FortiVoice unit. If you require the ability to view logs from the web-based manager, also enable local storage. For details, see Configuring logging to the hard disk. |
Before you can log to a remote location, you must first enable logging. For details, see Choosing which events to log. For logging accuracy, you should also verify that the FortiVoice unit’s system time is accurate. For details, see Configuring the time and date.
To configure logging to a Syslog server or FortiAnalyzer unit
- Go to Log & Report > Log Setting > Remote.
- Click New to create a new entry or double-click an existing entry to modify it.
GUI field
Description
Log to Remote Host
Enable
Select to allow logging to a remote host.
Name
Enter a name for the remote host.
IP
Enter the IP address of the Syslog server or FortiAnalyzer unit where the FortiVoice unit will store the logs.
Port
If the remote host is a FortiAnalyzer unit, enter
514; if the remote host is a Syslog server, enter the UDP port number on which the Syslog server listens for connections (by default, UDP 514).Level
Select the severity level that a log message must equal or exceed in order to be recorded to this storage location.
For information about severity levels, see Log message severity levels.
Facility
Select the facility identifier that the FortiVoice unit will use to identify itself when sending log messages.
To easily identify log messages from the FortiVoice unit when they are stored on a remote logging server, enter a unique facility identifier, and verify that no other network devices use the same facility identifier.
CVS format
Enable this option if you want to send log messages in comma-separated value (CSV) format.
Do not enable this option if the remote host is a FortiAnalyzer unit. FortiAnalyzer units do not support CSV-formatted log messages.
Logging Policy Configuration
Click the arrow to review the options and enable the types of logs you want to record to this storage location. For details, see Choosing which events to log.
- Click Create.
- If the remote host is a FortiAnalyzer unit, confirm with the FortiAnalyzer administrator that the FortiVoice unit was added to the FortiAnalyzer unit’s device list, allocated sufficient disk space quota, and assigned permission to transmit logs to the FortiAnalyzer unit. For details, see the FortiAnalyzer Administration Guide.
- To verify logging connectivity, from the FortiVoice unit, trigger a log message that matches the types and severity levels that you have chosen to store on the remote host. Then, on the remote host, confirm that it has received that log message.
For example, if you have chosen to record event log messages to the remote host and if they are more severe than Information, you could log in to the web-based manager or download a backup copy of the FortiVoice unit’s configuration file in order to trigger an event log message.
If the remote host does not receive the log messages, verify the FortiVoice unit’s network interfaces (see Configuring the network interfaces and About the management IP) and static routes (see Configuring static routes ), and the policies on any intermediary firewalls or routers. If ICMP ECHO (ping) is enabled on the remote host, you can use the
execute traceroutecommand to determine the point where connectivity fails.