xymon - Интернет в облаке

ПРОГРАММА:

ИМЯ

xymon - программа взаимодействия с клиентом Xymon

СИНТАКСИС

ксимон [опции] ПОЛУЧАТЕЛЬ сообщение

ОПИСАНИЕ

ксимон(1) это клиентская программа, используемая для связи с сервером Xymon. Часто бывает
используется клиентскими системами Xymon для отправки статусных сообщений и пейджинговых предупреждений о локальных тестах.

В Xymon программа xymon также используется в административных целях, например, для переименования или
удалить хосты или отключить хосты, которые не работают в течение более длительных периодов времени.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ И ПАРАМЕТРЫ

--отлаживать
Включите отладку. Это распечатает подробную информацию о том, как подключение к Xymon
сервер устанавливается.

--proxy =http://PROXYSERVER:ПОРТ ПРОКСИ/
При отправке статусных сообщений через HTTP используйте этот сервер как HTTP-прокси.
подключения напрямую к серверу Xymon.

--timeout = N
Указывает время ожидания для подключения к серверу Xymon в секундах. По умолчанию
составляет 5 секунд.

--отклик
Утилита xymon обычно знает, когда ожидать ответа от сервера, поэтому это
опция не требуется. Однако это приведет к тому, что любой ответ от сервера будет
отображается.

- объединить
Объедините текст сообщения командной строки с данными, предоставленными на стандартном вводе, и
отправить результат на сервер Xymon. Текст сообщения в командной строке
становится первой строкой объединенного сообщения.

ПОЛУЧАТЕЛЬ
Ассоциация ПОЛУЧАТЕЛЬ Параметр определяет, какой сервер получает сообщение. Если ПОЛУЧАТЕЛЬ
задано как "0.0.0.0", то сообщение отправляется на все серверы, перечисленные в
Переменная среды XYMSERVERS.

Обычно клиент использует "$ XYMSRV" для ПОЛУЧАТЕЛЬ параметр, так как это
определен для клиентских сценариев, чтобы они автоматически содержали правильное значение.

Ассоциация ПОЛУЧАТЕЛЬ параметр может быть URL-адресом веб-сервера, имеющего xymoncgimsg.cgi
или подобный скрипт установлен. Это туннелирует сообщения Xymon на сервер Xymon.
используя стандартный протокол HTTP. В xymoncgimsg.cgi(8) Инструмент CGI (включен в Xymon)
должен быть установлен на веб-сервере для работы транспорта HTTP.

СООБЩЕНИЕ
Ассоциация сообщение Параметр - это сообщение, которое будет отправлено на сервер Xymon.
Сообщения должны быть заключены в кавычки, но при этом они могут занимать несколько строк.
Максимальный размер сообщения определяется максимально допустимой длиной вашего
командной строки оболочки и обычно составляет 8-32 КБ.

Если вам нужно отправлять более длинные сообщения о состоянии, вы можете указать «@» в качестве сообщения:
После этого xymon прочитает статусное сообщение со своего стандартного ввода.

КСИМОН СООБЩЕНИЕ СИНТАКСИС

В этом разделе перечислены наиболее часто используемые сообщения в протоколе Xymon.

Каждое сообщение должно начинаться с одной из команд Xymon. Если указано HOSTNAME, оно
в имени хоста должны быть любые точки, замененные на запятые, если включен параметр Xymon FQDN.
(что по умолчанию). Таким образом, хост www.foo.com, например, будет сообщать как
"www, foo, com".

статус [+ LIFETIME] [/ group: GROUP] HOSTNAME.TESTNAME COLOR
Это отправляет сообщение о состоянии для одного теста (столбца) на одном хосте.
TESTNAME - это имя столбца, в котором будет отображаться этот тест; любое имя действительно
за исключением того, что использование точек в имени теста не сработает. ЦВЕТ должен быть одним из
допустимые цвета: «зеленый», «желтый», «красный» или «прозрачный». Цвета «синий» и «фиолетовый»
- хотя и допустимые цвета - не должны отправляться в статусном сообщении, так как они
обрабатывается специально сервером Xymon. Как особый случай (для поддержки пожилых
клиенты), «клиент» может использоваться как название цвета. Это вызывает статус
сообщение, которое Xymon будет обрабатывать как "клиентское" сообщение данных, а TESTNAME
Параметр используется как "идентификатор сборщика".
«Дополнительный текст» обычно включает местную метку времени и краткое изложение теста.
результат на первой строке. Любые строки, следующие за первой, имеют произвольную форму и могут
включите любую информацию, которая может быть полезна для диагностики сообщаемой проблемы.
LIFETIME определяет, как долго этот статус действителен после получения
Сервер Xymon. По умолчанию 30 минут, но вы можете установить любой период, который вам нравится. Например
для пользовательского теста, который запускается один раз в час, вам нужно установить это значение как минимум 60
минут - иначе через 30 минут статус станет фиолетовым. Это хорошая идея
чтобы установить LIFETIME немного больше, чем интервал между вашими тестами, чтобы
учитывайте разницу во времени, необходимом для выполнения вашего теста. ВРЕМЯ ЖИЗНИ в
минут, если вы не добавите "h" (часы), "d" (дни) или "w" (недели) сразу после
число, например "status + 5h" для статуса, действительного в течение 5 часов.
Параметр ГРУППА используется для направления предупреждений из статуса в определенную группу. Это
в настоящее время используется для статуса, сгенерированного из данных клиентов Xymon, например, для направления
оповещения о статусе «процесса» для разных людей, в зависимости от того, какой именно процесс
не работает.

