Xymon Mailing List Archive search

Default time to purple

list David Baldwin
Fri, 10 Jun 2011 09:00:27 +1000
Message-Id: <user-2579d081fe1e@xymon.invalid>

Ken,
What is the default time for a host to show purple for a test that has not run in a while....

Basically, I have a custom script I run in the background and update the bb-monitor (running v4.2.2)...I know if I run this test frequently everything will be green or ok, but its something I'd like to run only once or twice a day....
It depends what the LIFETIME is on the status message - default is 30
mins. If you have a custom script, should be changed to reflect
frequency test is run.

From the man page for xymon or bb:

http://www.xymon.com/xymon/help/manpages/man1/xymon.1.html

    XYMON MESSAGE SYNTAX

This section lists the most commonly used messages in the Xymon protocol.

Each message must begin with one of the Xymon commands. Where a
HOSTNAME is specified, it must have any dots in the hostname changed
to commas if the Xymon FQDN setting is enabled (which is the default).
So the host "www.foo.com <http://www.foo.com>";, for example, would
report as "www,foo,com".

status[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR <additional text>
    This sends in a status message for a single test (column) on a
    single host. TESTNAME is the name of the column where this test
    will show up; any name is valid except that using dots in the
    testname will not work. COLOR must be one of the valid colors:
    "green", "yellow", "red" or "clear". The colors "blue" and
    "purple" - although valid colors - should not be sent in a status
    message, as these are handled specially by the Xymon server. As a
    special case (for supporting older clients), "client" can be used
    as the name of the color. This causes the status message to be
    handled by Xymon as a "client" data message, and the TESTNAME
    parameter is used as the "collector id".
    The "additional text" normally includes a local timestamp and a
    summary of the test result on the first line. Any lines following
    the first one are free-form, and can include any information that
    may be useful to diagnose the problem being reported.
    The LIFETIME defines how long this status is valid after being
    received by the Xymon server. The default is 30 minutes, but you
    can set any period you like. E.g. for a custom test that runs once
    an hour, you will want to set this to at least 60 minutes -
    otherwise the status will go purple after 30 minutes. It is a good
    idea to set the LIFETIME to slightly longer than the interval
    between your tests, to allow for variations in the time it takes
    your test to complete. The LIFETIME is in minutes, unless you add
    an "h" (hours), "d" (days) or "w" (weeks) immediately after the
    number, e.g. "status+5h" for a status that is valid for 5 hours.
    The GROUP option is used to direct alerts from the status to a
    specific group. It is currently used for status generated from the
    Xymon clients' data, e.g. to direct alerts for a "procs" status to
    different people, depending on exactly which process is down.

-- 
David Baldwin - IT Unit
Australian Sports Commission          www.ausport.gov.au
Tel 02 62147830 Fax 02 62141830       PO Box 176 Belconnen ACT 2616
user-cbbf693f2c89@xymon.invalid          Leverrier Street Bruce ACT 2617


Keep up to date with what's happening in Australian sport visit http://www.ausport.gov.au

This message is intended for the addressee named and may contain confidential and privileged information. If you are not the intended recipient please note that any form of distribution, copying or use of this communication or the information in it is strictly prohibited and may be unlawful. If you receive this message in error, please delete it and notify the sender.