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

ПРОГРАММА:

ИМЯ

xymongen - генератор веб-страниц Xymon

СИНТАКСИС

ксимонген -?
ксимонген --Помогите
ксимонген --версия
ксимонген [опции] [выходной каталог]
(См. Раздел ОПЦИИ для описания доступных опций командной строки).

ОПИСАНИЕ

ксимонген генерирует обзорные веб-страницы для монитора Xymon. Это веб-страницы
которые показывают общий статус ваших хостов, а не подробные страницы статуса для каждого теста.

Примечание. Данные для веб-страниц извлекаются из ксимонд(8) демон, а ксимонген использует
значения переменных среды XYMSRV / XYMSERVERS для определения сети
адрес, по которому можно связаться с xymond. Если у вас есть несколько серверов, перечисленных в
XYMSERVERS, убедитесь, что первым является локальный сервер Xymon - это тот, который
xymongen запросит данные.

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

xymongen имеет большое количество параметров командной строки. Параметры можно использовать для изменения
поведение xymongen и влияет на генерируемые им веб-страницы.

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

--help или -?
Предоставьте сводку доступных параметров командной строки.

--версия
Печатает номер версии xymongen

--docurl = URL
Этот параметр устарел, используйте параметр HOSTDOCURL в xymonserver.cfg(5)
.

--doccgi = URL
Этот параметр устарел, используйте параметр HOSTDOCURL в xymonserver.cfg(5)
.

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

--htmlextension = .EXTENSION
Устанавливает расширение имени файла, используемое для веб-страниц, созданных xymongen. К
по умолчанию используется расширение «.html». Обратите внимание, что вам нужно указать «точку».

--report [= COLUMNNAME]
С этой опцией xymongen отправит статусное сообщение с подробной информацией о том, сколько
хосты были обработаны, сколько страниц было сгенерировано, какие произошли ошибки
во время пробега и немного статистики по времени. Имя столбца по умолчанию - «xymongen».

--htaccess [= htaccess-имя-файла]
Создавайте файлы .htaccess при создании новых каталогов веб-страниц. Содержание
файлы .htaccess определяются переменной среды XYMONHTACCESS (для
каталог верхнего уровня с xymon.html и nongreen.html); посредством
Переменная XYMONPAGEHTACCESS (для каталогов уровня страницы); и по
Переменная XYMONSUBPAGEHTACCESS для каталогов на уровне подстраницы и родительского уровня. В
имя файла .htaccess по умолчанию - ".htaccess", если имя файла не указано с
этот вариант. Переменная XYMONHTACCESS дословно копируется в верхний уровень
.htaccess файл. Переменная XYMONPAGEHTACCESS может содержать "% s", где имя
страницы вставлен. Переменная XYMONSUBPAGEHTACCESS может содержать два "% s"
экземпляры: первое заменяется именем страницы, второе -
имя подстраницы.

--max-eventcount = N
Ограничьте журнал событий на странице «Все, кроме зеленого» до N событий. По умолчанию: 100.

--max-eventtime = N
Ограничьте журнал событий на странице «Все не-зеленые» событиями, которые произошли в
за N минут. По умолчанию: 240.

--no-eventlog
Отключите журнал событий, который обычно отображается на странице «Все, кроме зеленого».

--max-ackcount = N
Ограничьте журнал подтверждений на странице «Все, кроме зеленого» до N событий. Дефолт:
25.

--max-acktime = N
Ограничьте журнал подтверждений на странице "Все не-зеленые" до подтверждений, которые произошли
за последние N минут. По умолчанию: 240.

--no-acklog
Отключите журнал подтверждений, который обычно отображается на странице «Все, кроме зеленого».

--cricitcallog [= столбец критического журнала]
При этом создается текстовый журнал того, что отображается на странице состояния critical.html,
и отправляет статусное сообщение для самого сервера Xymon, отражающее цвет
Страница критического статуса. Это позволяет отслеживать появление проблем на
страница критического статуса. Файл журнала хранится в $ XYMONSERVERLOGS / criticalstatus.log.