уведомить HOSTNAME.TESTNAME
Это инициирует отправку информационного сообщения тем, кто получает предупреждения для
эта комбинация HOSTNAME + TESTNAME, в соответствии с правилами, определенными в оповещения.cfg(5)
Это используется enadis.cgi(1) инструмент для уведомления людей об отключении хостов
или включен, но также может служить в качестве общего способа уведомления администраторов сервера.

данные HOSTNAME.DATANAME
Сообщение "данные" позволяет инструментам отправлять данные о хосте, не отображая его как
столбец на веб-страницах Xymon. Это используется, например, для отчета по статистике.
о хосте, например данные vmstat, которые сами по себе не представляют что-то, что
имеет красный, желтый или зеленый цвет. Он используется модулями нижнего фидера RRD, в том числе
другие. В Xymon сообщения с данными по умолчанию обрабатываются только xymond_rrd(8)
модуль. Если вы хотите обрабатывать сообщения с данными с помощью внешнего приложения, вы можете
хочу включить xymond_filestore(8) модуль данных-сообщений, для хранения данных-
сообщения в формате, совместимом с тем, как это делает демон Большого Брата.

отключить HOSTNAME.TESTNAME DURATION
Отключает определенный тест на DURATION мин. Это вызовет статус этого
test будет отображаться как «синий» на сервере Xymon, и никаких предупреждений для этого хоста / теста
будет сгенерирован. Если DURATION указывается в виде числа, за которым следует s / m / h / d, то это
интерпретируется как в секундах / минутах / часах / днях соответственно. Чтобы отключить
тестируйте, пока не станет ОК, используйте «-1» в качестве ДЛИТЕЛЬНОСТИ. Чтобы отключить все тесты для
host, используйте звездочку "*" для TESTNAME.

включить HOSTNAME.TESTNAME
Повторно включает тест, который был отключен.

запрос HOSTNAME.TESTNAME
Запросите сервер Xymon о последнем состоянии, сообщенном для этого конкретного теста. Если
статус хоста / теста известен, ответ - первая строка отчета о статусе
- текущий цвет будет первым словом в строке. Дополнительные строки текста
которые могут присутствовать в статусном сообщении, не могут быть получены.
Это позволяет любому клиенту Xymon определять статус конкретного теста, независимо от того,
это тот, который относится к хосту, на котором работает клиент, другому хосту или
возможно, результат комбинированного теста с нескольких хостов, управляемых комбинированный статус(1)
Обычно это полезно для сценариев клиентских расширений Xymon, которым необходимо
определить статус других хостов, например, чтобы решить, будет ли автоматический
действие по восстановлению должно быть инициировано.

КОНФИГУРАЦИЯ ИМЯ ФАЙЛА
Получите один из файлов конфигурации Xymon с сервера. Эта команда позволяет
клиент для извлечения файлов из каталога $ XYMONHOME / etc / на сервере, что позволяет
для полуавтоматического обновления конфигурации клиента. Поскольку конфигурация
файлы предназначены для того, чтобы иметь общий файл для конфигурации всех хостов в
система - и это фактически рекомендуемый способ настройки ваших клиентов - это
упрощает синхронизацию файлов конфигурации.

удалить HOSTNAME
Удаляет все данные, хранящиеся о хосте HOSTNAME. Предполагается, что у вас есть
уже удалил хост из файла конфигурации hosts.cfg.

отбросить HOSTNAME TESTNAME
Удалить данные об одном тесте (столбец).

переименовать OLDHOSTNAME NEWHOSTNAME
Переименуйте все данные для хоста, имя которого было изменено. Вы должны сделать это после
изменение имени хоста в файле конфигурации hosts.cfg.

