IPASTAT(8) IPASTAT(8)
НАИМЕНОВАНИЕ
ipastat -- утилита просмотра статистики
СИНТАКСИС
ipastat -h|v
ipastat [-c dir] [-u user] [-g group] [-f conf_file] -t [-t]
ipastat [-c dir] [-u user] [-g group] [-f conf_file] -q query
ОПИСАНИЕ
ipastat это утилита вывода статистики. Страница документации ipas-
tat.conf(5) содержит полное описание конфигурирования ipastat и описы-
вает все возможности этой утилиты.
ipastat запрашивает IPA модули статистики и выводит результаты на стан-
дартный вывод в соответствии с настройками в конфигурационном файле
ipastat.conf(5) и установками в командной строке. Эта утилита позво-
ляет выводить список правил, лимитов и порогов, выводить статистику для
правил, лимитов и порогов. Возможно одновременно использовать
несколько систем статистики и одновременно запрашивать статистику для
нескольких правил, лимитов и порогов.
ipastat не принимает никаких сигналов и обработка сигналов не опреде-
лена.
Доступные опции:
-c dir Определяет директорию, для которой ipastat сразу же выполнит
функцию chroot(2), директория должна быть задана с абсолютным
путевым именем. Рабочая директория не изменяется.
-f conf_file
Использовать данный конфигурационный файл вместо конфигурацион-
ного файла, заданного по умолчанию. Конфигурационный файл дол-
жен быть задан с абсолютным путевым именем.
-t Проверить конфигурационный файл, вывести его содержимое и завер-
шить работу. Эта опция позволяет проверить, понимает ли ipastat
и IPA модули ваш конфигурационный файл или нет. Два ключа -tt
включают так называемый ``режим подражания реальной конфигура-
ции'', в этом режиме ipastat установит все значение по умолчанию
и применит установки из секций rulepat для секций rule.
-q query
Запрос статистики из IPA модулей статистики (описан в отдельном
списке опций).
-u user
Изменить UID запущенной копии ipa на указанного пользователя.
Указанное значение может быть именем пользователя или UID. Если
опция -g не указана, то GID будет равен группе указанного поль-
зователя, также будут установлены все дополнительные группы
пользователя.
-g group
Изменить GID запущенной копии ipa на указанною группу. Указан-
ное значение может быть именем группы или GID. Эта опция также
заменяет все дополнительные группы пользователя.
-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 и опции -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 или с кодом возврата
отличным от нуля, если произошла какая-то ошибка.
ФАЙЛЫ
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)