# Websmon Monitor - Technical information
Websmon 1.01 -- Web-based system performance monitor for UNIX servers and PROGRESS databases
Keywords: websmon, system monitor, websmon monitor, performance monitor, unix, linux, system statistics, server statistics, progress, database statistics

|  | Websmon -- Web-based system performance monitor. Copyright © 2003-2005 Dmitry Lapenkov. All rights reserved. | [ Read in English ]

## Монитор Websmon. Подробности.

Перед чтением этого файла полезно ознакомиться с общими сведениями о мониторе Websmon, находящимися в файле Readme.

Инструкции по установке, настройке и запуску монитора Вы найдёте в файле Install.

Вы также можете посетить Web-сайт, находящийся по адресу: http://www.websmon.com.
На сайте приведены многочисленные примеры Web-страниц системной статистики, создаваемых монитором.

Websmon, или Web-based system monitor - это комплексная система мониторинга и управления производительностью локальных и удалённых серверов UNIX и серверов баз данных (БД) PROGRESS.

Вкратце, монитор Websmon состоит из следующих независимых систем:

- wmgather - система сбора статистики производительности серверов UNIX и БД PROGRESS; информация сохраняется в CSV файлах и используется для обновления баз данных статистики в формате RRD (о Round Robin Database читайте в файле /home/websmon/rrdtool/doc/rrdtutorial.txt);
- wmshow - система графического представления собранной статистической информации (Web-приложение, работающее под управлением HTTP-сервера Apache);
- wmwatch - система мониторинга активности хостов, TCP-сервисов и серверов БД PROGRESS.

1. Структура каталогов монитора Websmon.
2. wmshow - система графического представления статистической информации монитора Websmon.
   1. Главная страница монитора Websmon.
   2. Страницы статистики серверов UNIX.
   3. Страницы статистики серверов БД PROGRESS.
   4. Страницы статистики системных ресурсов серверов UNIX.
   5. Страницы статистики системных ресурсов БД PROGRESS.
3. Другие программы, входящие в состав монитора Websmon.
   1. websmon - скрипт сбора статистики
   2. wmbar - вспомогательная CGI-программа для системы wmshow
   3. wmdbrrd - программа сохранения статистики ресурсов БД PROGRESS в RRD-файлах
   4. wmexport - скрипт экпорта файлов статистики
   5. wmgather - программа сбора статистики
   6. wmgather2 - программа сбора статистики
   7. wmhttpd - управляющий скрипт HTTP-сервера Apache
   8. wmimport - скрипт импорта файлов статистики
   9. wmmkrrd - программа воссоздания RRD-файлов
   10. wmsetup - программа настройки конфигурационных файлов монитора Websmon
   11. wmsysid - программа получения идентификатора серверов UNIX
   12. wmwatch - программа мониторинга активности хостов и серверов БД PROGRESS
   13. wmzip - скрипт архивирования старых файлов статистики, собранных монитором Websmon
4. Конфигурационный файл монитора websmon.ini.
   1. Местонахождение конфигурационного файла.
   2. Несколько примеров секций конфигурационного файла.
   3. Секция [:default:] - значения параметров по умолчанию.
   4. Секция [:system:] - общесистемные настройки монитора Websmon.
   5. Секция [:graph:] - настройки графов (graphs) для системы wmshow.
   6. Секция [:bar:] - настройки graphic bars для системы wmshow.
   7. Секция [:license:] - лицензионная информация монитора Websmon.
   8. Пример конфигурационного файла монитора Websmon.
   9. Как добавить определение нового хоста?
   10. Как добавить определение нового сервера БД?
5. Файлы статистики, создаваемые монитором Websmon.
   1. CSV файлы статистики серверов UNIX
   2. RRD-файлы (база данных статистики) для серверов UNIX
   3. CSV файлы статистики серверов БД PROGRESS
   4. RRD-файлы (база данных статистики) для серверов БД PROGRESS
6. Сообщения монитора Websmon.
7. Приложение.

### 1. Структура каталогов монитора Websmon

Монитор Websmon по умолчанию устанавливается в /home/websmon и имеет следующую структуру каталогов:

/home/websmon/ |  | файл конфигурации websmon.ini и протокол работы монитора websmon.log
/home/websmon/apache/ |  | HTTP-сервер Apache
/home/websmon/bin/ |  | исполняемые файлы и скрипты
/home/websmon/doc/ |  | файлы документации Websmon
/home/websmon/icons/ |  | графические файлы для работы wmshow
/home/websmon/include/ |  | разнообразные include-файлы из пакетов Open Source Software
/home/websmon/lib/ |  | библиотеки, необходимые для работы Websmon (включая Perl 5.8 и дополнительные модули)
/home/websmon/man/ |  | руководства (manuals) к программам Open Source Software
/home/websmon/misc/ |  | различные файлы (прототипы файлов crontab, .profile, apache.conf и пр.)
/home/websmon/pro/ |  | файлы процедур сбора статистики работы серверов БД PROGRESS
/home/websmon/rrdtool/ |  | библиотеки RRD, необходимые для работы Websmon
/home/websmon/src/ |  | исходные тексты Open Source Software, используемого при работе монитора Websmon и распространяемого под лицензией GNU General Public License (например, Perl 5 или RRD tool)
/home/websmon/stats/ |  | каталог, в котором находятся файлы статистики, собранной монитором Websmon
/home/websmon/stats/HOST1/ |  | пример каталога файлов статистики сервера UNIX HOST1
/home/websmon/stats/HOST1/SVCE1/ |  | пример каталога файлов статистики сервера БД PROGRESS, работающего на HOST1 через TCP-сервис SVCE1
/home/websmon/stats/HOST2/SVCE2/ |  | пример каталога файлов статистики сервера БД PROGRESS, работающего на HOST2 через TCP-сервис SVCE2

### 2. wmshow - система графического представления статистической информации монитора Websmon

Web-приложение wmshow, работающее под управлением HTTP-сервера Apache, служит для вывода собранных статистических данных в наглядном виде динамически создаваемых Web-страниц, содержащих большое количество графической информации. Далее даются некоторые пояснения, важные для понимания указанных Web-страниц.

| Вызов: |  | wmshow [ini-file]
|  |  | wmshow -help

Опциональные параметры:

| ini-file |  | - альтернативное имя конфигурационного файла; по умолчанию /home/websmon/websmon.ini
| -help |  | - вывод на экран краткой справки о версии программы

### 2.1. Главная страница монитора Websmon (1-й уровень)

Главная (стартовая) страница, создаваемая системой wmshow, содержит визуальную информацию об активных и неактивных хостах, TCP-сервисах и серверах баз данных PROGRESS.

Адрес главной страницы монитора:

       http://statserver:8080/websmon

Здесь и далее statserver означает имя сервера статистики, на котором установлен и работает монитор Websmon, а 8080 - номер порта (по умолчанию), на котором работает HTTP-сервер Apache.

Fig.1. Websmon - главная страница

На странице представлен список хостов, перед именами которых находится иконка, показывающая, активен или неактивен в данный момент тот или иной хост (зелёная галочка или красный крестик).

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

За именем хоста (в скобках) может идти строка краткого описания данного хоста (см. описание параметра конфигурации desc).

Имена тех хостов (серверов UNIX), для которых монитором собирается статистика использования их ресурсов, представлены на главной странице в виде гипертекстовых ссылок (links) на страницы статистики соответствующих серверов UNIX (страницы 2-го уровня, см. п.2.2).

В правой половине окна для некоторых активных хостов может присутствовать список TCP-сервисов, работающих на этих хостах, с иконкой-признаком активности сервиса (зелёный или красный - для неактивного сервиса - ромбики); подробнее см. описание параметра конфигурации TCP_services.

Под строками с описаниями некоторых хостов могут находиться строки со ссылками на страницы статистики серверов баз данных PROGRESS, работающих на этих хостах (страницы 2-го уровня, см. п.2.3).

Описания БД (параметр конфигурации dbdesc) представлены на Web-странице с некоторым смещением относительно описания соответствующего хоста.

Как и для вышеописанных хостов, перед именами баз данных имеется признак активности сервера БД и, возможно, присутствует иконка-признак уведомления администратора БД об остановке данного сервера БД (параметр конфигурации dbemail).

Строки с описаниями серверов БД появляются на главной странице монитора, только если соответствующий хост активен.

В правой половине страницы для активных серверов БД показана некоторая полезная информация о этой базе данных (актуальная на момент последнего сбора статистики), в частности, число пользователей, работающих в данной базе, размер БД, свободное место, остающееся в файлах БД в %% (эта информация важна для администрирования многотомной базы с fixed-length extents) и размер BI файла БД.

Под списком хостов и серверов БД на главной странице, как и на всех остальных Web-страницах, создаваемых системой wmshow, указан e-mail адрес ответственного системного администратора (см. параметр конфигурации MAIL).

В правом верхнем углу указаны дата и время создания страницы.

### 2.2. Страницы статистики серверов UNIX (2-й уровень)

Страницы, содержащие статистическую информацию об использовании ресурсов серверов UNIX и линки на Web-страницы соответствующих ресурсов.

Эти страницы расположены по следующему адресу:

       http://statserver:8080/websmon?host=HOSTNAME

(для статистики сервера UNIX HOSTNAME)

Fig.2. Статистика сервера UNIX - сводная информация *

* Верхняя половина Web-страницы

В верхней части страницы находится информация об имени сервера и времени, когда была обновлена статистика для этого сервера.

Ниже расположены линки на страницы, содержащие статистику использования следующих ресурсов сервера UNIX (т.е. на страницы статистики 3-го уровня, подробнее см. п.2.4):

