[система Cacti — мониторинг нестандартных объектов]материал подготовил: Андрей Бородийчук 25.05.2006
В процессе работы с Cacti рано или поздно приходит такой момент, когда вы прекрасно осознаете, что эта система способна делать гораздо больше, нежели то, чем она сейчас у вас занимается. Есть еще десятки и сотни параметров, историю изменения которых вам хотелось бы видеть в любое время дня и ночи, но их отслеживание, к сожалению, не предусмотрено в стандартном наборе функций. Как же сделать так, чтобы все они в один прекрасный момент предстали перед вами в виде красивых цветных графиков?
Рассмотрим реальную задачу. Есть большая сеть, разбитая маршрутизаторами* на более мелкие подсети. Необходимо отслеживать, сколько пользователей обслуживается каждым маршрутизатором и сколько из них блокированы за неуплату. В нашем распоряжении база данных биллинга, в которой есть таблица, где каждой машине поставлен в соответствие IP-адрес маршрутизатора.
Для начала создается скрипт*, который сможет вывести в консоль требуемые величины в формате name1:value1 name2:value2 (количество переменных может быть любым) в зависимости от переданного ему параметра.
<?php # Подключение к базе данных $db = mysql_connect (‘host’, ‘login’, ‘pass’); mysql_select_db (‘database’, $db); # Аргумент, переданный скрипту $router = $_SERVER[‘argv’][1]; # Запрос-выборка общего количества клиентов $clients = mysql_query(‘select count(*) from clients where router=»‘.$router.'»‘); # Запрос-выборка количества блокированных клиентов $blocked = mysql_query(‘select count(*) from clients where router=»‘.$router.'» and blocked=1′); # Обработка результатов $clients = mysql_fetch_row($clients); $blocked = mysql_fetch_row($blocked); # Вывод результата printf(‘clients:%d blocked:%d’, $clients, $blocked); ?>
Этот скрипт логичнее всего будет поместить в папку scripts директории, в которую установлена Cacti. Далее он тестируется вручную. При вызове из командной строки он должен возвратить требуемый результат (не забудьте передать ему обязательный аргумент — IP-адрес маршрутизатора):
Когда скрипт сбора данных готов, следует привязать его к Cacti. Для этого переходим к методам сбора данных (Data Input Methods). Щелкая по ссылке Add, создаем новый метод. Заполняем поля:
Name — это описание, которое будет вам понятно. В нашем случае логично будет написать Router: Clients, Blocked.
Input Type — способ получения данных. Выбираем Script/Command.
Input String — командная строка. Сюда следует ввести команду, которой мы тестировали скрипт, заменив обязательный параметр на имя переменной в угловых скобках: /usr/bin/php -q /home/www/cacti/scripts/routers.php <router>.
Далее нажимаем кнопку Create и замечаем, что к форме добавились две таблицы: Input Fields и Output Fields. Первая — это параметры, передаваемые скрипту. Вторая — переменные, возвращаемые скриптом. Нажимаем Add в таблице Input Fields и заполняем форму:
Field [Input] — выпадающий список, в котором перечислен
ы все переменные, передаваемые скрипту. Они берутся из строки, которую мы ввели как команду в предыдущей форме. В нашем случае там только один пункт — router. Его и следует выбрать.
Friendly Name — описание данного параметра. пишем Router IP.
Остальные поля для нас не важны, за исключением разве что галочки Allow Empty Input — разрешить запуск скрипта без данного параметра (но тогда нужно было в самом скрипте предусмотреть обработку подобной ситуации!). Снова нажимаем Create и возвращаемся в свойства этого метода ввода данных. Переходим к таблице Output Fields, нажимаем там Add и заполняем ее форму:
Name — имя возвращаемого значения. Указываем clients (должно совпадать с возвращаемым скриптом параметром, однако если он один, то допускается любое).
Friendly Name — его описание. В нашем случае — Clients count.
Галочка Update RRD File символизирует о том, что этот параметр следует отслеживать, а не игнорировать (возможен случай, когда часть параметров, возвращаемых скриптом, неинтересна в плане мониторинга).
Сохраняем и повторяем то же для переменной blocked с описанием Blocked clients count. На этом редактирование метода ввода данных окончено, остается только нажать кнопку Save.
Далее переходим к шаблонам хранения данных (Data Templates) — создаем новый, заполняем поля. В таблице Data Templates:
Name — имя, которое будет отображаться. К примеру — Router stats.
Далее таблица Data Source — это хранилища данных. Обратите внимание — здесь появляются напротив каждого поля галочки Use Per-Data Source Value. Если мы ее установим, то используемое значение можно будет впоследствии изменить уже непосредственно при создании того или иного объекта на основе этого шаблона.
Name — так будут называться хранилища статистики. пишем Router stats: Clients, Blocked.
Data Input Method — из выпадающего списка выбираем созданный нами ранее метод ввода данных: Router: Clients, Blocked.
оставшиеся поля таблицы Data Source оставляем как есть. Табличка Data Source Item содержит описание отслеживаемой переменной — одной или нескольких.
Internal Data Source Name — внутреннее название отслеживаемой переменной. Указываем blocked.
Нажимаем Create и видим результат: в эту табличку добавилась строка Output Field и появилась таблица Custom Data.
В выпадающем списке поля Output Field можно увидеть переменные и их описания, которые мы задавали в методе ввода данных. Поскольку внутреннее название переменной мы дали blocked — выбираем из списка соответствующую величину blocked — Blocked clients count.
Поля Minimum Value и Maximum Value позволяют задать пределы изменения отслеживаемой величины — если она выйдет за эти рамки, то на графике будет пробел.
В Data Source Type выбираем GAUGE — это значит, что величина будет записываться «как есть». Если бы мы выбрали COUNTER — записывалась бы разница между прошлым и текущим ее состоянием.
Heartbeat оставляем как есть — это своеобразная внутренняя перестраховка Cacti от зависания.
Далее в этой же таблице нажимаем New — и появляется второе внутреннее хранилище. Заполняем аналогично первому, только имя даем ему clients и, соответственно, Output Field выбираем clients — Clients count. Кроме того, Cacti по умолчанию проставляет максимальное значение параметра в 100, поэтому будьте внимательны и лучше установите его в ноль, чтобы не было потом недоразумений. Далее заполняем таблицу Custom Data — она содержит пользовательские данные, передаваемые скрипту (если таковые требуются, и в нашем случае они требуются). Поскольку у нас в методе сбора данных только один параметр передается скрипту, то в этой таблице только одно поле, названное, как и наш комментарий к данному параметру: Router IP. Вот здесь однозначно следует установить галочку Use Per-Data Source Value — чтобы мы могли задать этот параметр отдельно для каждого хранилища (то есть чтобы собирать информацию одновременно с нескольких маршрутизаторов), и в качестве значения по умолчанию можно ввести, к примеру, 10.1.0. (допустим, что все