переименовать HOSTNAME OLDTESTNAME NEWTESTNAME
Переименовать данные об одном тесте (столбце).

xymondlog ИМЯ ХОСТА.ИМЯ ТЕСТА
Получите журнал состояния Xymon для одного теста. Первая строка ответа
содержит ряд полей, разделенных вертикальной чертой:

хоста Имя хозяина

имя теста Название теста

цвет Цвет состояния (зеленый, желтый, красный, синий, прозрачный, фиолетовый)

тестовые флаги Для сетевых тестов флаги, указывающие подробную информацию о тесте (используются
ксимонген).

последнее изменение Отметка времени Unix, когда цвет состояния в последний раз менялся.

время журнала Отметка времени Unix, когда было получено сообщение журнала.

действительное время Отметка времени Unix, когда сообщение журнала больше не является действительным (оно становится фиолетовым в
этот раз).

время Либо -1, либо временная метка Unix по истечении активного подтверждения.

время отключения Либо -1, либо временная метка Unix, когда статус больше не отключен.

отправитель IP-адрес, с которого был получен статус.

печенье Либо -1, либо значение cookie, используемое для подтверждения предупреждения.

подтверждение Пусто или сообщение подтверждения, отправленное при подтверждении статуса.
Новая строка, вертикальная черта и обратная косая черта экранируются обратной косой чертой в стиле C.

Dismsg Пусто или сообщение, отправленное, когда статус был отключен. Новая строка, знаки трубы
и обратная косая черта экранируется обратной косой чертой в стиле C.

После первой строки идет полный журнал статуса в текстовом формате.

xymondxlog ИМЯ ХОСТА.ИМЯ ТЕСТА
Извлекает строку XML, содержащую журнал состояния, как с командой «xymondlog».

ксимондон [CRITERIA] [fields = FIELDLIST]
Получает сводку состояния всех известных тестов, доступных для демона Xymon.

По умолчанию - если КРИТЕРИИ не указаны - возвращает одну строку для всех статусов.
сообщения, которые находятся в Xymon. Вы можете отфильтровать ответ по выбранному
страница, хост, тест, цвет или другие поля. PAGEPATH, NETWORK, HOSTNAME,
Параметры TESTNAME и * MSG интерпретируются регулярными выражениями, совместимыми с Perl;
параметр COLOR принимает несколько цветов, разделенных запятыми; значения * TIME
принимать временные метки эпохи unix. Другие переменные, указанные в ксимон-xmh(5) может также
использоваться.

Поскольку фильтрация хоста выполняется перед тестовой фильтрацией, она более эффективна (с
очень большие наборы данных) для использования PAGEPATH, HOSTNAME, NETWORK и других фильтров XMH_
по возможности перед глобальной фильтрацией с помощью COLOR, * MSG, * TIME или TESTNAME.

Вы можете фильтровать, например, и имя хоста, и имя теста.

page = PAGEPATH Включайте только тесты с хостов, найденных на странице PAGEPATH в
файл hosts.cfg.

net = СЕТЬ Включать только тесты с хостов с этим тегом NET:

ip = IPАдрес Включить только тесты от хостов с этим IP-адресом. Это регулярное выражение,
не CIDR.

host = HOSTNAME Включить только тесты с хоста HOSTNAME

test = ИМЯ ТЕСТА Включать только тесты с именем TESTNAME

color = COLORNAME Включать только те тесты, цвет статуса которых - COLORNAME

tag = TAGNAME Включать только хосты с определенным тегом, указанным в хосты.cfg(5)
линия. Обратите внимание, что сюда включены только элементы, известные компонентам xymon; произвольный
текст не включен

XMH_string = ЗНАЧЕНИЕ Включать только хосты с ксимон-xmh(5) переменная, соответствующая этому
ценностное

Расширенная фильтрация

msg = СООБЩЕНИЕ Включайте только тесты с полным содержанием, совпадающим с MESSAGE. Используйте "\ s" для
escape-пробелы (или другие строки PCRE)

ackmsg = СООБЩЕНИЕ Включайте только тесты с подтверждением (-ями) СООБЩЕНИЕ. Используйте "\ s" для
escape-пробелы (или другие строки PCRE)

dismsg = СООБЩЕНИЕ Включать только тесты, которые были отключены с сопоставлением строк
СООБЩЕНИЕ. Используйте «\ s» для экранирования пробелов (или других строк PCRE). (Это наиболее эффективно
чтобы соединить это с цветом = синий.)

Фильтры отметок времени