--loadhostsfromxymond
Вместо чтения файла hosts.cfg xymongen загрузит hosts.cfg
конфигурация из демона xymond. Это избавляет от необходимости читать
hosts.cfg, и если у вас xymond и xymongen работают на разных хостах, он также
устраняет необходимость копировать файл hosts.cfg между системами. Обратите внимание, что
Параметр "dispinclude" в hosts.cfg игнорируется, когда этот параметр включен.

СТР Палубы Prestige XXNUMX ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Эти параметры влияют на то, как веб-страницы, созданные xymongen, отображаются в браузере.

--страницы-последние
Поместите ссылки на страницы и подстраницы после хостов.

--pages-first
Поместите ссылки на страницы и подстраницы перед хостами (по умолчанию).

Эти два параметра определяют, есть ли у страницы со ссылками на подстраницы и хосты
сначала хосты или подстраницы.

--subpagecolumns = N
Определяет количество столбцов, используемых для ссылок на страницы и подстраницы. По умолчанию
равно N = 1.

--maxrows = N
Заголовки столбцов на странице по умолчанию отображаются только в начале страницы,
подстраница или группа хостов. Эта опция заставляет заголовки столбцов повторяться для
показаны каждые N хостов.

--showemptygroups

--no-showemptygroups
При создании групп хостов отображать таблицу и имена хостов, даже если есть
ни для одного из рассматриваемых хостов нет тестов. Используйте --no-showemptygroups, чтобы
Спрятать. (По умолчанию: да)

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

--pagetext-заголовки
Используйте текст описания из тегов "страница" или "подстраница" в качестве заголовка для
страницы вместо заголовка «Страницы, размещенные локально» или другого стандартного заголовка.

--без подчеркивания-заголовки
Обычно заголовки страниц подчеркиваются с помощью HTML-тега «горизонтальная линейка». Этот
опция отключает подчеркивание заголовков.

--recentgifs [= МИНУТЫ]
Используйте изображения с именем COLOR-latest.gif для тестов, статус которых изменился.
в течение последних 24 часов. Эти файлы GIF необходимо установить в
Каталог $ XYMONHOME / www / gifs /. По умолчанию порог установлен на 24 часа - если
вы хотите по-другому, вы также можете указать срок. Например
«--recentgifs = 3h» покажет последние GIF-файлы только в течение 3 часов после изменения статуса.

--sort-group-only-items
В обычной директиве "только для группы" вы можете указать порядок, в котором тесты
отображаются слева направо. Если вы предпочитаете, чтобы тесты были перечислены в
в алфавитном порядке, используйте эту опцию - тогда страница будет генерировать "только для группы"
группы, подобные ему, генерируют нормальные группы и сортируют тесты в алфавитном порядке.

--dialupskin = URL
Если вы хотите наглядно показать, что тест - это тест по коммутируемому соединению, вы можете использовать альтернативный вариант.
набор иконок для зеленого / красного / желтого> / etc. изображения, указав этот параметр. В
Указанный здесь параметр URL переопределяет обычную настройку XYMONSKIN.
переменная окружения, но только для тестов удаленного доступа.

--reverseskin = URL
То же, что и "--dialupskin", но для обратных тестов (тесты с '!' Впереди).

--tooltips = [всегда, никогда, главное]
Определяет, какие страницы используют всплывающие подсказки для отображения описания хоста (из
КОММЕНТАРИЙ запись в хосты.cfg(5) файл). Если установлено на всегда, всплывающие подсказки используются на всех
страниц. Если установлено на никогдавсплывающие подсказки никогда не используются. Если установлено на main, используются всплывающие подсказки
на главных страницах, но не на страницах «Все не зеленые» или «Критические системы».

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

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

