IPASTAT(8) IPASTAT(8)
НАИМЕНОВАНИЕ
ipastat -- утилита просмотра статистики
СИНТАКСИС
ipastat -h|v
ipastat [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
-t [-t]
ipastat [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
-q <query>
ОПИСАНИЕ
Утилита ipastat используется для запроса статистики у IPA модулей ста-
тистики и для вывода результатов на стандартный вывод (stdout). Стра-
ница документации ipastat.conf(5) содержит полное описание как конфигу-
рировать ipastat, она также содержит описание всех возможностей этой
утилиты.
ipastat, в соответствии с настройками в конфигурационном файле ipas-
tat.conf(5) и установоками в командной строке, запрашивает IPA модули
статистики и выводит результаты на стандартный вывод. Эта утилита поз-
воляет выводить список правил, лимитов и порогов, выводить статистику
для правил, лимитов и порогов. Возможно одновременно использовать
несколько систем статистики и одновременно запрашивать статистику для
нескольких правил, лимитов и порогов.
ipastat не воспринимает никаких сигналов и обработка сигналов не опре-
делена.
Доступные опции:
-c <directory>
Определяет директорию, для которой ipastat сразу же выполнит
функцию chroot(2), директория должна быть задана с абсолютным
путевым именем. Рабочая директория не изменяется.
-f <config-file>
Использовать данный конфигурационный файл вместо конфигурацион-
ного файла, заданного по умолчанию. Конфигурационный файл должен
быть задан с абсолютным путевым именем.
-u <user>
Изменить UID запущенной копии ipastat. Указанное значение может
быть именем пользователя или UID. Если опция -g не указана, то
GID будет равен группе указанного пользователя, также будут
установлены все дополнительные группы пользователя.
-g <group>
Изменить GID запущенной копии ipastat. Указанное значение может
быть именем группы или GID. Эта опция также заменяет все допол-
нительные группы пользователя.
-t Проверить конфигурационный файл на правильность, вывести его
содержимое и завершить работу. Эта опция позволяет проверить,
понимает ли ipastat и IPA модули ваш конфигурационный файл или
нет. Выведенная конфигурация обычно не должна использоваться как
конфигурационный файл (см. комментарий в выводе). Два ключа -tt
включают так называемый ``режим подражания реальной конфигура-
ции'', в этом режиме ipastat установит все значение по умолчанию
и применит установки из секций rulepat для секций rule.
-q <query>
Запрос статистики из IPA модулей статистики (описан в отдельном
списке опций).
-h Вывести информацию о доступных опциях и завершить работу.
-v Вывести номер версии, некоторые установки, что поддерживается из
ipastat.conf(5) и завершить работу.
Доступные опции строки запроса статистики:
-a rules
Вывести список правил.
-a limits
Вывести список лимитов для всех правил заданных в опциях -r.
-a thresholds
Вывести список порогов для всех правил заданных в опциях -r.
-x <regexp>
Отфильтровать вывод имён (опция -a) при помощи данного регуляр-
ного выражения POSIX (расширенный формат).
-s <stat1> <stat2> ...
Определить st_list для следующих правил, лимитов или порогов.
Новая опция -s начинает новый список систем статистики. Этот
список изменяет список систем статистики, заданный в конфигура-
ционном файле для правила, лимита или порога. Возможно указывать
встроенную систему статистики null. Если список в этой опции
пустой, то предыдущий список забывается и список для соответ-
ствующей секции берётся из конфигурационного файла.
-i|-I <interval>
Определить временной интервал, чтобы определить несколько непо-
следовательных временных интервалов используйте несколько опций.
Опция -I обозначает ``точный интервал'' и имеет эффект только
для статистики правил. Описание форматов и что такое временной
интервал см. ниже.
-r <rule>
Определить имя правила, возможно использовать несколько правил
одновременно.
-l <limit>
Определить имя лимита, возможно использовать несколько лимитов
одновременно.
-t <threshold>
Определить имя порога, возможно использовать несколько порогов
одновременно.
Во всех опциях -a возможно использовать укороченные аргументы.
Если не задана опция -a, тогда выводится статистика для правил, лимитов
или порогов. Не разрешается смешивать опции -l и -t, также не разреша-
ется смешивать одиночные опции -r с опциями -l или -t. Другими словами:
разрешается запрашивать статистику только для правил, только для лими-
тов или только для порогов.
Если правило, заданное в опции -r, не существует, то ipastat создаст
правило с заданным именем на лету, если это разрешено в ipastat.conf(5)
и это правило унаследует установки из секций rulepat и global. Этот же
эффект для лимитов и порогов (даже для правил, которые существуют в
конфигурационном файле).
Временные интервалы.
Общая и полная форма временного интервала следующая:
Y1.M1.D1/h1:m1:s1-Y2.M2.D2/h2:m2:s2
где, Y1, Y2 -- года, M1, M2 -- месяца, D1, D2 -- дни, h1, h2 -- часы,
m1, m2 -- минуты, s1, s2 -- секунды. Месяца могут быть заданы трёхбук-
венными сокращениями месяцов в английском языке.
Любой временной интервал состоит из левой и правой частей. Не требуется
чтобы каждая часть была полностью определена. Если левая часть времен-
ного интервала определена не полностью, то принимается первая секунда
первой минуты первого часа (и т.д.). Если правая часть временного
интервала определена не полностью, то принимается конец последней
секунды последней минуты последнего часта (и т.д.).
Правая часть временного интервала может быть упущена. В этом случае
правая часть равна левой части.
Для правила временной интервал означает, что временные отметки записей
правила в базе данных должны быть в диапазоне дат, заданных в временном
интервале. Если временной интервал задан в опции -i, то только одна из
временных отметок записей правила в базе данных должна быть в диапазоне
дат. Если временной интервал задан в опции -I, то тогда обе временные
отметки записей правила в базе данных должны быть в диапазоне дат. Если
временной интервал не задан, то по умолчанию используется временной
интервал для текущего месяца.
Для лимита временной интервал означает, что время старта лимита должно
быть в диапазоне дат в временном интервале. Если временной интервал не
задан, то выводится текущее состояние лимита.
Для порога временной интервал не имеет никакого эффекта.
ПРИМЕРЫ
Вывести список правил:
ipastat -q -a rul
Вывести список правил, начинающихся с подстроки "10":
ipastat -q -x ^10 -a rul
Вывести список лимитов для правил my и lan:
ipastat -q -a lim -r my -r lan
Вывести список порогов для заданных правил: rule1 и rule2, используя
систему статистики sdb, правило rule3 должно использовать систему ста-
тистики из конфигурационного файла:
ipastat -q -a thr -s sdb -r rule1 -r rule2 -s "" rule3
Вывести статистику для правил rule1 и rule2 за текущий месяц:
ipastat -q -r rule1 -r rule2
Вывести статистику для правила rule1 за январь и март текущего года:
ipastat -q -i jan -i mar -r rule1
Вывести статистику для правила rule1 с 10:00 до 12:00 текущего дня:
ipastat -q -i /10-/12 -r rule1
Вывести статистику для правил rule1, rule2 и rule3 за 2005 год:
ipastat -q -i 2005 -r rule1 -r rule2 -r rule3
Вывести текущие состояния лимитов lim1 для rule1 и limx для rule2:
ipastat -q -r rule1 -l lim1 -r rule2 -l limx
Вывести статистику для тех же лимитов, но все состояния лимитов должны
иметь время старта в январе 2004 года:
ipastat -q -i 2004.jan -r rule1 -l lim1 -r rule2 -l limx
Вывести статистику для порогов thr1 для rule1, thrx и thry для rule2,
порог thrx должен использовать систему статистики sdb, другие пороги
должны использовать системы статистики из конфигурационного файла:
ipastat -q -r rule1 -t thr1 -r rule2 -s sdb -t thrx -s "" -t thry
ДИАГНОСТИКА
ipastat завершает свою работу с кодом возврата 0 в случае успешного
завершения работы, и с кодом возврата 1 если произошла какая-то ошибка.
ФАЙЛЫ
ipastat.conf
(запустите ipastat с ключём -h, чтобы увидеть путевое имя конфигураци-
онного файла, используемое по умолчанию)
ДРУГИЕ ИСТОЧНИКИ
ipa(8), ipactl(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3)
АВТОР
Andrey Simonenko <simon@comsys.ntu-kpi.kiev.ua>
НЕДОРАБОТКИ
Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по
email.
16 апреля 2005 г. IPASTAT(8)