Некоторые поля (объясненные ниже) могут быть отфильтрованы с помощью временных меток unix и
следующие неравенства:> => <= <=! =

Эти фильтры: lastchange, logtime, validtime, acktime, disabletime.

Ответ представляет собой одну строку для каждого статуса, соответствующего КРИТЕРИЯМ, или всем статусам.
если критерии не указаны. Строка состоит из нескольких полей, разделенных
трубкой. Вы можете выбрать поля для извлечения, перечислив их в
СПИСОК ПОЛЕЙ. Доступны следующие поля:

хоста Имя хозяина

имя теста Название теста

цвет Цвет состояния (зеленый, желтый, красный, синий, прозрачный, фиолетовый)

Флаги Для сетевых тестов флаги, указывающие подробную информацию о тесте (используются
ксимонген).

последнее изменение Отметка времени Unix, когда цвет состояния в последний раз менялся.

время журнала Отметка времени Unix, когда было получено сообщение журнала.

действительное время Отметка времени Unix, когда сообщение журнала больше не является действительным (оно становится фиолетовым в
этот раз).

время Либо -1, либо временная метка Unix по истечении активного подтверждения.

время отключения Либо -1, либо временная метка Unix, когда статус больше не отключен.

отправитель IP-адрес, с которого был получен статус.

печенье Либо -1, либо значение cookie, используемое для подтверждения предупреждения.

line1 Первая строка журнала состояний.

подтверждение Пусто (если нет активных подтверждений), или текст подтверждения
сообщение.

Dismsg Пусто (если статус включен) или текст отключения
сообщение.

MSG Полный текст сообщения о текущем статусе.

клиент Показывает «Y», если данные клиента доступны, «N» - если нет.

clntstamp Отметка времени, когда было получено последнее клиентское сообщение, в Unix "эпоха"
формат.

список Список текущих благодарностей за тест. Это текстовая строка с
несколько полей, разделенных двоеточием. Есть 5 полей: Отметка времени для
когда было сгенерировано подтверждение и когда истечет срок его действия; «уровень подтверждения»; пользователь, который
отправил подтверждение; и текст подтверждения.

откидная информация Сообщает, колеблется ли статус. 5 полей, разделенных "/": "0", если
статус не махает и "1" если махает; отметка времени, когда последний статус
изменение было записано и когда было зарегистрировано первое изменение статуса; и два
цвета, между которыми колеблется статус.

Статистика Количество изменений статуса, которые были зарегистрированы для этого статуса с момента xymond
был начат.

модификаторы Перечисляет все активные модификаторы для этого статуса (т. Е. Обновления, отправленные с использованием
команда "изменить").

XMH_ * XMH-теги относятся к Xymon хосты.cfg(5) параметры конфигурации. Полный
их список можно найти в ксимон-xmh(5) справочная страница.

В полях ackmsg, dismsg и msg закодированы определенные символы: Новая строка - "\ n",
TAB - это «\ t», возврат каретки - «\ r», вертикальная черта - «\ p» и обратная косая черта - «\\».

Если параметр "fields" опущен, набор по умолчанию
hostname, testname, color, flags, lastchange, logtime, validtime, acktime, disabletime, sender, cookie, line1
используется.

Ксимондксборд
Извлекает строку XML со сводкой всех журналов состояния для
Команда "xymondboard".

hostinfo [КРИТЕРИИ]
Получает текущую конфигурацию хоста (т. Е. хосты.cfg(5) определение).
КРИТЕРИИ выбирает, о каких хостах следует сообщить, и идентичны КРИТЕРИЯМ в
команда xymondboard.

Ответ представляет собой одну строку для каждого хоста, который соответствует КРИТЕРИЯМ, или для всех хостов, если
критерии не указаны. Строка состоит из нескольких полей, разделенных знаком
трубка-вывеска. Первые два поля всегда будут именем хоста и IP-адресом.
Остальные поля - если есть - являются тегами hosts.cfg в произвольном порядке.

скачать FILENAME
Загрузите файл из каталога загрузки сервера Xymon.

