Monitor your fax scheduler/queue with OpenSMART

Graphing your fax queue with MRTG for HylaFAX.

The OpenSMART Monitoring and Reporting Tool (see http://opensmart.sourceforge.net/) is able to monitor the HylaFAX scheduler/queue.

A HowTo for monitoring your HylaFAX server can be found at http://opensmart.sourceforge.net/docs/documentation/userguide/appmon_hylafax.html

Here is an example configuration part for the OpenSMART agent:

<!-- ... -->
<PROC>
  <PROCESS>
    <PROCNAME>faxq|hfaxd|faxgetty</PROCNAME>
    <NUMBER>3</NUMBER>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
    <DESCRIPTION>
      hylafax isn't running. You should restart hylafax with
      /etc/init.d/hylafax start (as root)
      <!-- The restart command depends on your system... -->
    </DESCRIPTION>
  </PROCESS>
  <!-- More processes you want to check -->
</PROC>

<SOCKETS>
  <CHECK4SOCKET>
    <!-- Maybe you have to define the right interface definition for
    your system -->
    <INTERFACE>:::</INTERFACE>
    <PORT>4559</PORT>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
    <DESCRIPTION>hylafax scheduler hasn't an opened socket on 4559</DESCRIPTION>
  </CHECK4SOCKET>
  <!-- More sockets you want to check -->
</SOCKETS>

<LOGS>
  <LOGFILE>
    <LOGFILENAME>/var/log/messages</LOGFILENAME>
    
    <!-- we want to filter all proper recieved/sended fax entries
    <LOGFILTER>
      <REGEX>FaxGetty\[\d+\]: RECV FAX \(\d+\): recvq/fax.*.tif from .*, route
 to unspecified, \d pages in \d:\d\d</REGEX>
      <REGEX>HylaFAX\[\d+\]: .* of .* \[.*\] deleted /recvq/fax.*.tif</REGEX>
      <REGEX>FaxGetty\[\d+\]: RECV FAX \(\d+\): from .*, page \d in \d:\d\d, INF, 3.85 line/mm, .*, 
.* bit/s</REGEX> <REGEX>FaxGetty\[\d+\]: RECV FAX: bin/faxrcvd "recvq/fax.*.tif" "ttyS1" ".*" ""</REGEX> </LOGFILTER> <LOGFILTER> <REGEX>.*</REGEX><!-- Everything unknown --> <PRIORITY>1000</PRIORITY> <!-- That is AFTER all default priorities! --> <ERRORLEVEL>WARNING</ERRORLEVEL> </LOGFILTER> </LOGFILE> <!-- More logs you want to check --> </LOGS> <DISK> <!-- We assume, /var/spool/hylafax is an own filesystem! --> <FS> <FSNAME>^/var/spool/hylafax$</FSNAME> <ERRORLEVEL>WARNING</ERRORLEVEL> <VALUE>80</VALUE> <DESCRIPTION>/var/spool/hylafax is getting full.</DESCRIPTION> </FS> <FS> <FSNAME>^/var/spool/hylafax$</FSNAME> <ERRORLEVEL>ERROR</ERRORLEVEL> <VALUE>95</VALUE> <DESCRIPTION>/var/spool/hylafax is full.</DESCRIPTION> </FS> <!-- More filesystems you want to check --> </DISK>