Understanding Grandstream UCM Troubleshooting Tools and Syslog Modules

Grandstream UCM Syslog Modules for troubleshooting

Description

Grandstream UCM has built-in troubleshooting tools under the Maintenance tab. They are :

  1. SYSLOG
  2. Network Troubleshooting

Process Log & Syslog Level

Figure 1: Process Log in UCM Syslog

CDR API Log: Monitors processes related to CDR API configuration and function.

PBX MID Log: Monitors processes related to the CTI module. This includes CRM and PMS features, as well as web pages that use WebSocket to push statuses such as Dashboard, Active Calls, Extensions, CDR, Call Queue, Conference, Eventlist, HA, ZeroConfig, CRM, and PMS web pages.

Apply Change Log: Monitors “Apply Change” script status. This is related to the “Apply Change” function on the web UI.

CGI Log: Monitors processes related to the CGI module, which is used in all web page configurations.

Alert Log: Monitors processes for the Alert module, which is related to the System Events function.

ZeroConfig Log: Monitors processes related to the ZeroConfig module.

HA Log: Monitors processes related to the HA module.

Other Log: Monitors processes for services relying on Python script.


DTMF: Monitor all DTMF events such as feature code, IVR, and DISA.

CC: Monitor Busy Camp On/Call Completion service. This is related to CC configuration in extension configuration and VOIP trunk configuration.

FAX: This is related to FAX-related services.

SECURITY: Monitor Asterisk authentication-related services such as authentication for extension registration and trunk registration.


PBX Modules

Figure 2: PBX Modules have different levels: ALL, Error, Warning, Notice, Debug and Verbose.

AMI: This is to report Asterisk status.

Bridge: Mainly used for Conference room.

IO: Mainly used for Voice Prompt and IVR functionality.

JITTERBUFFER: Jitter buffer, which is the function that allows users to add a fixed or adaptive buffer in the dialplan to the read side of a channel.

PBX: Related to dial plan during call. This provides the core functionality of the system such as loading the Asterisk dialplan and looking up data on remote Asterisk systems.

Channel: This is the abstract concept of channel. Each calling party has a channel.

DSP: Track SVIP related issues (such as audio/video RTP related processing).

CDR: CDR related services.

chan_XXX: This is the specific channel that drives different protocols and channel types (SIP, PSTN and etc). For example, FXS/FXO/E1/T1 use chan_dahdi; PSTN auto detection in analog trunk use chan_autodetect.

app_XXX: Dialplan application that provides various features related to calls such as voicemail, DISA, Fax and etc. For example, app_queue is for Call Queue; app_voicemail is for voicemail; app_disa is for DISA; app_followme is for FOLLOWME.

func_XXX: Dialplan function.

codec_XXX: Codec-related functions that allow Asterisk to encode and decode different audio formats.

res_XXX: The third-party library used by Asterisk. Resource modules provide connections to 3rd party repositories and libraries that hold specific information.

loader: This is related to loading other modules.

pjsip: This is related to PJSIP (SIP). This is the open-source embedded SIP protocol stack that is essential to Asterisk functionality and operations. It provides many SIP features.

Logger: Asterisk logging module.


Network Troubleshooting

Ethernet Capture is required for SIP-related. Make sure the correct Interface Type is selected based on the UCM network type and issue scenario.

Figure 3: Ethernet Capture is required for issues related to SIP.

Issues and Troubleshooting

Figure 4 shows how we enable the logging and replicate the issue.

Steps

  1. Go to Maintenance > Syslog > click Clean
  2. Select the relevant PBX Modules or Process Log for your issue
  3. Click Save and replicate your issue
  4. Click Download
  5. Unzip the file, open and verify it with Notepad++

For the audio issue

we need ALL LEVEL of PJSIP, PBX, RTP, and AVS PBX Modules.


Leave a Comment