EventTracker: Configuring DLA Extension for AWStats Report AWStats Reports Publication Date: Oct 18, 2011 EventTracker 8815 Centre Park Drive Columbia MD 21045 www.eventtracker.com
About This Guide Abstract AWStats is a free powerful tool with lots of features that generates advanced web, streaming, ftp or mail server statistics, graphically. This log analyzer works as a CGI or from command line and shows you all possible information your log contains, in few graphical web pages. This document is designed to help Install, Configure and import AWStats generated report to EventTracker using DLA-Extension feature. Purpose The purpose of this document is to help users to Install, Configure, Schedule AWStats report generation and configure DLA Extension to import report in EventTracker. Intended Audience EventTracker users who wish to import AWStats report to EventTracker via DLA Extension. The information contained in this document represents the current view of Prism Microsystems, Inc. on the issues discussed as of the date of publication. Because Prism Microsystems, Inc. must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Prism Microsystems, Inc. and Prism Microsystems, Inc. cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. Prism Microsystems, Inc. MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE INFORMATION IN THIS DOCUMENT. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, this Guide may be freely distributed without permission from Prism, as long as its content is unaltered, nothing is added to the content and credit to Prism is provided. Prism Microsystems, Inc. may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Prism Microsystems, Inc. the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. The example companies, organizations, products, people and events depicted herein are fictitious. No association with any real company, organization, product, person or event is intended or should be inferred. 2013 Prism Microsystems, Inc. All rights reserved. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. 1
Table of Contents Install and Configure AWStats... 3 Install AWStats package if not installed.... 3 Configure AWStats... 3 Processing Building and Reading Reports... 5 Configure DLA-Extension to Import AWStats Report to EventTracker... 6 Viewing Reports in EventTracker... 11 2
Install and Configure AWStats Install AWStats package if not installed. (Preferable to install on EventTracker Console machine so reports generated by this will be available on same machine) Download Activeperl installer and install. http://www.activestate.com/activeperl/downloads. Download and Install AWStats installer for windows. http://sourceforge.net/projects/awstats/files/awstats/7.0/awstats-7.0.exe. Configure AWStats Once AWStats is installed. Run awstats_configure.pl from install folder. 1. Open command prompt. 2. Change directory to AWSinstall folder C:\Program Files\AWStats\tools> awstats_configure.pl and follow the instruction. 3. Enter apache web server install path, if installed or enter none to skip. Figure 1 4. Type Y, and then press Enter when asked to build a new Awstats config/profile. 3
Figure 2 5. Enter profile name. Ex: - Mywebsite. Awstats configuration file will be created in the install directory: C:\Program Files\AWStats\wwwroot\cgi-bin\. NOTE: Repeat the steps for each different web server logs by providing website name as profile name. For each profile one configuration file will be created.. Open Awstats configuration file from AWStats install path (default C:\Program Files\AWStats\wwwroot\cgi-bin\ on windows). Locate main setup section and verify following options are set properly in each configuration file. Suggested to create one Logfile folder. Under that create individual folder for each webserver logs. LogFile = C:\Program Files\apache\access.log for apache log or LogFile = C:\WINDOWS\system32\LogFiles\W3SVC1\ex%YY-24%MM-24%DD-24.log for IIS log LogType=W for web server log LogFormat=1 for apache or 2 for IIS (Refer AWStats manual for more options). LogSeparator=" " SiteDomain=WWW.mywebserver.com BuildReportFormat=html 4
Processing Building and Reading Reports 1. Open Command Prompt. 2. Change directory to AWstats tools path. 3. Run following commands. perl "C:\Program Files (x86)\awstats\wwwroot\cgi-bin\awstats.pl" -config=mywebsite update (Source web server log file available in configured path will be parsed and AWSTATS statistics database file will be created). perl "C:\Program Files (x86)\awstats\wwwroot\cgi-bin\awstats.pl" -config=v7demo - output -staticlinks > F:\Logfiles\AWStatsReports\Mywebsite.html (This will generate meaning full graphical web server statistics html report and report will be available in output path, in my example F:\Logfiles\AWStatsReports\Mywebsite.html ) Above steps should be repeated for each profile. This can be automated by creating batch script and scheduling it via task scheduler. 5
Configure DLA-Extension to Import AWStats Report to EventTracker 1. Open EventTracker Enterprise 2. Type valid user credentials and then click Login. 3. Click the Admin drop-down, and then select Manager Figure 3: Click Admin >> Manager 1. EventTracker displays the Manager Configuration page. 6
Figure 4 2. Click Direct Log Archive/NetFlow Receiver tab. Figure 5 3. Click Direct log file archiving from external sources checkbox, and then select a port from Associated virtual collection point dropdown. 4. Click the Add button. EventTracker displays the Direct Archiver Configuration pop-up window. 7
Figure 6: Direct Archiver Configuration Select DLA-Extension from Type dropdown. Type AWstatsreport.ini as Configuration Name. Click Browse and select path of AWStats html report file, and then click Configure. Figure 7 8
EventTracker displays the Direct Archiver Configuration pop-up window. Figure 8 Type *.html in File Pattern text box. Select Move to Reports from Action dropdown. Select Operation from Report Destination dropdown. Select Send E-mail to receive the report on e-mail. Type a valid sender e-mail address in the E-mail Id field, and a brief description in subject field. OR Select Send as attachment options to receive reports in attached format or select Send only notification options to receive notification. 4. Click the Add button, and then click the Save button. 9
Figure 9 NOTE: EventTracker displays Audit reports in Operation dashboard in EventTrackerWeb. 10
Viewing Reports in EventTracker 1. Navigate to Operation, and the click Reports. Figure 10: Operations >> Reports 2. Once report files are imported will be displayed in Reports page. Click the report title hyperlink to view the report. 11
Figure 11: Reports 12