Configuring logging
The Log & Report > 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 Gateway 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
You can store log messages locally on the hard disk of the FortiVoice Gateway.
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 Gateway.
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 Gateway’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 Enabled 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 Gateway 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 the display and search performance.
- In Log level, select the severity level that a log message must equal or exceed in order to be recorded to this storage location.
- In Log options when disk is full, select what the FortiVoice Gateway will do when the local disk is full and a new log message is caused, either:
- Overwrite: Delete the oldest log file in order to free disk space, and store the new log message.
- Do Not Log: Discard all new log messages.
- In Logging Policy Configuration, enable the types of logs that you want to record to this storage location.
Log type
Description
System
Includes system and administration events, such as downloading a backup copy of the configuration.
Generic
Includes the following events:
- SMTP relay or proxy events
- Voice user login and logout events
Voice
Includes phone calls events.
DTMF (Enhanced CDR)
Includes DTMF (Dual Tone Multi-Frequency) events.
- Click Apply.
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 GUI of the FortiVoice Gateway. If you require the ability to view logs from the GUI, 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 and choose which events to log. For details, see Configuring logging to the hard disk. 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.
- Click Create.
- If the remote host is a FortiAnalyzer unit, confirm with the FortiAnalyzer administrator that the FortiVoice Gateway 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 Gateway, 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.
|
GUI field |
Description |
|---|---|
| Enabled |
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 Gateway 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 Gateway will use to identify itself when sending log messages. To easily identify log messages from the FortiVoice Gateway 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 step 8 of Configuring logging to the hard disk. |
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 GUI or download a backup copy of the FortiVoice Gateway’s configuration file in order to trigger an event log message.
If the remote host does not receive the log messages, verify the FortiVoice Gateway’s network interfaces (see Configuring the network interfaces) 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 traceroute command to determine the point where connectivity fails.