--ignorecolumns = test [, test]
Данные столбцы будут полностью игнорироваться xymongen при создании веб-страниц.
Может использоваться для создания отчетов, в которых вы устраняете некоторые из наиболее шумных тестов,
как "сообщения".

--critical-red-only
На критическую страницу будут включены только красные столбцы статуса. По умолчанию
Критическая страница будет содержать хосты с красным, желтым и чистым статусом.

--nongreen-colors = ЦВЕТ [, ЦВЕТ]
Определяет, какие цвета вызывают появление теста на странице статуса «Все кроме зеленого».
ЦВЕТ красный, желтый или фиолетовый. По умолчанию включены все три.

--nongreen-ignorecolumns = test [, test]
То же, что --ignorecolumns, но применяется только к хостам на странице «Все не-зеленые».

--nongreen-ignorepurples
Устарело, используйте вместо этого "--nongreen-colors".

--nongreen-ignoredialups
Игнорируйте все узлы коммутируемого доступа на странице «Все не зеленые», включая журнал событий.

--нет-страниц
Не генерировать обычные страницы (обычно используются для генерации только незеленых страниц).
страница).

--незеленый
Не создавайте страницу «Все не зеленое».

--includecolumns = test [, test]
Всегда включать эти столбцы на страницу «Все, кроме зеленого». Будет включать определенные столбцы.
на странице nongreen.html независимо от ее цвета. Обычно nongreen.html сбрасывает
столбец test, если все тесты зеленые. Это можно использовать, например, чтобы всегда иметь ссылку на
столбец тенденций (с графиками RRD) со страницы nongreen.html.

--eventignore = тест [, тест]
Игнорируйте эти тесты при отображении журнала событий «Все не зеленым».

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

Эти параметры подавляют нормальное распространение статуса вверх по иерархии страниц.
Таким образом, у вас может быть тест со статусом желтый или красный, но при этом вся страница останется зеленой.
Это полезно для тестов, которые не обязательно должны вызывать тревогу, но когда вы все же хотите знать
актуальный статус. Эти параметры устанавливают глобальные значения по умолчанию для всех хостов; вы можете использовать NOPROPRED
и теги NOPROPYELLOW в хосты.cfg(5) файл, чтобы применить аналогичные ограничения для каждого хоста
основа.

--nopropyellow = test [, test] или --noprop = test [, test]
Отключить распространение статуса вверх, когда ЖЕЛТЫЙ. Параметр "--noprop" устарел
и не должен использоваться.

--noproppurple = тест [, тест]
Отключить распространение статуса вверх, когда ПУРПУРНЫЙ.

--nopropred = test [, test]
Отключить восходящее распространение статуса, когда КРАСНЫЙ или ЖЕЛТЫЙ.

--nopropack = test [, test]
Отключить восходящее распространение статуса при подтверждении статуса. Если хочешь
чтобы отключить распространение всех подтвержденных тестов, используйте "--nopropack = *".

PURPLE статус ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Пурпурные статусы появляются, когда прекращается сообщение о статусе теста. Статус теста действителен для
ограниченное количество времени - обычно 30 минут - и по истечении этого времени тест становится
пурпурный.

--purplelog = ИМЯ ФАЙЛА
Создайте файл журнала всех сообщений о статусе фиолетового цвета.

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

--pageset = НАЗВАНИЕ СТРАНИЦЫ
Создавайте веб-страницы для альтернативного набора страниц, кроме стандартного. См. Раздел НАБОРЫ СТРАНИЦ
внизу.

--template = ШАБЛОН
Используйте альтернативный шаблон для файлов верхнего и нижнего колонтитула. Обычно используются вместе
параметр "--pageset"; см. раздел СТРАНИЦЫ ниже.

АЛЬТЕРНАТИВНЫЙ ВЫВОД ФОРМАТЫ

