|Contents Previous Next|
ProxyInspector enables you to automate the tasks of importing log files and creating reports, as well as a number of other actions.
The quickest way to create log file import and report creation tasks is to use the task scheduler.
Automation of the log file import
The following command can be used for importing log files:
Console functions are only available in the registered version of the program.
The console of ProxyInspector enables you to automate report creation and delivery. A created report can be saved to a specified file or sent by email. To be able to use a report from the console, you need to save it as a template in the Report Wizard. Use the following command to create a report and save it to a file:
PI3Console.exe -report "name_of_report_template" /saveto="file_name"
To create summary report you need to use -top command:
-top(lines_number):report_type [/datetime="date_interval"] [/sortby="sort_column"] /servers="server_list"
lines_number - number of lines in summary report, should follow -top command without space, -top5 èëè -top10 for example
report_type - possible values are:
user - create report for top x users
site - create report for top x sites
ftpuser - create report for top x ftp users
wwwuser - create report for top x www users
/datetime - defines repot time frame, possible values for date_interval are:
from year-month-day hour:min:sec to year-month-day hour:min:sec - from or to part may be missed, year-month-day may be replaced with *
from * to * - will create report without date/time filter i.e. for whole data in database
from 2009-10-25 0:0:0 - will create report with all data starting from 2009-10-25 0:0:0
If /datetime parameter is ommited, report will be created using date time settings for summary reports defined on Start page.
/sortby - defines report sort column, sort_column possible values are:
/servers - defines servers to inculde into the report. Server names should be delimited by comma, for example: /servers="Server 1, Server 2, Server 3"
Examples of summary report command line:
PI3Console.exe -top10:user /saveto="file_name"
PI3Console.exe -top5:site /datetime="from 2009-01-01 0:0:0 to 2009-01-01 23:59:59" /saveto="file_name"
PI3Console.exe -top15:ftpuser /datetime="from * to *" /sortby="sent" /saveto="file_name"
PI3Console.exe -top20:wwwuser /datetime="this month" /sortby="total" /saveto="file_name"
The command for creating and emailing a report by mail has the following format:
PI3Console.exe -report "name_of_report_template " /mailto="recipient" [/subject="message_subject"]
you can specify several addresses using ';' as a delimiter.
By default, the report will be created in the HTML format.
Additional keys for creating/sending reports:
/excel the report will be created as a Microsoft® Excel book; Excel should be installed on the machine with ProxyInspector
/mht the report will be created in the MHT format
/filename="file_name" the report will be attached to the message under this name.
/group="group_name" create a report for each member of the specified group. The selected report template should be a template for one user (any). This option is not available in ProxyInspector for WinProxy and the MailDetective line of products. You can save generated reports to your hard drive and send them by email. When sending reports by email, user-specific reports will be sent to the addresses specified in users properties. The /mailto key sets the default email address for a user with no email address specified in the properties. Below is an example of using the /group key:
PI3Console.exe -report "TemplateForSomeUser" /saveto="C:\Reports\MyGroup\report.pdf" /group="MyGroup" /pdf
(Reports will be created for each user from group MyGroup and saved as reportN.pdf in C:\Reports\MyGroup)
PI3Console.exe -report "TemplateForSomeUser" /mailto="firstname.lastname@example.org" /group="MyGroup" /excel
(Each user from group MyGroup will receive a report based on template TemplateForSomeUser. If a user doesnt have an email address in his/her properties, the report will be sent to email@example.com)
ProxyInspector 3.x Enterprise edition
For synchronization with Active Directory from the console it is necessary to use a -adsync command, possible parameters are:
/users - synchronize user properties
/groups - synchronize user groups
/groups /repl - synchronize user groups in replace mode
you can use /users and /groups switches at the same time.
Console will use parameters defined on Active Directory page in Settings | Base settings. Connection will be always made using current user account.
PI3Console.exe -adsync /users /groups /repl
Each time the console is started, a log file is created (named as consoleddmmyy.hhmmss.log) in <Documents and Settings>\All Users\Application Data\ADVSoft\%Program_name%\logs with a full list of notifications and error messages.
Sometimes, it is necessary to disable on-screen output of notifications. In this case, use the silent key. The log file will also be created in this case. Log files are stored for 7 days before getting deleted.