Monitor your fax scheduler/queue with OpenSMART

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>