xymon - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

xymon - програма спілкування з клієнтом Xymon

СИНТАКСИС

xymon [параметри] ОТРИМАЧ повідомлення

ОПИС

xymon(1) це клієнтська програма, яка використовується для зв’язку з сервером Xymon. Це часто
використовується клієнтськими системами Xymon для надсилання повідомлень про статус і сповіщень пейджера під час локальних тестів.

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

ВАРІАНТИ І ПАРАМЕТРИ

--відлагоджувати
Увімкнути налагодження. Це роздрукує деталі про те, як під’єднатися до Xymon
сервер встановлюється.

--проксі=http://PROXYSERVER:PROXYPORT/
Під час надсилання повідомлень про статус через HTTP використовуйте цей сервер як HTTP-проксі
підключення безпосередньо до сервера Xymon.

--тайм-аут=N
Вказує час очікування підключення до сервера Xymon в секундах. За замовчуванням
становить 5 секунд.

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

-- об'єднати
Об’єднайте текст повідомлення командного рядка з даними, наданими стандартним введенням, і
надіслати результат на сервер Xymon. Текст повідомлення, наданий у командному рядку
стає першим рядком об’єднаного повідомлення.

ОТРИМАЧ
Команда ОТРИМАЧ Параметр визначає, який сервер отримує повідомлення. Якщо ОТРИМАЦЬ
задано як "0.0.0.0", то повідомлення надсилається на всі сервери, перелічені в
Змінна середовища XYMSERVERS.

Зазвичай клієнт використовує "$XYMSRV" для ОТРИМАЧ параметр, як це
визначено, щоб клієнтські сценарії автоматично містили правильне значення.

Команда ОТРИМАЧ Параметр може бути URL-адресою веб-сервера, який має xymoncgimsg.cgi
або встановлено подібний скрипт. Це тунелює повідомлення Xymon на сервер Xymon
за допомогою стандартного протоколу HTTP. The xymoncgimsg.cgi(8) Інструмент CGI (входить до Xymon)
для роботи HTTP-транспорту необхідно встановити на веб-сервері.

З
Команда повідомлення Параметр – це повідомлення, яке буде надіслано на сервер Xymon.
Повідомлення мають бути взяті в лапки, але при цьому вони можуть охоплювати кілька рядків.
Максимальний розмір повідомлення визначається максимально дозволеною довжиною вашого повідомлення
командного рядка оболонки і зазвичай становить 8-32 КБ.

Якщо вам потрібно надіслати довші повідомлення про статус, ви можете вказати «@» як повідомлення:
xymon потім прочитає повідомлення про стан зі свого стандартного коду.

КСИМОН З СИНТАКС

У цьому розділі наведено список найбільш часто використовуваних повідомлень у протоколі Xymon.

Кожне повідомлення має починатися з однієї з команд Xymon. Там, де вказано HOSTNAME, це
повинні мати будь-які точки в імені хоста, змінені на коми, якщо ввімкнено налаштування Xymon FQDN
(що є за замовчуванням). Таким чином, хост "www.foo.com", наприклад, буде звітувати як
«www,foo,com».

