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 это утилита вывода статистики. Страница документации ipastat.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.