AudioCodes Syslog Viewer User Manual
User's Guide
AudioCodes Utilities for Session Border Controllers and Media Gateways
Syslog Viewer
Version 1.4 and Later
User's Guide Contents
Table of Contents
1 Introduction ......................................................................................................... 7
2 Installing Syslog Viewer ..................................................................................... 9
3 Configuring the Device for Syslog ................................................................... 11
4 Getting Started .................................................................................................. 13
4.1 Capturing Data ..................................................................................................... 14
4.1.1 Receiving Logs from Device's Web Interface ..........................................................16
4.2 Loading Files ........................................................................................................ 18
4.2.1 Supported File Formats ...........................................................................................18
4.3 Writing Logs to Disk .............................................................................................. 18
4.4 Searching for Strings ............................................................................................ 19
4.5 Editing a Line Entry .............................................................................................. 19
4.6 Filtering Logs ........................................................................................................ 19
4.7 Configuring Syslog Listener .................................................................................. 22
4.8 Using the Command Line ..................................................................................... 22
5 Analyzing Syslog Messages ............................................................................ 23
5.1 Syslog Message Types ........................................................................................ 23
5.1.1 SIP Call Session Logs .............................................................................................24
5.1.2 Board Logs ..............................................................................................................25
5.1.3 SNMP Alarms ..........................................................................................................26
6 Analyzing Calls with SIP Ladder (Call Flow) ................................................... 27
7 Configuring Display Settings ........................................................................... 31
7.1 Changing the Scroll Buffer Default ........................................................................ 31
7.2 Rotating Log Files ................................................................................................ 31
7.3 Freezing Display ................................................................................................... 31
7.4 Disabling Auto-Scroll ............................................................................................ 31
7.5 Saving Captured Buffer ........................................................................................ 32
7.6 Configuring External Editor ................................................................................... 32
7.7 Detecting Missing and Out-Of-Order Logs ............................................................ 32
7.8 Filtering Incoming Traffic ...................................................................................... 32
7.9 Coloring and Formatting ....................................................................................... 33
7.9.1 Saving Window Position ..........................................................................................35
7.9.2 Configuring Font Type .............................................................................................35
A Syslog Error Abbreviations .............................................................................. 37
B Message Severity Levels .................................................................................. 39
Version 1.40 3 Diagnostics and Analysis
Syslog Viewer
This page is intentionally left blank.
User's Guide 4 Document #: LTRT-40031
User's Guide Notices
Notice
Information contained in this document is believed to be accurate and reliable at the time of
printing. However, due to ongoing product improvements and revisions, AudioCodes cannot
guarantee accuracy of printed material after the Date Published nor can it accept responsibility
for errors or omissions. Updates to this document can be downloaded from
https://www.audiocodes.com/library/technical-documents.
This document is subject to change without notice.
Date Published: October-22-2020
WEEE EU Directive
Pursuant to the WEEE EU Directive, electronic and electrical waste must not be disposed of
with unsorted waste. Please contact your local recycling authority for disposal of this product.
Customer Support
Customer technical support and services are provided by AudioCodes or by an authorized
AudioCodes Service Partner. For more information on how to buy technical support for
AudioCodes products and for contact information, please visit our website at
https://www.audiocodes.com/services-support/maintenance-and-support.
Stay in the Loop with AudioCodes
Abbreviations and Terminology
Each abbreviation, unless widely used, is spelled out in full when first used.
Document Revision Record
LTRT Description
40030 Initial document release.
40031 Updated to Ver. 1.44. Note added to indicate no support by MP-1xx for “Receiving
Logs from Device's Web Interface”; Syslog format updated to indicate SID and BID
contains serial number instead of MAC for Mediant Software and 9000; installation
updated
Version 1.40 5 Diagnostics and Analysis
Syslog Viewer
Documentation Feedback
AudioCodes continually strives to produce high quality documentation. If you have any
comments (suggestions or errors) regarding this document, please fill out the Documentation
Feedback form on our website at https://online.audiocodes.com/documentation-feedback.
User's Guide 6 Document #: LTRT-40031
User's Guide 1. Introduction
1 Introduction
Syslog is an event notification protocol that enables a device to send event notification
messages across IP networks to event message collectors, also known as Syslog Servers
The device (SBC/GW) contains an embedded Syslog client, which sends error
reports/events that it generates to a remote Syslog server
This information is a collection of error, warning, and system messages that records every
internal operation of the device
AudioCodes Syslog Viewer utility can be used for the following major tasks:
Recording and displaying syslog messages from your AudioCodes device
Analyzing recorded logs (including support for interactive SIP ladder diagram)
This document describes how to install, setup, configure the use the Syslog Viewer. The
figure below illustrates the syslog deployment.
Figure 1-1: Syslog Monitoring
Version 1.40 7 Diagnostics and Analysis
Syslog Viewer
This page is intentionally left blank.
User's Guide 8 Document #: LTRT-40031
User's Guide 2. Installing Syslog Viewer
2 Installing Syslog Viewer
This section describes how to install the Syslog Viewer on your PC. Installation of Syslog
Viewer is performed on the computer that has access to the device.
To install Syslog Viewer:
1. Download the Syslog Viewer installation file from AudioCodes website at
https://www.audiocodes.com/library/firmware.
2. Click the downloaded .exe file; the installation wizard starts:
Figure 2-1: Syslog Viewer-Welcome Screen
3. Click Next; the following appears:
Figure 2-2: Select Destination Location
Version 1.40 9 Diagnostics and Analysis
Syslog Viewer
4. Select the location on your computer where you want to install Syslog Viewer, and then
click Next; the following appears:
Figure 2-3: Select Location of Shortcut Menu
5. Select where you want to add Syslog Viewer's shortcut menu, and then click Next; the
program starts to install. When installation completes, the following appears:
6. Click Finish; the main window of the Syslog Viewer is displayed. For a description of
the main areas of the window, see Section Getting Started.
User's Guide 10 Document #: LTRT-40031
User's Guide 3. Configuring the Device for Syslog
3 Configuring the Device for Syslog
Before you can start receiving any Syslog messages from the device, you need to configure
the device to send generated Syslog messages to the Syslog Viewer.
Enabling syslog on device:
1. Run the Syslog Viewer tool.
2. On the same computer, connect to the device's Web interface, and then log in using the
device's username-password credentials.
3. Open the Logging Settings page (Troubleshoot menu > Troubleshoot tab > Logging
folder > Logging Settings).
4. Configure the following parameters:
• From the 'Enable Syslog' drop-down list, select Enable.
• In the 'Syslog Server IP' field, enter the IP address of the computer where Syslog
Viewer is running.
• From the 'VoIP Debug Level' drop-down list, select Basic.
Figure 3-1: Enabling Syslog on Device
5. Click Apply, and then click Save to save your settings.
Version 1.40 11 Diagnostics and Analysis
Syslog Viewer
This page is intentionally left blank.
User's Guide 12 Document #: LTRT-40031
Loading...