This is an old revision of the document!


Log Configuration

The log configuration page controls what type of information to record in the unit's different logs and where to send/store those logs.

Severity levels are:

  • Emergency
  • Alert
  • Critical
  • Error
  • Warning
  • Notice
  • Info
  • Debug

System Log

The system log records generic events that have occurred to the unit.

Usually debug level messages are not logged, to keep the system log clean and readable. When support requests you enable Debug messages in system log to record debug level messages too.

If you have the Internet filter enabled you can log web access attempts blocked by it by enabling Log blocked access attempts.

The system log can be viewed on the system log page or forwarded to various receivers, see below.

Firewall Log

The firewall log records information about packets received and sent by the unit.

The firewall log does not use severity levels, it qualifies packets as:

  • Error - internal error when processing packet
  • Drop - packet dropped by interface
  • Deny - packet denied by firewall
  • Accept - packet accepted by firewall rule

Usually the firewall log is turned off - no packets are logged.
:!: Enabling the firewall log may affect performance/throughput of the unit, especially when logging all packets and/or extensive details about each packet. At peak load, some packets may be left out from the log.

If you enable firewall logging, you should consider selecting Show rejected packets as that setting will log all packets stopped by the firewall, but not every single packet passing through.

:!: Try to limit logging by selecting as low log level and verbosity level as possible.

You can use the firewall log to see packet data (headers) too. A valuable tool for solving communication problems. You can log up to 64 bytes of packet contents (Log raw data) in hex or ASCII, and exclude common protocol (IP/TCP/UDP) headers so that the 64 logged bytes really are the data you are interested in.

Packets not logged

Multicast UDP packets are not logged, to avoid clogging down the firewall log. One single IPTV multicast channel can contain 500 packets per second! You can enable logging them using Log UDP multicast packets, though.

The communication with Internet Gate's own built-in web server is not logged. It can only be enabled using manually written Additional rules.

The firewall log can be viewed on the firewall log page or forwarded to various receivers, see below.

SIP Log

The SIP log records SIP and telephony related events.

Usually the SIP log does not record events with severity “info” and “debug”, to keep log tidy. You can however select different Verbosity level.

To record log messages about media streams you can either lower the verbosity level, or raise the Mediastream log level to above verbosity level.

You can filter the SIP log to record only certain headers, methods or IP addresses:

  • Log SIP header fields - Enter the name of the SIP header fields (e.g. From, To) you want to record into the SIP Log (Verbosity level has to be “info” or “debug” to use this feature). '*' can be used to record the complete SIP message with all headers.
  • Log SIP methods - Filter logging of SIP messages by method. If the word “not” is prepended all SIP messages that not matches the methods listed will be logged. Examples: “not REGISTER” or “INVITE ACK BYE CANCEL”.
  • Log only communication with IP addresses - Filter the logging of SIP messages. Only SIP messages sent or received to the given IP addresses are recorded into the SIP Log.

The SIP log can be viewed on the SIP log page or forwarded to various receivers, see below.

VPN Log

The VPN log records Virtual Private Network events. Visible only if VPN license is installed into the unit.

Usually debug messages are not recorded into the VPN log. You can however include them too if support requests you to.

The VPN log can be viewed on the VPN log page or forwarded to various receivers, see below.

Call Log

The call log records information about SIP calls made through the unit.

Call detail recording level - Select the amount of information recorded for each call:

  • Off - No information is logged.
  • Basic - Information about call participants, duration, termination reason, etc is recorded.
  • Including media statistics - Calculate and store information about voice quality too.

Log local calls too - Log information about local calls (made between LAN phones) too. (Same as setting “Always record route” on SIP advanced page.)

The Call log can be viewed on the Call log page or forwarded to various receivers, see below.

web_gui/log_configuration_page.1289213953.txt.gz · Last modified: 2010/11/08 11:59 by tibor
CC Attribution-Noncommercial-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0