Difference between revisions of "Logging - IP Stations"
From Zenitel Wiki
(→Logging in Turbine stations) |
(→Accessing the Logging page) |
||
(69 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{AEIPS}} |
− | This article describes how to enable and collect logs from | + | This article describes how to enable and collect logs from Zenitel IP Devices. The logs can be useful for debugging and troubleshooting purposes. |
− | The logging feature is | + | The logging feature is different in the [[:Category:Stations#INCA_stations|INCA family]]. See bottom of article for details. |
− | == Logging | + | {{note|[[Advanced Configuration Mode (Edge)|Advanced Configuration Mode]] must be enabled to access the Logging on the Zenitel IP stations}} |
− | * [[Logging into an IP Station|Log into the IP | + | |
+ | == Accessing the Logging page== | ||
+ | * [[Logging into an IP Station|Log into the IP device]] | ||
+ | * Enable [[Advanced Configuration Mode (Edge)|Advanced Configuration Mode]] | ||
* Select '''Station Administration''' > '''Logging''' | * Select '''Station Administration''' > '''Logging''' | ||
− | [[File: | + | [[File:IP_Station_Logging.png|thumb|left|700px|Logging configuration in IP stations]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | '''Detailed Logging: | + | === Basic logging === |
− | * Press '''Enable''' to start logging. | + | Basic logging is always active. Press the '''Download Logs''' button to download the log files to the computer. The log files are in a compressed archive format with file extension .gz. |
− | * Note that the station will '''reboot''' as soon as the '''Enable''' button is pressed, and will be out of service for approx. 30 seconds | + | |
− | * When | + | ===Detailed Logging === |
+ | <div style="float:right;"> <youtube width="350" height="210">tXmIlqN9ZGQ</youtube> </div> | ||
+ | By enabling Detailed logging much more main application events are logged into log files. This is useful when deep-tracing for events that caused issues or for performance bottlenecks. | ||
+ | * Press '''Enable''' to start detailed logging. | ||
+ | * Note that the station will do a '''partial reboot''' as soon as the '''Enable''' button is pressed, and will be out of service for approx. 30 seconds | ||
+ | * When finished with the logging, press '''Disable''' to stop the logging | ||
+ | * Press the '''Download Logs''' button to download the log files to the computer. The log files are in a compressed archive format with file extension .gz. | ||
− | |||
− | '''Clear | + | '''Clear Main Logs/Clear All Logs:''' After having downloaded the log files, they can be deleted from the station to free up space. |
− | + | {{Note|Although the station is using log rotation which automatically deletes old data, it is recommended not to keep the logging permanently enabled, as it will consume memory space and wear out the flash memory }} | |
− | |||
− | ''' | + | '''Detailed Logging''' creates some log file(s) that might be read and understood by technicians. These log files are located in the '''ipst''' folder. The rest of the logs are meant for software developers. The logs in the "ipst" folder shows the communication between station and server (SIP or DIP protocol, depending on the mode of operation). |
− | |||
− | |||
− | + | ===Tcpdump tool === | |
− | * The Tcpdump tool is included as from firmware version 4.7, and is used for collecting all data traffic in and out from the station for the time period specified | + | <div style="float:right;"> <youtube width="350" height="210">ClT8fY3AwhY</youtube> </div> |
+ | * The Tcpdump tool is included as from '''firmware version 4.7''', and is used for collecting all data traffic in and out from the station for the time period specified | ||
* The log file will be on the format .pcap, which can be read by packet analyzing applications such as '''Wireshark'''. | * The log file will be on the format .pcap, which can be read by packet analyzing applications such as '''Wireshark'''. | ||
* The '''Tcpdump timeout''' period can be set between 10 - 3600 seconds | * The '''Tcpdump timeout''' period can be set between 10 - 3600 seconds | ||
Line 33: | Line 39: | ||
* When the logging is ended, you need to refresh the web page (e.g. press the menu "Station Administration" > "Logging"), and you will see a link to download the "tcpdump.pcap" file to your PC | * When the logging is ended, you need to refresh the web page (e.g. press the menu "Station Administration" > "Logging"), and you will see a link to download the "tcpdump.pcap" file to your PC | ||
* Maximum file size is 5MB. After having downloaded the file to your PC, you should '''Delete tcpdump file''' to free up space in the station memory | * Maximum file size is 5MB. After having downloaded the file to your PC, you should '''Delete tcpdump file''' to free up space in the station memory | ||
+ | |||
+ | <br> | ||
+ | |||
+ | === Syslog Settings === | ||
+ | '''Syslog destination''' | ||
+ | |||
+ | Up to 3 different syslog server destinations can be configured, and reporting is done simultaneously for all configured destinations. A syslog destination is configured with following settings: | ||
+ | |||
+ | * '''Hostname''': Remote syslog server IP address | ||
+ | * '''Port''': Default is 514 | ||
+ | * '''Protocol type''': UDP (default) or TCP | ||
+ | |||
+ | '''Syslog facility and Log levels''' | ||
+ | |||
+ | A syslog facility is basically a source of the logging, or the type of the application (program) that is producing and sending log messages. Facilities are used so that logging servers can handle different facilities in different way. Turbine is using two different facilities: | ||
+ | |||
+ | # Application log (facility code 0): System level messages, same as "Detailed logging" | ||
+ | # Intercom log (facility code 1): User-level messages, related to SIP call events | ||
+ | |||
+ | |||
+ | The '''Priority Level''' is used to filter out log messages by severity level. The following severity levels are used: | ||
+ | |||
+ | *Warning | ||
+ | *Notice | ||
+ | *Info | ||
+ | *Debug | ||
+ | |||
+ | SIP Call events reported via the Intercom log: | ||
+ | * Warning: Registration lost | ||
+ | * Notice: No answer incoming or outgoing call | ||
+ | * Info: Registration successful | ||
+ | |||
+ | |||
+ | The server process which handles display of messages usually includes all lower (more severe) levels when display of less severe levels is requested. That is, if messages are separated by individual severity, a ''Warning'' level entry will also be included when filtering for ''Notice'', ''Info'' and ''Debug'' messages. | ||
+ | |||
+ | An additional filter field "'''Contains'''" can be used to filter out log messages according to a given string input. | ||
+ | |||
+ | {{note|The '''Syslog Settings''' are available as from firmware 4.11}} | ||
== Logging in INCA stations == | == Logging in INCA stations == | ||
− | The [[:Category: | + | The [[:Category:Stations#INCA_stations|INCA Stations]] provide log information when used in SIP or Pulse mode. When used in AlphaCom mode no log data is available. |
* [[Logging into an IP Station|Log into the IP Station]] | * [[Logging into an IP Station|Log into the IP Station]] | ||
Line 42: | Line 86: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | The web interface will | + | The web interface will show the last 150 lines of SIP related log data. |
− | + | [[Category: IC-EDGE Configuration]] | |
− | [[Category: | ||
[[Category: Pulse - Configuration]] | [[Category: Pulse - Configuration]] | ||
[[Category: SIP intercom - Configuration]] | [[Category: SIP intercom - Configuration]] | ||
− | + | [[Category: Turbine Configuration]] | |
[[Category:Logging]] | [[Category:Logging]] |
Revision as of 08:32, 27 February 2024
This article describes how to enable and collect logs from Zenitel IP Devices. The logs can be useful for debugging and troubleshooting purposes.
The logging feature is different in the INCA family. See bottom of article for details.
Advanced Configuration Mode must be enabled to access the Logging on the Zenitel IP stations |
Contents
Accessing the Logging page
- Log into the IP device
- Enable Advanced Configuration Mode
- Select Station Administration > Logging
Basic logging
Basic logging is always active. Press the Download Logs button to download the log files to the computer. The log files are in a compressed archive format with file extension .gz.
Detailed Logging
By enabling Detailed logging much more main application events are logged into log files. This is useful when deep-tracing for events that caused issues or for performance bottlenecks.
- Press Enable to start detailed logging.
- Note that the station will do a partial reboot as soon as the Enable button is pressed, and will be out of service for approx. 30 seconds
- When finished with the logging, press Disable to stop the logging
- Press the Download Logs button to download the log files to the computer. The log files are in a compressed archive format with file extension .gz.
Clear Main Logs/Clear All Logs: After having downloaded the log files, they can be deleted from the station to free up space.
Detailed Logging creates some log file(s) that might be read and understood by technicians. These log files are located in the ipst folder. The rest of the logs are meant for software developers. The logs in the "ipst" folder shows the communication between station and server (SIP or DIP protocol, depending on the mode of operation).
Tcpdump tool
- The Tcpdump tool is included as from firmware version 4.7, and is used for collecting all data traffic in and out from the station for the time period specified
- The log file will be on the format .pcap, which can be read by packet analyzing applications such as Wireshark.
- The Tcpdump timeout period can be set between 10 - 3600 seconds
- To start logging press Start tcpdump. The web page will count down the remaining time for the logging session
- You can stop the logging by pressing Stop tcpdump, or you can wait for the timeout period to expire
- When the logging is ended, you need to refresh the web page (e.g. press the menu "Station Administration" > "Logging"), and you will see a link to download the "tcpdump.pcap" file to your PC
- Maximum file size is 5MB. After having downloaded the file to your PC, you should Delete tcpdump file to free up space in the station memory
Syslog Settings
Syslog destination
Up to 3 different syslog server destinations can be configured, and reporting is done simultaneously for all configured destinations. A syslog destination is configured with following settings:
- Hostname: Remote syslog server IP address
- Port: Default is 514
- Protocol type: UDP (default) or TCP
Syslog facility and Log levels
A syslog facility is basically a source of the logging, or the type of the application (program) that is producing and sending log messages. Facilities are used so that logging servers can handle different facilities in different way. Turbine is using two different facilities:
- Application log (facility code 0): System level messages, same as "Detailed logging"
- Intercom log (facility code 1): User-level messages, related to SIP call events
The Priority Level is used to filter out log messages by severity level. The following severity levels are used:
- Warning
- Notice
- Info
- Debug
SIP Call events reported via the Intercom log:
- Warning: Registration lost
- Notice: No answer incoming or outgoing call
- Info: Registration successful
The server process which handles display of messages usually includes all lower (more severe) levels when display of less severe levels is requested. That is, if messages are separated by individual severity, a Warning level entry will also be included when filtering for Notice, Info and Debug messages.
An additional filter field "Contains" can be used to filter out log messages according to a given string input.
Logging in INCA stations
The INCA Stations provide log information when used in SIP or Pulse mode. When used in AlphaCom mode no log data is available.
- Log into the IP Station
- Select Station Administration > Logging
The web interface will show the last 150 lines of SIP related log data.