Документация ProxyInspector 3.x Standard edition :: Консоль

Консоль

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

Важно!

Быстрее всего можно создавать задания импорта лог файлов и создания отчетов с помощью планировщика заданий.

Автоматизация процесса импорта лог файлов

Для импорта лог файлов предназначена команда:
PI3Console.exe -import

Создание отчетов

Важно!

Функции работы с отчетами из консоли доступны только в зарегистрированной версии программы.

С помощью консоли ProxyInspector вы можете автоматизировать создание и рассылку отчетов. Созданный отчет может быть сохранен в указанный файл либо отправлен по электронной почте. Для использования из консоли отчет необходимо сохранить как шаблон в Мастере создания отчетов. Формат команды создания отчета с сохранением в файл:

PI3Console.exe -report "имя_шаблона_отчета" /saveto="имя_файла"

Для создания встроенных отчетов, необходимо использовать -top команду в формате

-top(количество_строк):тип_отчета [/datetime="временной_интервал"] [/sortby="столбец_сортировки"]

, где

количество_строк указывается сразу после -top без пробела, т.е. например -top5 или -top10

тип_отчета может быть одним из следующих значений:

user - наиболее активные пользователи Интернет

site - наиболее посещаемые сайты

ftpuser - наиболее активные FTP пользователи

wwwuser - наиболее активные WWW пользователи

/datetime задает временной интервал для создаваемого отчета

временной_интервал одно из значений ниже или интервал, заданный в форме from год-месяц-число часы:минуты:секунды to год-месяц-число часы:минуты:секунды

today - сегодня

yesterday - вчера

this week - эта неделя

last week - предыдущая неделя

this month - текущий месяц

last month - предыдущий месяц

Чтобы указать весь интервал времени нужно указать следующую строку: from * to *

Можно указать только часть from или to, например /datetime="from 2009-10-25 0:0:0"

Если параметр /datetime не указан, временной интервал будет взят из настроек ProxyInspector

/sortby задает поле, по которому выполняется сортировка и подсчет процентов

столбец_сортировки может быть одним из следующих значений:

requests - сортировка по столбцу "Количество запросов"

timespent - сортировка по столбцу "Затрачено времени"

sent - сортировка по столбцу "Отправлено"

received - сортировка по столбцу "Получено"

total - сортировка по столбцу "Общий трафик"

Примеры создания встроенных отчетов:

PI3Console.exe -top10:user /saveto="имя_файла"

PI3Console.exe -top5:site /datetime="from 2009-01-01 0:0:0 to 2009-01-01 23:59:59" /saveto="имя_файла"

PI3Console.exe -top15:ftpuser /datetime="from * to *" /sortby="sent" /saveto="имя_файла"

PI3Console.exe -top20:wwwuser /datetime="this month" /sortby="total" /saveto="имя_файла"

Важно!
Если файл уже существует он будет перезаписан. Чтобы избежать этого используйте ключ /no_rewrite.

Формат команды для создания и отправки по почте:

PI3Console.exe -report "имя_шаблона_отчета" /mailto="адресат" [/subject="тема_письма"]

можно указать несколько адресов, разделив их символом ';'.

По-умолчанию отчет будет создан в HTML формате.

Дополнительные ключи при создании/отправке отчетов:

/excel - отчет будет создан как книга Microsoft® Excel, Excel должен быть установлен на машине с ProxyInspector

/mht - отчет будет создан в формате MHT
/pir - отчет будет создан во внутреннем формате программы, что позволит открыть его в дальнейшем для просмотра
/pdf - отчет будет создан в формате PDF

/filename="имя_файла" - отчет будет прикреплен к письму именно под этим именем файла.

/group="group_name" - создать отчет для каждого из членов указанной группы, заданный шаблон отчета должен быть шаблоном отчета для одного пользователя(любого). Данная опция отсутствует в ProxyInspector for WinProxy и семействе продуктов MailDetective. Можно как сохранять сгенерированные отчеты на диск, так и отправлять по почте. Причем, при отправке по почте, отчет по конкретному пользователю будет отправлен на е-мейл адрес, указанный в свойствах этого пользователя. /mailto ключ задает е-мейл адрес по-умолчанию, на который будет отправлен отчет по пользователю, не имеющему адреса электронной почты в свойствах. Примеры использования ключа /group:

PI3Console.exe -report "TemplateForSomeUser" /saveto="C:\Reports\MyGroup\report.pdf" /group="MyGroup" /pdf

(Будут созданы отчеты для каждого пользователя из группы MyGroup вида reportN.pdf в папке C:\Reports\MyGroup)

PI3Console.exe -report "TemplateForSomeUser" /mailto="admin@company.domain" /group="MyGroup" /excel

(Каждому пользователю из группы MyGroup будет отправлен отчет, созданный по шаблону TemplateForSomeUser. Если пользователь не имеет адреса электронной почты в свойствах, отчет будет отправлен на admin@company.domain)

Протоколы работы консоли

При каждом запуске консоли в каталоге <Documents and Settings>\All Users\Application Data\ADVSoft\%Program_name%\logs создается файл протокола(название вида consoleddmmyy.hhmmss.log) в который записываются все информационные сообщения и сообщения об ошибках.

Иногда бывает необходимо отключить вывод сообщений на экран, в этом случае необходимо указать ключ -silent. Файл протокола будет создан также и при запуске с ключом -silent. Файлы протоколов хранятся 7 дней после чего автоматически удаляются.