--wml [= test1, test2, ...]
Эта опция заставляет xymongen генерировать набор "карточных" файлов WML, которые можно
доступ к WAP-устройству (сотовый телефон, КПК и т. д.). Сгенерированные файлы содержат
хосты, которые имеют КРАСНЫЙ или ЖЕЛТЫЙ статус на указанных тестах. Эта опция может определять
тесты по умолчанию для включения - значения по умолчанию могут быть переопределены или изменены с помощью
Теги "WML:" или "NK:" в хосты.cfg(5) файл. Если тесты не указаны, все тесты
будут включены.

--nstab = ИМЯ ФАЙЛА
Создайте файл HTML, подходящий для записи на боковой панели Netscape 6 / Mozilla. На самом деле
чтобы ваши пользователи могли получить такую ​​запись на боковой панели, вам понадобится этот код Javascript в
веб-страницу (например, вы можете включить ее в файл $ XYMONHOME / web / stdnormal_header):


<!--
function addNetscapePanel () {
if ((typeof window.sidebar == "объект") &&
(typeof window.sidebar.addPanel == "функция"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html"," ");
еще
alert («Боковая панель только для Mozilla или Netscape 6+»);
}
// ->


а затем вы можете добавить ссылку «Добавить на боковую панель», используя это в качестве шаблона:

Добавить на боковую панель

или если вы предпочитаете стандартную кнопку Netscape «Добавить вкладку», вы бы сделали это



<IMG SRC="/gifs/add-button.gif" ВЫСОТА=45 ШИРИНА=100
ALT = "[Добавить боковую панель]" STYLE = "border: 0">


"Add-button.gif" доступен в Netscape по адресу
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Если FILENAME не начинается с косой черты, файл боковой панели Netscape помещается в
Каталог $ XYMONHOME / www /.

--nslimit = ЦВЕТ
Минимальный цвет для включения в боковую панель Netscape - по умолчанию "красный", что означает
включены только критические предупреждения. Если вы хотите также включить предупреждения, используйте
"--nslimit = желтый".

--rss Сгенерировать поток доставки содержимого RSS / RDF для ваших предупреждений Xymon. Этот выходной формат
могут быть динамически встроены в другие веб-страницы, как и в случае с живыми новостными лентами.
видели на веб-сайтах. Будут сгенерированы два файла RSS, один отражает "Все не-
зеленая »страница, другая -« Критическая »страница. Они будут в
Файлы "nongreen.rss" и "critical.rss" соответственно. Кроме того, файл RSS
будет сгенерирован для каждой страницы и / или подстраницы, в которой перечислены хосты, присутствующие на этой
страница или подстраница.
Параметр FILENAME, ранее разрешенный для параметра --rss, теперь устарел.
Для получения дополнительной информации о каналах содержания RSS / RDF, пожалуйста, см.
http://www.syndic8.com/.

--rssextension = .EXTENSION
Устанавливает расширение имени файла, используемое для файлов RSS, созданных xymongen. К
по умолчанию используется расширение ".rss". Обратите внимание, что вам нужно указать «точку».

--rssversion = {0.91 | 0.92 | 1.0 | 2.0}
Желаемый выходной формат RSS / RDF-канала. Версия 0.91 кажется самой
обычно используемый формат и используется по умолчанию, если этот параметр не указан.

--rsslimit = ЦВЕТ
Минимальный цвет для RSS-канала - по умолчанию красный, то есть только
включены критические предупреждения. Если вы хотите также включить предупреждения, используйте
"--rsslimit = желтый".

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

--reportopts = НАЧАЛО: КОНЕЦ: ДИНАМИЧЕСКИЙ: СТИЛЬ
Вызов xymongen в режиме создания отчета. Обычно это используется
отчет.cgi(1) CGI-скрипт, но также может использоваться напрямую при предварительном создании
отчеты. Параметр START - время начала отчета в Unix time_t
формат (секунды с 1 января 1970 00:00 UTC); КОНЕЦ - время окончания отчета;
ДИНАМИЧНЫЙ - 0 для предварительно созданного отчета и 1 для динамического (он-лайн) отчета; СТИЛЬ
"критический", чтобы включать только критические (красные) события, "nongr", чтобы включать все не-зеленые
события и «все», чтобы включить все события.

--csv = ИМЯ ФАЙЛА
Используется вместе с --reportopts, это заставляет xymongen генерировать доступность
отчет в виде файла со значениями, разделенными запятыми (CSV). Этот формат обычно
используется для импорта в электронные таблицы для дальнейшей обработки.
CSV-файл включает временные метки Unix. Чтобы отобразить их как удобочитаемое время в
Excel, формула = C2 / 86400 + ДАТА ЗНАЧЕНИЕ (1 января 1970 г.) (если у вас есть временная метка Unix
в ячейке C2). Ячейка результата должна быть отформатирована как дата / время.
поле. Обратите внимание, что метки времени указаны в формате UTC, поэтому вам также может потребоваться обработка локальных
часовой пояс и летнее время выдают сами.

--csvdelim = DELIMITER
По умолчанию для разделения полей в выводе CSV используется запятая. Некоторые неанглоязычные
в электронных таблицах используется другой разделитель, обычно точка с запятой. Чтобы создать CSV
файл с правильным разделителем, вы можете использовать эту опцию, чтобы установить используемый символ
как разделитель. Например, "--csvdelim =;" - обратите внимание, что обычно это должно быть двойное
кавычки, чтобы оболочка Unix не интерпретировала символ-разделитель как
разделитель командной строки.

--snapshot = ВРЕМЯ
Создайте снимок страниц Xymon, как они появились в TIME. ВРЕМЯ задается как
секунд с 1 января 1970 г., 00:00 UTC. Обычно используется через снимок.cgi(1) CGI
скрипты.

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

--отлаживать
Заставляет xymongen выгружать большие объемы отладочной информации в стандартный вывод, если это было
скомпилирован с включенным -DDEBUG. Сообщая о проблеме с ксимонгеном, пожалуйста,
попробуйте воспроизвести проблему и предоставить результат работы xymongen с этим
опцию.

- время
Выгрузить информацию о времени, затраченном различными частями xymongen на стандартный вывод. Этот
полезно видеть, какая часть обработки отвечает за время выполнения
ксимонген.
Примечание: эта информация также предоставляется в выводе, отправляемом на дисплей Xymon.
при использовании опции "--report".

СТРОИТЕЛЬСТВО АЛЬТЕРНАТИВНЫЙ СТРАНИЦЫ

В версии 1.4 xymongen появилась возможность создавать несколько наборов страниц из
те же данные.
Предположим, у вас есть две группы людей, просматривающих веб-страницы Xymon. Группа А хочет
имеют хосты, сгруппированные по клиенту, которому они принадлежат. Вот как вы настроили Xymon -
набор страниц по умолчанию. Теперь группа B хочет, чтобы хосты были сгруппированы по операционной системе -
назовем это набором «os». Затем вы должны добавить макет страницы в hosts.cfg следующим образом:

ospage выиграть Microsoft Windows
ossubpage win-NT4 MS Windows NT 4
osgroup NT4 Файловые серверы
Почтовые серверы osgroup NT4
ossubpage win-xp MS Windows XP
OSPage Unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Это определяет набор страниц с одной страницей верхнего уровня (страница xymon.html), двумя страницами
связаны с xymon.html (win.html и unix.html), и, например, со страницы win.html есть
подстраницы win-nt4.html и win-xp.html
Синтаксис идентичен обычным директивам page и subpage в hosts.cfg, но
директива имеет префикс с именем набора страниц. Не помещайте хосты между страницей
и директивы подстраницы - просто добавьте все директивы в начало файла hosts.cfg.
Как же тогда вы добавляете хосты на страницы? Все просто - просто поставьте тег "OS: win-xp" на хосте.
линия определения. «ОС» должно совпадать с префиксом, используемым для имен наборов страниц, но в
верхний регистр. "Win-xp" должен соответствовать одной из страниц или подстраниц, определенных в этом
набор страниц. Например

207.46.249.190 www.microsoft.com # ОС: win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # ОС: unix-sun http://www.sun.com/

Если вы хотите, чтобы хост отображался внутри группы, определенной на этой странице, вы должны определить
группу по номеру, начиная с 1. Например, чтобы поместить хост в группу «Почтовые серверы NT4» в
в приведенном выше примере используйте «OS: win-nt4,2» (вторая группа на странице «win-nt4»).
Если вы хотите, чтобы хост отображался на главной странице, а не на подстранице, используйте «OS: *».

Все это просто определяет макет нового набора страниц. Чтобы сгенерировать его, вы должны запустить
xymongen один раз для каждого определяемого вами набора страниц, т. е. создайте сценарий расширения, подобный этому:

#!/ Бен / ш

XYMONWEB = "/ xymon / os" $ XYMONHOME / bin / xymongen \
--pageset = os --template = os \
$ XYMONHOME / www / os /

Сохраните это в $ XYMONHOME / ext / os-display.sh и настройте его для работы как расширение Xymon;
это означает добавление дополнительного раздела в tasks.cfg для его запуска.

Это генерирует страницы. Здесь используются несколько важных опций:
* XYMONWEB = переменная среды "/ xymon / os" и
Параметр «$ XYMONHOME / www / os /» работает вместе и помещает
новые файлы HTML набора страниц в подкаталоге вне обычного
Xymon webroot. Если вы обычно обращаетесь к страницам Xymon как
"http://xymon.acme.com/xymon/", вы получите доступ
новый набор страниц как "http://xymon.acme.com/xymon/os/"
NB: каталог, указанный как XYMONWEB, должен содержать символический
ссылку на каталог $ XYMONHOME / www / html / или ссылки на
отдельные статусные сообщения работать не будут. Похожие ссылки
следует сделать для гифок /, справки / и примечаний /
каталоги.
* "--pageset = os" указывает xymongen структурировать веб-страницы
с использованием макета «os» вместо макета по умолчанию.
* "--template = os" указывает xymongen использовать другой набор
шаблоны верхнего и нижнего колонтитула. Обычно xymongen использует
стандартный шаблон в $ XYMONHOME / web / stdnormal_header и
... / stdnormal_footer - с этим параметром вместо этого будет использоваться
файлы "os_header" и "os_footer" из
Каталог $ XYMONHOME / web /. Это позволяет вам настроить
верхние и нижние колонтитулы для каждого набора страниц. Если ты просто хочешь
чтобы использовать обычный шаблон, вы можете опустить эту опцию.

С ПОМОЩЬЮ КСИМОНГЕН Для ДОКЛАДЫ

Отчетность по xymongen реализована через замену стандартного Xymon.
скрипты отчетов (report.sh и reportlog.sh), установленные на ваших веб-серверах cgi-bin
каталог.

Эти два сценария оболочки были заменены двумя очень маленькими сценариями оболочки, которые просто
настроить переменные среды Xymon и вызвать отчет.cgi(1) or отчетlog.cgi(1)
скрипты в $ XYMONHOME / bin /

Вы можете использовать параметры командной строки xymongen при создании отчетов, например, чтобы исключить определенные
типы тестов (например, "--ignorecolumns = msgs") из отчетов, чтобы указать имя
столбцы трендов и информации, которых не должно быть в отчете, или для форматирования отчета
иначе (например, "--subpagecolumns = 2"). Если вы хотите, чтобы определенные параметры использовались, когда
отчет создается из веб-интерфейса, поместите эти параметры в свой
Файл $ XYMONHOME / etc / xymonserver.cfg в переменной среды XYMONGENREPOPTS.

Файлы отчетов, созданные xymongen, хранятся в отдельных каталогах (по одному на каждый
report) под каталогом $ XYMONHOME / www / rep /. Они должны быть автоматически очищены
- по мере создания новых отчетов старые удаляются.

После установки попробуйте сформировать отчет. Вы, вероятно, увидите, что ссылки в
верхний левый угол (в ack.html, nongreen.html и т. д.) больше не работает. Чтобы исправить это, измените
ваш файл $ XYMONHOME / web / repnormal_header, чтобы эти ссылки не ссылались на "& XYMONWEB", а
к обычному префиксу URL для ваших страниц Xymon.

SLA СОСТАВЛЕНИЕ ОТЧЕТОВ

Отчетность xymongen позволяет создавать истинное SLA (Соглашение об уровне обслуживания)
отчеты, также для периодов обслуживания, которые не являются 24x7. Это возможно путем определения
Тег «REPORTTIME: timespec» для хостов для определения периода обслуживания и, необязательно,
Тег «WARNPCT: level» для определения согласованной доступности.

Примечание: см. хосты.cfg(5) для точного синтаксиса этих параметров.

"REPORTTIME: timespec" указывает время дня, когда ожидается, что служба будет работать, и
Бег. По умолчанию это 24 часа в сутки, все дни недели. Если ваше соглашение об уровне обслуживания распространяется только на
Пн-Пт с 7:8 до 0700:2000, вы определяете это как «REPORTTIME = W: XNUMX: XNUMX» и генератор отчетов.
затем вычислит как обычную доступность 24x7, так и «доступность SLA», которая
учитывает только статус хоста в течение периода SLA.

Параметр DOWNTIME: timespec влияет на расчет доступности SLA. Если отключение
происходит в течение времени, заданного как возможное «ВРЕМЯ ВЫКЛЮЧЕНИЯ», тогда сбой сообщается с
статус «синий». (Тот же цвет используется, если вы "отключаете", а затем размещаете с помощью Xymon
функция "отключить"). Время, когда статус теста «синий», не входит в SLA.
расчет, ни в количестве времени, когда хост считается отключенным, ни в
общее количество времени, которое охватывает отчет. Таким образом, "синее" время фактически игнорируется
Расчет доступности SLA, позволяющий запланировать время простоя, не влияя на
сообщил о доступности SLA.

Пример: на хосте установлено «DOWNTIME: *: 0700: 0730 REPORTTIME = W: 0600: 2200», потому что он перезагружается.
ежедневно с 7:7.30 до 6:10, но услуга должна быть доступна с XNUMX:XNUMX до XNUMX:XNUMX. Для
в день отчета он был отключен с 7:10 до 7:15 (запланированная перезагрузка), но также
с 9:53 до 10:15. Итак, события дня:

0700: зеленый в течение 10 минут (600 секунд)
0710: синий в течение 5 минут (300 секунд)
0715: зеленый в течение 14 часов 38 минут (52680 секунд)
2153: красный в течение 22 минут (1320 секунд)
2215: зеленый

Услуга доступна за 600 + 52680 = 53280 секунд. Он не горит (красный) в течение 420 секунд.
(время с 21:53 до 22:00, когда заканчивается период SLA). Общее время включено в
отчет составляет 15 часов (с 7 утра до 10 вечера), за исключением 5 минут синего цвета = 53700 секунд. Итак, SLA
доступность 53280/53700 = 99,22%

Тег «WARNPCT: level» поддерживается в файле hosts.cfg, чтобы установить доступность.
порог для каждого хоста. Этот порог определяет, отображается ли тест как
зеленый, желтый или красный в отчетах. Значение по умолчанию может быть установлено для всех хостов с переходным отверстием.
переменная среды XYMONREPWARN, но переопределена этим тегом. Уровень задается как
процент, например "WARNPCT: 98.5"

ПРЕДНАЗНАЧЕННЫЙ ДОКЛАДЫ

Обычно xymongen создает отчеты, которые ссылаются на динамически генерируемые веб-страницы с
подробный статус теста (через CGI-скрипт reportlog.sh).

Можно заставить xymongen создавать отчет без этих динамических ссылок, поэтому
отчет можно экспортировать на другой сервер. Также может быть полезно предварительно сгенерировать
отчеты, чтобы снизить нагрузку за счет того, что несколько пользователей будут создавать одни и те же отчеты.

Для этого вы должны запустить xymongen с параметром «--reportopts», чтобы выбрать время.
интервал, охватываемый отчетом, стиль отчетности (критические, незеленые или все события),
и потребовать, чтобы не создавались динамические страницы.

Синтаксис:

xymongen --reportopts = время начала: время окончания: нодинамический: стиль

"starttime" и "endtime" указаны как значения Unix time_t, то есть в секундах с 1 января.
1970 00:00 GMT. К счастью, это можно легко вычислить с помощью утилиты даты GNU, если вы
используйте опцию вывода "+% s". Если у вас нет утилиты даты GNU, возьмите ее
с www.gnu.org; или вы можете использовать утилиту "etime" для той же цели, которая
доступно в архиве на сайте www.deadcat.net.

"нодинамический" равен либо 0 (для динамических страниц, по умолчанию), либо 1 (без динамических, т. е. до
сгенерировано, страниц).

"стиль" может быть либо "крит" (включая критические, т. е. только красные события), либо "нонгр" (включать все
не зеленые события) или «все» (включая все события).

Можно использовать другие параметры xymongen, например, "--ignorecolumns", если вы хотите исключить определенные
тесты из отчета.

Обычно вам также необходимо указать переменную среды XYMONWEB (она должна соответствовать
базовый URL-адрес, откуда отчет будет доступен) и выходной каталог
где хранятся файлы отчетов. Если вы укажете XYMONWEB, вам, вероятно, также следует
определите переменные среды XYMONHELPSKIN и XYMONNOTESSKIN. Они должны указывать на
URL-адрес, по которому находятся ваши файлы справки и заметок Xymon; если они не определены,
ссылки на файлы справки и заметок будут указывать внутри каталога отчетов и, вероятно, будут
не работа.

Итак, типичный вызов xymongen для статического отчета:

START = `date +% s --date =" 22 июня 2003 00:00:00 "`
END = `date +% s --date =" 22 июня 2003 23:59:59 "`
XYMONWEB = / reports / bigbrother / daily / 2003/06/22 \
XYMONHELPSKIN = / xymon / help \
XYMONNOTESSKIN = / xymon / notes \
xymongen --reportopts = $ НАЧАЛО: $ КОНЕЦ: 1: крит \
--subpagecolumns = 2 \
/ var / www / docroot / reports / xymon / daily / 2003/06/22

Параметр «XYMONWEB» означает, что отчет будет доступен с URL-адресом
"http://www.server.com/reports/xymon/daily/2003/06/22". Отчет содержит внутренние
ссылки, использующие этот URL-адрес, поэтому его нельзя легко переместить в другое место.

Последний параметр - это соответствующий физический каталог на вашем веб-сервере, соответствующий
XYMONWEB URL. Конечно, вы можете создавать файлы отчетов где угодно - возможно, на
другой компьютер - а затем переместите их на веб-сервер позже.

Обратите внимание, как даты(1) Утилита используется для расчета параметров времени начала и окончания.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

ДОСКА ФИЛЬТРА
Фильтр, используемый для выбора хостов / тестов для включения в веб-страницы путем фильтрации
данные, полученные из xymond vi командой xymondboard. Видеть ксимон(1) подробнее
о синтаксисе фильтра. По умолчанию фильтрация не выполняется.

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