Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
COMBO.CFG(5)		      File Formats Manual		  COMBO.CFG(5)

NAME
       combo.cfg - Configuration of combostatus	tool

SYNOPSIS
       $XYMONHOME/etc/combo.cfg

DESCRIPTION
       combostatus(1)	 uses	 it's	 own   configuration   file,   $XYMON-
       HOME/etc/combo.cfg Each line in this file defines a combined test.

FILE FORMAT
       Each line of the	file defines a new  combined  test.  Blank  lines  and
       lines  starting	with  a	 hash mark (#) are treated as comments and ig-
       nored.

       The configuration file uses the hostnames and testnames	that  are  al-
       ready  used in your Xymon hosts.cfg file. These are then	combined using
       normal logical operators	- "||" for "or", "&&" for "and"	etc.

       A simple	test - e.g. "Web1.http"	- results in  the  value  "1"  if  the
       "http"  test for	server "Web1" is green,	yellow or clear. It yields the
       value "0" if it is red, purple or blue.

       Apart from the logical operations, you can also do  integer  arithmetic
       and comparisons.	E.g. the following is valid:

       WebCluster.http = (Web1.http + Web2.http	+ Web3.http) >=	2

       This  test is green if two or more of the http tests for	Web1, Web2 and
       Web3 are	green.

       The full	range of operators are:

	       +      Add
	       -      Subtract
	       *      Multiply
	       /      Divide
	       %      Modulo
	       |      Bit-wise "or"
	       &      Bit-wise "and"
	       ||     Logical "or"
	       &&     Logical "and"
	       >      Greater than
	       <      Less than
	       >=     Greater than or equal
	       <=     Less than	or equal
	       ==     Equal

       There is	currently no support for a "not" operator. If you need it, use
       the transcription "(host.test ==	0)" instead of "!host.test".

       NB:  All	 operators have	EQUAL PRECEDENCE. If you need something	evalu-
       ated in a specific order, use parentheses to group the expressions  to-
       gether.

       If  the	expression comes out as	"0", the combined test goes red. If it
       comes out as non-zero, the combined test	is green.

       Note: If	the expression involves	hostnames with	a  character  that  is
       also  an	operator - e.g.	if you have a host "t1-router-newyork.foo.com"
       with a dash in the hostname - then the operator-character must  be  es-
       caped with a backslash '\' in the expression, or	it will	be interpreted
       as an operator.	E.g. like this:

	nyc.conn = (t1\-router\-nyc.conn || backup\-router\-nyc.conn)

EXAMPLE
       WebCluster.http = (Web1.http || Web2.http)
       AppSrvCluster.procs = (AppSrv1.conn && AppSrv1.procs) ||	 (AppSrv2.conn
       && AppSrv2.procs)
       Customer.cluster	= WebCluster.http && AppSrvCluster.procs

       The  first  line	defines	a new test, with hostname "WebCluster" and the
       columnname "http". It will be green if the  http	 test  on  either  the
       "Web1" or the "Web2" server is green.

       The  second  line  defines a "procs" test for the "AppSrvCluster" host.
       Each of the AppSrv1 and AppSrv2 hosts is	checked	for "conn" (ping)  and
       their  "procs" test. On each host, both of these	must be	green, but the
       combined	test is	green if that condition	is fulfilled on	 just  one  of
       the hosts.

       The  third  line	 uses the two first tests to build a "double combined"
       test, defining a	test that shows	the overall health of the system.

FILES
       $XYMONHOME/etc/combo.cfg

SEE ALSO
       combostatus(1)

Xymon			  Version 4.3.30:  4 Sep 2019		  COMBO.CFG(5)

NAME | SYNOPSIS | DESCRIPTION | FILE FORMAT | EXAMPLE | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=combo.cfg&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help