bionic (5) combo.cfg.5.gz

Provided by: xymon_4.3.28-3build1_amd64 bug

NAME

       combo.cfg - Configuration of combostatus tool

SYNOPSIS

       $XYMONHOME/etc/combo.cfg

DESCRIPTION

       combostatus(1)  uses it's own configuration file, $XYMONHOME/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 ignored.

       The  configuration  file  uses  the hostnames and testnames that are already 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 evaluated in a specific order, use
       parentheses to group the expressions together.

       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
       escaped  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)