logfetch(1) [debian man page]

LOGFETCH(1)						      General Commands Manual						       LOGFETCH(1)

NAME

       logfetch - Xymon client data collector

SYNOPSIS

       logfetch CONFIGFILE STATUSFILE

DESCRIPTION

       logfetch  is part of the Xymon client. It is responsible for collecting data from logfiles, and other file-related data, which is then sent
       to the Xymon server for analysis.

       logfetch uses a configuration file, which is automatically retrieved from the Xymon server. There is no	configuration  done  locally.  The
       configuration  file is usually stored in the $BBHOME/tmp/logfetch.cfg file, but editing this file has no effect since it is re-written with
       data from the Xymon server each time the client runs.

       logfetch stores information about what parts of the monitored logfiles have been processed already in the $BBHOME/tmp/logfetch.status file.
       This file is an internal file used by logfetch, and should not be edited. If deleted, it will be re-created automatically.

SECURITY

       logfetch  needs	read access to the logfiles it should monitor. If you configure monitoring of files or directories through the "file:" and
       "dir:" entries in client-local.cfg(5) then logfetch will require at least read-acces to the directory where the file  is  located.  If  you
       request checksum calculation for a file, then it must be readable by the Xymon client user.

       Do  NOT	install  logfetch  as  suid-root. There is no way that logfetch can check whether the configuration file it uses has been tampered
       with, so installing logfetch with suid-root privileges could allow an attacker to read any file on the system by using a hand-crafted  con-
       figuration file. In fact, logfetch will attempt to remove its own suid-root setup if it detects that it has been installed suid-root.

ENVIRONMENT VARIABLES

       DU     Command  used  to collect information about the size of directories.  By default, this is the command du -k. If the local du-command
	      on the client does not recognize the "-k" option, you should set the DU environment  variable  in  the  $BBHOME/etc/hobbitclient.cfg
	      file to a command that does report directory sizes in kilobytes.

FILES

       $BBHOME/tmp/logfetch.cfg

       $BBHOME/tmp/logfetch.status

SEE ALSO

       xymon(7), hobbit-clients.cfg(5)

Xymon							    Version 4.2.3:  4 Feb 2009						       LOGFETCH(1)

HOBBITD_CLIENT(8)					      System Manager's Manual						 HOBBITD_CLIENT(8)

NAME

       hobbitd_client - hobbitd worker module for client data

SYNOPSIS

       hobbitd_channel --channel=client hobbitd_client [options]

DESCRIPTION

       hobbitd_client  is  a  worker  module  for  hobbitd, and as such it is normally run via the hobbitd_channel(8) program. It receives hobbitd
       client messages sent from systems that have the the Xymon client installed, and use the client data to generate the Xymon  status  messages
       for  the  cpu-,	disk-,	memory-  and  procs-columns.  It also feeds Xymon data messages with the netstat- and vmstat-data collected by the
       client.

       When generating these status messages from the client data, hobbitd_client  will  use  the  configuration  rules  defined  in  the  hobbit-
       clients.cfg(5) file to determine the color of each status message.

OPTIONS

       --clear-color=COLOR
	      Define  the  color  used	when  sending  "msgs",	"files" or "ports" reports and there are no rules to check for these statuses. The
	      default is to show a "clear" status, but some people prefer to have it "green".  If you would rather prefer not to see these  status
	      columns at all, then you can use the "--no-clear-msgs", "--no-clear-files" and "--no-clear-ports" options instead.

       --no-clear-msgs
	      If there are no logfile checks, the "msgs" column will show a "clear" status. If you would rather avoid having a "msgs" column, this
	      option causes hobbitd_client to not send in a clear "msgs" status.

       --no-clear-files
	      If there are no file checks, the "files" column will show a "clear" status. If you would rather avoid having a "files" column,  this
	      option causes hobbitd_client to not send in a clear "files" status.

       --no-clear-ports
	      If  there are no port checks, the "ports" column will show a "clear" status. If you would rather avoid having a "ports" column, this
	      option causes hobbitd_client to not send in a clear "ports" status.

       --no-ps-listing
	      Normally the "procs" status message includes the full process-listing received from the client. If you prefer to just have the moni-
	      tored processes shown, this option will turn off the full ps-listing.

       --no-port-listing
	      Normally the "ports" status message includes the full netstat-listing received from the client. If you prefer to just have the moni-
	      tored ports shown, this option will turn off the full netstat-listing.

       --config=FILENAME
	      Sets the filename for the hobbit-clients.cfg file. The default value is "etc/hobbit-clients.cfg" below the Xymon server directory.

       --dump-config
	      Dumps the configuration after parsing it. May be useful to track down problems with configuration file errors.

       --test Starts an interactive session where you can test the hobbit-clients.cfg configuration.

       --debug
	      Enable debugging output.

FILES

       ~xymon/server/etc/hobbit-clients.cfg

SEE ALSO

       hobbit-clients.cfg(5), hobbitd(8), hobbitd_channel(8), xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009						 HOBBITD_CLIENT(8)