Monitoring Yate

Revision as of 16:12, 16 August 2013

This article shows the modules you need configured and loaded in order to monitor what happens in the server, especially when you have limited access to Yate (e.g. when Yate runs as daemon).

Meaning:

• Eventslog accessed from Rmanager
• SNMP data from Monitoring through YATE SNMP agent

Since you use or will use Yate, you'll need to check what happens inside the server at some point or another. The services Yate provides must be continuous, in order to avoid loss of calls or information (besides, who would want their lines to stop working right in the middle of a sales conference or a management meeting?).

Monitoring your system can be done in more ways than one, like many other things. This document reffers to the cases where your Yate runs as a daemon (for Linux users). This means that once it's started, you cannot communicate with it directly using a terminal.

The examples given in this document are from Mandriva 2010 spring OS, and Yate/YateClient 4.1.

What is monitoring

In this document, monitoring refers to using the two ways presented below in order to obtain running or debugging information as the system continues to run.
Of course, monitoring your software is quite a generic concept. Each Yate user has his/her own idea of what it means, depending of the existing configuration and the tools they prefer.
However, the basic notion of monitoring is that you follow what happens with your system in real time in order to debug or fix sometimes critical issues impending your activity.

Eventslog accessed from Rmanager

In order to monitor Yate through Eventslog, the following modules are needed:

   * eventlogs - found in /modules/server. Its configuration file is the eventlogs.conf, in the conf.d directory
   * rmanager - found in /modules. Its configuration file is rmanager.conf, also in conf.d. 

Eventlogs is a module that allows you to keep multiple logs when your Yate is daemonified, separated by specific criteria.

In order to load it when Yate starts you need to configure the eventlogs.conf from /conf.d directory. Here (eventlogs.conf) you set the path to the directory where you need the files to be created in, having log files depending of your specific configuration for creating them in the @@[mappings]@ section (e.g. linksets, trunks, links).

Now, in order to access the files while Yate is running, you need to use Rmanager, a module that makes possible the connection through Telnet to your Yate. The default configuration binds the localhost (127.0.0.1) and listens on port 5038 (you can change the configuration in rmanager.conf).

Type telnet 127.0.0.1 5038 in a terminal and this should follow:

[ana@localhost ~]$ telnet 127.0.0.1 5038
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
YATE 4.1.1-alpha1 (http://YATE.null.ro) ready on localhost.localdomain.

Let's say you want to check what modules are loaded. Modules list should do the trick:

module list 
lateroute*      ysnmpagent*     mgcpgw  monitoring*     cache   yradius   users*
pbxassist       heartbeat       analog  presence* park     callcounters    sipfeatures
accfile ysigchan        dbpbx     regfile register        mrcpspeech      queues* 
ccongestion       queuesnotify*   regexroute      wavefile        rmanager extmodule
ysipchan        ystunchan       h323chan        tonedetect        moh     callfork* 
pbx     yjinglechan     tonegen   ilbccodec*      yrtpchan        enumroute       analyzer
yiaxchan cdrbuild        callgen conference* isaccodec*      msgsniff  gvoice* dumbchan
filetransfer*   javascript*     openssl   cdrfile zlibcompress    ysockschan*     mux
subscription      cpuload sigtransport    ciscosm*        analogdetect    dbwave
mgcpca  clustering*     eventlogs       jabberserver jbfeatures

This way you can check if a module you need is loaded or not, you can restart it or stop it (depending on your needs). See here more on commands.

You can find out and ultimately control what happenned since Yate started. With logview /events log command all the messages from the point where Yate has started to present (so you can find out the uptime, for example).