клиент [/ COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Используется для отправки «клиентского» сообщения на сервер Xymon. Клиентские сообщения генерируются
клиентом Xymon; при отправке на сервер Xymon они сравниваются с
правила в анализ.cfg(5) файл конфигурации, и сообщения о состоянии генерируются
для клиентских тестов. COLLECTORID используется при отправке клиентских данных, которые
являются дополнением к стандартным данным клиента. Данные будут объединены с
нормальные данные клиента.

clientlog HOSTNAME [раздел = SECTIONNAME [, SECTIONNAME ...]]
Извлекает текущее необработанное клиентское сообщение, последнее отправленное HOSTNAME. Необязательный
Фильтр «раздел» используется для выбора определенных разделов данных клиента.

ping Пытается связаться с сервером Xymon. В случае успеха идентификатор версии сервера Xymon будет
сообщается.

тянутьклиент
Это сообщение используется при получении данных о клиенте с помощью реализованного механизма «вытягивания».
by ксимонфетч(8) и кэш сообщений(8) для клиентов, которые не могут подключиться напрямую к
Сервер Xymon.

список призраков
Сообщить список призрак клиенты, которых видит сервер Xymon. Призраки - это системы, которые
передавать данные на сервер Xymon, но они не указаны в файле hosts.cfg.

расписание [TIMESTAMP COMMAND]
Планирует команду, отправленную на сервер Xymon, для выполнения в более позднее время. Например
используется для планирования отключения хоста или службы в будущем. КОМАНДА
- это полная команда Xymon, подобная перечисленным выше. TIMESTAMP - это Unix
эпоха, когда будет выполнена команда.
Если параметры не указаны, текущие запланированные задачи перечислены в
отклик. Ответ представляет собой одну строку для каждой запланированной команды с идентификатором задания,
время выполнения команды, IP-адрес, с которого она была отправлена,
и полную командную строку.
Чтобы отменить ранее запланированную команду, "расписание отменить JOBID " может быть использован.
JOBID - это число, указанное в качестве первого элемента в выходных данных списка расписания.

отмечает FILENAME
Текст сообщения будет сохранен в $ XYMONHOME / notes / FILENAME, который затем будет использоваться как
гиперссылки из имен хостов или имен столбцов. Для этого необходимо, чтобы задача "Storenotes"
включен в tasks.cfg (по умолчанию отключен). FILENAME не может содержать
путь к каталогу - они удаляются автоматически.

идентификатор пользователя
Эти сообщения будут передаваться непосредственно модулям, слушающим "пользовательский" канал.
демона Xymon. Это предназначено для настраиваемой связи между клиентской стороной
модули и сервер Xymon.

изменить HOSTNAME.TESTNAME ЦВЕТ ИСТОЧНИК ПРИЧИНА
Изменение цвета определенного статуса без создания полного статуса
сообщение. Это для внутренних процессоров (например, графиков RRD), которые могут переопределить
цвет статуса на основе некоторых критериев, определенных вне нормального потока
положение дел. Например, нормальный статус "conn" может показаться зеленым, поскольку он просто проверяет
от того, можно ли пропинговать хост или нет; обработчик RRD может затем использовать "изменить"
команда для отмены этого фактического времени отклика ping превышает заданный порог.
(См. Настройку конфигурации «DS» в анализ.cfg(5) как это сделать). ИСТОЧНИК
это некоторая идентификация модуля, который генерирует сообщение "изменить" - будущее
модификации должны использовать один и тот же источник. Может быть несколько источников, которые изменяют
тот же статус (наиболее серьезный статус становится фактическим цветом
положение дел). ПРИЧИНА - это однострочная текстовая строка, объясняющая причину переопределения
нормальный цвет статуса - он будет отображаться на странице статуса.

ПРИМЕР

Отправьте обычное сообщение о состоянии на сервер Xymon, используя стандартный протокол Xymon по TCP.
порт 1984:
$ $ XYMON $ XYMSRV "status www, foo, com.http green` date` Web OK "

Отправить такое же сообщение о состоянии, но с использованием протокола HTTP через xymoncgimsg.cgi веб-сервера.
сценарий:
$ XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "статус www, foo, com.http зеленый
`date` Web OK"

Используйте сообщение «запрос», чтобы определить цвет теста «www», и перезапустите Apache, если он
красный:

$ WWW = `$ XYMON $ XYMSRV" запрос www, foo, com.www "| awk '{print $ 1}' `
$ if ["$ WWW" = "красный"]; затем перезапустите /etc/init.d/apache; фи

Используйте сообщение "config", чтобы обновить локальный файл mytest.cfg (но только если мы получим ответ):

$ $ XYMON $ XYMSRV "config mytest.cfg"> /tmp/mytest.cfg.new
$ if [-s /tmp/mytest.cfg.new]; тогда
mv /tmp/mytest.cfg.new $ XYMONHOME / etc / mytest.cfg
fi

Отправьте очень большое сообщение о статусе, которое было встроено в файл «statusmsg.txt». Вместо
чтобы предоставить его в командной строке, передайте его через stdin команде xymon:

$ cat statusmsg.txt | $ XYMON $ XYMSRV "@"

Используйте xymon онлайн с помощью сервисов onworks.net