status[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR
Це надсилає повідомлення про стан для одного тесту (стовпця) на одному хості.
TESTNAME — ім'я стовпця, де відображатиметься цей тест; будь-яка назва дійсна
за винятком того, що використання крапок у імені тесту не працюватиме. КОЛІР має бути одним із
дійсні кольори: «зелений», «жовтий», «червоний» або «прозорий». Кольори «блакитний» і «фіолетовий»
– хоча кольори дійсні – не слід надсилати у повідомленні про статус, оскільки вони є
обробляється спеціально сервером Xymon. Як окремий випадок (для підтримки старших
clients), «клієнт» можна використовувати як назву кольору. Це викликає статус
повідомлення, яке Xymon обробляє як повідомлення даних "клієнта", і TESTNAME
Параметр використовується як «ідентифікатор збирача».
«Додатковий текст» зазвичай включає локальну позначку часу та короткий зміст тесту
результат у першому рядку. Будь-які рядки, наступні за першим, є довільною формою і можуть
включити будь-яку інформацію, яка може бути корисною для діагностики проблеми, про яку повідомляється.
LIFETIME визначає, як довго цей статус дійсний після отримання
Сервер Xymon. За замовчуванням — 30 хвилин, але ви можете встановити будь-який період, який вам подобається. напр
для спеціального тесту, який виконується раз на годину, вам потрібно встановити принаймні 60
хвилин - інакше через 30 хвилин статус стане фіолетовим. Це гарна ідея
щоб встановити LIFETIME на трохи більше, ніж інтервал між тестами, до
враховуйте варіації часу, необхідного для виконання тесту. ЧАС ЖИТТЯ настав
хвилин, якщо ви не додасте "h" (години), "d" (дні) або "w" (тижні) відразу після
номер, наприклад "статус+5год" для статусу, який діє протягом 5 годин.
Параметр GROUP використовується для перенаправлення сповіщень зі статусу до певної групи. Це
наразі використовується для статусу, створеного з даних клієнтів Xymon, наприклад, для напряму
сповіщення про статус "procs" для різних людей, залежно від того, який саме процес
знаходиться внизу.

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

дані HOSTNAME.DATANAME
Повідомлення "дані" дозволяє інструментам надсилати дані про хост, не відображаючись як
колонка на веб-сторінках Xymon. Це використовується, наприклад, для звітування статистичних даних
про хост, наприклад дані vmstat, які самі по собі не представляють щось таке
має червоний, жовтий або зелений колір. Використовується модулями нижнього живильника RRD, серед
інші. У Xymon повідомлення даних за замовчуванням обробляються тільки xymond_rrd(8)
модуль. Якщо ви хочете обробляти повідомлення з даними за допомогою зовнішньої програми, ви можете
хочуть увімкнути xymond_filestore(8) модуль для даних-повідомлень, для зберігання даних-
повідомлення у форматі, сумісному з тим, як працює демон Big Brother.

вимкнути HOSTNAME.TESTNAME DURATION
Вимикає певний тест на DURATION хвилин. Це спричинить статус цього
тест відображатиметься як "блакитний" на сервері Xymon і не буде сповіщень для цього хоста/тесту
буде створено. Якщо ТРІВНІСТЬ вказано числом, за яким слідують с/м/год/д, це так
інтерпретується як у секундах/хвилинах/годинах/днях відповідно. Щоб вимкнути a
перевірте, поки не стане нормально, використовуйте "-1" як ТРИВАЛІВ. Щоб вимкнути всі тести для a
хост, використовуйте зірочку "*" для TESTNAME.

увімкнути HOSTNAME.TESTNAME
Повторно вмикає тест, який було вимкнено.

запит HOSTNAME.TESTNAME
Запит на сервер Xymon щодо останнього статусу, повідомленого для цього конкретного тесту. Якщо
статус хоста/тесту відомий, відповідь – це перший рядок звіту про стан
- поточний колір буде першим словом у рядку. Додаткові рядки тексту
які можуть бути присутніми в повідомленні про статус, не можна отримати.
Це дозволяє будь-якому клієнту Xymon визначати статус конкретного тесту
це той, що відноситься до хоста, на якому працює клієнт, іншого хоста або
можливо, результат комбінованого тесту з кількох хостів, якими керує комбостатус(1)
Зазвичай це буде корисно для сценаріїв розширення клієнта Xymon, які потребують
визначити статус інших хостів, наприклад, щоб вирішити, чи є автоматичним
слід розпочати відновлювальні заходи.

config FILENAME
Отримайте один із файлів конфігурації Xymon із сервера. Ця команда дозволяє
клієнт для отримання файлів із каталогу $XYMONHOME/etc/ на сервері, що дозволяє
для напівавтоматичного оновлення конфігурації клієнта. Оскільки конфігурація
файли розроблені так, щоб мати загальний файл для конфігурації всіх хостів у
система - і це насправді рекомендований спосіб налаштування ваших клієнтів - це
полегшує синхронізацію файлів конфігурації.

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

скиньте HOSTNAME TESTNAME
Видалити дані про один тест (стовпець).

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

перейменувати HOSTNAME OLDTESTNAME NEWTESTNAME
Перейменувати дані про один тест (стовпець).

xymondlog HOSTNAME.TESTNAME
Отримайте журнал стану Xymon для одного тесту. Перший рядок відповіді
містить серію полів, розділених знаком вертикальної лінії:

ім'я хоста Ім'я господаря

ім'я тесту Назва тесту

color Колір статусу (зелений, жовтий, червоний, синій, прозорий, фіолетовий)

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

остання зміна Часова позначка Unix, коли колір статусу востаннє змінювався.

час журналу Часова позначка Unix, коли було отримано повідомлення журналу.

час дії Часова позначка Unix, коли повідомлення журналу більше не дійсне (воно стає фіолетовим о
цього разу).

час підтвердження Або -1, або мітка часу Unix, коли закінчується термін дії активного підтвердження.

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

відправника IP-адреса, з якої отримано статус.

cookie Або -1, або значення cookie, що використовується для підтвердження сповіщення.

підтвердження Порожній або повідомлення підтвердження надіслано, коли статус було підтверджено.
Новий рядок, знаки прямої і зворотної косої риски екрануються за допомогою зворотної косої риски в стилі C.

dismsg Порожній або повідомлення надіслано, коли статус було вимкнено. Новий рядок, пайп-знаки
а зворотні скісні риски екрануються за допомогою зворотної косої риски в стилі C.

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

xymondxlog HOSTNAME.TESTNAME
Отримує XML-рядок, що містить журнал стану, як у команді "xymondlog".

xymondboard [КРИТЕРІЇ] [fields=FIELDLIST]
Отримує підсумок стану всіх відомих тестів, доступних для демона Xymon.

За замовчуванням – якщо не вказано КРИТЕРІЇ – він повертає один рядок для всіх статусів
повідомлення, які знаходяться в Xymon. Ви можете відфільтрувати відповідь за конкретним вибором
сторінка, хост, тест, колір або різні інші поля. Шлях сторінки, МЕРЕЖА, ІМ'Я ХОСТУ,
Параметри TESTNAME і *MSG інтерпретуються як регулярні вирази, сумісні з perl;
параметр COLOR приймає кілька кольорів, розділених комами; значення *TIME
прийняти часові позначки епохи Unix. Інші змінні, визначені в xymon-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 Включати лише тести з іменем тесту TESTNAME

колір=НАЗВА КОЛІРУ Включати лише тести, у яких колір статусу – COLORNAME

tag=TAGNAME Включати лише хости з певним тегом, зазначеним у hosts.cfg(5)
лінія. Зауважте, що тут включено лише елементи, відомі компонентам xymon; довільний
текст не входить

XMH_string=ЗНАЧЕННЯ Включати лише хости з a xymon-xmh(5) змінна, що відповідає цьому
значення

Розширена фільтрація

msg=ПОВІДОМЛЕННЯ Включати лише тести з повним вмістом, що відповідає MESSAGE. Використовуйте "\s", щоб
вихідні пробіли (або інші рядки PCRE)

ackmsg=ПОВІДОМЛЕННЯ Включати лише тести з підтвердженням(ями) ПОВІДОМЛЕННЯ. Використовуйте "\s", щоб
вихідні пробіли (або інші рядки PCRE)

dismsg=ПОВІДОМЛЕННЯ Включіть лише тести, які були вимкнені за допомогою відповідності рядків
ПОВІДОМЛЕННЯ. Використовуйте "\s", щоб уникнути пробілів (або інших рядків PCRE). (Це найбільш ефективне
щоб поєднати це з color=blue.)

Фільтри часових позначок

Певні поля (пояснення нижче) можна відфільтрувати за допомогою часових позначок unix та за допомогою
такі нерівності: >= > <= < = !=

Ці фільтри: остання зміна, час реєстрації, час дії, час підтвердження, час вимкнення

Відповідь – це один рядок для кожного статусу, який відповідає КРИТЕРІЯМ, або всім статусам
якщо критерії не вказані. Рядок складається з ряду полів, розділених
за трубою-знаком. Ви можете вибрати поля для отримання, перерахувавши їх у списку
СПИСОК ПОЛІВ. Доступні такі поля:

ім'я хоста Ім'я господаря

ім'я тесту Назва тесту

color Колір статусу (зелений, жовтий, червоний, синій, прозорий, фіолетовий)

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

остання зміна Часова позначка Unix, коли колір статусу востаннє змінювався.

час журналу Часова позначка Unix, коли було отримано повідомлення журналу.

час дії Часова позначка Unix, коли повідомлення журналу більше не дійсне (воно стає фіолетовим о
цього разу).

час підтвердження Або -1, або мітка часу Unix, коли закінчується термін дії активного підтвердження.

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

відправника IP-адреса, з якої отримано статус.

cookie Або -1, або значення cookie, що використовується для підтвердження сповіщення.

рядок1 Перший рядок журналу стану.

підтвердження Порожній (якщо підтвердження не активне) або текст підтвердження
повідомлення.

dismsg Порожній (якщо статус увімкнено) або текст вимкнення
повідомлення.

MSG Повний текст повідомлення про поточний статус.

клієнт Показує "Y", якщо є дані клієнта, "N", якщо немає.

clntstamp Позначка часу, коли було отримано останнє клієнтське повідомлення, в Unix "епоха"
Формат.

список підтверджень Список поточних підтверджень для тесту. Це текстовий рядок з
кілька полів, розділених двокрапкою. Є 5 полів: Позначка часу для
коли було створено підтвердження та коли він закінчується; "рівень підтвердження"; користувач, який
надіслав підтвердження; і текст підтвердження.

flapinfo Повідомляє, чи змінюється статус. 5 полів, розділених символом «/»: «0», якщо
статус не махає і "1", якщо махає; мітка часу, коли останній статус
була зафіксована зміна та коли була записана перша зміна статусу; і двоє
кольори, між якими змінюється статус.

статистика Кількість змін статусу, які були записані для цього статусу після xymond
було розпочато.

модифікатори Перелічує всі активні модифікатори для цього статусу (тобто оновлення, надіслані за допомогою a
команда "змінити").

XMH_* XMH-теги відносяться до Xymon hosts.cfg(5) налаштування конфігурації. Повний
їх список можна знайти в xymon-xmh(5) man-сторінка.

Поля ackmsg, dismsg та msg мають певні закодовані символи: Новий рядок — «\n»,
TAB — «\t», повернення каретки — «\r», знак вертикальної лінії — «\p», а зворотна коса риска — «\\».

Якщо параметр "fields" опущено, набір за замовчуванням
ім'я хоста, ім'я тесту, колір, прапори, остання зміна, час журналу, час дії, час підтвердження, час вимкнення, відправник, файл cookie, рядок 1
використовується.

xymondxboard
Отримує XML-рядок із підсумком усіх журналів стану, як для
команда "xymondboard".

інформація про хост [КРИТЕРІЇ]
Отримує поточну конфігурацію хоста (тобто hosts.cfg(5) визначення).
CRITERIA вибирає, який(і) хост(и) звітувати, і ідентичний CRITERIA в
команда xymondboard.

Відповідь – це один рядок для кожного хоста, який відповідає КРИТЕРІЯМ, або для всіх хостів, якщо
жодних критеріїв не вказано. Рядок складається з кількох полів, розділених між собою
труба-знак. Перші два поля завжди будуть ім'ям хосту та IP-адресою.
Решта полів - якщо такі є - це теги hosts.cfg без певного порядку.

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

клієнт[/COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Використовується для відправки "клієнтського" повідомлення на сервер Xymon. Формуються повідомлення клієнта
клієнтом Xymon; при відправці на сервер Xymon вони порівнюються з
правила в аналіз.cfg(5) конфігураційний файл, і генеруються повідомлення про стан
для тестів на стороні клієнта. COLLECTORID використовується під час надсилання даних клієнта
є доповненнями до стандартних даних клієнта. Дані будуть пов’язані з
звичайні дані клієнта.

clientlog HOSTNAME [section=SECTIONNAME[,SECTIONNAME...]]
Отримує поточне необроблене повідомлення клієнта, останнє надіслане HOSTNAME. Необов’язковий
Фільтр "section" використовується для вибору окремих розділів даних клієнта.

ping Спроба зв'язатися з сервером Xymon. У разі успіху ідентифікатор версії сервера Xymon буде
повідомляється.

pullclient
Це повідомлення використовується під час отримання даних клієнта через реалізований механізм "pull".
by xymonfetch(8) та msgcache(8) для клієнтів, які не можуть підключитися безпосередньо до
Сервер Xymon.

список привидів
Повідомити про список привид клієнтів, які бачить сервер Xymon. Привиди — це системи, які
звітувати про дані серверу Xymon, але не вказано у файлі hosts.cfg.

розклад [TIMESTAMP COMMAND]
Планує команду, надіслану на сервер Xymon для виконання пізніше. напр
використовується для планування вимкнення хоста або служби на якийсь час у майбутньому. КОМАНДА
це повна команда Xymon, така як перераховані вище. TIMESTAMP — це Unix
час епохи, коли команда буде виконана.
Якщо параметри не вказано, поточні заплановані завдання відображаються в списку
відповідь. Відповідь – один рядок для кожної запланованої команди з ідентифікатором завдання
час, коли команда буде виконана, IP-адреса, з якої вона була надіслана,
і повний командний рядок.
Щоб скасувати раніше заплановану команду, «розклад відмінити JOBID" може бути використано.
JOBID – це номер, який надається як перший елемент у виводі зі списку розкладу.

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

ID користувача
Ці повідомлення будуть передаватися безпосередньо модулям, які прослуховують канал "користувач".
демона Xymon. Це призначено для користувацького спілкування між клієнтською стороною
модулі та сервер Xymon.

змінити HOSTNAME.TESTNAME КОЛІР ДЖЕРЕЛО ПРИЧИНА
Змініть колір певного статусу, не створюючи повний статус
повідомлення. Це для серверних процесорів (наприклад, RRD-графів), які можуть замінювати
колір статусу на основі деяких критеріїв, визначених поза нормальним перебігом a
статус. Наприклад, звичайний статус "conn" може виглядати зеленим, оскільки він просто перевіряє
про те, чи можна запитувати хост чи ні; потім обробник RRD може використовувати "змінити"
Команда для перевизначення цього фактичного часу відповіді ping перевищує заданий поріг.
(Див. налаштування конфігурації "DS" в аналіз.cfg(5) як це зробити). ДЖЕРЕЛО
це деяка ідентифікація модуля, який генерує повідомлення "змінити" - майбутнє
модифікації повинні використовувати те саме джерело. Може бути кілька джерел, які змінюються
той самий статус (найсуворіший статус тоді стає фактичним кольором
статус). CAUSE — це текстовий рядок, що містить один рядок, що пояснює причину заміни
звичайний колір статусу - він буде відображатися на веб-сторінці статусу.

приклад

Надішліть звичайне повідомлення про статус на сервер Xymon, використовуючи стандартний протокол Xymon на TCP
порт 1984:
$ $XYMON $XYMSRV "статус www,foo,com.http зелений `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 перезапустити; fi

Використовуйте повідомлення "config", щоб оновити локальний файл mytest.cfg (але лише якщо ми отримаємо відповідь):

$ $XYMON $XYMSRV "config mytest.cfg" >/tmp/mytest.cfg.new
$ якщо [ -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