- Средняя загрузка сервера (server load average); в центре страницы показано последнее значение этого параметра
- Число работающих в системе пользователей (number of logged users); показано число пользователей на момент последнего сбора статистики
- Число работающих процессов (number of running processes); приведено последнее известное число процессов
- % использования процессора(ов) сервера (четыре линка: сводная информация о загрузке CPU и отдельно %usr, %sys, %wio); в центре страницы указано значение загрузки CPU и его графическое представление (в виде bar'а)
- Использование оперативной памяти сервера (memory utilization): общий объём памяти в MB и % используемой памяти, а также графическое представление этого параметра
- Использование дискового пространства свопинга (disk swap space utilization): размер области свопинга в MB, % использованного места, а также графическое представление параметра
- Использование файловых систем (filesystems utilization): два линка для каждой из файловых систем, перечисленных в параметре конфигурации монитора fss; один из линков указывает на страницу статистики использования inodes данной файловой системы, другой - на страницу статистики дискового пространства; в центре страницы указаны последние известные значения размера и использованного дискового пространства файловой системы, а также графическое представление данного параметра
- Сетевая активность сервера (network activity): линки на страницы статистики суммарного трафика и суммарного показателя сетевых ошибок; приведены также линки на страницы статистики отдельных сетевых интерфейсов, перечисленных в параметре конфигурации монитора ifs
- Статистика системного ввода/вывода (system I/O activity)
- Статистика системного пейджинга (paging statistics)
- Статистика системного свопинга (swapping statistics)
- Статистика операций ядра ОС с семафорами (OS kernel semaphores operations activity)
- Статистика операций ядра ОС с очередями соообщений (OS kernel message queues activity)
- Статистика активности системных переключений контекста (system context switching activity)
- Время работы сервера (server uptime)

Далее находятся линки на страницы с отчётами об актуальном состоянии сервера UNIX (отчёты создаются по запросу пользователя, в отличие от перечисленных выше Web-страниц, которые содержат только собранную ранее статистику); представлены следующие отчёты:

- подробный отчёт о состоянии системы (host status report),
- список работающих в системе пользователей (list of logged users),
- список работающих процессов (list of running processes).

В нижней части страницы приводится список серверов БД PROGRESS, работающих на данном хосте, с линками на соответствующие Web-страницы и информацией о БД, актуальной на момент последнего сбора статистики, в частности, показывается число пользователей, работающих в БД, размер БД, свободное место, остающееся в файлах БД в %% и размер BI-файла БД.

В правом верхнем и в правом нижнем углах страницы расположены иконки навигации с линками на главную страницу монитора Websmon.

### 2.3. Страницы статистики серверов БД PROGRESS (2-й уровень)

Страницы, содержащие статистическую информацию об использовании ресурсов серверов БД PROGRESS и линки на Web-страницы соответствующих ресурсов.

Эти страницы расположены по следующему адресу:

       http://statserver:8080/websmon?host=HOSTNAME&service=SERVICENAME

Здесь HOSTNAME - имя хоста, на котором работает сервер БД PROGRESS, а SERVICENAME - имя TCP-сервиса, через который происходит соединение с БД.

Fig.3. Статистика ресурсов сервера БД PROGRESS - сводная информация *

* верхняя половина Web-страницы

В верхней части страницы находится информация об имени базы данных, имени хоста, на котором работает сервер БД (имя хоста представляет из себя линк на соответствующую страницу статистики 2-го уровня, см. п.2.2), и времени, когда была обновлена статистика этого сервера БД.

Ниже расположены линки на страницы, содержащие статистику использования следующих ресурсов сервера БД PROGRESS (т.е. на страницы статистики 3-го уровня, подробнее см. п.2.5):

- Количество клиентов, подсоединённых к БД (total number of database connections); показано значение этого и ряда других параметров на момент последнего сбора статистики
- Число пользователей, работающих с БД (number of database users)
- Число самообслуживающихся клиентов (number of self-serving clients)
- Число удалённых клиентов (number of remote clients)
- Количество запущенных дополнительных серверов БД (number of database servers)
- Размер БД (database size); приведены последние известные значения размера БД и величины использованного пространства в файлах БД, а также графическое представление этого параметра
- Размер BI файла БД (database BI size)
- Размер AI файла БД (database AI size)
- Номер генерации файла AI (database AI extent generation number) - для AI файлов фиксированной длины
- Статистика эффективности использования кэша БД (% попадания запросов на чтение в кэш БД (database cache hit ratios), в %% ко всем запросам; приводится последнее известное значение этого параметра и его графическое представление
- Статистика эффективности использования буферов кэша БД (database cache buffers utilization): общее число буферов кэша и % реально используемых буферов; приводятся последние известные значения этих параметров и их графическое представление
- Статистика использования таблицы блокировок БД (locking table utilization): общее число блокировок, доступных пользователям БД, и % реально используемых блокировок; приведены значения и графическое представление этих параметров
- Суммарная статистика эффективности использования PROGRESS database writers: APW, BIW, AIW (информация о %% от всех записей, произведённых указанными процессами)
- Информация о PROGRESS Asynchronous Page Writers: число запущенных процессов, % записей в БД, произведённых PROGRESS APW (значение и графическое представление этого параметра показываются только если запущен хотя бы один процесс APW)
- Информация о PROGRESS Before Image Writer: число запущенных процессов (т.е. флаг: 0 или 1), % записей в BI файл БД, произведённых PROGRESS BIW (значение и графическое представление этого параметра показываются, только если процесс BIW запущен)
- Информация о PROGRESS After Image Writer: число запущенных процессов (т.е. флаг: 0 или 1), % записей в AI файл БД, произведённых PROGRESS AIW (значение и графическое представление этого параметра показываются, только если процесс AIW запущен)
- Суммарная активность ввода/вывода в БД (database block I/O)
- Статистика ввода/вывода в БД отдельно для блоков данных БД (I/O for database data blocks)
- Статистика ввода/вывода в БД отдельно для индексных блоков БД (I/O for database index blocks)
- Статистика чтения блоков данных и индексных блоков БД (database read activity)
- Статистика записи блоков данных и индексных блоков БД (database write activity)
- Статистика ввода/вывода в BI файл БД (database BI I/O)
- Статистика записи в AI файл БД (database AI write activity)
- Активность проведения и отката транзакций в БД (database transactional activity)
- Суммарная активность операций с записями БД (database record access statistics): CRUD - создание, чтение, обновление, удаление записей
- Статистика создания записей БД (record creation statistics)
- Статистика чтения записей БД (record reading statistics)
- Статистика обновления записей БД (record updating statistics)
- Статистика удаления записей БД (record deletion statistics)
- Суммарная активность операций с индексами БД (database index access statistics): создание, поиск, удаление индексов
- Статистика создания индексов БД (index creation statistics)
- Статистика поиска индексов БД (index finding statistics)
- Статистика удаления индексов БД (index deletion statistics)
- Статистика чекпойнтов БД: число модифицированных блоков БД (dirty blocks) и блоков, сброшенных на диск при окончании чекпойнта (flushed blocks)
- Статистика ожиданий BI-буферов, отдельно для занятых буферов (waits for busy BI buffers) и пустых буферов (waits for empty BI buffers)
- Статистика ожиданий AI-буферов, включая общее число ожиданий (total number of waits for AI buffers) и число ожиданий занятых буферов (waits for busy AI buffers)
- Статистика ожиданий заблокированных записей БД (waits for locked database records)
- Время работы сервера БД (database uptime)

В нижней части страницы находятся линки на страницы с актуальными (т.е. создаваемыми по запросу пользователя) отчётами брокера БД (в противоположность перечисленным выше Web-страницам, содержащим только собранную ранее статистику):

- подробный отчёт о состоянии БД (database status report)
- список работающих в БД системных и пользовательских процессов (database user list).

В правом верхнем и в правом нижнем углах страницы расположены иконки навигации с линками на главную страницу монитора Websmon.

### 2.4. Страницы статистики системных ресурсов серверов UNIX (3-й уровень)

Страницы, содержащие статистическую информацию об использовании различных системных ресурсов серверов UNIX.

Эти страницы расположены по следующему адресу:

       http://statserver:8080/websmon?host=HOSTNAME&page=RESOURCE

(для статистики системного ресурса RESOURCE сервера UNIX HOSTNAME)

Fig.4. Статистика ресурсов сервера UNIX - усреднённая загрузка сервера *

* верхняя часть Web-страницы

В верхней части страницы находится информация об имени сервера (линк на соответствующую страницу статистики 2-го уровня, п.2.2), имени системного ресурса, статистика использования которого представлена на странице, и времени, когда эта статистика была обновлена.

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

Указанные графы расположены на странице либо в одну, либо в две колонки, что определяется значением параметра конфигурации layout: vertical (по умолчанию) или square.

Графы представляют следующую информацию:

- самый подробный однодневный граф с 5-минутными средними значениями по вертикальной оси и двухчасовыми отметками на горизонтальной шкале показывает изменения системного ресурса за последние 33 часа;
- недельный граф с 30-минутными средними значениями по вертикали и горизонтальной шкалой, размеченной в днях недели, представляет информацию о значениях ресурса за последние 8 дней;
- месячный граф с двухчасовыми средними значениями системного ресурса и горизонтальной шкалой с разметкой в номерах недель года даёт информацию об изменениях значения ресурса за последние 5 недель;
- и, наконец, наиболее обобщённый годовой граф с однодневными средними значениями системного ресурса и горизонтальной шкалой, размеченной в месяцах, представляет информацию об изменениях значения ресурса за последние 13 месяцев.

Под каждым графом приведены максимальное, среднее и текущее значения указанного системного ресурса с усреднением значений в соответствии с данными, представленными на графе (т.е. средние за 5, 30 минут, 2 часа или 24 часа).

Для вышеуказанных значений используются следующие единицы измерения (units):

- u = микро (10E-6, миллионные доли)
- m = милли (10E-3, тысячные доли)
- k = кило (10E3, тысячи)
- K = 1024
- M = мега (10E6, миллионы)
- G = гига (10E9, миллиарды)
- T = тера (10E12, триллионы)

В правом верхнем и в правом нижнем углах страницы расположены иконки навигации с линками на страницу соответствующего сервера UNIX (страницу статистики 2-го уровня) и главную страницу монитора Websmon.

### 2.5. Страницы статистики системных ресурсов БД PROGRESS (3-й уровень)

Страницы, содержащие статистическую информацию об использовании различных системных ресурсов БД PROGRESS.

Эти страницы расположены по следующему адресу:

       http://statserver:8080/websmon?host=HOSTNAME&service=SERVICENAME&page=RESOURCE

(для статистики системного ресурса RESOURCE сервера БД PROGRESS, работающего на хосте HOSTNAME через TCP-сервис SERVICENAME)

Fig.5. Статистика ресурсов сервера БД PROGRESS - количество клиентов различных типов (SELF, REMC, BATCH), подключённых к БД *

* верхняя часть Web-страницы

В верхней части страницы находится информация об имени базы данных и имени хоста, на котором работает сервер БД (линки на соответствующие страницы статистики 2-го уровня, см. п.2.3 и п.2.2), имени ресурса, статистика использования которого представлена на странице, и времени обновления статистики для этого сервера БД PROGRESS.

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

Графы расположены либо в одну, либо в две колонки (см. параметр конфигурации layout).

Графы представляют следующую информацию:

- самый подробный однодневный граф с 5-минутными средними значениями по вертикальной оси и двухчасовыми отметками на горизонтальной шкале показывает изменения системного ресурса за последние 33 часа;
- недельный граф с 30-минутными средними значениями по вертикали и горизонтальной шкалой, размеченной в днях недели, представляет информацию о значениях ресурса за последние 8 дней;
- месячный граф с двухчасовыми средними значениями системного ресурса и горизонтальной шкалой с разметкой в номерах недель года даёт информацию о изменениях значения ресурса за последние 5 недель;
- и, наконец, наиболее обобщённый годовой граф с однодневными средними значениями системного ресурса и горизонтальной шкалой, размеченной в месяцах, представляет информацию об изменениях значения ресурса за последние 13 месяцев.

Под каждым графом приведены максимальное, среднее и текущее значения указанного системного ресурса с усреднением значений в соответствии с данными, представленными на графе (т.е. средние за 5, 30 минут, 2 часа или 24 часа). Используемые в графах единицы измерения значений см. в п.2.4.

В правом верхнем и в правом нижнем углах страницы расположены иконки навигации с линками на страницу соответствующего сервера БД PROGRESS (страницу статистики 2-го уровня) и главную страницу монитора Websmon.

### 3. Другие программы, входящие в состав монитора Websmon

Все программы монитора Websmon при вызове с параметром -help выводят на экран краткую справку о версии программы и её параметрах.

### 3.1. websmon - скрипт сбора статистики

Предназначен для вызова программ сбора статистики wmgather или wmgather2 (в зависимости от значения настроечного параметра WMGATHER в скрипте). Применяется для запуска wmgather/wmgather2 из crontab пользователя websmon, там же определяется и частота вызовов (т.е. частота сбора статистики).

| Вызов: |  | websmon
|  |  | websmon -help

### 3.2. wmbar - программа для графического представления значений системных ресурсов

Вспомогательная CGI-программа, вызываемая из wmshow, предназначена для графического представления значений тех или иных системных параметров в виде цветной полоски (single graphic bar), выводимой в PNG формате.

| Вызов: |  | <img width=WIDTH height=HEIGHT src="wmbar?CGI-parameters">
|  |  | wmbar -help

Список возможных CGI-параметров:

| width |  | - длина графической полоски в пикселах
| height |  | - высота полоски
| val |  | - длина заполненной части полоски
| fg |  | - цвет заполненной части (в стандартной форме #RRGGBB)
| bg |  | - цвет незаполненной части (фона) полоски
| border |  | - цвет бордюра полоски
| refresh |  | - время обновления картинки в секундах

### 3.3. wmdbrrd - программа сохранения статистики в файлах базы данных статистики RRD

Предназначена для обновления RRD-файлов статистики серверов БД PROGRESS, вызывается из процедуры PROGRESS dbstatx2.p (программа wmgather2).

| Вызов: |  | wmdbrrd dbtype dir step logfile record
|  |  | wmdbrrd -help

Обязательные параметры:

| dbtype |  | - тип БД, для Websmon версии 1.0 всегда progress
| dir |  | - каталог RRD-файлов, например, /home/websmon/stats/server1/db1
| step |  | - шаг (временной интервал обновления данных, sampling interval) в соответствующих RRD-файлах в минутах, по умолчанию значение шага равно 5 минутам
| logfile |  | - файл протокола работы программы, по умолчанию /home/websmon/websmon.log; имя файла - означает STDOUT
| record |  | - данные статистики в CSV формате (см. п.5.3)

### 3.4. wmexport - скрипт для экпорта CSV файлов статистики

Предназначен для экспорта файлов статистики и работы монитора в режиме off-line.

Создаёт файл с именем wm%HOST%SVCE%MM%YYYY.tgz, или wm%HOST%MM%YYYY.tgz, содержащий статистику использования ресурсов сервера UNIX с именем HOST и сервера БД PROGRESS (работающего через TCP сервис SVCE) за месяц MM года YYYY (или же только статистику использования ресурсов сервера UNIX).

| Вызов: |  | wmexport -H host [-S service] [-d outdir] [-m month] [-y year]
|  |  | wmexport -help

Обязательный параметр:

| -H host |  | - имя хоста (сервера UNIX), для которого собрана статистика

Опциональные параметры:

| -S service |  | - имя TCP сервиса, на котором работает БД PROGRESS (по умолчанию экспортируется только статистика для сервера UNIX)
| -d outdir |  | - каталог, в котором будет создан экспортный файл (по умолчанию /home/websmon)
| -m month |  | - номер месяца года, за который требуется статистика, month = 1 - 12 (по умолчанию текущий месяц)
| -y year |  | - номер года, за который требуется статистика, year = 2000 - 2099 (по умолчанию текущий год)

### 3.5. wmgather - программа сбора статистики

Программа последовательно собирает статистику из всех серверов UNIX и БД PROGRESS, перечисленных в конфигурационном файле websmon.ini, записывая её в соответствующие CSV-файлы и затем обновляет RRD-файлы, основываясь на собранной статистике.

| Вызов: |  | wmgather [-no-rrd-update] [ini-file]
|  |  | wmgather -help

Опциональные параметры:

| -no-rrd-update |  | - не обновлять RRD-файлы
| ini-file |  | - альтернативное имя конфигурационного файла (по умолчанию /home/websmon/websmon.ini)

### 3.6. wmgather2 - программа сбора статистики, параллелизованная версия

Программа собирает статистику из всех серверов UNIX (последовательно) и БД PROGRESS (параллельно), перечисленных в конфигурационном файле websmon.ini, записывая её в соответствующие CSV-файлы и затем обновляет RRD-файлы, основываясь на собранной статистике.

Все серверы БД PROGRESS, работающие на одном хосте, опрашиваются одновременно (запускается одна клиентская сессия PROGRESS для каждого сервера БД), таким образом, экономится время опроса (что может оказаться важным для конфигураций с большим число БД) за счёт увеличения расхода ресурсов сервера статистики, прежде всего оперативной памяти.

| Вызов: |  | wmgather2 [-no-rrd-update] [ini-file]
|  |  | wmgather2 -help

Опциональные параметры:

| -no-rrd-update |  | - не обновлять RRD-файлы
| ini-file |  | - альтернативное имя конфигурационного файла (по умолчанию /home/websmon/websmon.ini)

### 3.7. wmhttpd - управляющий скрипт HTTP-сервера Apache

Управляющий скрипт для HTTP-сервера Apache httpd, входящего в состав монитора Websmon, предназначен для запуска Apache httpd при загрузке UNIX, т.е. из каталогов /etc/rcN.d.

| Вызов: |  | wmhttpd start
|  |  | wmhttpd stop
|  |  | wmhttpd restart
|  |  | wmhttpd status
|  |  | wmhttpd configtest
|  |  | wmhttpd help

wmhttpd, вызванный без параметров, показывает краткую справку о версии и параметрах скрипта

Управляющие параметры:

| start |  | - запуск Web-сервера
| stop |  | - остановка Web-сервера
| restart |  | - остановка с последующим перезапуском
| status |  | - сообщение о состоянии Web-сервера
| configtest |  | - проверка файла конфигурации Web-сервера httpd.conf
| help |  | - справка о командах Web-сервера

### 3.8. wmimport - скрипт для импорта CSV файлов статистики

Предназначен для импорта файлов статистики из удалённых хостов и работы монитора Websmon в режиме off-line. Читает экспортный файл, созданный скриптом wmexport, и воссоздаёт CSV и RRD-файлы статистики для указанных сервера UNIX и сервера БД PROGRESS.

| Вызов: |  | wmimport -f file [-d dir] [-y] [-s] [-i interval] [-q]
|  |  | wmimport -help

Обязательный параметр:

| -f file |  | - экспортный файл статистики wm%HOST%SVCE%MM%YYYY.tgz или wm%HOST%MM%YYYY.tgz за MM месяц года YYYY, собранной для сервера UNIX HOST и, возможно, для сервиса БД PROGRESS SVCE

Опциональные параметры:

| -d dir |  | - каталог файлов статистики, в котором будут созданы CSV и RRD-файлы (по умолчанию /home/websmon/stats)
| -y |  | - если каталог файлов статистики не существует, то он будет создан после соответствующего подтверждения оператора; указание ключа -y отменяет этот запрос
| -s |  | - импортировать только статистику сервера БД PROGRESS; по умолчанию импортируется вся имеющаяся в экспортном файле статистика
| -i interval |  | - явно указать значение sampling interval (временного шага обновления данных) в минутах для воссоздаваемых RRD-файлов; по умолчанию значение шага определяется из данных статистики, содержащихся в CSV файле
| -q |  | - не выводить сообщения в процессе работы скрипта

### 3.9. wmmkrrd - программа преобразования CSV файлов статистики в файлы базы данных RRD

Предназначена для воссоздания базы данных статистики в формате RRD из первичного CSV файла; вызывается из скрипта wmimport.

| Вызов: |  | wmmkrrd [-quiet -step value] -unix CSV_file RRD_dir
|  |  | wmmkrrd [-quiet -step value] -progress CSV_file RRD_dir
|  |  | wmmkrrd -help

Обязательные параметры:

| -unix |  | - создавать RRD-файлы для статистики сервера UNIX
| -progress |  | - создавать RRD-файлы для статистики сервера БД PROGRESS
| file |  | - имя CSV файла статистики
| dir |  | - каталог, в котором будут созданы RRD-файлы

Опциональные параметры:

| -quiet |  | - в процессе работы программы не выводить сообщения
| -step value |  | - значение шага (временного интервала обновления данных, sampling interval) для создаваемых файлов RRD в минутах; по умолчанию это значение определяется из данных статистики, содержащихся в CSV файле

### 3.10. wmsetup - программа настройки конфигурационных файлов монитора Websmon

Интерактивная программа wmsetup предназначена для облегчения настройки конфигурационного файла Websmon websmon.ini.

Программа предложит ввести лицензионную информацию Websmon (регистрационный код для временной лицензии, или же серийный номер, регистрационный код, и максимальное позволенное лицензией число серверов для постоянной лицензии).

Затем wmsetup запросит имена mail-серверов, используемых монитором для рассылки оповещений системному администратору.

После этого wmsetup предложит изменить интервал сбора статистики, который по умолчанию равен 5 минутам.

Изменять значение этого параметра, как и значения по умолчанию прочих параметров, без необходимости не рекомендуется.

Затем программа предложит настроить графические параметры системы wmshow, такие, как размер и ориентация графов (graphs) и цветовых полосок (graphic bars), их цвета (в форме RRGGBB, где RR, GG, и BB - шестнадцатиричные значения соответственно красного, зелёного и синего в цвете), цвета, используемые в создаваемых монитором Web-страницах статистики, картинка, используемая как background (может отсутствовать) и т.д.

Определения цветов, используемых в graphic bars, следует задавать в следующем виде:

           main_fg:main_bg:%warning:warn_fg:warn_bg:%alarm:alarm_fg:alarm_bg

Пример:

           00cc00:8fffff:80:ffff00:8fffff:98:ff0000:8fffff

Здесь main_fg и main_bg являются основным цветом и фоном bar'а при нормальном состоянии значения отображаемого параметра - например, зелёный 00cc00 на голубом 8fffff фоне при значении параметра в диапазоне от 0% до 80%, %warning - значение параметра, выходящее из нормальных границ (80% для данного примера), warn_fg и warn_bg - цвета bar'а в состоянии предупреждения (например, жёлтый ffff00 на голубом фоне), и, наконец, %alarm, alarm_fg и alarm_bg - значение и цвета параметра в состоянии тревоги (например, красный ff0000 на голубом фоне при значении параметра большем, чем 98%).

После этого wmsetup предложит переопределить каталог CSV и RRD-файлов статистики (по умолчанию /home/websmon/stats), и каталог для файлов блокировки монитора Websmon (по умолчанию /tmp/websmon).

Наконец, после установки всех вышеописанных параметров wmsetup начнёт настройку серверов, для которых должен производиться мониторинг.

Для всех настраиваемых параметров в существующем после инсталляции монитора Websmon конфигурационном файле имеются разумные значения настроек, так что Вы можете без опасений оставить параметры такими, как они есть; исключение составляют имена mail-серверов в Вашей системе, имена и e-mail-адреса системных администраторов, и, разумеется, сами определения серверов UNIX и БД PROGRESS, для которых необходимо вести мониторинг.

Вы всегда можете выйти из программы без изменения существующих настроек, ответив на очередной вопрос q[uit]

| Вызов: |  | wmsetup [ini-file]
|  |  | wmsetup -license [ini-file]
|  |  | wmsetup -help

Опциональные параметры:

| ini-file |  | - альтернативное имя конфигурационного файла (по умолчанию /home/websmon/websmon.ini)
| -license |  | - изменить только лицензионную информацию Websmon

### 3.11. wmsysid - программа для определения идентификатора сервера UNIX

Программа определяет уникальный идентификатор сервера UNIX, основываясь на аппаратной конфигурации сервера, и выводит имя сервера UNIX и указанный идентификатор в виде строки шестнадцатиричных цифр; используется для расчёта лицензии на монитор Websmon.

| Вызов: |  | wmsysid [-quiet]
|  |  | wmsysid -help

Опциональный параметр:

| -quiet |  | - показывать только системный идентификатор

### 3.12. wmwatch - программа мониторинга активности хостов, TCP-сервисов, и серверов БД PROGRESS

Программа наблюдает за активностью хостов (включая серверы UNIX), TCP-сервисов и серверов БД PROGRESS, указанных в конфигурационном файле websmon.ini. Если какой-либо сервер или TCP-сервис становится неактивным, то системному администратору может быть послано уведомление по e-mail и/или SMS. Программа wmwatch вызывается из crontab пользователя websmon, там же задаётся и частота проверок.

| Вызов: |  | wmwatch [-verbose] [ini-file]
|  |  | wmwatch -help

Опциональные параметры:

| -verbose |  | - в процессе работы выводить более подробные сообщения об ошибках
| ini-file |  | - альтернативное имя конфигурационного файла (по умолчанию /home/websmon/websmon.ini)

### 3.13. wmzip - скрипт для архивирования старых файлов данных, создаваемых монитором Websmon

Будучи вызванным без параметров, скрипт архивирует старые (созданные за предшествующие месяцы и годы) CSV файлы статистики, расположенные в каталоге /home/websmon/stats/ и в его подкаталогах.

Если же скрипт вызван с параметром -log, то он производит архивирование .log-файла протокола работы монитора Websmon /home/websmon/websmon.log.

Скрипт вызывается (обычно ежемесячно) из crontab пользователя websmon.

| Вызов: |  | wmzip
|  |  | wmzip -log
|  |  | wmzip -help

### 4. Конфигурационный файл монитора websmon.ini

Конфигурационный файл монитора Websmon (если не указано иное имя, то /home/websmon/websmon.ini, подробнее см. п.4.1) представляет собой простой текстовый файл, состоящий из некоторого числа обязательных и необязательных разделов (секций).

Каждая секция файла начинается с заголовка в виде [имя_секции], расположенного на отдельной строке, и заканчивается либо началом следующей секции, либо концом файла.
Имя секции может содержать буквы, цифры, подчёркивания и тире.

В конфигурационном файле может быть любое количество пустых строк (т.е. строк, содержащих только символы пробела и/или табуляции) и строк комментариев, начинающихся с символа # (или символа ;) и заканчивающихся концом строки. Все эти строки игнорируются при разборе файла.

Секции состоят из параметров в виде Name=Value (пробелы вокруг = игнорируются), каждый из которых начинается на отдельной строке:

     [Section1]
      Parameter1 = Value1
      Parameter2 = Value2
      ...

Строки могут быть продолжены:

     [Section2]
      Parameter1 = Value1 Value2 \
                   Value3 \
                   Value4 ...

Помимо однострочных, могут быть использованы многострочные (multi-line) параметры (в стиле UNIX "here documents"):

     [Section3]
      Parameter_Name=<<EOT
       Value1
       Value2
       ......
    EOT

Все начальные пробелы в строках игнорируются.

Имена обязательных (служебных) секций начинаются и заканчиваются знаками : (двоеточие), например, [:license:].

К служебным секциям конфигурационного файла относятся секции со следующими именами:

| [:default:] |  | - секция значений параметров по умолчанию; если при определении хоста или сервера БД PROGRESS какие-либо значения опущены (это, как правило, большинство, если не все, параметры), то значения этих параметров будут взяты из значений соответствующих параметров секции [:default:]
| [:system:] |  | - общесистемные настройки монитора Websmon
| [:graph:] |  | - настройки графов (graphs) для системы wmshow
| [:bar:] |  | - настройки graphic bars для системы wmshow
| [:license:] |  | - лицензионная информация монитора Websmon

Имена остальных секций соответствуют именам хостов или серверов баз данных PROGRESS, работающих на определённых хостах, за которыми нужно вести мониторинг (например, [sun] или [linux_server] для серверов sun и linux_server, или [sun:dbsvce] - здесь sun - имя хоста, за которым следуют разделительный символ : (двоеточие) и dbsvce - имя сервиса, или же номер порта TCP, через который работает сервер БД PROGRESS).

Параметры, используемые в описаниях хостов и серверов БД PROGRESS, подробно объяснены ниже, в описании секции [:default:].

Внимание: секции с именами хостов должны быть определены перед секциями с именами сервисов, работающих на этих хостах; при определении имён следите за регистром букв!

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

Для редактирования конфигурационного файла может быть использован любой текстовый редактор.

### 4.1. Местонахождение конфигурационного файла

При запуске программы монитора Websmon ищут конфигурационный файл в следующих каталогах (обратите внимание на порядок):

- 1-й аргумент командной строки (если аргумент указан и существует)
- значение переменной shell WEBSMON_INI (если переменная определена)
- $WEBSMON/websmon.ini (если переменная WEBSMON определена)
- /home/websmon/websmon.ini (или тот домашний каталог пользователя websmon, который был задан при инсталляции монитора)
- $HOME/websmon.ini
- /etc/websmon.ini

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

### 4.2. Несколько примеров секций конфигурационного файла

4.2.1. Пример секции для хоста с именем sun (сервер под управлением ОС Sun Solaris, проводится мониторинг TCP-сервисов telnet, ssh, ftp, smtp, http; помимо стандартной, собирается статистика для файловых систем /, /usr, /var, /tmp, /home, /home2, /u и сетевых интерфейсов ge0 и hme0):

    # Production server running Sun Solaris 8
    [sun]
       ostype = solaris
       desc = Sun Solaris 8
       TCP_services =<<EOT
             telnet = 23
             SSH = 22
             FTP = 21
             SMTP = 25
             HTTP = 80
    EOT
       email = telnet,SSH,FTP
       fss = / /usr /var /tmp /home /home2 /u
       ifs = ge0 hme0

4.2.2. Пример секции для хоста neptune (ОС MS Windows 2000, проводится мониторинг TCP-сервисов FTP, SMTP и HTTP):

    # MS Windows 2000 FTP and mail server
    [neptune]
       ostype = mswin2k
       desc = MS Windows 2000
       TCP_services =<<EOT
             FTP = 21
             SMTP = 25
             HTTP = 80
    EOT
       email = SMTP

4.2.3. Пример секции для хоста mars (ОС Novell Netware 5):

    # File server running Novell Netware 5
    [mars]
       ostype = netware
       desc = Novell Netware 5
       email = yes

4.2.4. Пример секции для сервера БД PROGRESS prodb1, работающего на хосте sun через TCP-сервис dbservice1:

    # PROGRESS V9.1D database running on the host 'sun' under Sun Solaris 8
    [sun:dbservice1]
       dbname = prodb1
       dbdesc = PROGRESS database #1
       dbactive = yes
       dbemail = yes
    # E-Mail settings
       MAIL =<<EOT
           To = Database Administrator <dba@domain.com>
           Subject = PROGRESS database sun:prodb1 is down!
           Message = PROGRESS database PRODB1 running on SUN is down on %date at %time
    EOT
    # Environment variables
      ENV =<<EOT
            DLC = /usr/dlc-9.1d
            PROMSGS = /usr/dlc-9.1d/prolang/ame/promsgs.ame
            PROTERMCAP = /usr/dlc-9.1d/protermcap
            TERM = ansi
    EOT

4.2.5. Пример секции для сервера БД PROGRESS prodb2, работающего на хосте neptune через порт TCP с номером 55252:

    # PROGRESS V8.3C database running on the host 'neptune' under MS Windows 2000
    [neptune:55252]
       dbname = prodb2
       dbdesc = PROGRESS database #2
       dbactive = yes
       dbemail = yes
    # E-Mail settings
       MAIL =<<EOT
           To = Database Administrator <dba@domain.com>
           Subject = PROGRESS database neptune:prodb2 is down!
           Message = PROGRESS database PRODB2 running on NEPTUNE is down on %date at %time
    EOT
    # Environment variables
      ENV =<<EOT
            DLC = /usr/dlc83c
            PROMSGS = /usr/dlc83c/prolang/ame/promsgs.ame
            PROTERMCAP = /usr/dlc83c/protermcap
            TERM = ansi
    EOT
    # Additional PROGRESS session parameters (for MS Windows 2K)
      dbparams = -Mm 512

### 4.3. Секция [:default:] - значения параметров по умолчанию

В этой секции определяются параметры хостов и серверов баз данных PROGRESS по умолчанию (т.е. те параметры, которые были пропущены при определении хостов и серверов БД).

Все перечисленные ниже параметры могут быть переопределены в секциях определения хостов и серверов БД.

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

#### ostype = undefined

Тип операционной системы по умолчанию (не определён); допустимы любые значения (например, для ОС MS Windows NT: mswin, MS_Windows_NT, WindowsNT и т.д., но системная статистика будет собираться и отображаться только для операционных систем со следующими типами: linux для Red Hat Linux 7.x, 8.x, 9 и Enterprise Linux AS 3, solaris для Sun Solaris 8 и 9, и unixware для SCO UnixWare 7.

(Вы можете также попробовать ostype=aix для IBM AIX, но в версии монитора 1.0 поддержка сбора статистики для этой операционной системы находится в стадии бета-тестирования и частично проверена только на древней версии IBM AIX 4.2).

#### desc = no host description

Строка описания хоста по умолчанию; любая не слишком длинная строка - 30-40 знаков - которая будет появляться за именем хоста на Web-страницах, создаваемых монитором Websmon, например:

        desc = Sun E6500 production server

#### active = yes

Состояние хоста по умолчанию (активное).

Вы можете принудительно временно определить хост для монитора Websmon как неактивный (т.е. запретить сбор всей статистики для этого хоста - и всех серверов БД, работающих на этом хосте), указав в качестве значения параметра active любое из ключевых слов no, not, off, disabled или 0.

Хост считается активным, когда параметр active установлен в одно из значений yes, on, enabled или 1.

Значения, приведённые выше, не зависят от регистра букв, например:

        active = NOT

#### TCP_services =

Список TCP-сервисов, работающих на данном хосте, для которых надо вести мониторинг. Используется в системах wmshow и wmwatch и по умолчанию представляет собой пустой список.

Список является параметром с multi-line value, например:

        TCP_services =<<EOT
            telnet = 23
            SSH = 22
            FTP = 21
            SMTP = 25
            HTTP = 80
    EOT

Здесь каждое значение представляет собой пару имя_сервиса = номер_порта. Если об остановке того или иного сервиса требуется оповещать системного администратора, добавьте имя_сервиса (например, telnet) к значению параметра email (см. ниже описание параметра email) через пробел или запятую:

        email = SSH,telnet,FTP

#### pingmode = tcp

Протокол, используемый по умолчанию для проверки активности хостов (на хосте, разумеется, должна быть включена поддержка TCP/IP).

Заметьте, что для использования протокола icmp программы монитора Websmon должны работать с правами root.

Допустимые значения: tcp, udp, icmp.

Рекомендуется использовать протокол tcp.

#### timeout = 2

Время тайм-аута при проверке активности хостов, по умолчанию 2 секунды.

#### email = no

Параметр определяет, должен ли системный администратор получать уведомление по e-mail об остановке хоста или об остановках определённых TCP-сервисов, работающих на этом хосте.

По умолчанию уведомление запрещено (при значении параметра email, установленном в no, not, off, disabled или 0).

При значениях yes, on, enabled или 1 администратор будет уведомлятся об остановке самого хоста, например:

        email = yes

Для уведомления об остановках хоста и работающих на хосте TCP-сервисов необходимо присвоить параметру email список имён этих TCP-сервисов, определённых в параметре TCP_services (см. выше). Имена сервисов в списке должны быть разделены пробелами или запятыми, например:

        email = telnet SSH FTP HTTP

#### remsh = /usr/local/bin/ssh

Имя remote shell, используемого для сбора статистики на удалённых хостах по умолчанию, возможно, с надлежащими опциями, например:

        remsh = rsh

или

        remsh = /usr/local/ssh/bin/ssh -1

#### interval = 10

Интервал (sampling interval) для сбора статистики серверов UNIX в секундах, по умолчанию 10 секунд.

#### ifs =

Список сетевых интерфейсов серверов UNIX (через пробел или запятую), для которых в системе монитора wmshow должна отображаться их статистика (т.е. входящий и исходящий сетевой трафик, входящие и исходящие ошибки на интерфейсе), например:

        ifs = hme0 hme1

По умолчанию отображается только суммарная сетевая статистика для всех сетевых интерфейсов сервера.

#### fss = /

Список файловых систем серверов UNIX (через пробел или запятую), для которых в системе монитора wmshow должна отображаться статистика их использования (размер и свободное место на файловой системе, общее число / число использованных inodes), например:

        fss = / /usr /var /tmp /home /home2

По умолчанию отображается только статистика использования корневой (/) файловой системы.

#### dbtype = PROGRESS

Тип базы данных по умолчанию.

В версии монитора Websmon 1.0 значение всегда PROGRESS (параметр зарезервирован для будущего использования).

#### dbname = database_name

Имя базы данных по умолчанию, например:

        dbname = test_db

#### dbdesc = PROGRESS database

Строка описания базы данных по умолчанию; любая не слишком длинная строка - 20-30 знаков - которая будет появляться на Web-страницах, создаваемых монитором Websmon, например:

        dbdesc = Production database for Bank A

#### dbactive = yes

Состояние сервера БД данных по умолчанию (активное).

Сервер БД считается неактивным (т.е. сбор статистики для этого сервера не производится), когда параметр dbactive устновлен в одно из значений no, not, off, disabled или 0.

Сервер БД считается активным, когда параметр dbactive установлен в одно из значений yes, on, enabled или 1.

Значения, приведённые выше, не зависят от регистра букв, например:

        dbactive = NOT

#### dbparams = -T /tmp

Дополнительные (опциональные) параметры клиентской сессии PROGRESS по умолчанию.

Параметры используются при подключении к серверу БД PROGRESS с целью сбора статистики и получения отчётов об актуальном состоянии БД.

Например, для подключения к серверу БД PROGRESS, работающему на сервере под управлением ОС MS Windows NT Вам могли бы потребоваться следующие параметры:

        dbparams = -T /tmp -Mm 512

#### dbemail = no

Параметр определяет, должен ли администратор БД получать уведомление по e-mail об остановке серверов БД.

По умолчанию уведомление запрещено (при значении параметра dbemail, установленном в no, not, off, disabled или 0).

При значениях yes, on, enabled или 1 администратор будет уведомлятся об остановке серверов БД, например:

        dbemail = yes

#### dbinterval = 10

Интервал (sampling interval) для сбора статистики серверов БД PROGRESS в секундах, по умолчанию 10 секунд.

#### MAIL = value

Список шаблонов для уведомления по e-mail по умолчанию.

Список является параметром с multi-line value, например:

        MAIL =<<EOT
             From = Websmon System Monitor <websmon@localhost>
             To   = System Administrator <root@localhost>
             CC   =
             BCC  =
             X-Mailer = Mail::Sendmail
             Subject = %host:%service is down
             Message = %host:%service is down on %date at %time
    EOT

Вы можете определить любые поля заголовка сообщения (e-mail header), используя текстовые строки и следующие подстановки:

| %date |  | - дата генерации сообщения в формате DayOfWeek Day-Month-Year
| %time |  | - время генерации сообщения в формате HH:MM:SS
| %host |  | - имя хоста, на котором произошёл сбой
| %service |  | - имя остановленного сервиса (опционально)

#### ENV = value

Список переменных, которые должны быть установлены перед запуском клиента PROGRESS (это может быть необходимым, к примеру, если в Вашей системе одновременно существуют несколько инсталляций PROGRESS).

Список является параметром с multi-line value, например:

        ENV =<<EOT
            DLC=/usr/dlc_91d
            PROMSGS=/usr/dlc_91d/prolang/ame/promsgs.ame
            PROTERMCAP=/usr/dlc_91d/protermcap
            TERM=ansi
    EOT

### 4.4. Секция [:system:] - общесистемные настройки монитора Websmon

Параметры, задаваемые в этой секции, определяют такие настройки монитора, как местонахождение служебных файлов и файлов статистики, цвета, background, кодовую страницу и интервалы обновления Web-страниц, создаваемых монитором Websmon и т.п.

В отличие от параметров из секции [:default:], параметры этой и остальных системных секций не могут быть переопределены отдельно для какого-либо хоста и/или сервера БД.

#### flagdir = /tmp/websmon

Параметр flagdir определяет каталог, в котором будут создаваться временные служебные файлы монитора (различные файлы блокировок). По умолчанию это каталог /tmp/websmon.

#### logfile = /home/websmon/websmon.log

Параметр logfile определяет файл протокола монитора Websmon, по умолчанию это файл /home/websmon/websmon.log. Имя файла - обозначает STDOUT.

#### statdir = /home/websmon/stats

Параметр statdir определяет имя каталога, в котором находятся файлы накопленной статистики (файлы расположены в подкаталогах statdir/SERVER и statdir/SERVER/SERVICE, где SERVER - имена хостов, а SERVICE - имена TCP-сервисов, используемых для связи с серверами БД.

Имена самих файлов статистики определяются месяцем и годом их создания (YYYYMM), например, 200401.csv для статистики, собранной в январе 2004 года.

#### polling_interval = 5

Этот параметр определяет значение интервала сбора статистики для системы wmgather (в минутах) и должен соответствовать значению интервала вызова скрипта websmon в crontab-файле пользователя websmon. Параметр также определяет частоту обновления (refresh time) всех, кроме главной, Web-страниц статистики, создаваемых монитором.

Значение параметра polling_interval по умолчанию - 5 минут. Изменять этот параметр не рекомендуется.

#### refresh = 30

Частота обновления (refresh time) главной (стартовой) Web-страницы монитора в секундах; по умолчанию 30 секунд.

#### bg_color = fff6f0

#### text_color = 000000

#### value_color = 0000ff

#### alink_color = ff00ff

Параметры определяют цвета, используемые на Web-страницах монитора: цвет фона (bg_color), текста (text_color), значений (value_color) и ссылок в тексте (alink_color).

Значения параметров цвета здесь и далее определяются в форме RRGGBB, где RR, GG, и BB - шестнадцатиричные значения соответственно красного, зелёного и синего в цвете.

#### background = bg4.jpg

Параметр определяет имя файла, содержащего background image (wallpaper); может отсутствовать. По умолчанию файл bg4.jpg.

Все файлы изображений находятся в каталоге, определяемом параметром конфигурации wmicons конфигурационного файла HTTP-сервера Apache httpd.conf (по умолчанию это каталог /home/websmon/icons, в котором находятся несколько background images с именами bg*.jpg).

Подробнее о файлах изображений, используемых монитором Websmon см. п.7.

#### charset = iso-8859-1

Кодировка, используемая на Web-страницах статистики монитора. По умолчанию используется кодовая страница ISO 8859-1.

#### MailServers = localhost

Список имён почтовых серверов, используемых для рассылки уведомлений об остановках хостов и/или серверов БД.

Список представляет собой доменные имена mail-серверов с опциональным указанием SMTP-портов (через пробел), например:

        MailServers = mail ms2:25 backup_mail:8025

#### UNIX_info = on

Параметр определяет, должны ли быть представлены на Web-страницах, создаваемых монитором, актуальные отчёты о состоянии серверов UNIX.

Если wmshow работает под управлением Web-сервера Apache отличного от того, который поставляется в составе Websmon, то у Вас могут возникнуть проблемы с получением таких отчётов на удалённых серверах UNIX, поскольку wmshow будет работать под UID apache и не сможет обеспечить беспарольный login в account websmon на удалённом сервере UNIX.

Ещё одна проблема доступа может возникнуть в связи с директивой HTTP-сервера suEXEC (поддержка которой должна быть разрешена при построении исполняемого файла HTTP-сервера).

Для устранения подобных проблем используйте HTTP-сервер Apache, поставляемый с монитором Websmon, и запускайте этот HTTP-сервер от имени пользователя websmon.

Если же Вы всё же должны запускать Web-приложение wmshow под управлением общесистемного HTTP-сервера Apache, то рекомендуется отключить параметр UNIX_info:

        UNIX_info = off

### 4.5. Секция [:graph:] - настройки графов (graphs) для системы wmshow

Параметры из этой секции определяют вид графов на Web-страницах статистики монитора Websmon, создаваемых системой wmshow.

Значения параметров цвета здесь и далее определяются в форме RRGGBB, где RR, GG, и BB - шестнадцатиричные значения соответственно красного, зелёного и синего в цвете.

#### width = 400

Ширина (X size) создаваемых графов в пикселах; по умолчанию 400.

#### height = 100

Высота (Y size) создаваемых графов в пикселах; по умолчанию 100.

#### ygrid =

Тип координатной сетки (Y grid lines), выводимой на графах; по умолчанию использована стандартная сетка (regular grid lines).

Вы можете попробовать

        ygrid = -R

или

        ygrid = -Y --no-minor

Изменять этот параметр не рекомендуется. Подробнее см. man rrdgraph

#### colorFont = 000000

#### colorBold = 0000ff

#### colorBG = f5f5f5

#### colorMgrid = 000000

#### colorFrame = 000000

#### colorArrow = ff0220

#### colorError = ff0220

#### colorVrule = ff0000

Цвета, используемые при создании графа: текст в графе (colorFont), жирный текст (colorBold), фон (colorBG), цвет координатной сетки (colorMgrid), цвет рамки (colorFrame), цвет стрелки на горизонтальной оси времени (colorArrow), цвет сообщения об ошибке (colorError), цвет вертикальных линий, отмечающих начало дня, недели, месяца и года (colorVrule).

Все цвета указываются в форме RRGGBB (см. выше).

#### color1 = 00cc00

#### color2 = 0000ff

#### color3 = ffaa00

#### color4 = ff00ff

#### color1max = 077727

#### color2max = 077c77

Цвета линий на графах: четыре основных цвета для отображаемых на графах (в виде линий и/или залитых областей) параметров и две линии максимальных значений.

Основные значения: зелёный, синий, жёлтый и фиолетовый цвета. Максимальные значения: тёмно-зелёный и тёмно-синий цвета.

#### layout = square

Ориентация графов на Web-страницах статистики, создаваемых монитором:

| layout = vertical |  | - вертикальная ориентация (в одну колонку): дневная статистика недельная статистика месячная статистика годовая статистика
| layout = square |  | - ориентация в форме квадрата (в две колонки): дневная статистика недельная статистика месячная статистика годовая статистика

### 4.6. Секция [:bar:] - настройки graphic bars для системы wmshow

Параметры в этой секции определяют вид single graphic bars, представляющих те или иные значения ресурсов серверов UNIX и серверов БД PROGRESS.

Цвета graphic bars определяются следующим образом:

        main_fg:main_bg:%warning:warn_fg:warn_bg:%alarm:alarm_fg:alarm_bg

Здесь main_fg и main_bg являются основным цветом и фоном bar'а при нормальном состоянии значения отображаемого параметра - например, зелёный на голубом фоне при значении параметра в диапазоне от 0% до 80%, %warning - значение параметра, выходящее из нормальных границ (80% для данного примера), warn_fg и warn_bg - цвета bar'а в состоянии предупреждения (например, жёлтый на голубом фоне), и, наконец, %alarm, alarm_fg и alarm_bg - значение параметра и цвета bar'а в состоянии тревоги (например, красный на голубом фоне при значении параметра большем, чем 98%).

Значения параметров цвета здесь и далее определяются в форме RRGGBB, где RR, GG, и BB - шестнадцатиричные значения соответственно красного, зелёного и синего в цвете.

#### width = 202

Ширина (X size) создаваемых bar'ов в пикселах; по умолчанию 202.

#### height = 9

Высота (Y size) создаваемых bar'ов в пикселах; по умолчанию 9.

#### colorBorder = 000000

Цвет рамки bar'а: по умолчанию чёрный (000000).

#### colorCPU = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

Bar для параметра загрузки CPU сервера UNIX: предупреждение при загрузке CPU более чем 90%, тревога при загрузке более чем 95%

#### colorMem = 0000ff:8fffff:98:ffff00:8fffff:99:ff0000:ffc0c0

Bar для параметра использования памяти сервера UNIX: предупреждение, если используется более чем 98% памяти, тревога, если более чем 99%

#### colorSwap = 0000ff:8fffff:80:ffff00:8fffff:90:ff0000:ffc0c0

Bar для параметра использования дискового пространства свопинга сервера UNIX: предупреждение, если используется более чем 80% swap space, тревога, если более чем 90%

#### colorFS = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

Bar для параметра использования файловой системы сервера UNIX: предупреждение, если занято более чем 90%, тревога, если более чем 95%

#### colorDBsize = 0000ff:8fffff:97:ffff00:8fffff:99:ff0000:ffc0c0

Bar для параметра использования файлов БД PROGRESS: предупреждение, если занято более чем 97%, тревога, если более чем 99%

#### colorDBhits = ff0000:ffc0c0:90:ffff00:8fffff:95:0000ff:8fffff

Bar для параметра database cache hits (попадание запросов на чтение в кэш БД): предупреждение, если параметр МЕНЬШЕ, чем 95%, тревога, если МЕНЬШЕ, чем 90% - возможно, необходимо увеличить размер кэша? (применена инвертированная цветовая карта)

#### colorDBbufs = ff0000:ffc0c0:75:ffff00:8fffff:80:0000ff:8fffff

Bar для параметра database cache utilization (использование буферов кэша БД): предупреждение, если использовано МЕНЕЕ чем 80% буферов кэша, тревога, если МЕНЕЕ чем 75% буферов кэша - кэш просто не используется, возможно, нужно уменьшить его размер (применена инвертированная цветовая карта)

#### colorDBlocks = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

Bar для параметра database locking table utilization (использование таблицы блокировок БД): предупреждение, если используется более чем 90% таблицы, тревога, если более чем 95% таблицы

#### colorAPW = ff0000:ffc0c0:50:ffff00:8fffff:75:0000ff:8fffff

Bar для параметра database APW utilization (использование PROGRESS Asynchronous Page Writers): предупреждение, если с помощью APW записано менее чем 75% всех записей в БД, тревога, если менее чем 50% записей - возможно, требуется запустить долнительный APW?

#### colorBIW = ff0000:ffc0c0:75:ffff00:8fffff:90:0000ff:8fffff

Bar для параметра database BIW utilization (использование PROGRESS BI Writer): предупреждение, если с помощью BIW записано менее чем 90% всех записей в BI area, тревога, если менее чем 75% BI записей

#### colorAIW = ff0000:ffc0c0:75:ffff00:8fffff:90:0000ff:8fffff

Bar для параметра database AIW utilization (использование PROGRESS AI Writer): предупреждение, если с помощью AIW записано менее чем 90% всех AI записей, тревога, если менее чем 75% AI записей

### 4.7. Секция [:license:] - лицензионная информация монитора Websmon

В этой секции находятся параметры, имеющие отношение к лицензии на использование монитора Websmon.

#### S/N

Серийный номер лицензии на монитор Websmon.

Параметр может отсутствовать для временной лицензии (trial license).

#### RegCode

Регистрационный код лицензии.

Этот параметр должен присутствовать в любом конфигурационном файле монитора Websmon.

#### MaxUnixSrv

Максимальное число серверов UNIX, для которых возможен мониторинг (параметр может отсутствовать для временной лицензии).

В качестве значения укажите ключевое слово UNLIMITED для лицензии с неограниченным числом серверов UNIX, и NONE, если Ваша лицензия не поддерживает мониторинг системных ресурсов серверов UNIX.

#### MaxProgSrv

Максимальное число серверов БД PROGRESS, для которых возможен мониторинг (параметр может отсутствовать для временной лицензии).

В качестве значения укажите ключевое слово UNLIMITED для лицензии с неограниченным числом серверов БД PROGRESS, и NONE, если Ваша лицензия не поддерживает мониторинг системных ресурсов серверов БД PROGRESS.

### 4.8. Пример конфигурационного файла монитора Websmon

    #comment
    #
    # @(#) A sample Websmon Monitor configuration file
    #
    # Websmon -- Web-based system performance monitor, version 1.01.
    # Copyright (C) 2003-2005 Dmitry Lapenkov. All rights reserved.
    #
    #

    ##################
    ## UNIX servers

    # SCO UnixWare 7
    [unixware]
       ostype = unixware
       desc = SCO UnixWare 7.1.1
       TCP_services =<<EOT
             telnet = 23
             SSH = 22
             FTP = 21
             HTTP = 80
    EOT
       remsh = rsh
       ifs = net0
       fss = / /usr /var /home /home2

    # Sun Solaris 8
    [sun]
       ostype = solaris
       desc = Sun Solaris 8
       TCP_services =<<EOT
             telnet = 23
             SSH = 22
             FTP = 21
             SMTP = 25
             HTTP = 80
    EOT
       fss = / /usr /home

    # Red Hat Linux 9
    [rhlinux]
       ostype = linux
       desc = Red Hat Linux 9
       TCP_services =<<EOT
             SSH = 22
             HTTP = 80
    EOT
       fss = / /usr

    # FreeBSD 5
    [mailsrv]
       ostype = freebsd
       desc = FreeBSD 5
       TCP_services =<<EOT
             SSH = 22
             FTP = 21
             DNS = 53
             SMTP = 25
             POP3 = 110
             HTTP = 8080
    EOT

    # MS Windows 2000
    [mswin2000]
       ostype = mswin2k
       desc = MS Windows 2000
       TCP_services =<<EOT
             FTP = 21
             SMTP = 25
             HTTP = 80
    EOT

    ###############################
    ## PROGRESS database servers

    # PROGRESS database prodb1 on sun
    [sun:prodb1]
       dbname = test
       dbdesc = Test database
       dbactive = yes

    #####################################################################
    ## Default settings for UNIX servers and PROGRESS database servers

    [:default:]

    # Default OS type [undefined]
      ostype = undefined

    # Default host description
      desc = no description

    # Default host state [active]
      active = yes

    # Default list of TCP services to be monitored [none]
      TCP_services =

    # Default protocol for 'ping': one of tcp, udp, icmp [tcp]
      pingmode = tcp

    # Default timeout for 'ping' [2 sec]
      timeout = 2

    # Should a UNIX sysadmin be notified by e-mail when UNIX server is down? [no]
      email = no

    # Default remote shell to access a remote host: rsh, ssh, etc [ssh]
      remsh = /usr/local/bin/ssh

    # Default sampling interval for a UNIX server [10 sec]
      interval = 10

    # Default list of network interfaces to be monitored [none]
      ifs =

    # Default list of UNIX file systems to be monitored [root file system only]
      fss = /

    # Default database type [PROGRESS]
      dbtype = PROGRESS

    # Default database name [dbname]
      dbname = dbname

    # Default database description
      dbdesc = PROGRESS database

    # Default state of a database server [active]
      dbactive = yes

    # Additional PROGRESS session parameters [-T /tmp]
      dbparams = -T /tmp

    # Should a DBA be notified by e-mail when database server is down? [no]
      dbemail = no

    # Default sampling interval for a database server [10 sec]
      dbinterval = 10

    # Default templates for the e-mail notifications
      MAIL =<<EOT
             From = Websmon System Monitor <websmon@localhost>
             To   = System Administrator <root@localhost>
             CC   =
             BCC  =
             X-Mailer = Mail::Sendmail
             Subject = %host:%service is down
             Message = %host:%service is down on %date at %time
    EOT

    # Environment variables
      ENV =<<EOT
            DLC = /usr/dlc
            PROMSGS = /usr/dlc/prolang/ame/promsgs.ame
            PROTERMCAP = /usr/dlc/protermcap
            TERM = ansi
    EOT

    ######################
    ## Graphs settings

    [:graph:]

    # Width of the graphs (X size) [400]
    # width = 400

    # Height of the graphs (Y size) [100]
    # height = 100

    # Graphs colors: font is black, bold is red, background is grey, major grid and
    #     frame are black, arrow head and error text are red, vertical ruler is red
    # colorFont = 000000
    # colorBold = 0000ff
    # colorBG   = f5f5f5
    # colorMgrid = 000000
    # colorFrame = 000000
    # colorArrow = ff0220
    # colorError = ff0220
    # colorVrule = ff0000

    # Graphs colors: 1st line is green and 2nd line is blue,
    #                3rd line is yellow, 4th line is violet
    # Maxima lines: 1st is dark green, 2nd is navy blue
    # color1 = 00cc00
    # color2 = 0000ff
    # color3 = ffaa00
    # color4 = ff00ff
    # color1max = 077727
    # color2max = 077c77

    # Graphs orientation: [vertical]
      layout = square

    ######################
    ## Bars settings

    [:bar:]

    # Width of the bars being created (X size) [202]
    # width = 202

    # Height of the bars being created (Y size) [9]
    # height = 9

    # Bars border color: black
    # colorBorder = 000000

    # Bars colors: CPU utilization bars
    #     default: blue on light blue, light yellow on light blue, red on pink
    # colorCPU = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

    # Bars colors: memory utilization bar
    # colorMem = 0000ff:8fffff:98:ffff00:8fffff:99:ff0000:ffc0c0

    # Bars colors: swap space utilization bar
    # colorSwap = 0000ff:8fffff:80:ffff00:8fffff:90:ff0000:ffc0c0

    # Bars colors: filesystem utilization bar
    # colorFS = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

    # Bars colors: database space utilization bar
    # colorDBsize = 0000ff:8fffff:97:ffff00:8fffff:99:ff0000:ffc0c0

    # Bars colors: database cache hits bar (inverted color map)
    # colorDBhits = ff0000:ffc0c0:90:ffff00:8fffff:95:0000ff:8fffff

    # Bars colors: database cache utilization bar (inverted color map)
    # colorDBbufs = ff0000:ffc0c0:75:ffff00:8fffff:80:0000ff:8fffff

    # Bars colors: database locking table utilization bar
    # colorDBlocks = 0000ff:8fffff:90:ffff00:8fffff:95:ff0000:ffc0c0

    # Bars colors: PROGRESS APW utilization bar (inverted color map)
    # colorAPW = ff0000:ffc0c0:50:ffff00:8fffff:75:0000ff:8fffff

    # Bars colors: PROGRESS BIW utilization bar (inverted color map)
    # colorBIW = ff0000:ffc0c0:75:ffff00:8fffff:90:0000ff:8fffff

    # Bars colors: PROGRESS AIW utilization bar (inverted color map)
    # colorAIW = ff0000:ffc0c0:75:ffff00:8fffff:90:0000ff:8fffff

    ######################
    ## System settings

    [:system:]

    # Directory where all Websmon flag and lock files reside [/tmp/websmon]
    # flagdir = /tmp/websmon

    # Websmon log file (- means STDOUT) [/home/websmon/websmon.log]
    # logfile = /home/websmon/websmon.log

    # Directory where .csv and .rrd statistic data files reside [/home/websmon/stats]
    # statdir = /home/websmon/stats

    # Polling interval for wmgather [5 minutes]
      polling_interval = 5

    # Refresh time for main Websmon page [30 sec]
    # refresh = 30

    # Colors of Websmon pages
    # bg_color = fff6f0
    # text_color = 000000
    # value_color = 0000ff
    # alink_color = ff00ff

    # Background image for Websmon pages (remove this if you want no background images)
      background = bg4.jpg

    # Charset of Web pages being created [ISO 8859-1]
    # charset = iso-8859-1

    # List of SMTP mail servers (mail_server_name[:port] ...) [localhost]
      MailServers = mailsrv localhost

    # Should the current UNIX host information be presented on the pages?
      UNIX_info = on

    ###########################
    ## Registration settings

    [:license:]

    # Registration code
      RegCode = $9BFF-09230-5CE6E-FAFBB-F7BE2

### 4.9. Как добавить определение нового хоста?

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

        [new_host_name]

Если Вы хотите, чтобы монитор сразу же начал собирать статистику работы вновь определённого сервера, то Вам нужно дополнительно определить тип операционной системы, работающей на этом хосте, т.е. указать значение параметра ostype (по умолчанию ostype=undefined), например:

        [new_host_name]
         ostype = solaris

Прочие параметры будут взяты из секции [:default:], хотя Вы могли бы найти полезным сразу же добавить строку описания хоста (параметр desc):

        [new_host_name]
         ostype = solaris
         desc = A Sun Solaris server

### 4.10. Как добавить определение нового сервера БД?

Если хост, на котором работает сервер БД, уже определён в конфигурационном файле, то сразу добавляйте определение сервера, иначе вначале добавьте определение хоста (см. п.4.9).

Для определения сервера БД достаточно завести секцию с именем, состоящим из имени хоста, на котором работает сервер БД, разделяющего двоеточия и имени TCP-сервиса, через который работает сервер БД, и единственным параметром dbname, определяющим имя базы данных, например:

        [host_name:proservice1]
         dbname = testdb1

Разумеется, имя TCP-сервиса (в вышеуказанном примере proservice1) должно быть определено (обычно в файле /etc/services).

Секция сервера БД должна быть определена в конфигурационном файле после определения того хоста, на котором работает сервер БД.

Все прочие параметры, относящиеся к серверу БД, будут взяты из секции [:default:]. Полезно, однако, сразу же добавить строку описания базы данных, например:

        [host_name:proservice1]
         dbname = testdb1
         dbdesc = Test PROGRESS database

### 5. Файлы данных, создаваемые монитором Websmon

Система сбора статистики монитора wmgather создаёт первичные CSV файлы и вторичные базы данных статистики в формате RRD в следующих каталогах:

/home/websmon/stats/SERVER - для статистики сервера UNIX SERVER
/home/websmon/stats/SERVER/SERVICE - для статистики сервера БД PROGRESS, работающего на хосте SERVER через TCP-сервис SERVICE

Имена CSV файлов статистики определяются месяцем и годом их создания (в форме YYYYMM), например, 200401.csv для статистики, собранной в январе 2004 года.

Подробнее о формате RRD (Round Robin Database) можно прочитать здесь: /home/websmon/rrdtool/doc/rrdtutorial.txt

### 5.1. CSV файлы статистики серверов UNIX

Формат CSV файлов статистики использования ресурсов серверов UNIX:

     # Комментарий - имя сервера UNIX, месяц и год, когда собиралась статистика
     # Комментарий - список имён полей CSV записи в данном файле

Поля CSV-записи:

1. Дата получения статистики (report timestamp), dd/mm/yy
2. Время получения статистики (report timestamp), HH:MM:SS
3. Время работы сервера UNIX (server uptime) в секундах
4. Число зарегистрированных пользователей (logged users) в системе
5. 1-минутное среднее значение server load average
6. 5-минутное среднее значение server load average
7. Загрузка CPU сервера: %usr
8. Загрузка CPU сервера: %sys
9. Загрузка CPU сервера: %wio
10. Загрузка CPU сервера: %idle
11. Вся память сервера (RAM), K bytes
12. Свободная память сервера, K bytes
13. Величина дискового пространства свопинга, K bytes
14. Свободное (неиспользованное) пространство для swap, K bytes
15. Системный ввод/вывод: чтение (system read), blk/s
16. Системный ввод/вывод: запись (system write), blk/s
17. Системный пейджинг: page in, page/s
18. Системный пейджинг: page out, page/s
19. Системный свопинг: swap in, blk/s
20. Системный свопинг: swap out, blk/s
21. Число процессов в системе
22. Активность переключений контекста, context switches/s
23. Активность операций с семафорами, sema/s
24. Активность операций с очередями сообщений ядра ОС, msg/s
25. Сетевой ввод/вывод, в следующем формате:

                  IF1=rx:tx:ierr:oerr IF2=rx:tx:ierr:oerr ...

    Здесь IF1, IF2 ... - имена сетевых интерфесов,
    rx - входящийтрафик, packets
    tx - исходящий трафик, packets
    ierr - входящие ошибки на интерфейсе
    oerr - исходящие ошибки на интерфейсе
    Пример:

                  eth0=456720:445767:0:0 lo=24192:24192:0:0

26. Использование файловых систем, в следующем формате:

                  /fs1=sizeK:freeK:inodes:ifree /fs2=sizeK:freeK:inodes:ifree ...

    Здесь /fs1, /fs2 ... - имена файловых систем,
    sizeK - объём файловой системы, K bytes
    freeK - свободное место на файловой системе, K bytes
    inodes - общее число inodes файловой системы
    ifree - число свободных inodes
    Пример:

                  /=2023952:556092:257536:204506 /usr=6158948:2577944:783360:616935

### 5.2. RRD-файлы (база данных статистики) для серверов UNIX

Вместе с CSV файлом статистики сервера UNIX система wmgather создаёт и затем обновляет базу данных статистики в формате RRD, состоящую из следующих файлов:

| cpusys.rrd |  | - %sys CPU, %total (%sys+%usr+%wio) CPU
| cpuusr.rrd |  | - %usr CPU, %total CPU
| cpuwio.rrd |  | - %wio CPU, %total CPU
| cswitch.rrd |  | - system context switching, switch per sec
| fs%.rrd |  | - root filesystem: used filesystem space in K, total filesystem size in K
| in%.rrd |  | - root filesystem: used inodes, total number of inodes
| fs%usr.rrd |  | - /usr filesystem: space
| in%usr.rrd |  | - /usr filesystem: inodes
| fs%........rrd |  |
| in%........rrd |  | - и т.д. для всех файловых систем, перечисленных в конфигурационном файле websmon.ini
| neterrs.rrd |  | - total of network errors: incoming errors, outgoing errors
| network.rrd |  | - total of network traffic: incoming and outgoing traffic, pkt/s
| iferr_eth0.rrd |  | - network errors on 'eth0': incoming errors, outgoing errors
| if_eth0.rrd |  | - network traffic on 'eth0': incoming and outgoing traffic, pkt/s
| iferr_ppp0.rrd |  | - network errors on 'ppp0': incoming errors, outgoing errors
| if_ppp0.rrd |  | - network traffic on 'ppp0': incoming and outgoing traffic, pkt/s
| iferr_.......rrd |  |
| if_..........rrd |  | - и т.д. для всех сетевых интерфейсов, перечисленных в конфигурационном файле websmon.ini
| io.rrd |  | - system I/O: system reading activity rate, blk/s, system writing activity rate, blk/s
| load.rrd |  | - server load averages: 1-minute averages, 5-minute averages
| memory.rrd |  | - server memory: used memory in K, total memory in K
| message.rrd |  | - kernel message queues activity, msg/s
| paging.rrd |  | - system paging: paging in and paging out, page/s
| process.rrd |  | - number of running processes
| semaphore.rrd |  | - kernel semaphores activity, sema/s
| swapping.rrd |  | - system swapping: swapping in and swapping out, blk/s
| swap.rrd |  | - disk swap space: used swap space in K, total swap space in K
| uptime.rrd |  | - server uptime, sec
| users.rrd |  | - number of logged users

### 5.3. CSV файлы статистики серверов БД PROGRESS

Формат CSV файлов статистики использования ресурсов серверов БД PROGRESS.

Здесь значения, описываемые как "общие" (total), определяются с момента старта брокера БД (или с момента включения подсистемы журналирования БД (After-Imaging), если речь идёт о параметре, относящемся к AI), в то время как значения, описываемые как "текущие" (current) - за время сбора статистики (т.е. за sampling interval)

     # Комментарий - имя базы данных и хоста, на котором работает сервер БД,
     #                       месяц и год, когда собиралась статистика
     # Комментарий - список имён полей CSV записи в данном файле

Поля CSV-записи:

1. Дата получения статистики (report timestamp), dd/mm/yy
2. Время получения статистики (report timestamp), HH:MM:SS
3. Время работы сервера БД PROGRESS (dbserver uptime) в секундах
4. количество non-batch клиентов (т.е. пользователей), подключенных к БД
5. количество batch клиентов, подключенных к БД
6. количество self-serving клиентов (SELF), подключенных к БД
7. количество remote клиентов (REMC), подключенных к БД
8. количество запущенных дополнительных серверов БД (SERV)
9. Размер БД в блоках
10. Число свободных блоков (free blocks) в файлах БД
11. Число пустых блоков (empty blocks) в файлах БД
12. Размер BI файла(ов), K
13. Размер BI кластера, K
14. Число закрытых BI кластеров
15. Свободное место в используемом BI кластере в байтах
16. Размер файла AI, K (0, если используются fixed-length AI extents)
17. Номер генерации файла AI (для fixed-length AI extents)
18. Размер блока данных БД, K
19. Размер BI блока БД, K
20. Размер AI блока БД, K
21. Общее число буферов в буферном пуле (размер кэша БД)
22. Число использованных буферов пула
23. Общее число логических запросов на чтение из БД (logical reads)
24. Общее число запросов на чтение на уровне ОС (OS reads)
25. Текущий уровень попадания запросов на чтение в кэш БД (database cache hit ratio) в %
26. Общее количество прочитанных блоков БД
27. Общее количество записанных блоков БД
28. Текущее значение активности чтения блоков БД, блок/сек
29. Текущее значение активности записи блоков БД, блок/сек
30. Общее количество прочитанных BI блоков
31. Общее количество записанных BI блоков
32. Текущее значение активности чтения BI блоков, блок/сек
33. Текущее значение активности записи BI блоков, блок/сек
34. Общее количество записанных AI блоков
35. Текущее значение активности записи AI блоков, блок/сек
36. Текущее значение активности проведения транзакций в БД (transactions committed), транзакций в сек
37. Текущее значение активности отката транзакций в БД (transactions undone), транзакций в сек
38. Текущее значение активности чтения записей БД, записей в сек
39. Текущее значение активности создания записей БД, записей в сек
40. Текущее значение активности обновления записей БД, записей в сек
41. Текущее значение активности удаления записей БД, записей в сек
42. Общее количество записей в БД
43. Общее количество записей, произведённых PROGRESS APW
44. Текущий показатель эффективности использования PROGRESS APW, %
45. Общее количество записей в BI файл(ы) БД
46. Общее количество записей, произведённых PROGRESS BIW
47. Текущий показатель эффективности использования PROGRESS BIW %
48. Общее количество записей в AI файл(ы) БД
49. Общее количество записей, произведённых PROGRESS AIW
50. Текущий показатель эффективности использования PROGRESS AIW %
51. Количество работающих PROGRESS APW (0 ... N)
52. Количество работающих PROGRESS BIW (0 или 1)
53. Количество работающих PROGRESS AIW (0 или 1)
54. Общее число произведённых checkpoints
55. Время старта последнего checkpoint
56. Время финиша последнего checkpoint
57. Число модифицированных (dirty) блоков, которые должны были быть записаны во время последнего checkpoint
58. Число блоков, которые не удалось записать за время последнего checkpoint и которые поэтому должны были быть сброшены (flushed) на диск в момень окончания checkpoint
59. Размер системной таблицы блокировок БД (locking table)
60. Количество блокировок, используемых в данный момент
61. Количество блокировок, использованных с момента старта брокера БД
62. Количество ожиданий shared и exclusive блокировок БД
63. Количество ожиданий заблокированных записей БД
64. Текущее значение активности чтения блоков данных БД, блок/сек
65. Текущее значение активности записи блоков данных БД, блок/сек
66. Текущее значение активности чтения индекных блоков БД, блок/сек
67. Текущее значение активности записи индекных блоков БД, блок/сек
68. Текущее значение активности создания индексов в БД, индекс/сек
69. Текущее значение активности удаления индексов в БД, индекс/сек
70. Текущее значение активности поиска индексов в БД, индекс/сек
71. Количество ожиданий занятых буферов BI (busy BI buffers waits)
72. Количество ожиданий пустых буферов BI (empty BI buffers waits)
73. Количество ожиданий занятых буферов AI (busy AI buffers waits)
74. Общее количество ожиданий буферов AI
75. Активность запросов для получения эксклюзивных блокировок (exclusive locks), запросов/сек
76. Активность выдачи exclusive locks, locks/сек
77. Количество ожиданий exclusive locks
78. Активность запросов для получения разделяемых блокировок (share locks), запросов/сек
79. Активность выдачи share locks, locks/сек
80. Количество ожиданий share locks
81. Активность запросов для получения блокировок доступа к записи (record get locks), запросов/сек
82. Активность выдачи record get locks, locks/сек
83. Количество ожиданий record get locks

### 5.4. RRD-файлы (база данных статистики) для серверов БД PROGRESS

Вместе с CSV файлом статистики сервера БД PROGRESS система wmgather создаёт и затем обновляет базу данных статистики в формате RRD,

состоящую из следующих файлов:

| activity.rrd |  | - transactions committed per sec, transactions undone per sec
| aiextnum.rrd |  | - AI extent generation number
| aiio.rrd |  | - AI block writing rate, block per sec
| aisize.rrd |  | - AI size, bytes
| aiwait.rrd |  | - number of busy AI buffers waits, total AI buffers waits
| aiw.rrd |  | - AI writes performed by AIW, % (current / cumulative values)
| apw.rrd |  | - DB writes performed by APW, % (current / cumulative values)
| biio.rrd |  | - BI block I/O rates, block per sec
| bisize.rrd |  | - BI size, bytes
| biwait.rrd |  | - number of busy BI buffers waits and empty BI buffers waits
| biw.rrd |  | - BI writes performed by BIW, % (current / cumulative values)
| cachebufs.rrd |  | - number of used buffers, total number of db cache buffers
| cachehits.rrd |  | - db cache hit ratios (current / cumulative values)
| checkpoint.rrd |  | - number of flushed blocks, number of dirty blocks
| dataio.rrd |  | - database data blocks I/O rates, block per sec
| dbio.rrd |  | - database I/O rates, block per sec
| dbread.rrd |  | - database data and index blocks reading rates, block per sec
| dbremc.rrd |  | - number of REMC database connections, total db connections
| dbself.rrd |  | - number of SELF database connections, total db connections
| dbserver.rrd |  | - number of database SERVers runnning, REMC db connections
| dbsize.rrd |  | - used database space in bytes, database size in bytes
| dbuptime.rrd |  | - database uptime in seconds
| dbusers.rrd |  | - user database connections, total (user+batch) db connections
| dbwrite.rrd |  | - database data and index blocks writing rates, block per sec
| indexc.rrd |  | - database index creation rate, index per sec
| indexd.rrd |  | - database index deletion rate, index per sec
| indexf.rrd |  | - database index finding rate, index per sec
| indexio.rrd |  | - database index blocks I/O rates, block per sec
| locktable.rrd |  | - number of record locks currently in use, locking table size
| naiw.rrd |  | - number of PROGRESS AIW running (that is, 0 or 1)
| napw.rrd |  | - number of PROGRESS APW running
| nbiw.rrd |  | - number of PROGRESS BIW running (that is, 0 or 1)
| recc.rrd |  | - database record creation rate, record per sec
| recd.rrd |  | - database record deletion rate, record per sec
| recr.rrd |  | - database record reading rate, record per sec
| recu.rrd |  | - database record updating rate, record per sec
| recwait.rrd |  | - number of waits for locked database records

### 6. Сообщения монитора Websmon

Сообщения, возникающие в процессе работы программ монитора Websmon, записываются в файл протокола websmon.log, находящийся в каталоге /home/websmon. Файл websmon.log регулярно архивируется (см. описание скрипта wmzip).

Некоторые сообщения о системных ошибках UNIX (возникающие преимущественно в системе планирования и исполнения задач cron) операционная система может посылать на почтовый адрес пользователя websmon.

Для того, чтобы просмотреть эти сообщения, используйте команду mail.

Если Вы зарегистрированы не под идентификатором websmon, то используйте команду su root -c "mail -u websmon"

Сообщения о сбоях и остановках хостов, TCP сервисов и серверов БД PROGRESS посылаются системой wmwatch указанным в конфигурационном файле монитора Websmon системным администраторам и/или администраторам БД.

Те ошибки и сообщения системы wmshow, которые возникают в процессе работы HTTP-сервера Apache, записываются в файл протокола ошибок HTTP-сервера /home/websmon/apache/logs/error_log

### 7. Приложение

Список и краткое описание файлов, находящихся в каталоге misc:

apache.conf

- директивы конфигурационного файла HTTP-сервера Apache httpd.conf, необходимые для работы системы wmshow монитора; в частности, здесь определены такие параметры, как websmon - Web-приложение wmshow, wmbar - вспомогательная программа для изображения single graphic bars и wmicons - каталог, в котором расположены статические файлы изображений (image- и icon-файлы), используемые монитором Websmon.

| crontab |  | - прототип crontab-файла пользователя websmon
| profile |  | - настройки для файла .profile пользователя websmon
| websmon.ini |  | - пример конфигурационного файла монитора Websmon

uw7_top.tgz

- утилита top (исполняемый файл для ОС SCO UnixWare 7.1), необходимая для получения части системной статистики (server load averages) на серверах под управлением ОС SCO UnixWare 7.1.
Инсталлируйте этот программу на удалённых серверах, для которых собирается статистика, в каталог /usr/local/bin (разумеется, только в том случае, если утилита top на этих серверах ещё не установлена), используя следующую команду:
cd / ; su root -c "gzip -cd uw7_top.tgz | tar xvf -"
В противоположном случае статистика средней загрузки удалённых серверов, работающих под управлением ОС SCO UnixWare 7.1, собираться и отображаться монитором не будет (вся остальная статистика будет и собираться, и отображаться в обычном режиме).

aix_top.tgz

- утилита top (исполняемый файл для IBM AIX 4.2), необходимая для получения части системной статистики (использование дискового пространства свопинга) на серверах под управлением этой операционной системы.
Инсталлируйте эту программу на удалённых серверах, работающих под управлением IBM AIX, в каталог /usr/local/bin, используя следующую команду:
cd / ; su root -c "gzip -cd aix_top.tgz | tar xvf -"
В противоположном случае указанная статистика собираться и отображаться монитором не будет (прочая статистика будет собираться и отображаться в обычном режиме).

PROGRESS © is a trademark of the Progress Software Corporation