NetIQ TD WRC Admin Guide

Reporting Service–Enterprise Edition v6.
1
Reporting Service–eBusiness Edition v6.1
Reporting Service–Small Business Edition v6.1
Reporting Center–Enterprise Edition v6.1

Reporting Center–eBusiness Edition v6.1
Log Analyzer–Advanced Edition v8.1

Log Analyzer v8.1
Administrator’s Guide
October 2003 Edition

© 1996-2003 NetIQ Corporation
Disclaimer
This document and the software described in this document are furnished under and are
subject to the terms of a license agreement. Except as expressly set forth in such license
agreement, NetIQ Corporation provides this document and the software described in this
document “as is” without warranty of any kind, either express or implied, including, but not
limited to, the implied warranties of merchantability or fitness for a particular purpose. Some
states do not allow disclaimers of express or implied warranties in certain transactions;
therefore, this statement may not apply to you.
This document could include technical inaccuracies or typographical errors. Changes are
periodically made to the information herein. These changes may be incorporated in new
editions of this document. NetIQ Corporation may make improvements in or changes to the
software described in this document at any time.
© 1996-2003 NetIQ Corporation. All rights reserved.
U.S. Government Restricted Rights: If the software and documentation are being acquired by
or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcon-
tractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense
(DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the
government’s rights in the software and documentation, including its rights to use, modify,
reproduce, release, perform, display or disclose the software or documentation, will be
subject in all respects to the commercial license rights and restrictions provided in the license
agreement.
Trademarks
AuditTrack, CommerceTrends Reporting Server, and WebTrends are registered trademarks of
NetIQ Corporation. Additional trademarks of NetIQ Corporation include: ClusterTrends,
DBTrends, Enterprise Reporting Server, Enterprise Suite, Enterprise Suite for Lotus
Domino, FastTrends, Log Analyzer, Firewall Suite, Security Analyzer, Virtual WebTrends,
WebTrends Live, VRM, eVRM, and WebTrends Professional Suite.
Other brands and their products are trademarks or registered trademarks of their respective
holders.
Product Support
If you should have any questions during the installation or use of your WebTrends software,
please contact our Product Support Department at:
Telephone: (503) 223-3023,
Fax (503) 294-7130.
ii Administrator’s Guide
Table of Contents
Chapter 1
Introduction ............................................................................................ 15
About WebTrends software ............................................................................................................ 15
How to use this guide ....................................................................................................................... 15
How WebTrends Software Works ................................................................................................. 16
WebTrends Software Features ........................................................................................................ 17
New and Improved Features in This Version .............................................................................. 18
Documentation and Help ................................................................................................................ 18
What the typographic conventions mean ........................................................................18
Making documentation available to non-administrators ...............................................19
Getting help in the program ..............................................................................................20
About NetIQ Corporation .............................................................................................................. 20
Product Accessories and Plug-ins .....................................................................................20
NetIQ Products ...................................................................................................................20
Contacting NetIQ Corporation ...................................................................................................... 22
Chapter 2
Installation and Setting Up .................................................................... 23
Overview ............................................................................................................................................ 23
Before You Begin .............................................................................................................................. 23
System requirements ...........................................................................................................23
Supported Browsers ............................................................................................................25
Minimum Screen Resolution .............................................................................................25
Installing on Windows NT .............................................................................................................. 25
Installing WebTrends software .........................................................................................25
Configuring WebTrends software service .......................................................................26
Giving your user account necessary rights ......................................................................26
• iii
Installing on Windows 2000/XP .....................................................................................................27
Installing WebTrends software ......................................................................................... 27
Configuring WebTrends software service ...................................................................... 28
Giving your account necessary rights .............................................................................. 28
Installing on Linux and Solaris ........................................................................................................29
Using the installation script ............................................................................................... 30
Running WebTrends software .........................................................................................................33
Logging Out of WebTrends software .............................................................................................34
Registering WebTrends software .....................................................................................................34
Trial mode ............................................................................................................................ 35
Purchasing WebTrends software ..................................................................................... 35
Registering your purchase and entering the authorization key .................................... 35
Checking for Product Updates ........................................................................................................36
Installing Upgrades ............................................................................................................................36
Product Versions ................................................................................................................................36
Installing WebTrends GeoTrends Database .................................................................................37
About Client Only Installations ........................................................................................ 38
Uninstalling WebTrends software ...................................................................................................38
Uninstalling Windows NT, 2000, and XP versions ...................................................... 38
Uninstalling Linux versions ............................................................................................... 38
Uninstalling Solaris versions ............................................................................................. 39
Viewing Your WebTrends Licensing Status ..................................................................................39
Viewing the Limits of Your Installation .........................................................................................40
Viewing Product Licensing Features ..............................................................................................41
Installing Program Add Ons ............................................................................................................41
Installing Add Ons ............................................................................................................. 42
Removing Add Ons ........................................................................................................... 42
iv Administrator’s Guide
Chapter 3
Using Profiles ......................................................................................... 43
The Role of Profiles in WebTrends Software Analysis ............................................................... 43
Preparing to Analyze Web Site Activity ........................................................................................ 44
Adding Profiles .................................................................................................................................. 44
Profile Type ..........................................................................................................................45
Site Logs ...............................................................................................................................47
Site Configuration ...............................................................................................................47
General settings ...................................................................................................................48
Parent-Child Configuration ..............................................................................................49
List of Servers ......................................................................................................................51
Log Data Sources ................................................................................................................52
Home ....................................................................................................................................53
Summary ...............................................................................................................................54
Advanced Settings Tabs ................................................................................................................... 55
Advanced Features ..............................................................................................................55
Campaigns ............................................................................................................................56
Custom Reports ...................................................................................................................56
Database Directory .............................................................................................................57
Filters .....................................................................................................................................57
Internet Resolution .............................................................................................................58
Locale ....................................................................................................................................61
Post-processing ....................................................................................................................61
Pre-processing .....................................................................................................................62
Profile Access ......................................................................................................................63
Report Header .....................................................................................................................63
Report Templates ................................................................................................................64
Reports ..................................................................................................................................65
Scheduler ..............................................................................................................................66
• v
Table Limiting ..................................................................................................................... 66
Visitor History ..................................................................................................................... 67
Editing Profiles ...................................................................................................................................68
Copying Profiles .................................................................................................................................69
Deleting Profiles .................................................................................................................................69
Managing the Profile List ..................................................................................................................70
Using the profile search feature ........................................................................................ 70
Navigating multiple page listings ...................................................................................... 71
Refreshing the profiles list ................................................................................................. 71
Working with Log Data Sources .....................................................................................................71
Creating log data sources ................................................................................................... 71
Listing profiles associated with log data sources ........................................................... 73
Chapter 4
Using Analysis, Status, and Archives......................................................75
On-demand Analysis .........................................................................................................................75
Stopping Analysis ...............................................................................................................................76
Re-analyzing Profiles .........................................................................................................................76
Clearing Profiles .................................................................................................................................77
Monitoring Profile Status ..................................................................................................................77
Stopping Automatic Updates ...........................................................................................................77
Working with Archives .....................................................................................................................78
Activating archiving ............................................................................................................ 78
Archive settings ................................................................................................................... 78
Restoring profiles ................................................................................................................ 79
Archive Now ....................................................................................................................... 79
Chapter 5
Using Advanced Features ....................................................................... 81
Advertising Views ..............................................................................................................................81
vi Administrator’s Guide
Adding an Advertising View definition ...........................................................................81
About dynamic pages and parameters .............................................................................83
Editing an Advertising View definition ...........................................................................85
Deleting an Advertising View definition .........................................................................86
Examples of advertising tracking methods .....................................................................86
Content Groups ................................................................................................................................ 88
Adding a Content Group definition .................................................................................88
Editing a Content Group definition .................................................................................89
Deleting a Content Group definition ...............................................................................89
Intranet Domains .............................................................................................................................. 90
Adding an Intranet Domain definition ............................................................................90
Editing an Intranet Domain definition ............................................................................91
Deleting an Intranet Domain definition ..........................................................................91
Path Analysis ...................................................................................................................................... 92
Adding a Path Analysis definition ....................................................................................92
Editing a Path Analysis definition ....................................................................................93
Deleting a Path Analysis definition ..................................................................................93
Scenario Analysis ............................................................................................................................... 94
Adding a Scenario Analysis definition .............................................................................94
Editing a Scenario Analysis definition .............................................................................96
Deleting a Scenario Analysis definition ...........................................................................97
Session Tracking ................................................................................................................................ 97
Adding a Session Tracking definition ..............................................................................98
Editing a Session Tracking definition ..............................................................................99
Deleting a Session Tracking definition ......................................................................... 100
URL Parameter Analysis ................................................................................................................ 100
Analyzing activity for a dynamic site ............................................................................. 100
Adding a URL Parameter Analysis definition .............................................................. 101
Editing a URL Parameter Analysis definition .............................................................. 103
• vii
Deleting a URL Parameter Analysis definition ............................................................104
URL Search and Replace Definitions ......................................................................................... 104
Using URL Search and Replace to group pages ..........................................................105
Adding URL Search and Replace definitions ...............................................................105
Editing a URL Search and Replace definition ..............................................................106
Deleting a URL Search and Replace definition ...........................................................106
Applying Advanced Feature Definitions ..................................................................................... 106
Applying advanced features globally ..............................................................................107
Applying advanced features on a per-profile basis ......................................................107
Listing profiles associated with definitions ................................................................................. 108
Chapter 6
Using Filters.......................................................................................... 109
How Filters Work ........................................................................................................................... 109
Combining Filter Types ................................................................................................................. 109
Visit and Hit Filters ........................................................................................................................ 110
Adding a Visit Filter ....................................................................................................................... 110
Adding a Hit Filter .......................................................................................................................... 113
Editing a Filter ................................................................................................................................. 115
Deleting a Filter ............................................................................................................................... 116
Applying Filters Definitions .......................................................................................................... 116
Applying filters globally ...................................................................................................116
Applying filters on a per-profile basis ...........................................................................117
Listing profiles associated with filters .......................................................................................... 118
Filter Element Descriptions .......................................................................................................... 118
Visit filter elements ...........................................................................................................118
Hit filter elements .............................................................................................................121
viii Administrator’s Guide

Chapter 7
Using Custom Reports ..........................................................................133
Adding a Report with Predefined Dimensions and Measures ................................................. 134
Adding a Report with Custom Dimensions, Measures, and Filters ........................................ 140
Adding dimensions .......................................................................................................... 140
Creating Drilldown Reports ........................................................................................... 142
Adding measures .............................................................................................................. 143
Adding filters .................................................................................................................... 145
Adding a custom data source ......................................................................................... 147
Editing a Custom Report Definition ........................................................................................... 148
Deleting a Custom Report Definition ......................................................................................... 148
Working with Dimensions ............................................................................................................. 149
Combining Dimensions .................................................................................................. 149
Formatting custom tables ............................................................................................... 149
Summing measures across visits ................................................................................................... 150
Applying Custom Reports Definitions ........................................................................................ 151
Applying custom reports globally .................................................................................. 152
Applying custom reports on a per-profile basis .......................................................... 152
Listing profiles associated with custom reports ......................................................................... 153
Chapter 8
Creating and Viewing Reports ..............................................................155
How Reports Are Built .................................................................................................................. 155
WebTrends software ........................................................................................................ 155
Log files ............................................................................................................................. 155
Profiles ............................................................................................................................... 158
Report templates .............................................................................................................. 158
Managing Profile Processing ......................................................................................................... 160
Stop processing profiles .................................................................................................. 160
Arranging the order of the profiles in the Waiting Queue ........................................ 161
• ix
Removing a profile from the queue ...............................................................................161
Viewing Reports .............................................................................................................................. 162
Using the WebTrends Desktop ......................................................................................162
Converting reports to alternate formats ........................................................................165
Report Data and Help Cards ......................................................................................................... 167
Chapter 9
Configuring Options ............................................................................. 169
Options Tabs ................................................................................................................................... 169
Archiving tab .....................................................................................................................169
Compressed Log File Cache tab ..................................................................................... 170
Database Directory tab ....................................................................................................171
Domain tab ........................................................................................................................172
File Types tab ....................................................................................................................172
FTP Log File Cache tab ...................................................................................................173
FTP Options tab ...............................................................................................................174
General tab ........................................................................................................................175
Internet Resolution tab ....................................................................................................176
Locale tab ...........................................................................................................................177
Performance tab ................................................................................................................178
Profiles tab .........................................................................................................................178
Proxy tab ............................................................................................................................179
Report Header tab ............................................................................................................179
Report Template tab ........................................................................................................180
Reports tab .........................................................................................................................181
Scheduler tab .....................................................................................................................182
Table Limiting tab ............................................................................................................182
(UNIX only) GeoTrends tab ..........................................................................................183
x Administrator’s Guide
Chapter 10
Setting User Access ...............................................................................185
Overview .......................................................................................................................................... 185
Adding Users ................................................................................................................................... 185
Editing User Information .............................................................................................................. 188
Deleting Users ................................................................................................................................. 188
About Users’ View Only Permissions .......................................................................................... 189
Chapter 11
Campaigns ............................................................................................. 191
Campaigns Overview ...................................................................................................................... 191
Campaign Definitions ..................................................................................................................... 192
Campaign definition components ................................................................................. 192
Adding campaign definitions .......................................................................................... 192
Editing campaign definitions .......................................................................................... 194
Deleting campaign definitions ........................................................................................ 194
Product Definitions ........................................................................................................................ 195
Shopping Cart Definitions ............................................................................................................. 195
Chapter 12
Using the WebTrends Map ...................................................................197
Overview .......................................................................................................................................... 197
Installation ........................................................................................................................................ 198
Browser modifications ..................................................................................................... 198
Installation ......................................................................................................................... 199
Initial configuration ......................................................................................................... 200
Launching the utility ........................................................................................................ 203
Using the WebTrends Map ........................................................................................................... 204
Toolbar .............................................................................................................................. 204
Path Analysis ..................................................................................................................... 204
• xi
Content Groups ................................................................................................................205
Campaigns ..........................................................................................................................206
Scenario Analysis ..............................................................................................................207
Filters ..................................................................................................................................209
Chapter 13
Running From the Command Line .......................................................211
About the Command Line Capability .......................................................................................... 211
Directory Structure ......................................................................................................................... 212
Command Line Options ................................................................................................................ 213
Scripts .................................................................................................................................213
Executables ........................................................................................................................214
Chapter 14
Using the Data Source Splitter (DSS)................................................... 219
The Data Source Splitter (DSS) .................................................................................................... 219
Using the DSS ................................................................................................................................. 219
Adding a DSS Definition ............................................................................................................... 220
Editing a Data Source Splitter definition ......................................................................221
Adding Virtual Domains .................................................................................................221
Editing Virtual Domains .................................................................................................222
Deleting Virtual Domains ............................................................................................... 222
Example .............................................................................................................................223
Sample Data Source Splitter Definition File ............................................................................... 224
Logs section .......................................................................................................................226
Split section ........................................................................................................................226
ecmprofilex section ..........................................................................................................226
Adding DSS profiles ....................................................................................................................... 227
Profile Settings ................................................................................................................................. 228
xii Administrator’s Guide

Chapter 15
Using Parent-Child Profiles...................................................................231
Parent-Child profiles ....................................................................................................................... 231
Parent-Child Terminology ............................................................................................................. 232
Two Types of Parent Profiles ....................................................................................................... 233
How Parent-Child Profiles Work ................................................................................................. 234
File and Directory Names .............................................................................................................. 236
File names .......................................................................................................................... 236
Directory location of split log files (Full-featured Analysis) ...................................... 236
Limitations of Parent-Child Profiles ............................................................................................ 237
Adding Parent profiles ................................................................................................................... 238
Splitting by URL .............................................................................................................................. 239
Editing Parent Profiles ................................................................................................................... 239
Sample Parent-Child configuration file, splitting by domain name .......................... 240
Sample Parent-Child configuration file,
splitting by URL ............................................................................................................... 243
without splitting ................................................................................................................ 244
Creating and Editing a Child Profile ............................................................................................ 246
Viewing Child profiles for a Parent profile .................................................................. 249
Viewing reports for a Child profile ............................................................................... 249
Customizing Child profiles ............................................................................................. 250
The Parent-Child Profile Report .................................................................................................. 251
Command line utilities ..................................................................................................... 251
Appendix A
Regular Expression Syntax................................................................... 253
Regular Expression Components ................................................................................................. 253
Basic elements ................................................................................................................... 253
Qualifying characters ....................................................................................................... 255
• xiii
Building Regular Expressions ....................................................................................................... 257
Matching order rules ........................................................................................................258
Comparing Regular Expressions and Wildcards ........................................................................ 259
Appendix B
Optimizing and Troubleshooting......................................................... 261
Optimizing Performance ............................................................................................................... 261
Storing data locally ............................................................................................................261
Improving the use of disk space and memory .............................................................261
Configuring web server settings ..................................................................................... 261
(UNIX only) Saving hard drive space ...........................................................................262
Special considerations
for configuring WebTrends software ............................................................................262
Troubleshooting .............................................................................................................................. 263
Conflicting file permissions .............................................................................................263
Initialization issues ............................................................................................................263
Investigating errors ...........................................................................................................265
Dates for reports are unexpected ...................................................................................268
Appendix C
Silent Installation .................................................................................. 269
Silent Install Instructions for Solaris/Linux ............................................................................... 269
Installing as root ...............................................................................................................269
Silent Install Instructions for Windows NT/2000 .................................................................... 272
Installing as root ...............................................................................................................272
Index .................................................................................................... 275
xiv Administrator’s Guide

Chapter 1
Introduction
About WebTrends software

WebTrends software provides relevant, actionable reports on your web visitor behavior to
drive smarter business decisions for companies and service providers of all sizes. WebTrends
software creates comprehensive, predefined reports that are easy to use and ready to go out-
of-the-box. The reports concentrate on the most important marketing, commerce, and
technical metrics, enabling business users to quickly gain valuable insight on web site activity.
Fully customized reports can easily be created for more insight. (For more information, see
“Using Custom Reports” on page 133.)
The WebTrends reports are available enterprise-wide via an entirely browser-based solution.
Thus, multiple business users in an organization, from marketing and sales to IT profes-
sionals, have access to customized reports anytime, anywhere. The simple user interface
means that non-technical users can configure their own reports, significantly reducing IT
involvement.
The WebTrends software should be installed on a system that can access web log files or
SmartSource files. The WebTrends software server must reside on a Windows, Solaris or
Linux machine, but the client machine is platform independent.
How to use this guide

This administrator’s guide is for use with six of our WebTrends products, but not all sections
apply to all products. If a section has no icons next to its heading, that section applies to all
five products. If a chapter or section has icons next to its heading, the information in that
section applies only to those products.
Note: If you are using the WebTrends Reporting Service (WRS) Small Business edition, please
reference the WebTrends Getting Started Guide instead of this guide. While Chapter 8, “Creating
and Viewing Reports” on page 155 contains some information that is applicable to WRS
Small Business, it’s mostly for administrators. The WebTrends Getting Started Guide is available at
http://product.webtrends.com/ptw.aspx?action=14&prodtype=wrc&version=6.1.
• Introduction 15
The following table explains which icons represent which products.
Table 1-1. Edition Icons
This icon: Represents this product:
WebTrends Reporting Center - Enterprise Edition
WebTrends Reporting Service - Enterprise Edition
WebTrends Reporting Center - e-Business Edition
WebTrends Reporting Service - e-Business Edition
Log Analyzer - Advanced Edition
Log Analyzer
How WebTrends Software Works

WebTrends software retrieves and processes web data independently through a powerful web
site analysis engine. Using a simple browser interface, an administrator can create “profiles”
that specify:
• Location of the raw web server log files or SmartSource files
• Filters (what types of information to include and exclude from the raw data)
• Report time spans (enable daily, weekly, monthly reports, etc.)
• Report templates (define style and colors, etc.)
• Technical information (cookie format for identifying users, DNS lookup mode, etc.)
16 Administrator’s Guide
• Administrative information (archive frequency, legacy data removal, etc.)
• User access (defining who has control over a profile)
The WebTrends software analyzes raw log data, according to profile settings, to create
summary data files containing the specified historical information. These summary files
contain the results of the traffic analysis computations done during the raw log processing.
A summary file is created for each day, week, month, quarter, and year spanned by the raw
data. To generate the reports, WebTrends software accesses the summary information and
creates a report framework for each of its profiles. Users are then able to log in and view a
comprehensive summary of web activity.
WebTrends software requires minimal IT administration and offers a browser-based adminis-
trative user interface for maintenance anywhere, anytime. Additionally, WebTrends software is
a cross-platform solution supporting Sun Solaris, Red Hat Linux and Microsoft Windows
2000/NT.
WebTrends Software Features

WebTrends software has the following features:
• Web Traffic Analysis: Reports on all aspects of your web site’s activity, including how
many people are visiting your web site, where they come from, and what pages interest
them most.
• Comprehensive Reports: Automatically create and maintain reports at regular intervals,
eliminating the need to run several individual reports manually. Generate weekly,
monthly, quarterly, and yearly reports that focus on the content you choose.
• Advanced features: Create global definitions that make your analysis more informative.
Advanced features deal with pages that you want to group together, dynamic pages, and
frequently traveled paths through your site.
• Support for Multiple Servers: Creates reports, using ClusterTrends™ technology, for
sites hosted by multiple servers. ClusterTrends can be implemented if you have a Server
Add-On license.
• Report Template Designer: Use this to customize your reports’ content. You can
specify your preferred dashboards, languages, colors, fonts, and layout.
• Introduction 17
• User Access Management: Grant permissions and default settings on an individual
basis. A range of permissions is possible, from only being able to view reports to
program-wide access as an administrator. You can pre-configure profile settings for any
or all users, making their work easier. Users only view the reports and program features
they have access to.
• Profile archiving: Back up profile databases at regular intervals. You can use them to
restore the profile at a later date.
• Remote Configuration: Access reports, profile settings, user accounts, and all other
program features remotely.
New and Improved Features in This Version

The 6.1 release includes several new and improved features that offer ease-of-use and
flexibility for all users across the organization. For details and additional information, go to
What’s New and Cool at
Documentation and Help

What the typographic conventions mean
The following table describes the typographic changes used in this guide.
Note: For information about the product icons that are used next to the headings, see “How
to use this guide” on page 15.
Table 1-2. Typographical Changes
This text Represents
Bold The name of an icon or button (New), a text box (Base Time
text box), or check box (Save User ID check box in the user inter-
face).
Title Case The name of a dialog box (Edit Connection dialog box),
Lucinda Source code examples, program output, or anything typed by the

Console user.
“in quotes” The title of a chapter or section.
Making documentation available to non-administrators

A user guide for non-administrators is also available. We urge you to make the WebTrends
Getting Started Guide available on your intranet or network.
The WebTrends Getting Started Guide is viewed online using Adobe Acrobat. If you purchased
the CD-ROM version of the WebTrends software, you can get the .pdf file from the CD.
Otherwise, you can download the manual from
Note: If you don’t have Adobe Acrobat, you can download it from Adobe’s web site,
www.adobe.com.
To download the .pdf version of this manual:

1. Complete either of the following:
• From the AdminConsole, select Help > Documentation & Release Notes.
• Open your browser., and type following URL:
http://product.webtrends.com/
ptw.aspx?action=14&prodtype=wrc&version=6.1
• Introduction 19
2. You see the WebTrends Reporting Center Documentation page.
3. Click Administrator’s Guide.
Getting help in the program

WebTrends software provides online help to guide you through the program. From the
upper-left of the AdminConsole, select Help > Contents & Index.
Newer WebTrends users may find our tutorial helpful. To launch it, select Help > Getting
Started Tutorial.
About NetIQ Corporation

NetIQ Corporation is a leading provider of software solutions for managing, securing, and
analyzing all components of your enterprise computing infrastructure. These components
include servers, networks, directories, Web servers, and various applications. With its roots as
the premier provider of Windows infrastructure management, NetIQ Corporation now
provides cross-platform solutions that enhance business performance and improve returns
on infrastructure and Web investments.
NetIQ Corporation is headquartered in San Jose, California, with offices throughout the
United States, Canada, Europe, and Asia.
Product Accessories and Plug-ins

WebTrends software has various accessories and plug-ins to help expand and complement its
functionality, including conversion scripts, tech tools, and cookie server plug-in. To access
these additional tools, select Plug-ins or Product Accessories from the Accessories menu
in the upper-right of the AdminConsole.
NetIQ Products
NetIQ Corporation provides integrated products that simplify and unify systems
management, security, and network performance management in your extended enterprise.
These products also help organizations prepare for and migrate to Windows 2000 and
Windows .NET. NetIQ Corporation offers the following solutions:
Performance and Availability Management
These products allow you to manage, analyze, and report on the health, performance, and
availability of your mission-critical Windows and UNIX applications and servers. With these
products, you can pinpoint network problems and resolve them quickly and effectively.
Security Management and Administration

These products provide real-time Windows security event consolidation, configuration
management, host-based intrusion detection, centralized assessment and incident
management, vulnerability assessment and prevention, firewall log analysis and reporting, and
Windows security administration. With these products, you can also manage group policy,
administration workflows, and permissions on vital assets throughout your enterprise.
VoIP Management and Network Testing

These products enable you to evaluate your network for Voice over IP (VoIP) traffic before
deployment, as well as manage and troubleshoot VoIP during and after deployment. With
these products, you can also test application or hardware performance and predict the impact
of network changes, such as adding users or new applications.
Web Analytics and Management

These products deliver important insight into every element of Web site visitor activity, as
well as improved Web site performance and availability. These solutions enhance your e-
business performance, resulting in higher returns on infrastructure and marketing invest-
ments and improved visitor-to-customer conversion rates.
Windows and Exchange Management

These products enable you to manage all Windows and Exchange essentials, from ensuring
optimal availability and performance to seamless migration, secure administration, and in-
depth analysis.
• Introduction 21
Contacting NetIQ Corporation
Please contact us with your questions and comments. We look forward to hearing from you.
For support around the world, please contact your local partner. For a complete list of our
partners, please see our Web site. If you cannot contact your partner, please contact our
Technical Support team.
From the WebTrends AdminConsole, select Help > Technical Support to open the
Technical Support area of the NetIQ web site. You can also contact them by any of the means
below.
Table 1-3. Support Contact Information
Department Contact Information
Sales 503-294-7025
888-932-8736 (only in the United States and Canada)
Sales E-mail info@netiq.com
Support www.netiq.com/support
NetIQ Web site www.netiq.com
Also, your comments are very important to us. Please take the time to let us know about your
WebTrends software experience by selecting Feedback from the Help menu in the upper-
right of the AdminConsole. You are taken to a page where you can rate different aspects of
our product and provide your comments.
Chapter 2
Installation and Setting Up
Overview
This chapter contains installation instructions for your WebTrends software. For unattended
or silent installation instructions, please see “Silent Installation” on page 269.
Before You Begin

Please be sure to complete the following:
• Review the system, browser, and minimum screen resolution requirements below to
ensure optimum performance of the WebTrends software on your system.
• Collect any valid authorization keys for the product, Add-On licenses, or subscriptions.
• Select two available TCP ports for use by the analysis engine and the remote interface
You can then choose from the following installation paths to install the product:
• “Installing on Windows NT” on page 25
• “Installing on Windows 2000/XP” on page 27
• “Installing on Linux and Solaris” on page 29
System requirements
The following minimum system requirements are needed to install and run your WebTrends
software:
• Intel x86
− 1GHz MHz processor or better
− 1 GB memory
− 1 GB disk space (SCSI disks recommended)
• Installation and Setting Up 23

• Sun
− 400 MHz UltraSparc-II processor or better (UltraSparc-lll processor recommended)
− 1 GB memory
− 1 GB disk space
Multiple CPUs are recommended for large numbers of profiles and/or users. More disk space
and memory is required to analyze large log files. Also, it’s best to install the WebTrends
software on a separate, dedicated system which has NFS-mount access to all of the logs.
Contact your Product Support representative for more information.
WebTrends software runs on the following operating systems:
Windows
Webtrends software is supported on Microsoft NT 4.x (SP3 and above), Windows 2000,
Windows XP, and Windows 2003.
Note: While the WebTrends software won’t run on Windows 95, 98, or ME, you can operate
WebTrends software through a browser loaded on these systems.
Linux
WebTrends software is supported on any Intel platform running Red Hat 6.2, 7.0, 7.1, 7.2,
7.3, 8.0, 9.0.
Solaris
WebTrends software is supported on UltraSparc platforms running Solaris 7, 8 and 9.
Note: If you want to convert your reports to Microsoft Word or Excel, your workstation must
be running Microsoft Office 2000 or above (Office X or above for Macintosh users).
Supported Browsers
Run WebTrends software using the following browsers:
• For Windows NT, 2000, XP, and 2003:
− Microsoft Internet Explorertm v5.0 and higher
− Netscape Navigator v7.0, and higher
• For Solaris and Linux:
− Netscape Navigator v7.0, and higher
• For Mac OS 8, 9, X, and 10.2:
− Netscape Navigator v7.0 and above
Minimum Screen Resolution

WebTrends reports are designed to be displayed with a minimum screen resolution of
1024 by 768 pixels. If you use a lower resolution, the reports may be more difficult to see in
your screen.
Installing on Windows NT
Installing the software on Windows NT is a three-part process:
• Installing WebTrends software
• Configuring WebTrends software service
• Giving your account necessary rights
Installing WebTrends software

To install WebTrends software:
1. Insert the WebTrends software CD-ROM into your CD-ROM drive. If your system is set
up to use auto-run, the setup program is automatically launched. If not, choose Run
from the File or Start menus and type:
X:\setup
where X is the drive letter of your CD-ROM drive.

2. Before the WebTrends software program files are copied to your system, the Software
License Agreement is presented. If you agree to the stated terms, click Accept.
Otherwise, click Cancel to exit the setup program without installing the software.
3. Follow the on-screen instructions to install the WebTrends software.
Configuring WebTrends software service

If you plan to access log files through mapped (or network) drives, you must first configure
product services to log on under an account with access rights to those drives. By default,
product services are logged on under the system account. To access mapped drives, you
should typically configure the services to log on under a user account. This involves two
steps: selecting an account to use for each service, and giving that account the appropriate
rights.
To configure WebTrends software service:
1. Open the Windows Control Panel, and select Services.
2. Select the appropriate WebTrends service from the list.
3. Click Startup. The Services dialog box opens.
4. Select This Account. Specify the account to use, and type the password for the account.
Giving your user account necessary rights

To give your user account necessary rights:
1. Select Programs > Administrative Tools > User Manager to open the Windows NT
User Manager.
2. Select the account that you specified for the WebTrends software services in the previous
procedure, then select Policies > User Rights.
3. Select the Show Advanced User Rights check box.
4. Select Act As Part Of The Operating System from the Right drop-down list.
5. If your user account isn’t listed, click Add. Add your account and click OK.
6. Repeat steps 4 and 5 for the Log On As A Service right.
7. To close the User Rights Policy dialog box, click OK.
8. In the User Manager dialog box, double-click on Administrators. If your account isn’t
listed, add it.
9. To close the Group Properties dialog box, click OK.
The installation of the WebTrends software is complete.
Important: NetIQ Corporation strongly recommends that all users review the
releasenotes.txt file to read up-to-the-minute information on the latest version of the
software. Access these notes by selecting Documentation & Release Notes from the Help
menu on the AdminConsole.
Installing on Windows 2000/XP

Installing the software on Windows 2000/XP is a three-part process:
• Installing WebTrends software
• Configuring WebTrends software service
• Giving your account necessary rights
Installing WebTrends software

To install WebTrends software:
1. Insert the WebTrends software CD-ROM into your CD-ROM drive. If your system is set
up to use auto-run, the setup program is automatically launched. If not, choose Run
from the File or Start menus and type:
X:\setup
where X is the drive letter of your CD-ROM drive.

2. Before the WebTrends software program files are copied to your system, the Software
License Agreement is presented. If you agree to the stated terms, click Accept.
Otherwise, click Cancel to exit the setup program without installing the software.
3. Follow the on-screen instructions to install the WebTrends software.

Configuring WebTrends software service
If you plan to access log files through mapped (or network) drives, you must first configure
product services to log on under an account with access rights to those drives. By default,
product services are logged on under the system account. To access mapped drives, you
should typically configure the services to log on under a user account. This involves two
steps: selecting an account to use for each service, and giving that account the appropriate
rights.
To configure WebTrends software service:
1. Open the Windows Control Panel and double-click Administrative Tools.
2. Double-click Component Services.
3. Select Services (Local) in the left pane.
4. Right-click WebTrends software listed in the right pane.
5. Select Properties.
6. Click on the Log On tab.
7. Select This Account and click Browse to select an account from the list.
8. Enter the password for the account, confirm the password, and click OK to exit the
dialog box.
Giving your account necessary rights

To give your account necessary rights:
1. Open the Windows Control Panel and double-click Administrative Tools.
2. Double-click Local Security Policy.
3. Under Security Settings in the left pane, expand Local Policies.
4. Double-click User Rights Assignment.
5. Double-click Act as part of Operating System, and make sure the account you
specified when configuring the WebTrends software service is listed.
6. Click Add to open the Select Users or Groups dialog box.
7. From the Look In drop-down list, select the domain or work group where the
WebTrends software is installed.
8. From the users associated with the selected domain or workgroup list, select the user
account you wish to add.
9. Click Add, and then click OK to add the user account.
10.Repeat steps 5 through 9 for Log On As A Service and Log On Locally policies.
The installation of the WebTrends software is now complete. If the server is running while
you perform these procedures, you need to restart the server for the changes to take effect
Important: NetIQ Corporation strongly recommends that all users review the
releasenotes.txt file to read up-to-the-minute information on the latest version of the
software..
Note: To run the WebTrends software, launch your browser and type the name of the
machine, followed by a colon and the port you specified during installation.
For example: http://server:1099.
You can also launch WebTrends software using the IP address of the system running the
program:
http://<xxx.xxx.xxx.xx>
Installing on Linux and Solaris

The steps for installing on both Linux and Solaris are now exactly the same. Use the appro-
priate installation script—either wt-wrc-linux.i586.tar.gz for Linux or wt-wrc-
solaris.i586.tar.gz for Solaris—to install your WebTrends software. Before installing, make
sure you have the following information:
• Any valid authorization keys for the product, Add-On licenses, or subscriptions.
• Select two available TCP ports for use by the analysis engine and the remote interface.
Note: The Bourne shell or a Bourne-like shell must be available to install your WebTrends
software.

Using the installation script
The installation script installs the files and configures program settings in one process.
Note: You can be installed either as root or non-root when running the installation script.
Important: If you have a version of WebTrends software already, the service for your
WebTrends software must be stopped before you can install a new version or upgrade an
existing version.
To install WebTrends software using the installation script:

1. At the command line, type:
mkdir <tempdirectoryname>
where tempdirectoryname is the directory used to uncompress and un-tar the files
needed for installation.
2. Type:
cd <tempdirectoryname>
to change to the tempdirectoryname directory location.

3. Type:
cp <source path>/<archive name>.tar.gz .
to copy the files and directory to the temporary installation directory.

4. Type:
gunzip <archive name>.tar.gz
to uncompress the files.

5. Type:
tar -xvf <archive name>.tar
to extract the files from the .tar file.
6. Type:
cd wt-wrc-6.1
to change to the wt-wrc-6.1 directory location.

7. Type:
./install.wtrs
The Software License Agreement is displayed. To view the complete text, press Enter.
8. Do one of the following:
− If you accept the Software License Agreement, type:
accept
The installation begins.

− If you do not accept the Software License Agreement, press CTRL-C.
9. If you are not logged on as root, you are warned that you cannot install the program as a
system service. Press CTRL-C to cancel, or Enter to proceed with the installation.
A message describes the user authentication options.
10.Press Enter when you have reviewed the explanation.
11.Do one of the following:
− To accept the default directory for your WebTrends software, press Enter. The
default directory is /usr/local/webtrends.
− To install the program in another location, type the new path then type Y to confirm
that you want to use the specified directory.
Important: If a message displays with the heading “PREVIOUS VERSION WARNING,”

you already have a version of your WebTrends software installed. We highly recommend
that you back up all necessary files to another location before proceeding.
12.Provide any valid WebTrends software authorization keys that you have. If you are
upgrading from a previous version, type any new authorization keys you may have
acquired. Type each key separately followed by Enter.
13.Type Enter on a blank line to continue. The installer will try to verify the authorization
keys provided. If any invalid codes are found, you will receive a warning message. While
you can complete the installation, you will need valid keys in order to use the product.

14.Specify whether to install the sample log files and configuration data. The samples
provide insight into how you can configure profiles and report settings for various types
of log files to get the reports you want.
− To install samples, type Y.
− To not install samples, type n.
Note: The sample log and sample configuration data require approximately 8 MB of disk
space.
You see a message about generating reports from data in an Oracle database. (For more
information about this, see “Optimizing and Troubleshooting” on page 261.)
15.Click Enter.
16.Specify whether or not to install custom reports.
− To install custom reports, type Y.
− To not install custom reports, type n.
17.Click Enter.
18.Type the port number for the user interface. This is the port through which a user’s
browser can access the WebTrends software. The default port is 1099. Make sure the
port is not used by any other service.
Type Y to confirm the port number.
19.Type the user name of the administrator performing the installation.
20.Type the port number that the user interface can use to communicate with the analysis
engine. It must be a different port than you specified in step 18. The default port is 9999.
To accept it, press Enter.
Type Y to confirm that this is the port that you want to use.
21.If installing as root, you can specify how you want to start the WebTrends software. (This
message will not appear if you are not installing as root.)
− To start your WebTrends software when you boot the system, type Y.
− Type n if you want to start it manually.
22.A message tells you that you can use the wtrs.server script to stop or restart the program.
Press Enter to continue.
23.A message tells you that the authorization key is being activated.
Note: If your authorization key validation succeeded, then this product activation step
should succeed. If product activation does not succeed, complete the installation process
and then get a valid authorization key. You will then activate the WebTrends software
using the valid authorization key using the wtlicman tool.
24.If licensing succeeded, a message asks if you want to start your WebTrends software now.
To start it, type Y. Otherwise, type n.
25.A message explains that you can use the wtengine.server script to start or stop the user
interface, and the wtrs.server script to start or stop both the user interface and the
Reporting Engine. Press Enter when you have reviewed information about the services
available.
26.To review the release notes, type Y. Otherwise, type n.
The installation is now complete. A message displays the URL for the opening server
interface.
Note: To run your WebTrends software, launch your browser and type the name of the
machine, followed by a colon and the port you specified during installation.
For example: http://server:1099.
You can also launch your WebTrends software using the IP address of the system
running the program:
Running WebTrends software

Once WebTrends software is installed, you can run it through your browser.
To run WebTrends software:
1. Open an Internet Explorer or Netscape Navigator browser.
2. Type the name of the machine where the WebTrends software is installed, followed by a
colon and the port that you specified during installation. For example:
http://server:1099.

You can also launch WebTrends software using the IP address of the system running the
program:
3. The login dialog box opens. Click the Login button.
4. Type in the user name and password.
5. Click OK to launch the AdminConsole, the starting point for using WebTrends software.
Logging Out of WebTrends software

If you simply close your WebTrends software user interface without logging out, the user will
not be immediately logged out. To completely log out the current user, click the Log Out
button on the upper left corner of the AdminConsole. This will return you to the main Log
In dialog box, which you may then close or use to log in a new user.
Logging out may be important if your WebTrends software licensing is user-based.
Note: If you do not use the Log Out button and have closed the WebTrends software, the user
session will eventually be timed out.
Registering WebTrends software

Register your product using one of the procedures described here.
• If you downloaded a trial version from the web site, see the following section, “Trial
Mode”.
• If you want to buy WebTrends software, see “Purchasing WebTrends software” on
page 35.
• If you purchased the product, see “Registering your purchase and entering the authori-
zation key” on page 35.
Trial mode
You can download WebTrends software from the NetIQ web site, but until you enter an
authorization key, the product is not activated. NetIQ allows you to explore the product in
trial mode using a trial mode authorization key. In trial mode, you can review program
features and run reports on your own log files for 14 days.
After 14 days, the trial mode authorization key expires. At this time, you will be able to open
your WebTrends software, but you will only be able to view reports for the included sample
profiles and sample log files.
To register for a trial authorization key and activate the product in trial mode:
1. From the AdminConsole, select Administration > Registration.
2. Complete the registration form, and click Submit. A trial code is created for you and
sent to your e-mail address.
3. Copy the trial mode authorization key from the response e-mail.
4. Launch the WebTrends software. A dialog box opens.
5. In the Activate Product text box, paste the authorization key.
6. Click Submit. The product is activated in trial mode.
Purchasing WebTrends software

If you are running a trial version and you would like to purchase it, you can buy it through the
NetIQ web site or by calling NetIQ sales at (503) 294-7025.
Registering your purchase and entering the

authorization key
Once you purchase the product, you'll get a product authorization key which you must enter
into the Activate Product dialog box and click Submit. The Activate Product dialog box
appears if your trial version has expired. If it has not expired, you must first deactivate the trial
mode authorization key. After deactivating the trial mode authorization key, you will then see
the Activate Product dialog box when you launch the WebTrends software.

To deactivate the trial mode authorization key:
1. From the upper right of the AdminConsole, select Administration > Product
Licensing & Updates.
2. Select the General tab if it is not already selected.
You see the General dialog box.
3. In the Activated License area at the top of the General dialog box, click Deactivate.
The current license is deactivated.
Checking for Product Updates

You can check for updates to both WebTrends software and the GeoTrends database through
the Administration menu on the AdminConsole by selecting Product Licensing & Updates
> License/Product Updates tab then clicking the Manual Update button near the bottom
of the dialog box.
You can also use the wtlicman -u command from the command line to check for available
product updates.
Installing Upgrades
To upgrade your existing version of WebTrends software, install the program in the same
directory. During the installation, backups of wtremote.ini and wtm_wtx.ini are made. The
new settings in these files are merged with the existing ones. We strongly recommend that you
back up your installation through either the application or some other method.
Product Versions
Several versions of WebTrends software are available. For information about the features
associated with each version, visit the NetIQ web site.
Installing WebTrends GeoTrends Database
Enhance your reports by supplementing visitor data with geographical information using the
GeoTrends database. For more information about GeoTrends, see “What is GeoTrends?” on
page 59.
You have three choices when installing GeoTrends:
• Stand-alone. Select this if you have limited memory (less than ~700MB) on an
individual box and can accept a slower processing speed. This type of installation takes a
little longer than Server And Client or Client Only.
• Server And Client. Select this if you have a separate machine to host the server, or if
your analysis machine has over 2GB of memory. It is faster than the Stand-alone option.
Note: If you are able to load both the server and client on the same machine, that is the
fastest mode for processing GeoTrends.
• Client Only. Select this when your GeoTrends server is installed on a separate machine
and you're only installing clients.
To install GeoTrends, complete the following instructions:
1. Access the .zip file for installing GeoTrends by clicking Accessories > GeoTrends from
the top right corner of the WebTrends AdminConsole. This opens the GeoTrends
download page on the NetIQ web site.
2. On the GeoTrends download page, follow the instructions to download the appropriate
GeoTrends version for your operating system
3. Open the zip file and do one of the following:
− To install only clients, double click setupclient.exe and follow the steps in the
WebTrends installation wizard. This process is exactly the same as installing Client
Only with setupserver.exe but because it doesn't contain the extra files for
Stand-alone and Server and Client, it is quicker and uses fewer resources.
− To install Stand-alone, Server And Client, or Client Only, click setupserver.exe
and follow the steps in the WebTrends installation wizard.

About Client Only Installations
When installing Client Only, you are asked for a server name. Enter the network name for the
server or an IP address. You can only enter one server name in the wizard. If you want to
enter multiple servers, edit the geoclient.ini file, which is found in the Client folder in the
directory where GeoTrends is installed. Enter the server names, separated by semicolons, in
the serverip field.
Uninstalling WebTrends software

If at any time you want to remove the WebTrends software from your system, use the
procedure described here.
Uninstalling Windows NT, 2000, and XP versions

WebTrends software includes a standard Windows uninstall program. Use the steps described
here if you did not install the WebTrends plug-ins.
To begin uninstalling the program:
1. Select Start > Settings > Control Panel. The Windows Control Panel opens.
2. Select Add/Remove Programs from the Windows Control Panel.
3. In the Install/Uninstall tabbed view, select your WebTrends software the list of existing
programs.
4. Click Add/Remove. The Uninstall program walks you through the removal of the
program from your system.
Uninstalling Linux versions

To uninstall WebTrends software:
1. If the WebTrends software is running, stop it by typing:
<install dir> ./wtrs.server stop
where <install dir> is the directory where the WebTrends software is installed.
2. If the WebTrends software is configured to run as a system service, type:
rm /etc/rc.d/init.d/S99
Note: You must be logged in as root to remove this file.
3. Before removing the product from your server, you must deactivate your license. From
the command line, use wt-licman -d to deactivate your license.
4. Type:
rm -rf <install dir>
Uninstalling Solaris versions

To uninstall WebTrends software:
1. If the WebTrends software is running, stop it by typing:
<install dir> ./wtrs.server stop
where <install dir> is the directory where the WebTrends software is installed.
2. If the WebTrends software is configured to run as a service, type:
rm /etc/rc3.d/S99wtrs
Note: You must be logged in as root to remove this file.
3. Before removing the product from your server, you must deactivate your license. From
the command line, use wt-licman -d to deactivate your license.
4. Type:
rm -rf <install dir>
Viewing Your WebTrends Licensing Status

You can view basic information about your WebTrends software licensing status and
deactivate currently active licenses if needed.

To view WebTrends software licensing information:
1. From the Administration menu of the AdminConsole, click Product Licensing &
Updates.
2. On the General tab, review the following areas for status information:
− Activated License. Displays your authorization key. Click Deactivate to automati-
cally delete the license. To continue using your WebTrends software, you will have to
reactivate the license.
− Current Activations. Displays the number of computers currently using the listed
license to run the WebTrends software. Click View to list all of the computers and
corresponding IP addresses that are using the activated license.
− OS. Displays the operating system that the software is running on.
− License Type. Displays the type of licensing allowed: Full, Lease, Trial, or Demo.
− Subscription. If you have a subscription, the expiration date of the software
subscription is displayed.
Tip: From the commandline, you can use wtlicman -s to display your current licensing
data.
Viewing the Limits of Your Installation

The Limits dialog box of WebTrends Licensing displays information relating to the activation
limits of your WebTrends software license.
• Current. Refers to your current usage. The Current values for Activations and
Number Of Profiles is the number of those items at the present time. The Current
values for Page Views Per Profile, Number Of Hits Per Profile, and Number Of
Web Servers, are the highest values, out of all of your profiles, for those limits for the
month. They are the peak values for those limits and are intended to help you manage
your activities within your licensing limits. If the Current value is Not Available, analysis
has not happened nothing has been reported for the limit yet.
• Limit. Refers to the limits of your license.
WebTrends software licenses typically contain limits to the following features:
• Page views per profile
• Peak monthly page views
• Activations
• Number of hits per profile
• Number of Allowed Profiles
• Number of Server Clusters
• Number of CPUs per Analysis System
Note: Exceeded limits are shown in red and highlighted with an asterisk. If you exceed a
limit, you’ll have a grace period where the WebTrends software functions in a limited
capacity, giving you a chance to adjust your license. It is recommended to adjust your
license as soon as possible.
Click Refresh to update the information on your current usage of your license. This will
update any licensing changes made from the command line and any licensing updates made
by NetIQ to their licensing database.
Viewing Product Licensing Features

The Features dialog box lists the features that are currently allowed by your WebTrends
software license.
Installing Program Add Ons

When you first install the WebTrends software, you have the ability to analyze log files from a
single web server. If you wish to analyze log files for additional web servers, you must
purchase the appropriate number of server Add Ons.
The easiest way to order the correct number of Add Ons is to contact your sales represen-
tative. NetIQ sales can be reached by telephone at
(503) 294-7025.
To review your current licensing data from the command line, type wtlicman -s.
Note: Plug-ins and product accessories are also available to expand and complement
WebTrends software. To access these additional tools, select Plug-ins or Product Acces-
sories from the Accessories menu in the upper-right of the AdminConsole.

Installing Add Ons
To install Add Ons:
1. When you order the add ons, write down the add on key that you are given. You must
submit the add on key to activate the new add on capability.
2. From the Administration menu on the AdminConsole, select
Product Licensing & Updates.
3. Select the Add Ons tab. The Add Ons dialog box opens.
4. Click the New Add-On button. The Add New Add On dialog box opens.
5. Type your add on key, and click Submit.
6. Click OK.
Removing Add Ons

To remove an add-ons:
1. From the Administration menu on the AdminConsole, select
Product Licensing & Updates.
2. Select the Add Ons tab. The Add Ons dialog box opens.
3. Click the Remove button next to the add on you wish to remove. The add-on is
removed.
4. Click OK.
Chapter 3
Using Profiles
The Role of Profiles in WebTrends Software

Analysis
WebTrends software reports are based on profiles which define the location of your web
server log file and how the log file should be analyzed. A profile provides the following data:
• Whether your web site resides on a single server or on multiple servers (including server
clusters)
• Log file type and location
• Home page location and default pages for your site
• Filters to apply
• Which cookie to use
• Which reporting template to use
• Report header settings
• Reports to create
• Schedule for updating reports
• IP address resolution
• Users who can access the profile
• Location for report data
Note: If you have been granted administrative rights, you can add, edit, and modify all profiles,
even those created by other users. If you have not been granted administrative rights, many of
the options explained in this chapter may not be available to you.
• Using Profiles 43
Preparing to Analyze Web Site Activity
To set up a new profile to analyze your site’s activity, you need to answer the following
questions:
• Does your site reside on a single server or on multiple servers? If your site is on
more than one server (such as in a server cluster configuration), you need to know the
location of the servers and where your logs reside on the servers. Also, be sure you have
the proper licensing if you are reporting on activity for multiple servers.
• Where are log files stored? You need the exact file path to your log files. (For more
information about working with log file paths see “Working with Log Data Sources” on
page 71)
• What is the rotation of your log files? You need to know the schedule for rotating your
log files, whether they’re daily, monthly, or so on.
Note: You must purchase and install a Server Add-on with ClusterTrends to analyze web sites
whose logs reside on multiple servers.
Adding Profiles
Note: Use Data Source Splitter (DSS) and Parent-Child profiles to process multiple domains
from the same set of log files. For information on creating these profiles, see the following:
• Data Source Splitter profiles: “Adding DSS profiles” on page 227
• Parent-Child profiles: “Adding Parent profiles” on page 238
This section explains how to configure a profile using the Add New Profile wizard. The
wizard has over 20 sections that it will automatically walk you through. The order of the
sections depends on your licenses and choices made during the creation of the profile.
• “Profile Type” on page 45
• “Site Logs” on page 47
• “Site Configuration” on page 47
• “General settings” on page 48
• “Parent-Child Configuration” on page 49
• “List of Servers” on page 51
• “List of Servers” on page 51
• “Log Data Sources” on page 52
• “Home” on page 53
• “Summary” on page 54
• “Advanced Features” on page 55
• “Campaigns” on page 56
• “Custom Reports” on page 56
• “Database Directory” on page 57
• “Filters” on page 57
• “Internet Resolution” on page 58
• “Table Limiting” on page 66
• “Post-processing” on page 61
• “Pre-processing” on page 62
• “Profile Access” on page 63
• “Report Header” on page 63
• “Report Templates” on page 64
• “Reports” on page 65
• “Scheduler” on page 66
Once the profile has been created, these screens can also be randomly accessed from the
AdminConsole through Profiles > Edit.
Profile Type
Use the Profile Type dialog box to specify the type of content on your server.
To select a profile type:
1. From the Profiles menu on the left of the AdminConsole, click New.
You see the Profile Type dialog box.
2. Select one of the following types of content to be analyzed:
− Web Server: Use this for standard web content, including WAP and Palm content.
− Streaming Media Server: Use this for analyzing streaming media server log files.
3. Select the type of profile to create:
− Standard Profile: Use this for standard web content.
− Data Source Splitter Profile (DSS): Use this to create a master profile that utilizes
Data Source Splitter definitions.
− Parent-Child:
Express Analysis (W3C Logs Only): Use this to create a Parent-Child profile
that uses SDC tags to configure profile settings such as advanced features,
filters, and campaigns. Express Analysis more fully automates profile creation by
using SDC tags embedded in web site pages to configure standard profile
settings. Individual customers will need to include the SDC tags in the pages
they want to associate with advanced features or other settings. Because Express
Analysis relies on SDC tags to configure profile settings, rather than the user
interface, several tabs and other options will be missing when you edit an
Express Analysis profile.
Full-featured Analysis: Use this to create a Parent-Child profile that has all the
standard profile settings available for configuration. Full Featured Analysis
uniformly applies any standard profile settings configured for the parent
profile—advanced feature settings, filters, campaigns, etc.—to all of its child
profiles. In effect, the parent profile settings function as a template that is
applied to the associated child profiles. To customize any of these settings for an
individual child profile, you must modify that child profile from the Configure
Child Profiles dialog box.
Note: The options you see in the Profile Type dialog box depend on your licenses
and may be different from what is shown. For more information on additional
features, contact NETIQ support at 503-294-7025.
4. Click Next.
About Profile Type settings
About Step 2 – Supported Streaming Media servers

WebTrends software can analyze the log files of the following media servers:
• RealMedia
• QuickTime
• Windows Media
The formats of these log files will be auto-detected. These formats will be added to the list of
supported formats in the UI, even though these formats are auto-detected.
Note: WebTrends software does not support extended features such as error logging and
SML.
Site Logs
If you use the WebTrends Warehouse program, you need to specify that your log files are in
the WebTrends Warehouse.
To select where to store log files:
1. Select where to store the log files:
− If you’re not using the WebTrends Warehouse program, select Web Site Logs Are
Stored In Log Files.
− If you’re using the WebTrends Warehouse program, select Web Site Logs Are
Stored In A WebTrends Warehouse.
2. Click Next.
Site Configuration
Use the Site Configuration dialog box to specify the number of servers on which your web
site resides.
To specify where your web site resides:
1. Specify your site’s configuration:
− If your web site resides on one server, select My Web Site Is On One Physical
Machine.
− If your web site resides on more than one server, select My Web Site Is On
Multiple Physical Machines. With the ClusterTrends Add-On, WebTrends
software can analyze web site activity for sites that reside on multiple servers.
2. Click Next.
General settings
To specify general settings:
1. In the Name text box, type a name for the profile. This name also serves as a default
profile title in reports.
2. Specify how much of the log to analyze.
− To analyze the entire log file, select From Start Of Log File(s).
− To analyze the log beginning with the date specified, select From The Following
Date. Enter the date using the mm/dd/yyyy format. For example, June 20th, 2001
would be typed as 06/20/2001.
3. If you want to override the GMT (Greenwich Mean Time) offset, do the following:
a. Select the Override The GMT Offset To Use For Processing Reports check
box.
b. In the text box that appears, enter the value, in hours, that you want to adjust the
time.
4. In the Profile File Name text box, type the name for this profile. This name is listed in
the Profile Statistics section below the list of profiles on the AdminConsole.
5. If you want to archive this profile, select Enable Archiving. For information about
restoring archives, see “Restoring profiles” on page 79.
6. If you do not want this profile to be included in analysis, select Disable This Profile.
Note: When you are ready to use a disabled profile for analysis, you can activate it by
selecting it at the AdminConsole then selecting Edit and the General tab.
7. To capture web page titles for inclusion in reports, select Retrieve HTML Page Titles.
8. Click Next.
About General settings
About Step 3 – GMT offsets

Note: This feature is used for log files that are local time only. It doesn’t apply to W3C log files
or any log files that have a time zone offset in them.
By default, WebTrends software uses the time zone of the server you are running the analysis
on. Use the Time Zone fields to adjust for differences between the time zones where the log
files are created and where they are analyzed. This helps to create more accurate reports.
Note: To adjust for times moving west from GMT, use a positive value. To adjust for times
moving east from GMT, use a negative value.
Parent-Child Configuration
Use the Parent-Child Configuration dialog box to specify what criteria to use to split log file
data into child profile data. Also use it to specify any child profiles that should specifically be
created or not created. And use the dialog box to access the Configure Child Profiles dialog
box, in which you can customize individual child profile settings or create child profiles.
To specify Parent-Child profile settings:
1. For Child Profile Identification, select one of the following criterion for automatically
splitting the log file data into child profile data:
Note: Auto-discovery of child profiles does not work when URL is used as the split
criterion.
− Domain. Select this to split the log file data into child profile data based on the
domain.
− SmartSource Site ID. Select this to split the log file data into child profile data
based on the SmartSource Site ID.
− URL Query Parameter Value. Select this to split the log file data into child profile
data based on URL query parameter values.
− URL. Select this to split the log file into child log files based on the URL. When you
select this criterion, you must use the Configure Child Profiles dialog box to define
the individual child profiles.
Note: This option is only available with Full-featured Analysis profiles.
2. For Valid Auto-discovered Child Profiles, select one of the following:

− Always. Select this to create all possible child profiles based on the identification
criteria.
− Except For Specific Identification Strings. Select this option and you see the
Identification Strings button. Click this button and in the Valid Child Identifi-
cation Strings dialog box, specify the strings that identify the child profiles that you
do not want to create. Type in the small text box on the right and click Add to
specify the identification strings to be excluded. To remove an identification string
from the list, select the string and click Remove.
− Only For Specific Identification Strings. Select this option and you see the
Identification Strings button. Click this button and in the Valid Child Identifi-
cation Strings dialog box, specify the strings that identify the child profiles to be
created. Type in the small text box on the right and click Add to specify the identifi-
cation strings to be included. To remove an identification string from the list, select
the string and click Remove.
3. For Parent Profile Settings, select from the following options, which are applied by the
parent profile when it identifies and analyzes child profiles:
− Non-RegEx Patterns Should Parse For Multiple Items. Select this if you are not
using regular expressions to define your split criteria and you have multiple expres-
sions that you are parsing for. This selection is usually used when Domain is the split
criterion. Once you have selected this check box, the Delimiter For Multiple
Patterns text box opens.
Delimiter For Multiple Patterns. Type the character that separates multiple entries
in the match pattern you specified your analysis software to use if you decided to
split log files using non-regular expressions. This prevents your analysis software
from viewing your non-regular expression as one long string.
− Delete Split Logs After Child Analysis Complete (only available with Full-
featured Analysis). Select this to delete each child log file after its profile analysis has
finished.
− For The Next Analysis Pass, Create Profile Configurations, But Do Not
Split/Analyze. Select this to only create child profiles. Splitting and analyzing log
file data will not be done with this option. This is helpful when you have hundreds
of domains and want to be sure that they split correctly before using system
resources for analysis.
− Include Express Analysis Roll-up Report. Select this to include a single report
containing all of the individual child reports. The Roll-up report does not replace
individual child reports but is in addition to them.
Note: This option is only available with Express Analysis profiles.
4. Click the Configure Child Profiles link to manually configure child profiles. For
example, after child profiles are auto-discovered, you may wish to assign user access on
an individual child profile basis. Also use this dialog box to create or modify child profiles
that use the URL as the criteria for splitting the log file data.
List of Servers
If you specified in the Site Configuration dialog box that your log files are on multiple
physical machines, this dialog box appears. Use this box to specify which servers to include in
this analysis.
To review site configuration settings, see “Site Configuration” on page 47.
To specify servers and their corresponding log file paths:
1. Add any appropriate servers.
a. Click Add.
You see the New Cluster Server dialog box.
b. For Server Name(s), type the name of the server to be added.
c. From the Select Log Data Sources list, select the check boxes to the left of the log
data sources that you want included with this server.
d. If necessary, add or edit existing log data sources as needed for this profile.
Note: For information on managing log data sources, see “Working with Log Data
Sources” on page 71 or Log Data Sources in the index of the online Help.
e. Click OK.
2. Edit any existing server’s information.
a. From the Server Name(s) list, select the server.
b. Click Edit.
c. Make appropriate changes.
d. Click OK.
3. Delete any listed servers that you do not want included in this analysis.
a. From the Server Name(s) list, select the server.
b. Click Delete.
c. You are asked to confirm the deletion.
d. Click OK.
4. Click Next.
Log Data Sources

This dialog box appears when you specified in the Site Configuration dialog box that your log
files are on one physical machine. To review site configuration settings, see “Site Configu-
ration” on page 47.
To specify log data sources:
1. Click Log Data Sources.
You see the Log Data Sources dialog box.
2. From the Select Log Data Sources list, select the check boxes to the left of the log data
sources that you want included with this profile.
3. If necessary, add or edit existing log data sources as needed for this profile.
4. Click OK then OK again to confirm saving your changes.

You see the selected log data sources listed.
5. Click Next.
Home
Use the Home dialog box to define the location and file name of your web site’s home page.
If you’re creating a Stream profile, you only need to complete step 2. The other options are
not available.
Note: Entering this information is optional but it is recommended that you do it because it
defines the location of your web server home page regardless of the existence of any sub-
domains on which you may be reporting.
To specify home page location and file names:

1. In the Home Page File Names text box, include the file names that the web server
defaults to when a visitor enters a URL without entering a specific file name. Remove any
existing file names that don’t apply and type any new names that are needed. Separate
multiple file names with spaces. You can type up to 255 characters.
2. In the Web Site URL text box, specify the URL to the root of your web site, including
the access method (http://, ftp://, or file:///).
Note: If this text box is left blank, you can’t retrieve HTML page titles for this profile
unless the log file is a multi-homed domain log file.
3. If your server requires user authentication, type the Username and Password in the
appropriate text boxes.
4. Click Next.
About Home settings
Note: To retrieve page titles, you must turn on the titles option. To do that, from the Admin-
Console, select the Options > General tab > Retrieve HTML Page Titles check box.
About Step 1 – Home page file names

Specifying default home pages lets you report all references to the home page whether or not
the visitor specifically included the file name. This makes the home page hit count more
accurate.
About Step 2 – Web Site URL

The following examples illustrate the results when your home page file name is
default.htm and the Web Site URL is specified as
http://www.WebTrends.com.
• A hit to http://www.WebTrends.com/default.htm is identified as:
http://www.WebTrends.com/
• A hit to http://www.WebTrends.com/reports/default.htm is identified as:

http://www.WebTrends.com/reports/
Summary
In the Summary dialog box, choose one of the following options:
Completing the profile

If the profile settings are correct, you can finish it now.
To complete the profile:
1. Click Finish.
You see a note that the profile’s been added.
2. Click OK.
Editing previous settings
If your previous settings are incorrect, click Back until you get to the appropriate dialog box
to change your settings.
Configuring Advanced settings

To continue configuring the profile, click Advanced Settings. Select the appropriate tabs to
define the desired settings. The tabs are defined in the following sections.
Advanced Settings Tabs

Use Advanced Settings to further customize your profile. Included in the tabs for these
settings are tabs representing the dialog boxes that you completed in the new profile wizard.
The additional tabs you see depend on choices you made in the new profile wizard.
The following sections describe the new tabs that appear. If you do not modify the settings,
you accept the global defaults. Specify global defaults through the main menu links along the
top of the AdminConsole.
Advanced Features
To configure Advanced Features:
1. Under the Advanced Features list, click any of the links for the Advanced Features.
2. For Session Tracking, select the radio button to the left of the definition that will be the
default for this profile. For all other tabs, select the check box to the left of the defini-
tions you want applied to this profile.
For details on configuring the Advanced Features, refer to the following sections:
• Advertising Views (see page 81)
• Content Groups (see page 88)
• Intranet Domains (see page 90)
• Path Analysis (see page 92)
• Scenario Analysis (see page 94)
• Session Tracking (see page 97)
• URL Parameter Analysis (see page 100)
•
• URL Search And Replace (see page 104)
Campaigns
To configure Campaigns:
Under the Campaigns list, click any of the hyperlinked features.
• Campaigns: Select the check boxes to the left of the campaigns to be applied to this
profile. (For details on configuring campaigns, see page 191.)
• Products: Product Definitions is an obsolete feature and will be removed in future
versions of the WebTrends software. Much of the legacy Product Definition functionality
can be achieved through the use of Custom Reports and Scenario Analysis.
− Refer to “Using Custom Reports” on page 133 for information on custom reports.
− Refer to “Scenario Analysis” on page 94 for information on scenario analysis.
• Shopping Carts: Shopping Cart Definitions is an obsolete feature and will be removed
in future versions of the WebTrends software. Much of the legacy Shopping Cart
Definition functionality can be achieved through the use of Scenario Analysis. Refer to
“Scenario Analysis” on page 94 for information on scenario analysis.
Custom Reports
Use the Custom Reports dialog box to apply custom reports to this profile. Click the Custom
Reports link and select the check boxes to the left of the custom reports to be applied to this
profile.
Refer to “Using Custom Reports” on page 133 for more information.
Database Directory
Use the Database Directory dialog box to specify the location for the profile database. These
databases store all the information needed to create reports, and because of this, can grow
quite large. Store them on a drive where you have a large amount of available space.
To specify the directory or path where analysis data is stored:
In the Database Directory text box, type the path to where you want to store the profile
database.
Use ./ to specify a directory relative to the directory where the WebTrends software is
installed.
Note: The default values for this dialog box are defined in Options. If you accept them, and
the defaults are later changed in Options, the settings will also change for this profile.
About Database Directory settings

If you change the database location, the WebTrends software re-analyzes the log file from the
beginning. This is necessary because a new database is created, and the original databases
remain in the old location.
To maintain separate databases for each profile, use the %profile% macro in the file path, as
shown in the default entry, and the database will use the same name as the profile. For
example, if your profile is named SuperSport, and you include the %profile% macro in the
file path, the WebTrends software creates a database named SuperSport.
Filters
Use filters to limit the scope of your analysis to include only relevant data in reports for this
profile. You can filter on either visit or hit parameters. Click either of the links and select the
check boxes to the left of the filters to be applied to this profile.
For details on configuring filters, see “Adding a Visit Filter” on page 110, or “Adding a Hit
Filter” on page 113.
Internet Resolution
To specify the settings for resolving IP addresses:
1. To provide domain names in your reports, select the Perform A DNS Lookup For
each Unresolved IP Address check box. If your web server doesn't resolve IP
addresses and you don't select this check box, your reports display visitor's IP addresses.
2. To include company and demographic information in your reports, select the Company
Location Resolution check box. If this check box is not selected, your reports will
contain limited company and demographic information.
About Internet Resolution settings
About Step 1 - Performing DNS lookups

IP Resolution is the process of translating the numeric IP addresses into domain names.
Domain names are more descriptive so they can be more useful in reports, especially if you
don't know the individual IP addresses for your servers.
Once a numeric address has been resolved, the result is stored in a permanent cache to
expedite all subsequent reports. The default cache size is 50,000 entries; once this limit is
reached, the oldest addresses are replaced with the new entries.
It’s most efficient for your web server to resolve IP addresses when it logs activity but if it is
unable to, use this option to resolve the addresses when the WebTrends software analyzes the
log files.
Note: If the WebTrends software resolves IP addresses, it may slow reporting.
About Step 2 - Company Location Resolution (GeoTrends)
The Company Location Resolution check box is available only if WebTrends GeoTrends is
installed. To install GeoTrends, go to the Accessories menu in the upper right corner of the
AdminConsole, and select GeoTrends. This action opens the GeoTrends download page on
the NetIQ web site. Follow the instructions on the page to download the appropriate
GeoTrends version for your operating system. The GeoTrends database requires approxi-
mately 720 MB of free disk space to install and store.
What is GeoTrends?
GeoTrends enhances both pre-defined and custom reports with demographic and marketing
data by using the client machine’s IP address to look up information such as area code,
region, country, city, state, and market segmentation information. In pre-defined reports, the
main differences when using GeoTrends are reflected in several Visitors reports, especially
those reports under the Geography heading.
For example, analyze a log file and look at the Top Countries report under the
Visitors > Geography reports.Using GeoTrends, the reports show which countries visitors
come from. Without GeoTrends, the reports show only one country category entitled,
Unknown Origin. In custom reports, GeoTrends dimensions will be available with or
without the GeoTrends installation, but as with pre-defined reports, little or no data will be
available when those dimensions are used in reports.
For instructions on installing GeoTrends, see “Installing WebTrends GeoTrends Database”
on page 37.
How Do You Activate Your GeoTrends Installation?

If your WebTrends software and GeoTrends are installed on a Microsoft Windows-based
system, you must stop and restart the WebTrends Services to activate your GeoTrends Instal-
lation. However, if you installed the WebTrends software and GeoTrends on a Linux or
Solaris platform, a GeoTrends tab appears that opens the GeoTrends dialog box. Type the
GeoTrends installation location in the Installation Directory text box of the GeoTrends
dialog box.
How Can You Tell That GeoTrends is Installed?
When GeoTrends is installed, the Company Location Resolution check box appears in the
Internet Resolution dialog box. You can access this dialog box in both Options and Profiles.
To access it in Options, click the Options link on the main menu of the WebTrends Admin-
Console, and select the Internet Resolution tab.
What Information is Available with GeoTrends?

The specific information that is available from the GeoTrends includes:
• Area code. The area code associated with the client machine's IP address.
• City. The city associated with the client machine's IP address.
• Country. The country associated with the client machine's IP address.
• DMA (Designated Market Area). DMAs consists of all counties whose largest viewing
share is given to stations of that same market area. Non-overlapping DMAs cover the
entire continental United States, Hawaii and parts of Alaska. There are currently 210
DMAs throughout the U.S.
• Domain Name. The domain name associated with the client machine's IP address.
• Geographic Region. The world geographic region associated with the client machine's
IP address.
• MSA (Metropolitan Statistical Area). MSAs are relatively freestanding Metropolitan
Areas and are not closely associated with other Metropolitan Areas. These areas typically
are surrounded by non-metropolitan counties. A Metropolitan Area is defined as one of a
large population nucleus, together with adjacent communities that have a high degree of
economic and social integration with that nucleus. Some MAs are defined around two or
more nuclei. Each MA must contain either a place with a minimum population of 50,000
or a Census Bureau-defined urbanized area and a total MA population of at least 100,000
(75,000 in New England).
• Network. Network to which the client machine's IP address belongs, for example,
Earthlink or AOL.
• Network Type. Type of network connection to which the client machine's IP address
belongs.
• Organization. The organization or company associated with the client machine's IP
address.
• PMSA (Primary Metropolitan Statistical Area). If an area that qualifies as a metro-
politan area has more than one million people, PMSAs may be defined within it. PMSAs
consist of a large urbanized county or cluster of counties that demonstrates very strong
internal economic and social links, in addition to close ties to other portions of the larger
area.
• State. The state associated with the client machine's IP address.
• Throughput. An estimate of the bandwidth of the client machine's IP address.
• Time Zone
Note: Because GeoTrends relies on IP addresses to look up data in the database, it is recom-
mended that you do not select Resolve Mode in the Domain Name/IP Resolution Mode
drop-down list of the Internet Resolution dialog box. Also, ensure that your web server is not
configured to perform DNS lookups for IP addresses as it creates the log file. In both
instances, you will have to resolve domain names back into IP addresses before you can
benefit from the GeoTrends data.. The time zone associated with the client machine's IP
address.
Locale
Use the Locale tab to identify the country used in reports to show domestic activity.
To specify your country of origin, select it from the Your Country drop-down list.
Post-processing
To run a file immediately after an analysis, use the post-processing feature. Post-processing is
configurable on a per-profile basis.
To specify post-processing settings:
1. Select the Post-processing check box.
2. For Application, browse or type the path to the application you want to run.
3. For Working Folder, type the path name to the working directory.
4. Type any command line parameters you want for the designated application. Command-
line parameter options are commonly used to run batch files or shell scripts.
5. To check return codes, complete the following steps:
a. Select the Check Return Code(s) radio button.
b. In the Return Code(s) text box, type your setting. (You may need to scroll down to
see the text box.)
c. Click Add.
d. Repeat step b and step c for each code to be added.
e. Select the appropriate radio button to designate whether these codes indicate success
or failure. This designation applies to all listed codes. It’s not possible to mix success
and failure codes in this list.
6. If you want the post-process command to run, even if there are problems with the
analysis, select the Run Always check box.
Pre-processing
To run a file immediately prior to a scheduled analysis, use the pre-processing feature.
You can configure the WebTrends software to not run the scheduled analysis should the
pre-processing command fail. Pre-processing is configurable on a per-profile basis.
To specify pre-processing settings:
1. Select the Pre-processing check box.
2. For Application, browse or type the path to the application you want to run.
3. For Working Folder, type the path name to the working directory.
4. Type any command line parameters you want for the designated application. Command-
line parameter options are commonly used to run batch files or shell scripts.
5. If you want to consider return codes, complete the following steps:
a. Select the Check Return Code(s) radio button.
b. In the Return Code(s) text box, type your setting. (You may need to scroll down to
see the text box.)
c. Click Add.
d. Repeat steps b and c for each code to be added.
e. Select the appropriate radio button to designate whether these codes indicate success
or failure. This designation applies to all listed codes. It’s not possible to mix success
and failure codes in this list.
Profile Access
As an administrator, you have access to all profiles. Use the Profile Access dialog box to
define any additional users who can use this profile. (For information on creating and
modifying user accounts, see Chapter 10, “Setting User Access” on page 185.)
To specify who has access to the profile:
1. From one of the lists, select a user.
2. Use the arrows to put the user in the appropriate list.
3. If you want the report for this profile to be viewed publicly, select the Enable Reports
Generated By This Profile check box.
About Profile Access settings
About Step 3 - Enable Reports

The Enable Reports check box works in conjunction with the Allow All Reports Enabled
check box in the Configure User Access And Privileges dialog box. (See “Adding Users” on
page 185 for more information.) Both of the check boxes must be selected for anonymous
viewers to see the reports.
Report Header
To define the Report Header:
1. In the Report Title text box, type the title of the report. If nothing is entered, the profile
name is used by default.
2. In the Report Description text box, type additional information about the report, such
as the audience or the purpose of the report.
3. By default, the WebTrends logo appears in the report. To replace it with a logo of your
choice, complete the following under both Primary and Secondary. (You may need to
scroll down to see these functions.)
a. For Report Image, type or browse to specify which graphic to include in the report
header. The image is automatically resized for the WebTrends Desktop (Report
Viewer).
b. For Report Image Alt, specify the text to be displayed when the image isn’t
available or is loading. In some browsers, this text may appear as a tool tip over the
image.
c. For Associated URL, type the address where the user will go when clicking the
Report Image.
Note: The default values for this dialog box are defined in Options. If you accept them,
and the defaults are later changed in Options, the settings will also change for this profile.
Report Templates
Report templates define the content, language, and style for the report. For more details, see
“Report templates” on page 158.
To make a report template available for a profile’s reports:
1. From the Templates Available list, select the template you want to use:
Note: The template list varies according to the type of profile you’re creating, Web Profile
or Stream Profile.
2. Click the < button to move the selected template to the Templates Selected list.
3. Select the day of the week you want the Report Calendar to display as the start of the
week.
To specify the default report template:
1. From the Templates Selected list, select the template you want to use as the default
template for the profile.
2. Click Set Default. An asterisk should appear next to the report template you selected,
indicating that it is the default template.
Reports
To specify how often to generate reports and the number of reports saved:
1. Assign report intervals by selecting the appropriate Report Types check boxes.
2. From the Reports To Store list, select the number of reports to save for each report
type.
3. In the Maximum Number Of Elements Available In Report Tables text box, type
the maximum number of elements that you want queried for each table.
About Reports settings
About Step 2 - Storing reports

If you run a large number of reports, you might want to limit the number of reports saved.
Using the Reports To Store option, you can select the number of reports saved for each
interval. When a new report is added, the oldest report is deleted so that the limit is
maintained.
When determining how many reports to store, consider how much disk space you want to
devote to reports and how long you want to save them. A report using the Complete
Summary template as installed needs 1 MB.
Scheduler
Use the Report Scheduler to specify when the profile is analyzed and how often reports are
updated.
To specify when and how often the profile’s report is updated:
1. In the Initial Start Time text box, specify when you want reports to begin generating.
2. From the Frequency drop-down list, select how often to update the report.
3. From the Priority drop-down list, select the priority for updating this profile’s reports.
When more than one profile is scheduled to be analyzed, profiles with a high priority will
be placed in the front of the queue while low-priority profiles will be placed at the back.
Table Limiting
To help the WebTrends software run more efficiently, reduce the amount of memory required
by limiting the size of certain tables. Table limiting for Express Analysis profiles is a little
different than for other profiles. For information about limiting tables, go to the appropriate
section for the type of profile you’re creating.
Express Analysis profiles

1. For Maximum Visitors In Memory, type the maximum number of visitors to keep in
memory. After the maximum number is reached, the visitors data is written to disk.
2. For Maximum Files Per Merge, type the maximum number of session files to concur-
rently open for merge at any given time. Many systems limit the number of open file
handles available. Do not exceed those limits.
3. For Maximum Files Per Report, type the maximum files to keep per report. Keep in
mind that the reporting speed improves if you have fewer files. Also, remember that
compaction requires time and disk I/O.
All Other Profiles
To set limits on memory usage:
For each category you want to limit, deselect the No Limit check box and type the limiting
number in the corresponding Number Of Elements In Thousands text boxes.
About Table Limiting settings

When the limiting the following tables, consider the following information:
Top Domain Names is usually the first table limited because it uses so much memory. Once
the limit has been reached, no new items will be added, however, activity for items already in
that table will continue to be tracked.
Top Visitors is usually the second choice for limiting. Once the limit has been reached, the
WebTrends software tracks only who’s visiting and how many times they visit. Other more
specific items like exactly when the visits occurred and how many pages were viewed in each
visit, are not tracked.
Before limiting Top Pages, examine your Page File Type definitions (Options > File
Types). Page File Type definitions can greatly affect how quickly this table grows - specifi-
cally, if you’re including query strings for Page File Type definitions.
Visitor History
Use Visitor History to capture data for visitor segmentation analysis. Visitor History enables
you to define the segment of your visitors that most interest you. For example, you might
want to know information about your most valuable customers, e.g., how much have they
spent with you, how long has it been since they’ve placed an order, or how many days has it
been since they’ve visited your site. Use this information to help drive customers to your site
so they’ll do more and spend more, whatever your site’s goals are.
Note: The extra analysis required for this feature will affect system performance.
To specify the visitor segments to be tracked:
1. Select the Enable Visitor History check box.
2. Select the appropriate check boxes for the categories to be tracked.
− If you select Campaign History, use the Default Campaign Duration text box to
define how many days to store the campaign as an active campaign. WebTrends
software will first check the SDC tags to see if the campaign duration is defined and
if it is not, the Default Campaign Duration value is used. If your SDC tags don't
define campaign duration and you set Default Campaign Duration to zero, the
campaign will be counted as a most recent campaign but it will never be stored as an
active campaign.
− If you select Search Engine History, the Most Recent Search Engine Duration
text box becomes active. Enter how long, in number of days, that you want to save
the most recent information about the search engine. Information that has been
saved for more than that many days is deleted.
3. To limit the amount of Visitor History information that is saved, select the Enable
Visitor History Trimming check box and specify when to begin trimming and which
visitors to trim. Trimming visitor history permanently removes the excess visitors from
the database. Use this when your database is too large and you need more disk space
Note: If you track new visitor information, be careful how you trim. When the visitors
that were trimmed return to your site, they are treated as new visitors because you no
longer have any history of them.
WebTrends software performs Visitor History trimming after analysis is complete.

Once you’ve enabled Visitor History then configure your custom reports using the appro-
priate query parameters for the selected categories. For more information about using query
parameters, see “Guide to WebTrends Query Parameters", available at
http://product.webtrends.com/WRC/6.1/Documents/query_params.pdf. For information
on how dimensions and measures work with custom reports for visitor history analysis, click
the link for Visitor History in the Index of the online Help.
Editing Profiles
Use the Edit Profile dialog box to modify settings for a profile. If the profile is being used for
analysis when you make the changes, it is updated when the analysis is complete.
To edit a profile:
1. Select a profile in the list.
2. From the Profiles menu on the left, select Edit.
3. Select the tab with the settings that you want to modify.
4. Make your changes.
5. Click OK to close the dialog box.
Copying Profiles
You can use existing profiles as the basis for a new profile using the Copy Profile command.
Note: Database information and reports are not copied over to the new profile.
To copy a profile:
2. From the Profiles menu on the left, select Copy.
A copy of the profile opens to the General tab.
3. In the Description text box, rename the profile.
4. Make any modifications.
5. Click OK to close the dialog box.
Deleting Profiles
You can remove profiles from the Profile Description list if they are no longer needed.
To delete a profile:
2. From the Profiles menu on the left, select Delete.
3. To confirm that you want to remove the profile, click OK.
Managing the Profile List
If your profile library has grown to the point that finding the profile to work with has become
a chore, you can limit the number of profiles that are displayed through the AdminConsole.
You can also search for profiles using the controls in the Search bar on the AdminConsole if
you know the name, or part of the name, of the profile you are looking for or the users who
have access to the profile.
The Search bar consists of a Search button, a drop-down list that lets you specify the search
parameter, and a text box in which you type the search criteria for that parameter.
Tip: You can increase or decrease the number of profiles displayed by modifying the
MaxGridProfiles option in the wtm_wtx.ini file.
Using the profile search feature

To search for profiles:
1. From the Search drop-down list, select the search parameter:
− By Profile Name: Lets you search for part or all of a profile’s name.
− By Username: Lets you search for all profiles that a specified user has permission
to access.
Note: To see the list of WebTrends software users, click Administration > User
Access in the upper right of the AdminConsole. To check who has access to a
profile, select the profile, click Edit, and click the Profile Access tab.
2. In the text box to the right of the Search drop-down list, type the name of the profile or
the username.
Note:
• When typing a profile name, you can use wild cards. When typing a username, you
can not use wildcards but must type the name exactly how it is in the WebTrends
software.
• If the text box is blank when searching for a username, the profiles for the current
user are listed.
3. Click Search.
Navigating multiple page listings

The Profiles list displays 40 profiles per page. To the right of the Search text box, the
WebTrends software tells how many total profiles are listed and which part of the list you're
currently viewing. Use the < and > buttons to navigate back and forth between multiple
pages of profiles.
Refreshing the profiles list

To display the most up-to-date list of profiles, click the Refresh button on the right end of
the Search bar. This ensures that all changes to the Profiles list are displayed on-screen.
Working with Log Data Sources

Log data sources are an easy way to group a set of log files in a single definition that multiple
profiles can reference. This is helpful when the location of the log files change. Instead of
having to edit all of the profiles using the log files, you just edit the log data source and all of
the associated profiles pick it up.
Before you apply log data sources to profiles (see “Log Data Sources” on page 52), you must
create them.
Creating log data sources

To create a log data source:
1. From the links near the top right of the AdminConsole, click Log Data Sources.
2. Click Add.
3. Specify the type of log file and its source, then click Next.
4. Specify the settings for either a log file or webhouse type of log data source.
5. Click Finish.
For more detailed information on how to create and apply log data sources, please refer to
Log Data Sources in the index of the online Help.
About Step 4 – Log file path formats
The following table provides examples of different types of log file paths.
Table 3-1. Log file path format examples
Example Description
ftp://ftp.domain.com/ Specifies the complete path to the log files

logs/mylog.log accessed using FTP.
ftp://ftp.domain.com/ Specifies two log files, ex020501.log and

logfiles/ ex020531.log in the logfiles directory on the
ex020501.log|ftp:// ftp.domain.com server.
ftp.domain.com/logfiles/
Notice that the file paths are separated with a
ex020531.log
pipe character.
(UNIX) httpd/logfiles/ Specifies the access_log in the httpd/logfiles

access_log directory.
(UNIX) httpd/logfiles/ Specifies the previous day’s activity for a log file
access_log\ named according to date.
%date-1%%mm%%dd%%yy%
(NT) c:\\winnt\ Specifies all the logs beginning with ex in the

logfiles\ex*.log winnt\logfiles directory.
(NT) \\utah\winnt\ Specifies the UNC path for all logs beginning
logfiles\ex*.log with ex in the winnt\logfiles directory on the
machine named utah.
(NT) \\webserver\ Specifies the previous day’s activity for a log file
logfiles\ named according to date.
%date-1%%mm%%dd%%yy%.log
Listing profiles associated with log data sources
To better understand the effects when you update log data sources, you can view a list of
profiles associated with each log data source. The list tells you which profiles are affected by
changes to the log data source.
To list all profiles that use a log data source:
1. From the links near the top of the AdminConsole, click Log data Source.
2. Select the log data source and click Show Uses.
You see the Locate Uses dialog box listing all profiles associated with the current log data
source.
3. Click OK.
Chapter 4
Using Analysis, Status, and
Archives
The following sections explain the features related to the Analysis, Status, and Archives
menus.
On-demand Analysis
Use the Analyze Now command before generating reports on profiles that haven't been
analyzed recently. This command overrides the profile’s scheduled analysis and inserts the
profile into the report queue. If another profile’s analysis is underway, the inserted profile’s
analysis may not begin immediately, but the profile will remain queued until analysis can
begin.
To use Analyze Now:
1. From the AdminConsole, select the profile you want to analyze.
2. From the Analysis menu on the left, select Analyze Now. You see the Analyze Now
dialog box.
3. To insert the profile into the analysis and report queue, click OK.
After it processes, you see a dialog box telling you the status of the analysis.
4. Click OK.
Analyze Now may create changes in the reports (which show shifts in data patterns over
time) because they change when the data is analyzed. Upon examination of your reports, you
may find that you need to re-analyze the profile using an archived database.
• Using Analysis, Status, and Archives 75

Stopping Analysis
You can interrupt processing of a profile using the Stop Analysis command. Doing so
postpones analysis until the next scheduled interval.
To stop an analysis:
1. From the AdminConsole, select the profile for which you want to stop processing.
2. From the Analysis menu on the left, select Stop Analysis. The Stop Current Analysis/
Reporting Cycle dialog box opens.
3. To stop processing the profile, click OK.
4. Click OK again to confirm that your request was successful.
Re-analyzing Profiles
Re-analyze profiles to create completely new reports which reflect changes to profile settings.
Re-analyze will:
• Delete all databases and reports associated with the old version of the profile.
• Create new databases based on new profile settings.
• Insert the profile into the report queue.
Re-analyze does not change profile settings (.wlp) or the profile status log. Also, if another
profile’s analysis is underway, the re-analysis may not be begin immediately but the profile will
remain queued until analysis can begin.
To re-analyze a profile:
1. From the AdminConsole, select the profile to re-analyze.
2. From the Analysis menu on the left, select Re-Analyze. The Re-analyze Profile dialog
box appears.
3. To re-analyze the profile, click OK.
After it processes, you see a dialog box telling you the status of the re-analysis.
4. Click OK.
Clearing Profiles
When you clear a profile, you delete all of its interim data (including databases, reports, and
status logs) while keeping the profile settings. Clear a profile after making changes that require
its data set to be recreated. Also, clearing a profile can be helpful in getting a clean start,
should something corrupt the profile’s interim data.
To clear a profile:
1. From the AdminConsole, select the profile that you want to clear.
2. From the Analysis menu on the left, click Clear.
You see the Clear Profile dialog box.
3. To clear the profile, click OK.
After it processes, you see a dialog box telling you the profile will now be cleared.
4. Click OK.
Monitoring Profile Status

The WebTrends software maintains a status file for each profile. You can use the status file to
monitor the processing of the logs. From the Profile Status dialog box you can view the
current state of the profile, the file name, and the location of the status log file. Use the scroll
bar to peruse the profile history.
To view the status of a profile:
1. From the AdminConsole, select the profile whose status you want to view.
2. From the Status menu on the left, select Profile Status. The Profile Status dialog box
opens.
3. When finished reviewing the status, click Close.
Stopping Automatic Updates

The WebTrends software automatically updates the status of all listed profiles. To reduce
unnecessary network traffic, stop these updates.

To stop the automatic profile status updates:
From the Status menu on the left, select Stop Auto Status. This stops the updates for all
listed profiles, not just the one that is selected.
To restart the automatic updates:
Under Status in the profile statistics below the list of profiles, click Click Here To Re-
enable Auto Status.
Working with Archives

You can archive profiles at regular intervals or on demand. An archive contains a backup of
the databases for the profile, allowing you to restore the profile to a previous state. Archives
are useful if certain log files were not available during analysis, if you discover your log files
have been corrupted, or if you made changes to the profile that you want to restore.
Activating archiving
You must enable a profile for archiving before you can archive it.
To enable archiving for a profile:
1. From the AdminConsole, select the profile and click Edit.
2. Select the General tab.
3. Select the Enable Archiving check box.
Archive settings
Archive settings apply to all profiles enabled for archiving. Settings include how often
archives are made, the maximum number of archives per profile, and whether to enable
archiving by default. See “Archiving tab” on page 169 for details.
Restoring profiles
Restore archives to complete profiles with missing information. For example, if the wtrs.audit
file says that there is a date without log file data. You could restore the profile to an archived
version, place the missing logs in the proper location, and restart the analysis so that reports
show activity for the newly added logs files.
Monitor the wtrs.audit file for messages like this one to determine when an archive should be
used:
Sep-07-1999 07:33:48: No log data for profile daily on Sunday,
February 14, 1999
You’re also able to restore archives from the command line. See the .pdf file “Advanced
WebTrends Configuration Using .ini Files”, which can be found in the Documentation
directory of the WebTrends CD, for more information.
To restore a profile:
1. Select the profile to restore.
2. From the Archives menu on the left, select List Archives. The Profile Archives dialog
box opens.
3. From the Available Archives drop-down list, select the archive that you want to restore
and click Restore.
Note: When you restore a profile using an archive, all databases and reports created after
the archive date are deleted.
4. Click OK.
Archive Now
If you want to preserve a profile in its current state, use Archive Now to create an archive on
demand. Archive Now works for all profiles, regardless of whether they are enabled for
archiving.
To create an archive on demand:
1. From the AdminConsole, select the profile to be archived.
2. From the Archives menu on the left, select Archive Now.

You see the Archive Now dialog box.
3. Click OK.
After processing, you see a dialog box telling you the status of the archive request.
4. Click OK.
Chapter 5
Using Advanced Features
The following sections explain the advanced features, how to create advanced feature defini-
tions, and how to apply the definitions.
Advertising Views
Use Advertising Views to determine the number of visitors to your web site who view or click
on particular ads. With this feature you can produce advertising reports for each of your
clients.
If you are selling advertising space on your web site, for example, you can collect traffic
statistics to help determine pricing schedules. If you use the Advertising filter in your profile,
you can show traffic patterns for a specific advertisement (such as busiest time of the day or
busiest day of the week), as well as demographic information (such as the top viewing or
clicking organizations or countries).
For details on defining ad views and clicks from the command line, see the .pdf file
“Advanced WebTrends Configuration Using .ini Files”, which can be found in the Documen-
tation directory of the WebTrends CD. For details on creating profiles with filters that track
specified advertisements, see “Using Filters” on page 109.
Note: To track the effectiveness of web site advertisements that you have placed on someone
else’s site, see “Campaigns” on page 191.
Adding an Advertising View definition

To add an Advertising View definition:
1. From the links at the top of the AdminConsole, select Advanced Features > Adver-
tising Views. You see the Advertising Views tab.
2. Click Add. The New Ad View definition wizard opens.
• Using Advanced Features 81

3. In the Name text box, type a name for the new advertisement definition. This is used to
identify it in the Profile list and in reports.
4. Click Next.
5. In the Page Expression text box, type the file name or text string identifying the Ad
View to be tracked. This is how the page appears in the log file. For example, if the URL
is www.webtrends.com/site_download/download.htm, in the Page Expression
text box, you’d type: /site_download/download.htm. You can use * and ? as wild
cards.
6. If you want to use regular expressions, select the Regular Expression check box. To
confirm your entry before continuing, click Test.
7. If the specified page is a dynamic page, do the following (for information on dynamic
pages, see “About dynamic pages and parameters” on page 83):
a. Under URL Parameters (optional), click Add.
b. Enter the Parameter Name and Parameter Value you would like to match in the
specified page URL.
c. Select whether the Parameter Value is text, numeric, or a regular expression.
d. Click OK.
8. Click Next.
You see the Ad Clicks dialog box.
9. In the Page Expression text box, type the script or redirect command of the Ad Click
to be tracked, as it appears in the log file of your server.
Note: WebTrends software scans only the log file Page field for the text that you specify,
so the click must create an entry in your log file. For example, if a visitor clicks on an ad
which takes them out of your site directly via a URL, this is not logged in your log file.
To be able to track ad clicks, you must implement some type of server-side scripting (for
example, CGI, Perl, or ASP) to perform a redirect to the destination URL. A very
common Perl script is redir.pl.
10.If you want to use regular expressions, select the Regular Expression check box. To
11.If you want to add parameters, do the following:
a. Under URL Parameters (optional), click Add.
b. Enter the Parameter Name and Parameter Value you would like to match in the
specified page URL.
Note: Parameter names and values are not case sensitive.
c. Select whether the Parameter Value is text, numerics, or regular expressions.

d. Click OK.
12. Click Finish.
The view you created is appended to the list in the Advertising Views tab.
About dynamic pages and parameters
Dynamic pages
Dynamic pages are often used for things like product pages that are dynamically generated
from a database, based on values that a visitor has selected. Dynamic pages typically have
URLs that look something like this:
/products/furniture.asp?cart_id=445&product=couch
In addition to the base URL (/products/furniture.asp), this example also has param-
eters tagged onto its end, following the question mark (?). These parameters typically come in
name=value pairs. In the example above, there are actually two name=value pairs. cart_id
is the name and 445 is the value; product is the name and couch is the value. Note that
more than one name=value pairs are separated by an ampersand (&).
An example of a dynamic page is a product page that changes based on the product shown or
the characteristic of a product. For example, /products/furniture.asp
?product=couch or /products/furniture.asp?color=blue. The page
(furniture.asp) is the same, just certain parameters in the page have changed.

Parameters
Parameters are located in the URL immediately after a question mark and are followed by an
equal sign and a return value. For example, if your qualifying page is:
/products/furniture.asp?product=couch
The parameter name is product and the value is couch. You cannot use wild cards to specify
a parameter name; you can, however, use them to specify the value. The value can also be
expressed using text, numerics, or regular expressions. For examples, see the following table.
Table 5-1. Parameter value examples
Method Examples
Text couch* locates the following: couch_blue, couch_danish,

couch, couch_bed, etc. (Refer to the note on using wildcards
below.)
table would locate simply table.
Numerics Numerics are a comma-separated list of integer values, or ranges of val-

ues. You cannot use wildcards with numerics.
1,3,5,7 would match only 1,3,5, or 7.
200-300,500 would match 200, 220, 299, etc.
1,2,5-10,17-30 would match 1,6,18,29, etc.
Method Examples
Regular cou.h matches a value beginning with cou, followed by any single char-
expression acter (.) and ending with h. This would include any of the following:
(This is an couch, couth, cough, etc.
advanced ^couch$|^chair$ would match either couch or chair
method) couch|chair would match a value containing either couch or (|)
chair, i.e. blue_chair, chair_55, big_couch_55, etc.
couch$|chair$ would match any value ending ($) in either couch or
chair.
Regular expressions use a generalized pattern language that can be used
to match patterns in your value. For further explanation and examples,
refer to “Regular Expression Syntax” on page 253.
Note: You can only use wild cards at the beginning and end of the item you are searching for.
For example, *couch but not cou*ch. Also you cannot use them to match paths, i.e. *.* or
*.asp. Refer to “Comparing Regular Expressions and Wildcards” on page 259 for more
information.
Editing an Advertising View definition

To edit an existing Advertising View definition:
1. From the Advertising Views tab, select the Advertising View definition to edit.
2. Click Edit.
3. Enter your changes and click OK to save.

Deleting an Advertising View definition
To delete an existing Advertising View definition:
1. From the Advertising Views tab, select the Advertising View definition to delete.
2. Click Delete.
3. Click OK. The Advertising View definition is removed from the dialog box list.
Examples of advertising tracking methods
Example 1: Tracking Statically Linked Ads

For this example, we'll track the IBM advertisement which is statically linked—in other
words, it's not retrieved through CGI scripts, but called straight using the <IMG SRC>
HTML tag.
When a browser hits your site and sees the link to the image, it asks the server for that image
and generates a log entry on the server that looks something like this:
... "GET /images/ibm_ad.gif"
Since the filename ibm_ad.gif is unique to just IBM's advertisement, it’s sufficient to type the
file name itself into the Ad View File Name text box to accurately track views of this ad.
Example 2: Tracking Ads Sent Through Scripts

In this example, you have an automated CGI script that delivers ads to a browser. The adver-
tisement image, ibm_ad.gif, is sent to the client using a CGI script that contains an adver-
tisement ID number rather then a filename.
The only way to retrieve this particular ad is to link from an image on your view page to a
CGI script. Here is an example of a possible URL:
http://www.xyz.com/cgi-bin/showad.cgi?ad=123456
When a web browser sees this URL, it asks the server for that image and generates a log entry
that looks like:
... "GET /cgi-bin/showad.cgi?ad=123456"
Since the CGI script returns the image, the file name is irrelevant.
For our ad view we want to use text specific to this advertisement only—in this case, the ad
ID string for the CGI script. Consequently, in the Ad View File Name text box, type:
showad.cgi ad=123456
This works because this combination of text shows up in the log file only when retrieving the
IBM advertisement image.
In the Ad Click ID String text box, type the text identifying the advertisement click you want
to track. This must be the exact text (not case-sensitive) from the web server log file. You can
specify multiple components separated by spaces.
Since only the log file Action field is scanned (usually Get or Post statements) for the text that
you specify, the click must create an entry in your log file. For example, if a visitor clicks on an
ad which takes him or her out of your site directly via a URL, that click is not logged in your
log file. To be able to track ad clicks, you must implement some type of server-side scripting
(for example, CGI, Perl, or ASP) to perform a redirect to the destination URL. A very
common Perl script is redir.pl.
To summarize, if you have a GIF file on your site that links to IBM’s site through redir.pl, the
settings in the Ad Views and Clicks dialog box would break down like this:
• In the Description text box, you would type:
IBM Laptop Advertisement
• In the Ad View File Name text box, you would type:

ibm_ad.gif
• In the Ad Click ID String text box, you would type:

url=www.ibm.com
With these settings, when a visitor to your site clicks on the ad, the following information is
recorded in your log file:
GET /cgi-bin/redir.pl?url=www.ibm.com

Content Groups
No matter how well organized your site is, there are going to be times when you will want
information about categories that can’t be defined in terms of specific pages or directories.
For example, you might need to know about a product that shows up on several types of
pages in a number of different directories, or you might want information on particular
products within one or more directories. In these cases, a report that looks at specific direc-
tories or most-requested pages probably won’t give you the information you need—at least
not without forcing you to search through lots of irrelevant report entries for the ones you
need.
Content Groups enable you to analyze related pages together in one report. A Content
Group definition is a set of patterns that identifies the pages that you want to report on as a
group. Patterns are the key parts of the URL. If the URL matches a defined pattern, it is
associated with the group. Content Group definitions can either be applied to all profiles or
applied to individual profiles.
For example, you can create a group called "Company News", and specify that each page
URL that qualifies for that group must contain /corp_news/. In this case, the following
URLs would be included in your qualification level:
/company/corp_news/press/march1999.htm
/company/corp_news/earnings/first99.htm
For details on defining Content Group definitions from the command line, see the .pdf file
“Advanced WebTrends Configuration Using *.ini Files”, which can be found in the
Documentation directory of the WebTrends CD or at
http://www.netiq.com/support/wrc/extended/documentation.asp.
Adding a Content Group definition

To add a Content Group definition:
1. From the links at the top of the AdminConsole, select Advanced Features > Content
Groups.
2. Click Add. The New Content Group definition wizard opens.
3. In the Name text box, type a name for the new group. This is used to identify it in the
Profile list and in reports.
4. Click Next.
5. In the Page Expression text box, type the file name or text string identifying the
content group to be tracked. This is how the page appears in the log file. For example, if
the URL is www.webtrends.com/site_download/download.htm, in the Page
Expression text box, you’d type: /site_download/download.htm. You can use *
and ? as wild cards.
6. If you want to use regular expressions, select the Regular Expression check box. To
7. If you want to add parameters, under URL Parameters (optional), click Add.
8. Enter the Parameter Name and Parameter Value you would like to match in the
specified page URL.
9. Select whether the Parameter Value is text, numerics, or regular expressions.
10.Click OK.
11.Click Finish.
The Content Groups tab of the Advanced Features dialog box appears with the new
Content Group definition added to the list.
Editing a Content Group definition

To edit an existing content Group definition:
1. From the Advanced Features dialog box, select the Content Group definition to edit.
2. Click Edit.
Deleting a Content Group definition

To delete an existing Content Group definition:
1. From the Advanced Features dialog box, select the Content Group definition to delete.
2. Click Delete.
3. Click OK. The Content Group definition is removed from the dialog box list.

Intranet Domains
Within large organizations, certain sub-nets or ranges of IP addresses usually represent a
department, area, or location of an organization, but they are not represented in the company
database. This is where the Intranet Domains feature steps in.
The Intranet Domains feature lets you provide a more detailed break-down of your organi-
zation's domain name. You can define domains which specify an area of your organization by
country, state, city, department, or even individual workstations. Once you have added this
information with the Intranet Domains tool, it is automatically included in your report profile
data and shows up in the following areas of our reports:
• Top Companies
• Top Countries
• Top Cities
• Top Organizations
For details on defining Intranet Domain definitions from the command line, see the .pdf file
tation directory of the WebTrends CD, for more information.
Adding an Intranet Domain definition

To efficiently track which departments of a company are using the company Intranet, for
example, you can create Intranet Domain definition for each department—or a division of
the company, or individual user, whatever granularity you choose. This information is
automatically stored with other traffic data included in reports.
To add an Internet Domain definition:
1. From the links at the top of the AdminConsole, select Advanced Features > Intranet
Domains.
You see the Intranet Domains tab.
2. Click Add. The Intranets dialog box opens.
3. In the Intranet Domain text box, enter the domain name of the department or division
of your organization to be listed in your report (for example, marketing.xyz.com).
4. In the Description text box, enter the descriptive name of the organization or
department as you want it to appear in reports (for example, Marketing Dept.).
5. In the City text box, enter the location of the department or division.
6. From their respective drop-down lists, select a state and a country.
Note: This geographic information is used to produce the geographic tables and graphs in
reports.
7. In the IP Address/Pattern/Subnet text box, enter the IP address, domain name, or

range of IP addresses as they appear in your web server log file (for example,
marketing.xyz.com).
Note: Because pattern matching for Intranet Domain entries are performed after Internet
Resolutions, you only need to use an IP address in this field if neither your web server
nor the WebTrends software is converting IP addresses to domain names.
8. Click OK to save your settings.

The Advanced Features dialog box reappears, with the Intranet Domains tab showing.
Editing an Intranet Domain definition

To edit an existing Intranet Domain definition:
1. From the Intranet Domains tab, select the Intranet Domain definition to edit.
2. Click Edit.
Deleting an Intranet Domain definition

To delete an existing Intranet Domain definition:
1. From the Intranet Domains tab, select the Intranet Domain definition to delete.
2. Click Delete.
3. Click OK. The Intranet Domain definition is removed from the dialog box list.

Path Analysis
Path analysis definitions help you determine where visitors went from a specified page, and
make it possible to create reports that include path analysis data about the parts of the site
that interest you.
Suppose that you want to know where visitors go after they visit the pricing page, order.htm.
You’d create a path analysis definition that uses order.htm as its starting point, and set a limit
on the number of paths you want shown in the report. When you generate a report that uses
this path definition, you get a listing of visitor paths that begin at the order.htm page.
Path analysis definitions can either be applied to all profiles or applied on a profile basis. For
details on defining path analysis definitions from the command line, see the .pdf file
tation directory of the WebTrends CD, for more information.
Adding a Path Analysis definition

To add a Path Analysis definition:
1. From the links at the top of the AdminConsole, select Advanced Features> Path
Analysis.
2. Click Add. The Path Analysis dialog box opens.
3. In the Description text box, type a name for this path analysis. The name you provide
here will identify the Path Analysis throughout the application.
4. Select whether to track based on pages or content groups.
5. In the Page/Content Group To Track text box, type the web page or select the
content group to use as the starting point for the path analysis.
6. For From This Page/Content Group, in the Number Of Levels To Track text box,
type a number to specify the depth of the path analysis. For example, a value of 6 reports
on the next six pages that the user visits from the specified page.
7. For To This Page/Content Group, in the Number Of Levels To Track text box, type
a number to specify the depth of the path analysis. For example, a value of 9 reports on
the previous nine pages that the user visited before the specified page.
8. In the Maximum Number Of Paths To Track text box, type the maximum number of
paths to track for this definition.
Note: The number of paths you track affects the resources used in processing. The higher
the number of paths, the more resources are tied up. You may want to track the fewest
paths possible to reduce the resource load.
9. Click OK.
The Advanced Features dialog box reappears, with the Path Analysis tab showing.
Editing a Path Analysis definition

To edit an existing Path Analysis definition:
1. From the Advanced Features dialog box, select the Path Analysis definition you want to
edit.
2. Click Edit.
Deleting a Path Analysis definition

To delete an existing Path Analysis definition:
1. From the Advanced Features dialog box, select the Path Analysis definition you want to
delete.
2. Click Delete.
3. Click OK. The definition is removed from the dialog box list.

Scenario Analysis
Use Scenario Analysis definitions to specify a path that you would like to monitor, such as a
sequence of check-out or registration pages. You specify the name of the Scenario Analysis
definition and the URLs that make up the each step of the scenario. WebTrends software
monitors traffic along these paths and reports the number of visits to each step along the
path.
Note: Depending on your version of WebTrends software, you might not have access to
Scenario Analysis. For more information, contact NETIQ support.
Adding a Scenario Analysis definition

To add a Scenario Analysis definition:
1. From the links at the top of the AdminConsole, select Advanced Features.
2. Select the Scenario Analysis tab. The list of Scenario Analysis definitions opens.
3. Click Add.
The Scenario Analysis dialog box opens.
4. In the Name text box, type the name for this definition. This name is used in the list of
Scenario Analysis definitions. This name does not appear in reports. If you are using
SmartSource tags, this name should be the Scenario Analysis name you specified in the
tags.
5. In the Report Title text box, enter the title of the report for this Scenario Analysis
definition. The report title will appear in the list of available reports.
Note: The report title will appear in the list of available reports once you’ve associated it
with at least one profile. Access the list of available reports by selecting Templates from
the main menu. For more details on report templates, see “Report templates” on
page 158.
6. In the Short Description text box, type the information you want to appear under the
banner for the report for this scenario analysis. For example, if you’re tracking the regis-
tration process for the ABC seminar, you might enter a short description of, "Visits to
registration pages for the ABC seminar."
7. In the Help Card Description text box, explain the benefits of this definition and why
someone would want to use it. This information appears at the top of the Help Card for
this definition.
8. If you’re using SmartSource tags to track users’ paths in your website, select the Use
SmartSource Tags Exclusively To Identify Scenario Steps check box. Otherwise
leave this box unchecked and, when adding the list of steps, you’ll specify the URL of the
page to be tracked.
9. In the Ordered List Of Steps list, add the appropriate steps in the order that the visitor
will visit them.
a. To the right of the Ordered List Of Steps list, click Add. The Add Step dialog box
opens.
b. In the Name text box, type the name for this step. This name is used in the
Ordered List Of Steps list. If you are using SmartSource tags, enter either the step
name (e.g., CartView, CartAdd, etc.) or the step number (e.g., 1, 2, 3, etc.) that was
used in the SmartSource tag.
c. In the Report Name text box, type the name for this step as you would like it to
appear in the graphs and tables generated in the report.
d. In the Description (Help Card) text box, define this step. This will appear in the
Help Card area of reports.
Note: If you selected the Use SmartSource Tags Exclusively To Identify

Scenario Steps check box in 8, you will not see the controls for the following three
procedure steps because their information is included in the SmartSource tags.
Skip to i.
e. In the Page text box, type the URL of the page to be tracked.
f. To treat the URL as a regular expression, select the Regular Expression check box.
g. If necessary, add the appropriate URL Parameters. For more information on URL
parameters, see “About dynamic pages and parameters” on page 83.
1) To the right of the URL Parameters (optional) list, click Add. The Add
Parameter dialog box opens.
2) In the Parameter Name text box, type the URL parameter on which to look
for matches.
3) In the Parameter Value text box, type the value for the specified Parameter
Name.

4) Select whether the Parameter Value is Text, Numeric, or a Regular
Expression.
h. Click OK.
i. Click OK.
You’re returned to the Scenario Analysis dialog box.
j. Repeat a through g for each step to be added. The number of steps you added will be
reflected in the list of scenario analysis definitions in the Step Count column.
Note: Scenario Analysis assumes that the design of your Web site enforces the correct
order of the steps. If visitors can randomly access your steps, you might not get an
accurate report. The order of the steps in the Ordered List Of Steps list box does
not affect how Scenario Analysis functions, but you can use the arrows to match the
order of your Web site.
10.Click OK.
Editing a Scenario Analysis definition

To edit an existing Scenario Analysis definition:
1. From the Advanced Features dialog box, select the Scenario Analysis definition to edit.
2. Click Edit.
Note: Some Scenario Analysis definitions that come loaded with the WebTrends software
contain strings surrounded by %% signs, for example,
%%SA_RT_Shopping_Cart_Funnel%%. These strings are used as tokens that refer to
localized text. If you change these tokens, the localized text function does not work. Also,
the tokens are specific to the Scenario Analysis definitions that contain them. If you copy
Scenario Analysis definitions that contain tokens, replace the tokens with your own text.
Deleting a Scenario Analysis definition
To delete an existing Scenario Analysis definition:
1. From the Advanced Features dialog box, select the Scenario Analysis definition to delete.
2. Click Delete.
3. Click OK. The Scenario Analysis definition is removed from the list.
Session Tracking
Use Session Tracking definitions to specify the length of visitor sessions and how to track
them. It's a good way to stitch together visitor sessions by tracking a common value. You can
track visitor sessions either by IP address only or by one of the following methods. Use IP
Tracking Only is the default setting.
• Authenticated User: Use this to track visitors by user name. You may find more authen-
ticated users than visitors because several persons may be using the same IP address.
Since many ISPs dynamically assign IP addresses, and since multiple visitors may come
from a single IP address, authenticated users is a much more accurate way to identify
visitors.
Note: Use this option only if all of your pages require authentication. If some pages
require authentication and others do not, your reports may not be accurate.
• URL Match: Use this to track visitor sessions by URL. This search is not case sensitive.
• Parameter Match: Use this to track visitor sessions by parameter name. Parameters are
located in the URL immediately after a question mark and they are followed by an equal
sign and a return value. For example, if the URL is /login.asp?user=bob, the
parameter name would be user. If there are multiple parameters, they are separated by
an ampersand (&).
• Cookie: Use this to track visitor sessions by cookie.
You can select one, all, or any combination of the these methods. If you select more than one,
the WebTrends software will look for them in the order they are listed. Once the WebTrends
software finds a value for one of the methods, it uses that value for that visitor session and
disregards the other methods, even if the other methods have values too.

For example, suppose you select Authenticated User, Parameter Match, and Cookie.
WebTrends software first searches for authenticated users, if there are no values for that, then
it searches for parameter matches. If it is able to match a parameter, that parameter’s value is
used for this visitor session, even if there are values for cookies too.
Adding a Session Tracking definition

To add an Session Tracking definition:
1. From the links at the top of the AdminConsole, select Advanced Features.
2. Select the Session Tracking tab and click Add.
3. In the Description text box, type the name for this session. This name will appear in the
list of Session Tracking definitions and in the reports.
4. In the Session Termination Timeframe text box, type the number of minutes a visitor
can be inactive before the session is considered terminated. The default setting is 30
minutes.
5. For Type Of Tracking, select the method to track the visitor session.
6. Click Next, and depending on your choices in 5, complete the following steps for the
appropriate dialog boxes:
Note: When you select Authenticated User, there isn’t an additional dialog box but the
Reporting Server tracks visitors by user name and password.
URL Match:
a. From the Match From drop-down list, select the starting point for the match.
b. In the next text box, enter the string to match.
c. From the Up To drop-down list, select the ending point for the match.
d. In the next text box, enter the text that indicates the end of the matching string.
e. If desired, select the Remove Matched Text check box. Use this to avoid reporting
a unique URL for every user who visits the page. This helps to keep the top
document tables more accurate.
f. Use the Test Area to see how the matching definition works before running an
analysis. Enter a URL to test. The Resulting URL text box displays the URL after
the replacement is performed. Session Tracking String displays the text that was
matched to the URL.
Parameter Match:
a. In the Parameter Name text box, type the name of the parameter you would like to
track. Parameter names are not case-sensitive and you cannot use wild cards to
specify a parameter name.
b. If desired, select the Remove Matched Parameter And Parameter Value check
box. With this selected, after the parameters and values are used to define a visitor
session, they are deleted from the log files.
Cookie:
Select one of the following options for tracking cookies:
− Use WebTrends Plug-in Code. Use this format if you’ve installed a WebTrends
logging plug-in on your web server.
− Use This Cookie. To specify the cookie to use, type the cookie text in this box.
− Use Entire cookie Field. Select this to use the entire cookie field.
7. In the Summary dialog box, review the settings and click Finish.
The Advanced Features dialog box reappears, with the Session Tracking tab showing.
Note: To make this new definition the default session tracking definition, click Select
Default.
Editing a Session Tracking definition

To edit an existing Session Tracking definition:
1. From the Advanced Features dialog box, select the Session Tracking definition you want
to edit.
2. Click Edit.

Deleting a Session Tracking definition
To delete an existing Session Tracking definition:
1. From the Advanced Features dialog box, select the Session Tracking definition you want
to delete.
2. Click Delete.
URL Parameter Analysis

Analyzing activity for a dynamic site
Getting meaningful data about a dynamic web site presents different problems than tracking
the same types of data on a static site. By associating each page that interests you with one or
more of the parameters used to create it, you can create reports that provide both a summary
of activity for each dynamic page (via the Dynamic Pages and Scripts section) and parameter
data for each page defined (via the Dynamic Pages section).
When creating reports on dynamic sites, avoid tracking pages as documents. To confirm that
the file extension your site uses for dynamic pages (such as .asp) is not listed as a document
type, select the File Types configuration option. See “File Types tab” on page 172 for more
information.
The section that follows explains what a URL Parameter Analysis definition is and provides
instructions for creating one. For details on defining URL parameter analysis definitions from
the command line, see the .pdf file “Advanced WebTrends Configuration Using .ini Files”,
which can be found in the Documentation directory of the WebTrends CD, for more infor-
mation.
Note: If you don’t define a page through a URL Parameter Analysis definition, the total hits
for the page are reported in the Top Forms section.

About URL Parameter Analysis definitions
A URL Parameter Analysis definition associates a page with the parameter used to create it,
enabling you to report on dynamically created web pages. Because many parameters can be
passed for a single page, you can create definitions for each parameter. The number of hits
and user sessions for each value submitted with the parameter appear in the Dynamic Page
reports. URL Parameter Analysis definitions can either be applied to all profiles or applied to
individual profiles.
The following procedure assumes you want to report on activity for products on a downloads
page. The URL for this page would look something like this:
www.webtrends.com/site_download/
download.htm?product=0014&product2=0021
Adding a URL Parameter Analysis definition

To add a URL Parameter Analysis definition:
1. From the links at the top of the AdminConsole, select Advanced Features > URL
Parameter Analysis.
2. Click Add. The URL Parameter Analysis dialog box opens.
3. In the Description text box, type a name for this parameter analysis definition. This
description will identify the definition in the Advanced Features window, in the profile
window, and in reports.
In the Page Name text box, type the name of the web page used by this definition. The
name you type is the one that will be used for the page each time it appears in the log file.
If the URL is www.webtrends.com/site_download/download.htm, you would
type this in the Page Name text box:
/site_download/download.htm
Note: To specify a home page, type a slash (/) in the Page Name text box. If the domain
is specified in the log file, then it must also be specified here.

4. To treat the URL as a regular expression, select the Regular Expression check box.
Note: If the text in the Page Name text box starts or ends with an asterisk (*) and the
Regular Expression check box is not selected, the page name is treated as a special type
of regular expression. In this case, the asterisk will match 0 or more of any character at
either the beginning of the page, the end of the page, or both.
5. To see how the expression works on a sample string, click Test.

6. Define the main parameter that you want to report on.
a. In the Primary Parameter text box, type the name of the main parameter. Param-
eters are located in the URL immediately after a question mark and they are followed
by an equal sign and a return value. If there are multiple parameters, they are
separated by an ampersand (&). For our example URL, you’d type product.
b. By default, the name in the Primary Parameter text box is used whenever this
parameter appears in reports. If you want a more descriptive name to be used, type
that name in the Name To Display In Reports text box.
c. If you want to translate the parameter, select the Translate Parameter1 Into More
Meaningful Strings check box then, in the Location Of Translation File text
box, type or browse the path to the file you want to use to store the translation.
Note: For more information, see the following section, “About translation files” on
page 103.
d. To limit the number of entries for this parameter, type a number in the Maximum
Entries text box. This can help improve performance.
7. To narrow your focus, you can define a second parameter to be reported on.
a. In the Parameter2 text box, type the name of the secondary parameter. For our
example URL, you’d type product2.
b. By default, the name you typed in the Parameter2 text box is used whenever this
parameter appears in reports. If you want a different name to be used, type that
name in the Name To Display In Reports text box.
The report table that is generated using the primary and secondary parameters
includes a column for all values that matched ID and another column for all values
that matched ID2, and breaks down the activity for each size.

c. If you want to translate the parameter, select the Translate Parameter2 Into More
Meaningful Strings check box then, in the Location Of Translation File text
box, type or browse the path to the file you want to use to store the translation.
Note: For more information, see the following section, “About translation files” on
page 103.
d. To limit the number of entries for this parameter, type a number in the Maximum
Entries text box. This can help improve performance.
8. Click OK.
The Advanced Features dialog box reappears, with the URL Parameter Analysis tab
showing.
About translation files

A translation file lists each value that parameter may have, and associates each value with a
phrase that’s easier to understand. For example, if your web site refers to products by number,
the translation file can translate those numbers into actual product names.
Each line in a translation file contains a value and a phrase, separated by a comma or tab, as
shown here:
0014,Firewall Suite
0016,Professional Suite
Sometimes you will want to translate several parameter values into the same phrase. If you sell
running shoes on your site, for example, and you want to report on all styles of a brand, the
translation file might look like this:
flight07,Flight Shoes
flight06,Flight Shoes
Editing a URL Parameter Analysis definition

To edit an existing URL Parameter Analysis definition:
1. From the Advanced Features window, select the URL Parameter Analysis definition you
want to edit.
2. Click Edit.

Deleting a URL Parameter Analysis definition

To delete an existing URL Parameter Analysis definition:
1. From the Advanced Features window, select the URL Parameter Analysis definition you
want to delete.
2. Click Delete.
3. Click OK. The definition is removed from the window list.
URL Search and Replace Definitions
Each entry in the web server log contains a field that references the URL of the page or file
that a visitor accessed. Each unique URL is counted as a separate page or file, and the infor-
mation in the field is used to track activity on the web site.
Some web server plug-ins or applications add unique identifiers to URLs that can cause hits
to these pages to be counted incorrectly. For example, some shopping-cart applications add a
unique string to a page name to identity each visitor to that page. This address string makes it
possible to track a visitor’s progress through the site and keep track of what’s in their
shopping cart. Every hit to a page that uses this added string appears in the log as a unique
URL, despite the fact that the hits are really all for the same page.
The URL Search and Replace feature helps you cut through this confusion. By deleting
specific identifiers from URLs or replacing all unique identifiers with a common string, you
can make page counts accurate and reports more informative. It also avoids out-of-memory
conditions that can result when the number of unique IDs is extremely high.
For details on defining URL Search and Replace definitions from the command line, see the
.pdf file “Advanced WebTrends Configuration Using .ini Files”, which can be found in the
Documentation directory of the WebTrends CD, for more information.
Note: You should use the URL replacement feature before any other processing takes place.

Using URL Search and Replace to group pages
You can use URL replacement definitions to analyze and report on URLs differently than
those URLs are recorded in the log. For example, you could report all pages from a certain
directory as hits to the same page, forcing the pages into a “group.” Because the URL
replacement is done before the analysis, the change affects the counting for all tables and
graphs.
Grouping pages using this method is not the same as using content groups. Content group
definitions only apply to the Content Group section, but a URL replacement definition
applies to all sections of the report.
Adding URL Search and Replace definitions

To add URL Search and Replace definitions:
1. From the links at the top of the AdminConsole, select Advanced Features > URL
Search And Replace.
2. Click Add.
The URL Search and Replace dialog box appears.
3. In the Name text box, type the name of this URL Search and Replace definition. This is
used to identify it in the definitions list and in reports.
4. From the Replace From drop-down list, select the starting point for the replacement.
Type the string to match in the next text box. You can specify multiple strings by
separating them with a pipe character (|). The pipe is interpreted as an "OR"--so if it
finds any of the strings listed, it will replace it with your text. The search is not case
sensitive.
5. From the Up To drop-down list, select the ending point for the replacement and type the
text that indicates the end of the replacement string.
6. In the With text box, type the text that will replace the string you defined in 4.
7. If desired, select the Perform Replacement Only If The URL Contains check box
and type a value to be matched. The text is replaced only if the URL contains this value.
8. To use the replaced text to track new users, select the Use The Text That Was
Replaced To Track Visitor Sessions check box.

9. Use the Test Area to see how the definition works. In the Enter A URL To Test text
box, type a sample URL, and click Test. The results appear in the Resulting URL text
box. The text that was removed appears in the Text That Was Replaced text box.
10.Click OK.
The Advanced Features dialog box reappears, with the URL Search And Replace tab
showing.
Editing a URL Search and Replace definition

To edit an existing URL Search and Replace definition:
1. From the Advanced Features dialog box, select the URL Search and Replace definition
you want to edit.
2. Click Edit.
Deleting a URL Search and Replace definition

To delete an existing URL Search and Replace definition:
1. From the Advanced Features dialog box, select the URL Search and Replace definition
you want to delete.
2. Click Delete.
Applying Advanced Feature Definitions

Once you have created your advanced feature definitions, you apply them to your profiles.
You can apply them globally or on a per profile basis.

Applying advanced features globally
You can apply advanced features in such a way that the settings you choose apply globally, to
all profiles. Once these global settings are selected for application, they cannot be de-selected
in an individual profile’s settings.
To apply advanced feature definitions globally:
1. From the links near the top of the AdminConsole, click Advanced Features.
2. Select the tab for the Advanced Feature category containing the definitions you wish to
apply globally.
− To apply specific definitions to all profiles, select the Global check boxes to the left
of the definitions you wish to apply.
− To apply all of the listed definitions to all profiles, click Select All. Definitions
created after this is clicked will not be automatically selected in this dialog box or in
individual profile settings.
− To deselect all of the listed definitions, click Select None.
Note: The definitions you select are applied to both existing and newly created profiles.
You cannot override these settings from within a profile’s settings.
4. To accept your changes, click OK. A confirmation dialog box displays.

5. Click OK again to confirm they have been saved.
Applying advanced features on a per-profile basis

You can apply advanced features directly to a profile from within an individual profile’s
settings. These selections only affect the selected profile.
To apply advanced feature definitions to an individual profile:
1. From the profiles list on the AdminConsole, select the profile to which you wish to apply
one or more Advanced Feature definitions, and click Edit. The profile’s settings open.
2. Select the Advanced Features tab.
3. Select the link containing the Advanced Feature definition to be applied.

− To apply specific definitions to this profile, select the check boxes to the left of the
definitions you wish to apply.
− To apply all of the listed definitions to this profile, click Select All. Definitions
created after this is clicked will not be automatically selected.
− To select all of the listed definitions and have all new definitions automatically
selected when they’re created, select the Always Use All <Advanced Feature>
check box.
Note: If a definition has been selected from the AdminConsole’s Advanced Features
dialog box, the definition has been applied globally to all profiles. You cannot override
these global settings on a per-profile basis.
5. To accept your changes, click OK. You return to the profile setting’s Advanced Features
dialog box.
6. Click OK again to save your advanced features settings. A confirmation message displays.
7. Click OK once more to confirm the changes to the profile that you’ve submitted to the
profile’s database.
Listing profiles associated with definitions

To better understand the effects when you update Advanced Features definitions, you can
view a list of profiles associated with each definition. The list tells you which profiles are
affected by changes to the definition.
To list all profiles that use a definition:
1. From the links near the top of the AdminConsole, click Advanced Features.
2. Select the tab for the Advanced Feature category containing the definition whose
associated profiles you would like to view.
3. Select the definition and click Show Uses.
You see the Locate Uses dialog box listing all profiles associated with the current
definition.
4. Click OK.

Chapter 6
Using Filters
How Filters Work

Filters let you specify the data that you want to process and store on a profile basis. The filters
that you use determine which portions of the log file data are stored in the data set.
You can create two kinds of filters:
• Include filters process activity in the log file that matches the filters you have defined
and ignore everything else.
• Exclude filters process all activity except the data you specify.
The distinction between these filters is subtle, but it becomes clearer if you think of it in
terms of what you want to accomplish with your filter. Suppose that you have a multi-homed
log file and you want to store activity for only one of those domains. You would create an
Include filter because you want to include only data for one domain. But suppose that your
multi-homed log contains activity for three of your domains and you want to store activity for
only two of them. In this case, it’s simplest to create an Exclude filter that excludes the third
domain.
The two filter types are not mutually exclusive; you can use both Include and Exclude filters in the
same profile. For example, if you want to determine how much of your domestic web server
activity comes from organizations other than the military, you would create an include filter
for all U.S. user addresses and an exclude filter for all military user addresses (.MIL).
Combining Filter Types

You can combine both filters of the same type and of different types.
• Using Filters 109

• Combining multiple filters of the same type: When applying multiple Include filters,
if the information meets the criteria of any of the filters, it is included. For example, if
you combine an include filter definition of URL=\test.htm with another definition of
returncode=304, you’ll include all hits that either have a URL of \test.htm or a return
code of 304. This is also true when using multiple Exclude filters.
• Combining Include filters with Exclude filters: For any given activity, if both an
Include filter and an Exclude filter match, the Exclude filter prevails and the information
is excluded.
Note: Filter order does not matter. That is, the order of the filters does not affect the way that
they are processed.
Visit and Hit Filters

You can apply your include or exclude filters to visits (also known as user sessions) and hits.
Visit Filters apply to visits, which consist of all activity for one user of a web site. By default a
user session is terminated when a user is inactive for more than 30 minutes. To add a Visit
Filter, read “Adding a Visit Filter” on page 110.
Hit filters apply to hits, which are actions on a web site such as when a user views a page or
downloads a file. To add a hit filter, read “Adding a Hit Filter” on page 113.
Adding a Visit Filter

The following instructions tell you how to create a new Visit Filter.
To add a Visit filter:
1. From the top of the AdminConsole, select Filters then the Visit Filters tab. Any Visit
Filter that you have created will be listed here.
2. Click Add. You see the Filter Type dialog box.
3. Select the type of filter you want to create:
− Include Filter—only log data which matches this criteria will be included in the
reports for this profile.
− Exclude Filter—log data which matches this criteria will be excluded from the
reports for this profile.

4. Select the type of server containing the information to be filtered, Web Server or
Streaming Media Server.
Note: WebTrends software supports the following streaming media: RealMedia, Quick
Time, and Windows Media.
5. Click Next. The General dialog box opens.

6. In the Filter Name text box, type a name for the filter.
7. Select one of the following options:
− Include/Exclude All Activity—include all visits in this profile’s report (disables
filter effectivity).
− Include/Exclude Activity Based Upon—limit the visits included in this profile’s
report to the selected Active Visit Filter Parameters. Select from the following Active
Visit Filter Parameters to build your filter:
• Entry Page – for more information, see “Entry Page” on page 118.
• Campaigns – for more information, see “Campaigns” on page 119.
• Referrer – for more information, see “Referrer” on page 120.
8. Click Next to continue.
9. If you selected Include/Exclude All Activity, go to step step 19 to complete building
your filter.
10.If you selected Include/Exclude Activity Based On, continue with the paths corre-
sponding to the check boxes that you select:
− If you selected Referrer, the Referrer dialog box opens. Continue with step step 11.
− If you selected Entry Page, the Entry Page dialog box opens. Note that .htm has
been entered as the Page Expression. Continue with step step 15.
− If you selected Campaigns, the Campaign dialog box opens. Continue with step
step 18.
11.From the Referrer drop-down list, select which type of referrers you want to either
include or exclude from your filtering. Choose from:
− All Referrers
− No Referrer
− http: URLs
− file: URLs

− mail: URLs
− ftp: URLs
− User Defined Referrer
Note: The default setting is All Referrers. For more information about referrers, see
“Referrer” on page 120.
12.If you don’t select All Referrers or No Referrers, type the URL in the Referral text
box. Be sure to include the protocol, such as http://.
13.Click the Help button on this page for examples of referring URLs.
14.Click Next and continue with step step 19.
15.Use the Entry Page parameter to include visits based upon the page at which they
entered your site. In the Page Expression text box, type an expression that describes
the entry page(s). You may use asterisks(*) as wildcards.
Note: Because most servers are case sensitive, be sure to type your filter exactly as the data
appears in the log file. For more information about Entry Page parameters, see “Entry
Page” on page 118.
16.If you want to use regular expressions, select the Regular Expression check box. To
Note: Click the Help button on this page for examples of page expressions.
17.If you want to filter on URL parameters, select one of the following options:
− To add an URL parameter:
1) Click Add to create a URL parameter. The URL Parameter page opens. For
example, if the URL is:
the parameter name would be “product” and the value would be “couch”.
You cannot use wildcards to specify a parameter name. However, you can use
wildcards to specify the value. The value can also be expressed by using text,
numerics, or regular expressions.
2) Enter your settings, and click OK to continue.

− To edit an existing URL parameter:
1) Select the parameter you want to edit.
2) Click Edit. The URL Parameter page opens.
3) Enter your changes, and click OK to continue.
− To delete an existing URL parameter:
1) Select the parameter you want to delete.
2) Click Delete. The URL parameter is removed from the list.
3) Click Next and continue with step step 19.
18.The Campaigns list shows all campaigns currently configured for this profile. If you want
to continue filtering every campaign associated with this profile, select the Always
Include (Exclude) All Campaigns For This Profile check box (which is the default
setting). Otherwise, deselect that check box and either select the check boxes of the ad
campaigns to be filtered, click Select All to select all ad views and clicks currently listed,
or click Deselect All to deselect any currently selected items in the list. For more infor-
mation, see “Campaigns” on page 119.
Click Next.
19.The Visit Filter Summary page opens and displays a summary of your current filter
settings. To edit your settings, click Back until you’re where you need to do your edits.
20.If everything is correct, click Finish. Your new Visit Filter will appear in the Global Visit
Filters dialog box as shown.
Adding a Hit Filter

The following instructions tell you how to create a new Hit filter.
To add a Hit filter:
1. From the top of the AdminConsole, select Filters then the Hit Filters tab.
2. Click Add. The Filter Type dialog box opens.
3. Select the type of filter you want to create:
− Include—only log data which matches this criteria will be included in the reports
for this profile.

− Exclude—log data which matches this criteria will be excluded from the reports for
this profile.
4. Select the type of server containing the information to be filtered, Web Server or
Streaming Media Server.
Note: WebTrends software supports the following streaming media: RealMedia, Quick
Time, and Windows Media.
5. Click Next. The General Hit Filter dialog box opens.

6. In the Filter Name text box, type a name for the filter.
7. Select one of the following options:
− Include/Exclude all activity—include all hits in this profile’s report (disables filter
effectivity).
− Include/Exclude activity based upon—limit the hits included in this profile’s
report to the selected Active Hit Filter Parameters. Select from the following to build
your filter:
• Address – for more information, see “Address” on page 121.
• Ad Views And Clicks – for more information, see“Ad Views and Clicks” on
page 123.
• Authenticated User Name – for more information, see “Authenticated User
Name” on page 123.
• Browser – for more information, see “Browser” on page 124.
• Cookie – for more information, see “Cookie” on page 125.
• Day Of Week – for more information, see “Day Of Week” on page 125.
• Directory – for more information, see “Directory” on page 125.
• File – for more information, see “File” on page 127.
• Hour Of Day – for more information, see “Hour Of Day” on page 128.
• HTTP Methods – for more information, see “HTTP Methods” on page 128.
• Multi-homed domain – for more information, see “Multi Homed Domain” on
page 129.
• Return Codes – for more information, see “Return Codes” on page 129.
• URL – for more information, see “URL” on page 130.
8. Click Next.

9. If you selected Include/Exclude All Activity, go to step step 19 of “To add a Visit
filter:” to complete building your filter.
10.If you selected Include/Exclude Activity Based On, the wizard opens one dialog box
for each parameter you selected. Enter your settings on each page, clicking Next to
continue.
Note: You can click Back at any time during this sequence to make changes to the hit
filter you are building.
11.The Hit Filter Summary page opens and displays a summary of your current filter
settings. To edit your settings, click Back until you’re where you need to do your edits.
12.If everything is correct, click Finish. Your new hit filter will appear in the Global Hit
Filters dialog box.
Editing a Filter
To edit a filter:
1. From the top of the AdminConsole, select Filters. The Global Visit Filters dialog box
opens.
2. Select the Visit Filter you want to change and click Edit. Note that it does not matter if
the corresponding check box is selected. The Edit Visit Filter dialog box opens.
Note: Click the Hit Filters tab to begin editing a hit filter.
3. Select any highlighted tab for the portion of the filter that you want to change. If a tab is
not highlighted, you must first select the General tab and select the corresponding item.
This will activate the tab.
4. Click OK to save your settings. The updated Visit Filter appears in the Global Visit
Filters dialog box.

Deleting a Filter
To delete a filter:
1. From the top of the AdminConsole, select Filters. The Global Visit Filters dialog box
opens.
2. From the Visit Filters or Hit Filters tabs, select the filter to be deleted. Click Delete.
3. Click OK to confirm the deletion.
The filter is removed.
Note: You can not delete a filter if it is currently applied to a profile. If you try to delete it, you
see a message telling you which profiles it is applied to.
Applying Filters Definitions

Once you have configured your filters, apply them to your profiles. You can apply filters
globally or on a per-profile basis.
Applying filters globally

You can apply filters in such a way that the settings you choose apply globally, to all profiles.
Once these global settings are selected for application, they cannot be de-selected in an
individual profile’s settings.
To apply filter definitions to globally:
1. From the AdminConsole, select the Filters tab.
2. Select either the Hit Filters or Visit Filters tab, depending on the type of filter you are
applying. Based on your selection, you see either the list of Hits or Visitor Sessions filters.
− To apply specific definitions to all profiles, select the check boxes to the left of those
definitions.
created after this is clicked will not be automatically selected in this dialog box or in
individual profile settings.

You cannot override these settings from within a profile’s settings.

Applying filters on a per-profile basis

You can apply filters directly to a profile from within an individual profile’s settings. These
selections only affect the selected profile.
To apply filter definitions to an individual profile:
1. From the profile’s list, select the profile to which you wish to apply one or more filters
2. Click Edit. You see the profile’s settings.
3. Select the Filters tab.
4. Select either Hit Filters or Visit Filters links then the Hit Filters or Visit Filters tab,
depending on the type of filter you are applying. Based on your selection, you see either
the list of Hits or Visitor Sessions filters.
5. From the filters list, select the filter to apply.
− To apply specific definitions to this profile, select the check boxes to the left of those
definitions.
Note: If a definition has been selected from the AdminConsole’s Filters dialog box, the
definition has been applied globally to all profiles. You cannot override these global
settings on a per-profile basis.
7. To accept your changes, click OK. You return to the profile setting’s Filters dialog box.
8. Click OK again to save your filters settings. A confirmation message displays.

Listing profiles associated with filters

To better understand the effects when you update filters, you can view a list of profiles
associated with each filter. The list tells you which profiles are affected by changes to the
filter.
To list all profiles that use a filter:
1. From the links near the top of the AdminConsole, click Filters.
2. Select the tab containing the filter whose associated profiles you would like to view.
3. Select the filter and click Show Uses.
You see the Locate Uses dialog box listing all profiles associated with the current filter.
4. Click OK.
Filter Element Descriptions

The following two main sections discuss the filter elements available for Visit filters and Hit
filters.
Visit filter elements

The following filter elements are available for use with Visit filters.
Entry Page
Use the Entry Page filter element to include or exclude entire visitor sessions based upon the
first page viewed. An entry page is the first page that the visitor requests in a session. The
item could be an image, a document, or a file.

For example, you have an ad banner on Yahoo! that links users to the page
/ads/yahoo_ad.htm. (This page might simply redirect users to your home page.) You could
create an Include filter with the entry page element set to
/ads/yahoo_ad.htm to determine the number of users clicking through from that banner.
The following table provides examples of how to format an Entry Page filter. Keep in mind
that the Entry Page filter applies to entire user sessions (visits), not individual hits.
Table 6-1. Entry Page filter examples
Example Explanation
/browser.htm Filters any session starting at browser.htm in the root direc-

tory.
browser.htm Filters a session browser.htm from any directory.
/ads/*.htm Filters any .htm file in the /ads directory.
/ads/*.* Filters any file in the /ads directory.
ad.* Filters any file named ad from any directory.
You can also use wildcards to match strings. For example, if the filter string contains no file or
extension, and has exactly one asterisk (*), which appears at the end of the string, a string
match against the record path is performed.
Campaigns
The Campaigns list shows all campaigns currently configured for this profile. Select the check
boxes of the appropriate campaigns to be filtered. For more information about Campaigns,
see “Campaign Definitions” on page 192.

Referrer
Use the Referrer filter to include or exclude entire visitor sessions based on the referring
URL. A referring URL is the link from which the visitor accessed your site. This filter helps
you identify the quantity and quality of visitors coming to your site from other sites or from a
specific Internet advertisement.
The default for the Referrer Include filter, All referrers, filters all hits with referring data
regardless of site.
The default for the Referrer Exclude filter, No referrers, filters only hits without any referring
information.
A filter entry of http:// filters any hits prefixed by http://.
Table 6-2. Examples of referrer filters
Example Explanation
http://www.refer- Filters anything coming from http://www.refer-

rer.com* rer.com. Hits from ftp://www.referrer.com are not
filtered.
http://www.referrer.* Filters www.referrer.com, www.referrer.net,

www.referrer.org.
*.referrer.com* Filters ftp.referrer.com,

www.referrer.com, but not things such as
www.referrer2.com or www.referrer.net.
*referrer* Filters anything with referrer in the name.

www.referrer.com, www.referrer1.com,
www.notreferrer.net, referrer.com, referrer, etc.
http://www.refer- Filters only references from page.htm at the

rer.com/page.htm www.referrer.com site.

Example Explanation
http://www.refer- Filters page.htm, page.html, page.html2, etc. from

rer.com/page.htm* the root of the www.referrer.com domain.
*.referrer.com/ Filters page.htm or page.html from any

page.htm* referrer.com domain (such as search.referrer.com or
ftp.referrer.com).
Hit filter elements
Address
Use the Address filter to include or exclude hits coming from specific domains, subnets, or IP
addresses from the results of this profile. For example, you can create a filter that excludes all
activity from your own domain. The default, All Addresses, is indicated by an asterisk (*) in
the User Address or Country field.
Table 6-3. Examples of address filters
Example Result
204.245.240.0-63 All numeric IP addresses from 204.245.240.000 through

204.245.240.63.
204.245.240.0- All numeric IP addresses from 204.245.240.0 through

204.245.240.64 204.245.240.64.

Example Result
204.245.240.64/26 CIDR notation, which shows that a block of IP addresses

belongs to a specific backbone provider. This lets larger
Internet routers use a single IP address to represent all of
the thousands of addresses serviced by a that backbone
provider. Instead of having to recognize each individual IP
address, the router now needs only determine which pro-
vider "owns" the block of IP addresses. The CIDR nota-
tion in the example is a "shorthand" which specifies all IP
addresses of this classless subnet: 204.245.240.64 -
204.245.240.127.
204.245.240.* Specifies all IP addresses from 204.245.240.000 through

204.245.240.255.
*.WebTrends.com Only those addresses that have a sub-domain that appears

to the left of this domain (such as,
www.WebTrends.com, ftp. WebTrends.com, etc.) This
would not include addresses without a sub-domain.
*WebTrends.com Any address that includes the specified domain, with or

without a sub-domain (such as, www. WebTrends.com, ftp.
WebTrends.com, or WebTrends.com).
*.edu *.com *.net All addresses that have the domain types: edu, com, or net.
*.de All addresses from Germany.
http://www.* Only those addresses that have www as a sub-domain.

Ad Views and Clicks
This filter is used in conjunction with Advertising Views and can include or exclude hits
resulting from an Ad View or Ad Click. Use this filter to produce reports based on a specific
Web site advertisement's activity. If you want to track activity related to a specific adver-
tisement on your site, define the ad using Advertising Views, and then filter all activities
related to the ad.
The Always Include All Hits To All Defined Ad Views and Ad Clicks check box is
selected by default. To choose individual ad views and clicks, clear this check box and select
the items you want to include.
Use the Select All and Deselect All links at the bottom of the dialog box to automatically
select or de-select the check boxes for all ad views and ad clicks.
Note: To define Advertising Views, from the AdminConsole, select Advanced > Advertising
Views tab. For more information on Advertising Views, see “Adding an Advertising View
definition” on page 81.
Authenticated User Name

If you have a site that requires visitors to log on with a user name and password, you can filter
those users.
Note: If you’re not getting the proper results with this filter, check that the user names and
passwords are being captured in the log files. Not all log files capture this information by
default.
In the Authenticated Username text box, type the name to be filtered. Put quotation marks
around names that contain spaces. Refer to the examples that follow for formatting tips.
Select Include All Hits From Authenticated Users if you wish to include any hit that origi-
nates from a user that must use a password and username to access your site. Select the Case
Sensitive check box if you want to filter exact upper- or lower-case matches.
Note: Because most servers are case sensitive, be sure to type your filter exactly as the data
appears in the log file, and select this box.

Table 6-4. Authenticated User Name filter examples
Example Result
"Jane Smith" Filters any activity that matches Jane Smith.

Note: If the user name you are filtering contains a space,
use quotation marks around the user name as shown here.
"Bob Smith" "Mike Filters any activity that matches these user names.
McIntosh" "John
Hill"
Browser
Use the Browser filter to either include or exclude a browser, spider, robot, Palm browser, or
WAP browser from the analysis and reporting. You can filter any browser if you know how it
appears in the Agent field of the log file.
Use a space to separate multiple browsers. Put quotation marks around browser names that
have spaces. You cannot use wildcards for browser filters. Refer to the following table for
more information.
Table 6-5. Browser filter examples
Example Result
Mozilla/4. Mozilla/3.1 Filters any activity that matches Netscape Navigator 4.

or Netscape Navigator 3.1.
MSIE “Microsoft Filters any activity that matches any version of Inter-
Internet Explorer/” net Explorer.

Note: You cannot use wildcards (*) in a browser filter. WebTrends Warehouse Builder assumes
that there are wildcards at either end of each browser entry when comparing it to the agent
field in the log file.
Filtering for Netscape Navigator may not return accurate results because many browsers
identify themselves as Netscape Navigator
Cookie
A cookie is a file sent with the page requested from the server to the visitor, and stored on the
visitor’s system. It uniquely identifies previous visitors to your site the next time they return.
The cookie filter is a visitor session filter. When the cookie for a visitor session is matched or
not matched, depending on whether the filter is include or exclude, the entire visitor session is
included or excluded.
Type the cookie you want to either include or exclude in your filtering in the Cookie Name
text box. You can use wildcards. For example, if the cookie you wanted to filter was
ACME=abcde, then you would type ACME here. Then type the value attribute in the Cookie
Value text box. Using the above example, you would type abcde in this text box. Select the
Cookie Value As Regular Expression check box to treat the URL as a regular expression.
Click Test to see how the expression works on a sample string.
Regular expression syntax is described in detail in “Regular Expression Syntax” on page 253.
Day Of Week
Use the Day Of Week filter to include\exclude specific days of the week. If a day’s check box
is selected, log file activity that matches that day is filtered.
Directory
Use the Directory filter to include or exclude the activity of a specific directory. The default
for an Include Directory filter is to include all directories starting at the root directory,
indicated by an asterisk (*). There is no default for the Exclude Directory filter.
Use wildcards to specify multiple directories, or separate directories with a space. Put
quotation marks around directories containing spaces or commas. For example: "/logo
graphic".

Table 6-6. Directory Filter examples
Example Result
/images Specifies the directory /images is filtered and all

sub-directories therein, if Include Sub-directories is
selected.
"/image files" Specifies the long directory, /image files.
"/image files" / Specifies the following directories: /image files, /intranet,

intranet /graphics and /graphics.
/*graphics Specifies any first-level directory whose name ends in

graphics, such as /bitmap graphics, but not /intranet/bit-
map graphics.
/*/graphics Specifies all second-level directories named /graphics, such

as /home/graphics and /intranet/graphics, but not /
home/sales/graphics. Directories such as /home/graph-
ics/logos, are specified by this example only if Include
Sub-directories is selected.
/graphics /*/ Specifies all first, second and third level directories named
graphics /*/*/ graphics, such as /graphics, /home/graphics, and /home/
graphics sales/graphics. Sub-directories of these, such as /home/
graphics/logos, and /home/sales/graphics/logos/spe-
cials would be included only if Include Sub-directories is
selected.

Example Result
/*graphics*/ Specifies all first level directories with names containing

graphics, such as /graphics, /graphics files, and /bitmap
graphics.
Note: Remember to put quotation marks around directo-
ries containing spaces or commas.
The Also Include/Exclude Sub-Directories check box is selected by default. This option
includes or excludes all sub-directories for the specified directory. Select the Case Sensitive
Match check box if the server containing the directory requires exact upper- or lower-case
matches.
File
Use the File filter to include or exclude specific files. Type the file name or extension in this
field, or click the down-arrow to select a file type from the list. The default for an Include File
filter is to include all files, indicated by “*.*”. There is no default for an Exclude File filter.
Use wildcards to specify file names or extensions, such as all HTML files (*.HTM) or all GIF
files (*.GIF). Specify several file types at once by inserting a space between each file type.
Select the Case Sensitive check box if you want to look for exact case matches (upper and
lower case).
Note: Many servers are case-sensitive, be sure to type your filter exactly as what you want to
look for in the log file, and select the Case Sensitive check box.
Table 6-7. File Filter examples
Example Result
help.htm Filters the file help.htm.

Example Result
*.gif *.bmp Filters bitmap (.bmp) and gif (.gif) files.
help*.html Filters all html files whose name begin with help.
help*.* Filters all files whose name begin with help, regardless of
type.
"marketing.htm" Filters the files marketing.htm, marketing help.htm, and

"marketing marketing leads.htm.
help.htm"
"marketing
leads.htm"
Hour Of Day
Use the Hour Of Day filter to include or exclude activity that occurs within the specified
hours of the day. Any activity that is within the range specified in the Hours drop-down lists
is filtered.
HTTP Methods
Select which HTTP methods you want to use in your Include or Exclude filter:
• GET. A request method that returns whatever information is identified by the request
URI. This is the most common request method. For example, if the request asks for a file
on a server, the contents of the file are returned.
• POST. An HTTP request that sends a block of data that must be handled by the URI in
the request. Both the client and server must understand the format of the data being sent
for the request to be successful. The most common use of the POST method is with
HTML form data that is sent to a server, where it will be processed by CGI scripts.
• PUT. Similar to the POST method, only the URI in the request has a different function.
In the PUT request method, the URI identifies the resource for which the block of data
enclosed with the request is intended.

• HEAD. A request method much like the GET method, except that instead of returning
the information identified by the request URI, it returns only the response headers of the
HTTP request. This method can be used for obtaining meta-information about the
resource identified by the Request-URI without transferring the information itself. For
example, if the request asks for a file on a server, the file name may be returned, rather
than the contents of the file.
• UNKNOWN. Any HTTP request method that is not a GET, POST, PUT, or HEAD
method.
Multi Homed Domain

Use the Multi Homed Domain filter if your log file contains activity from more than one
domain. Specify the domains you want to include or exclude. For example, if your log file
contains activity from domains www.abc.com, www.def.com, and www.ghi.com, and you want
to store activity for www.abc.com, you would create an Include filter and type www.abc.com
in the Domain text box.
Note: This filter only applies to multi-homed log files. To filter multiple domains, separate
your entries with a space.
Return Codes
Use the Return Codes filter to specify the types of results you want to include or exclude. For
example, if you are creating an include filter and you want to only report on successful hits,
select Success Only from the list.
You can select one of the common returns codes provided in the list, or type another numeric
result code in this field.
Note: The default, All Return Values, is indicted by an asterisk (*) in the field.
The predefined list includes the following:

• (All Return Values)
• Success Only
• Failed Only
• Success, OK (200)
• Success, Created (201)
• Success, Accepted (202)

• Success, Partial Information (203)
• Success, No Response (204)
• Success, Redirected (300)
• Success, Moved (301)
• Success, Found (302)
• Success, New Method (303)
• Success, Not Modified (304)
• Failed Bad Request (400)
• Failed Unauthorized (401)
• Failed Payment Required (402)
• Failed Forbidden (403)
• Failed Not Found (404)
• Failed Internal Error (500)
• Failed Not Implemented (501)
• Failed Overloaded Temporarily (502)
• Failed Gateway Timeout (503)
• User Defined Return Code(s)
URL
Type the expression you want to use in the Page Expression text box. This is how the page
appears in the log file. For example, if the URL is www.webtrends.com/site_download/
download.htm, in the Page Expression text box, you would enter: /site_download/
download.htm. You can use * and ? as wild cards.
To treat the URL as a regular expression, select the Regular Expression check box. Click
Test to see how the expression works on a sample string.
Regular expression syntax is described in detail in “Regular Expression Syntax” on page 253.
If the page specified in the Page Expression text box is a dynamic page, you may wish to use
URL parameters to properly identify the URL. You may add, edit, and delete URL parameters
in the URL Parameters section of this dialog box.
Add a URL parameter:

1. Click Add to create a URL parameter. The URL Parameter page opens. For example, if
the URL is:
the parameter name would be “product” and the value would be “couch”.

You cannot use wildcards to specify a parameter name. However, you can use wildcards
to specify the value. The value can also be expressed by using text, numerics, or regular
expressions.
2. Enter your settings, and click OK to continue.
Edit an existing URL parameter

1. Select the parameter you want to edit.
2. Click Edit. The URL Parameter page opens.
3. Enter your changes, and click OK to continue.
Delete an existing URL parameter

1. Select the parameter you want to delete.
2. Click Delete. The URL parameter is removed from the list.

Chapter 7
Using Custom Reports
The Custom Reports feature lets you create reports of your own design from a selection of
report elements. That is, you can manage the type of content that you want to report on. This
can be of significant value if you want reports to reflect specific data that is not correlated for
your precise needs in the standard WebTrends software reports.
Each custom report consists of one table and its associated graph(s). Some basic concepts
involved in creating custom reports are the following:
• Primary Dimension: The main group that you want to track (for example, a product
category, such as sports apparel).
• Secondary Dimension: Subset of the Primary Dimension that you want to track (for
example, products, such as running shoes, shorts, t-shirts, jackets, and socks).
• Measures: Visitors generate Measures (quantities) during their visits, and these Measures
are represented in the reports in columns. Measures let you define how the data for a
column will be retrieved from the log file. For example, if visitors put a pair of socks in
their shopping cart, the socks would be retrieved as shoppingcart.asp additem
qty=5 and counted in the report.
The following table represents a sample custom report with a Primary Dimension of sports
apparel and various kinds of sports apparel as the Secondary Dimension. The Quantity
Purchased column is a Measure showing how many of a specific product was purchased. The
Visits column lists how many visits came to that page of the web site. Note that although
visitors may visit a web site only a few times, they can make many purchases.
• Using Custom Reports 133

Table 7-1. Sample Custom Table
Primary Secondary Quantity Visits

Dimension Dimension Purchased
Sports Apparel Running shoes 5 7

Shorts 9 4
T-shirts 12 10
Jackets 3 1
Socks 25 12
Adding a Report with Predefined Dimensions and

Measures
The following procedure describes how to add a custom report with predefined dimension
and measures. If you want to create a custom report with custom dimensions, measures, and
filters, see “Adding a Report with Custom Dimensions, Measures, and Filters” on page 140.
To add a Custom Report definition:
1. From the links at the top of the AdminConsole, select Custom Reports. You see the
Custom Reports dialog box.
2. Click Add.
3. In the Name text box, type a unique name for this table. This name only represents the
custom report in the WebTrends software interface, not your reports. An example name
would be Ad Campaign for Ectera Insurance.
4. In the Report Title text box, enter a title for the report. This title will appear at the top
of the report and in the report’s table of contents. Make report titles short and to the
point, which helps the readability of the table of contents. Continuing with the previous
example, the report title would be Ad Campaign.
5. From the Category drop-down list, select a category with which to classify this report. If
you do not select a category, the report will be placed in the Default category.

6. To add a custom category complete the following steps:
a. Click Add. You see the Category Management dialog box.
b. From the Manage Categories For list, select the Custom Report feature to create a
category for.
c. Under Category List, click Add.
d. In the Enter New Category Name text box, type a category name then click Add.
The new category is added to Category List. You can add more categories or click
OK to return to the General dialog box.
7. In the Short Description text box, type a brief description of this custom report. This
appears at the top of the generated report.
8. In the Help Card Description text box, type any additional explanatory information
about the custom report. This text will appear in the Help Card information that follows
the graphs and tables of the report.
9. Click Next. You see the Dimensions dialog box.
Note: For information about dimensions, see “Working with Dimensions” on page 149.
10.From the Primary Dimension drop-down list, select the dimension you want to use. If
you select Cookie Parameter or Query Parameter, you see the Parameter Name text
box. Type the name of the parameter. For example, a parameter name to track many
products could be called productID.
11.In the Column Name text box, type a name or use the default name. This name is the
column heading for that dimension in the report table.
12.(Optional) To exclude the default string entry from this report, select the Exclude
Default Strings check box. The default string is recorded when this dimension infor-
mation is missing from the log file. Excluding this string helps focus the report on the
information actually collected in the log file.
13.(Optional) If the specified Primary Dimension's value is based on a query parameter with
multiple values, you see the Correlate Multiple Values check box. Select this when you
want to align the multiple values. For example, if you want to track multiple products and
their corresponding order amounts.
14.(Optional) To limit the number of elements that are analyzed, deselect the No Limit
check box for Max Analysis Elements and type the maximum number of elements (in
thousands) that you want to be analyzed for this dimension.

Use this option if you have very large analysis tables and want to optimize disk space and
improve performance. For example, if the dimension is URL and you have a month
worth of data containing millions of URLs, Max Analysis Elements can be used to limit
the unique URLs that are analyzed. Once the limit is reached, no new URL will be
captured. This helps to keep tables at a manageable size.
15.In the Max Report Elements (Top-level) text box, type the limit for the number of
entries that are shown in the report for this dimension.
Use this option to make your reports more concise and readable. For example, you have
2,000,000 URLs recorded for this report but you want to display only 200 of them. All of
the data is still being analyzed, unlike with Max Analysis Settings, so you get the complete
analysis but you focus the reports on the top elements.
16.In the Max Report Elements (Per Sub-level) text box, type the limit for the number
of sub-level entries that may be shown for the associated top-level dimension. This
option will only appear if you have elected to create Drilldown reports by using query
parameters to define sub-level entries for a dimension. For more information on creating
Drilldown reports, see “Creating Drilldown Reports” on page 142.
Just as with the Max Report Elements (Top-level), use this option to make your
reports more concise and readable.
17.(Optional) From the Secondary Dimension drop-down list, select another dimension,
if needed.
18.In the Column Name text box, type a name or use the default name. This name is the
column heading for that dimension in the report table.
19.(Optional) To exclude the default string entry from this report, select the Exclude
Default Strings check box. The default string is recorded when this dimension infor-
mation is missing from the log file. Excluding this string helps focus the report on the
information actually collected in the log file.
20.(Optional) If the specified Secondary Dimension's value is based on a query parameter
with multiple values, you see the Correlate Multiple Values check box. Select this when
you want to align the multiple values. For example, if you want to track multiple products
and their corresponding order amounts.
21.(Optional) To limit the number of elements that are analyzed, deselect the No Limit
check box for Max Analysis Elements and type the maximum number of elements (in
thousands) that you want to be analyzed for this dimension.

Use this option if you have very large analysis tables and want to optimize disk space and
improve performance. For example, if the dimension is URL and you have a month
worth of data containing millions of URLs, Max Analysis Elements can be used to limit
the unique URLs that are analyzed. Once the limit is reached, no new URL will be
captured. This helps to keep tables at a manageable size.
22.In the Max Report Elements (Top-level) text box, type the limit for the number of
entries that are shown in the report for this dimension.
Use this option to make your reports more concise and readable. For example, you have
2,000,000 URLs recorded for this report but you want to display only 200 of them. All of
the data is still being analyzed, unlike with Max Analysis Settings, so you get the complete
analysis but you focus the reports on the top elements.
23.In the Max Report Elements (Per Sub-level) text box, type the limit for the number
of sub-level entries that may be shown for the associated top-level dimension. This
option will only appear if you have elected to create Drilldown reports by using query
parameters to define sub-level entries for a dimension. For more information on creating
Drilldown reports, see “Creating Drilldown Reports” on page 142.
Just as with the Max Report Elements (Top-level), use this option to make your
reports more concise and readable.
24.Click Next and you see the Measures dialog box.
25.From the Column 1 drop-down list, select the measure to be used.
26.Type a name or use the default name in the corresponding Column Name text box.
This name will become the column heading for that measure in the report table. If you
do not give the measure a column name, a default column name will be assigned.
27.Some measures require that you select how they are counted. Select the appropriate
method (Sum, Average, Minimum, Maximum, or Count) from the corresponding
Method drop-down list.
Note: If Count is selected as the method, the values associated with the measure will be
ignored and the number of times the measure is in the log file is counted.
28.Repeat step step 25 through step step 27 for the remaining measures that you need – up
to four measures total. Click Next and you see the Format dialog box.
29.Select whether to format the primary column over time or by top items or both.

30.Select the type of graph you want formatted from the Trend and Top Items categories.
− From Trend select one of the following graphs: Bar Graph, Stacked Graph, Line
Graph, or Area Graph.
− From Top Items select Bar Graph or Pie Chart.
31.Under Table Row Limits you can determine how many rows of data for primary and/
or secondary dimensions will be represented reports in Word or Excel format. Click
Next and you see the Filters dialog box.
32.Select the Include or Exclude box for each filter that applies. Note that all of the filters
you have created are added to this list.
33.Click Finish. Your custom report should now be added to the list of Custom Reports.
34.Click OK, and click OK to the confirmation message. The AdminConsole opens.
You can re-analyze the profiles and generate a report. The following figure shows a report
generated from pre-defined dimensions and measures:

Figure 7-1. Sample Revenue By Product Custom Report

Adding a Report with Custom Dimensions,
Measures, and Filters
The following set of instructions describe how to add a report with customized dimensions,
measure, and filters. It will also describe how to specify where the source data originates.
Note that this set of instructions assumes that you are starting from scratch.
Adding dimensions
To add custom dimensions:
1. From the links at the top of the AdminConsole, select Custom Reports and then the
Dimensions tab.
2. Click Add, and you see the General dialog box.
3. In the Name text box, enter a unique name for this dimension. This name will appear in
the lists of custom dimensions in the profile views.
4. From the Category drop-down list, select a category with which to classify this
dimension. If you do not select a category the dimension will be placed in the Default
category.
5. To add a custom category complete the following steps:
category for.
c. Click Add.
The new category is added to the Category List. You can add more categories or
click OK to return to the General dialog box.
6. In the Column Name text box, type a name. This name appears in the report at the top
of the column for this dimension.
7. In the Help Card Description text box, enter any additional information that may be
help in understanding the dimension. This information will appear in the Help Card area
that follows the report. Click Next. You see the Based On dialog box for custom dimen-
sions.

8. From the Value To Base On drop-down list, select the value on which to base your
dimension.
If you select Cookie Parameter or Query Parameter, you see the Parameter Name
text box. Type the name of the parameter. For example, a parameter name to track many
products could be called productID.
Note: If you are creating Drilldown reports, you would select Query Parameter here, and
enter the name of the query parameters associated with the sub-levels of the dimension
being defined. For more information on creating reports with Drilldown capability, see
“Creating Drilldown Reports” on page 142.
For parameters with multiple values, select the Parameter Can Have Multiple Values
check box and specify the delimiter used to separate values.
9. To override the default string that appears when this dimension's information is missing
from the log file (such as "None"), select the Override Default String check box. Type
a new default string in the New String text box. The new string will appear instead of
the standard default string.
10.From the Extract Substring drop-down list, select how to examine a substring of the
value that you selected in Value To Base On drop-down list. This is helpful when you
want to pick out a specific subset of information in the string.
If you select Fixed Pattern, you can use the variable %val% to identify multiple strings.
For example, if productID is represented in the log file by 1N-xxx where xxx can be
any combination of numbers, you can select Fixed Pattern from the drop-down list and
then type 1N-%val% in the Pattern text box so that all substrings starting with 1N- are
extracted.
11.(Optional) Select the Translate Substring Retrieved Above check box and complete
the following steps to translate the substring into more meaningful information.
a. From the Data Source drop-down list, select the data source. This list contains the
data sources you create via the Data Source tab (see “Adding a custom data source”
on page 147).
b. In the Key Column text box, type the letter that corresponds to the column in the
data source containing the keys from the log file. For example, if the keys are in the
first column, type a.
c. In the Value Column text box, type the letter that corresponds to the column in the
data source containing the values for the keys. For example, if the values are in the
second column, type b.
12.Click Finish.

Your custom dimension is now ready to be used to create a custom report.
Creating Drilldown Reports

Drilldown reports allow you to break down a custom report dimension into the sub-elements
that comprise it. For example, if you had a report that provided information on the state from
which your web visitors originate, you might want to see what cities by state those visitors
come from. Drilldown reports let you define the sub-levels within a dimension that you wish
to review. Drilldown reporting can occur in three different ways: using GeoTrends, SDC, or
dynamic sites.
Drilldown using GeoTrends

If you have installed GeoTrends, you can create hierarchical reports using GeoTrends
geographical data. The sub-levels are already defined if you select to use this option, and are
available as a standard dimension called Geographic Drilldown.
To access Geographic Drilldown dimension, you will need to access the Dimensions dialog
box when either editing an existing custom report or creating a new custom report. The
Geographic Drilldown dimension will be available in the Primary Dimension drop down
list or the Secondary Dimension drop down list.
Drilldown using SDC

Drilldown reports may also be used with a SmartSource Data Collector. To use this method,
you will need to create a new custom dimension, and define the query parameters in your
SDC log file that represent the sub-levels you wish to include in reports.
Drilldown with dynamic sites

And finally, if your site is a dynamically generated site, you can use the query parameters of
your URLs to define a new custom dimension and its sub-levels. While SDC is designed to
easily handle Drilldown reporting, you can design your site so that it accommodates
Drilldown reporting. You would need to ensure that your query parameters were designed in
such a way that the sub-levels were easily recognizable and consistent.
For example, to get Drilldown reports for State, then City by State, you would want to make
sure that the query parameters logged in your web server log file contained these parameters
and values.

To use Drilldown with dynamic sites or SDC:
1. Follow steps step step 1 through step step 7 in the instructions from “To add custom
dimensions:” on page 140.
2. From the Value To Base On drop-down list, select Query Parameter. The Parameter
Name text box displays.
3. In the Parameter Name text box, type the name of the query parameters in your log file
that represent the sublevels you wish to have Drilldown reports for. For example, a
parameter name for state could simply be state, and the parameter name for city could
be city. With SDC, these parameter names will be pre-defined names.
4. These log entries are likely separated by a delimiting character such as an ampersand (&)
or a semi-colon (;). If an ampersand was the delimiting character, you might have a log
file entry for city and state in the query parameters that looks like this:
city=Houston&state=Texas
To tell WebTrends software how to separate out these sub-levels, select the Parameter
Contains Drilldown Data, and enter the delimiting character in the Delimiter text box.
5. Continue with step step 9 from “To add custom dimensions:” on page 140.
Adding measures
To add custom measures:
Measures tab.
2. Click Add, and you see the General dialog box for custom measures.
3. Type the name of the new measure in the Name type box. This name appears in the lists
of custom measures in the profile views.
4. From the Category drop-down list, select a category with which to classify this measure.
If you do not select a category the measure will be placed in the Default category. To add
a custom category complete the following steps:
category for.
c. Click Add.

5. In the Column Name text box, type the name to appear in the report at the top of the
column for this measure.
6. In the Help Card Description text box, enter any additional information that may be
help in understand the measure. This information will appear in the Help Card area that
follows the report.
7. Click Next. You see the What To Measure dialog box.
8. Select the value on which to base your measure from the Value To Base On drop-down
list.
9. In the Parameter Name text box, type in a parameter name. For example, a parameter
name to track many products could be called productID.
10.For parameters with multiple values, select the Parameter Can Have Multiple Values
check box and specify the delimiter used to separate values.
11.From the Extract Substring drop-down list, select how to examine a substring of the
value that you selected in Value To Base On drop-down list then, if appropriate, specify
the pattern of the substring. This is helpful when picking out a specific subset of infor-
mation in the string.
If you select Fixed Pattern, you can use the variable %val% to identify multiple strings.
For example, if productID is represented in the log file by 1N-xxx where xxx can be
any combination of numbers, you can select Fixed Pattern from the drop-down list and
then type 1N-%val% in the Pattern text box so that all substrings starting with 1N- are
extracted.
12.(Optional) Select the Translate Substring Retrieved Above check box and complete
the following steps to translate the substring into more meaningful information.
a. From the Data Source drop-down list, select the data source. This list contains the
data sources you create via the Data Source tab (see “Adding a custom data source”
on page 147).
b. In the Key Column text box, type the letter that corresponds to the column in the
data source containing the keys. For example, if the keys are in the first column, type
a.
c. In the Value Column text box, type the letter that corresponds to the column in the
data source containing the values. For example, if the values are in the second
column, type b.

13.Click Next.
14.From the When drop-down list, specify when to take the measurement and take the
following steps if appropriate.
a. If you select All Hits or Hits That Match Specified URL, you are asked if you
want to sum this measure across visits. If you want to report on the average value of
the total hits per visit, select Yes. If you want to report on each individual hit, select
No.
Note: For more information about this option, see “Summing measures across visits”
on page 150.
b. If you select Hits That Match Specified URL, specify an expression in the Page
Expression text box and select whether to match expressions that equal or do not
equal it. The hits are filtered before accumulating the value into the visit's total.
15.Click Next. You see the Format dialog box.
16.If you are creating a report that deals with money, complete the following steps to
format the report.
a. From the Currency Symbol drop-down list, select how to represent the monetary
values shown in your reports.
Note: This feature does not allow you to convert monetary amounts from once
currency to another.
b. In the Decimal Places text box, specify the number of decimal places. If you
specify 0, no decimal point will appear in the report.
17.Click Finish.
Adding filters
To add custom filters:
Filters tab.
2. Click Add, and you see the General dialog box for custom filters.
3. In the Name text box, type a name for this filter.

4. From the Category drop-down list, select a category with which to classify this filter. If
you do not select a category the filter will be placed in the Default category. To add a
custom category complete the following steps:
category for.
c. Click Add.
5. Specify whether this is a Hit or Visit filter.
Note: When editing a filter, you are not able to change this setting.
6. Complete the following steps to specify the match criteria.

a. Click Add.
b. From the Filter On drop-down list, select the type of information to be filtered. The
fields that appear beneath this drop-down list depend on your selection.
Note: After you create custom dimensions or measures, they automatically populate
this drop-down list. If you don't see the dimension or measure on the list, it may be a
hit dimension or measure and you're creating a visit filter or vice versa.
c. In the fields that appear, specify the attributes to be matched for this filter.
Note: When specifying a Numeric Comparison Method, you can use commas to
separate multiple entries. The data has to match only one of the entries to be
considered a match for this filter. Also, while greater than a number (>15) and less
than number (<15) are acceptable entries, greater than or equal to (>=15) and less
than or equal to (<=15) are not.
d. Click OK.
e. Repeat step step a through step step d for each criteria to be matched.
7. Select whether the data must meet all or any one of the criteria.

8. Click Finish. Your new filter is listed in the Custom Reports dialog box.
Adding a custom data source

To add a data source
Data Sources tab.
2. Click Add, and you see the General dialog box for custom data sources.
3. In the Name text box, type a name for your data source that is meaningful and that you
can easily recognize.
4. Select if this data source is a file or a database.
a. If you select File, complete the following:
1) In the Location Of Translation File text box, type or browse the path to the
file you want to use to store the translation.
2) Use the Column Delimiter drop-down list to specify the columns in the trans-
lation file.
b. If you select Database, complete the following:
1) Select a Source Database Type from the corresponding drop-down list.
2) In the Source Database text box, type or browse the path to the data base you
want to use.
3) Type the user name and the password for the Database Authentication in the
corresponding text box.
5. Click Test Connection to check that the WebTrends software can access the specified
source database
6. Click OK. Your newly created data source is now listed in the Custom Reports dialog
box.

Editing a Custom Report Definition
To edit an existing custom report definition:
1. Select the custom report definition you want to edit.
2. Click Edit.
3. Update the settings as needed, and click OK to save..
Important: When editing an existing custom report, changes to certain fields can cause errors
in analysis because the existing analysis data is based on different criteria than analysis data
collected after you make the changes. When this happens, you see a warning and you're given
a choice of the following:
• Continue with the changes and clear the existing analysis data
• Canceling the changes and using the existing custom report and analysis data.
Your decision affects all profiles that use the modified custom reports. For more information,
see the online Help for Custom Reports.
Some custom reports that come loaded with WebTrends software contain strings surrounded
by %% signs, for example, %%CD_Cookie%%. These strings are used as tokens that refer to
localized text. If you change these tokens, the localized text function does not work. Also, the
tokens are specific to the custom reports that contain them. If you copy a custom report
containing a token, replace the token with your own text.
Deleting a Custom Report Definition

To delete an existing custom report definition:
1. Select the custom report definition you want to delete.
2. Click Delete.
3. The custom report definition is removed from the list.

Working with Dimensions
Combining Dimensions
The following are some suggestions for useful combinations of dimensions.
Table 7-2. Dimension combinations
Primary Dimension Secondary Dimension Benefit
Shopping Cart Level New Or Returning Visi- Shows the difference in shopping
tor behavior between new and return-
ing visitors.
Shopping Cart Level Day Of The Week Shows the change in shopping
behavior over time.
Campaign Day Of The Week Shows the effectiveness of the

campaign over time.
State Products Viewed During Shows the interest in products by

Visit geographic location.
Search Engine Shopping Cart Level Shows which search engines pro-
duced more buyers. This could be
helpful for targeting future adver-
tising.
Formatting custom tables

When the following dimensions are selected as the only dimension or the second dimension
of a table, the table can only be formatted by Visits or PercentOfVisits. These dimensions

tally hits differently than the other dimensions so the Hits and PercentOfHits options are not
available.
• Entry Page
• Exit Page
• Products Viewed During Visit
• Product Categories Viewed During Visit
• Shopping Cart Level
Summing measures across visits

To report on visits rather than individual hits, sum your measures across visits. For example,
you can create a custom report that shows the average amount of money spent during each
visit by visitors from Oregon. To do this, create a custom measure and call it "Cost". Base this
measure upon a query parameter that accumulates All Hits and sums them across the visit.
Then create a custom report, with a Primary Dimension of State that includes the measure,
and select Average for the method of counting the measure. For this example, assume the log
file recorded the following information:

Table 7-3. Sample log file information
Visitor State Cost
V1 OR $2
V1 OR $3
V2 WA $10
V2 WA $12
V3 OR $15
V3 OR $12
In this scenario, if you enable Do You Want To Sum This Measure Across Visits, the total
cost of all hits from Oregon ($32) is divided by the number of visits from Oregon (V1 plus
V3 = 2 visits) to get an average of $16 per visit. If you didn't sum the measure across the visit,
the WebTrends software takes the total cost of all hits from Oregon ($34) and divides it by
the total number of hits from Oregon (4) to get a result of $8, the average cost per hit.
Note: If you are using the correlation of multiple values, do Not sum measures across visits.
That is, if you have multiple hits in a visit, each with a correlation between the product, order
quantity, and revenue parameters, they will be summed together as in the following example:
In a single hit, a visitor bought 2 apples for $2 and 3 oranges for $4. The result of sum across
visit is 5 apples for $6 and 5 oranges for $6.
Applying Custom Reports Definitions

Once you have created your Custom Reports definitions, you apply them to your profiles.
You can apply them globally or on a per profile basis

Applying custom reports globally
You can apply custom reports in such a way that the settings you choose apply globally, to all
profiles. Once these global settings are selected for application, they cannot be de-selected in
an individual profile’s settings.
To apply custom reports globally:
1. From the AdminConsole, select the Custom Reports tab.
2. Select the Reports tab.
− To apply specific definitions to all profiles, select the check boxes to the left of the
You cannot override these settings on a per profile basis.

Applying custom reports on a per-profile basis

You can apply custom reports directly to a profile from within an individual profile’s settings.
These selections only affect the selected profile.
To apply custom report definitions to an individual profile:
1. From the AdminConsole, select the profile to which you wish to apply custom report
definitions, and click Edit. The profile’s settings open.
2. Select the Custom Reports tab.
3. Select the Custom Reports link.

− To apply specific definitions to this profile, select the check boxes to the left of the
− To select all of the listed definitions and have all new definitions automatically
selected when they’re created, select the Always Use All <Reports> check box.
Note: If a definition has been selected from the AdminConsole’s Custom Reports dialog
box, the definition has been applied globally to all profiles. You cannot override these
global settings on a per-profile basis.To accept your changes, click OK. You return to the
profile setting’s Custom Reports dialog box.
5. Click OK again to save your custom report settings. A confirmation message displays.
Listing profiles associated with custom reports

To better understand the effects when you update custom reports, you can view a list of
profiles associated with each custom report. The list tells you which profiles are affected by
changes to the custom report.
To list all profiles that use a custom report:
1. From the links near the top of the AdminConsole, click Custom Reports.
2. Verify the Reports tab is selected.
3. Select the custom report and click Show Uses.
You see the Locate Uses dialog box listing all profiles associated with the current custom
report.
4. Click OK.

Chapter 8
Creating and Viewing Reports
How Reports Are Built

This chapter explains the elements for building reports and how to use them to create
reports. Understanding these main concepts is essential to using WebTrends software effec-
tively.
WebTrends software
WebTrends software analyzes data from your log files to help you understand the activity on
your site. Through a profile, you specify the log file to be analyzed, how it should be analyzed,
and the reports to generate.
Note: In addition to performing functions through a browser, you can also control all aspects
of the WebTrends software from the command line. See the .pdf file “Advanced WebTrends
Configuration Using .ini Files”, which can be found in the Documentation directory of the
WebTrends CD, for more information.
Log files
When someone connects to your site, the event is stored by the web server in a log file. Log
files record data such as the user, the protocol used to access the page (such as HTTP or
FTP), what they did, the platform used (such as UNIX, NT, Windows 98), the search engine
(such as Yahoo or Lycos), keywords, date, time, and much more. The WebTrends software
uses the data from this log file to create reports.
Log files typically have a .log extension and are located in various directories, depending on
the web server that you use.
• (NT) Microsoft IIS: c:\winnt\system32\logfiles\ex010616.log
• Creating and Viewing Reports 155

• (NT) Netscape: c:\netscap\servers\http-[server
name]\logs\ex010616.log
Sample log file: Common and combined (extended)

format
The NCSA recognizes two log file format standards, the common and combined (sometimes
called extended) formats. The following is a sample line from a common log file:
www.webtrends.com - - [16/Jun/2001:10:36:09+0000] "GET /dept/
argguides/dwsg/420102.jpg HTTP/1.0" 304 21342
The combined log file format is similar to the common log file format with the addition of
the referrer and agent fields at the end of the line. The following is a sample in combined
format:
www.club-voile.fr - - [12/Jun/2001:19:35:39 +0000] "GET / HTTP/
1.0" 200 6054 "http://search.yahoo.com/bin/
search?p=trends%20internet" "SPRY_Mosaic/v8.32 (Windows 16-bit)
SPRY_package/v4.00"
The following table defines each of the fields in the combined format sample.
Table 8-1. Field definitions for combined format log files
Field # Field Name Description Text From Combined Sample
Field 1 User Address The numeric IP address or www.club-voile.fr

domain name of the user
accessing the site
Field 2 Rfc931 The domain for multi- -

homed web servers
Field 3 User Authenti- The user name, if required -

cation

Field # Field Name Description Text From Combined Sample
Field 4 Date/Time The date and time the user 12/Jun/2001:19:35:39

accessed the site
Field 5 GMT offset The number of hours from +0000

GMT (if this is +0000 it is
logged in GMT time)
Field 6 Action The particular operation "GET / HTTP/1.0"

(i.e., “Get” or “Post”) of
the hit (this must be in
quotes)
Field 7 Return Code The return code for the 200

action tells if the process
was a success or failure and
why
Field 8 Size The size of the file sent 6054
Field 9 Referrer: The URL which linked the "http://search.yahoo.com/bin/

user to your site search?p=trends%20internet"
Field 10 Browser/ The web browser and plat- "SPRY_Mosaic/v8.32 (Windows

form used by the visitor to 16-bit) SPRY_package/v4.00"
Platform
your site

Profiles
Profiles specify the information for the reports. They define the data to be gathered.
Profiles specify how the log file should be analyzed and which activities you want to report
on. Through the profile, you define the log file’s location, its type, any activity you want
filtered, and whether the IP resolution should be performed. The WebTrends software
analyzes the log file according to the profile and uses the result to create reports. For more
information, see “Using Profiles” on page 43.
Report templates
Specify the appearance of your reports using report templates. A report template defines the
look and content of the report, including the colors, tables, graphs, and language used. You
can start with a blank template or the WebTrends software provides a set of report templates
which you can modify to create new ones. The report template settings are on the following
two tabs.
Content tab
The left side of the tab displays the folder hierarchy for the template and the right side is
where you manage the following items:
• Folder Name text box: Use this to specify the name of your folders. They are used in
the report’s table of contents.
• Check boxes and edit tools: Select the check boxes for the items to be modified then
click Cut, Copy, Paste, Delete, or the Move arrows to apply those functions to the
selected items. You can also select and deselect all of the current check boxes at once.
• New Folder icon: Use this to add a folder to the folder listed in the Folder Name text
box.
• Add Reports icon: Use this to add dashboards and reports to the currently selected
folder.

• Add Dashboard icon: Use this to add dashboard items and external links to the
currently selected folder. Dashboards appear in reports as summary items that you can
click to get the full information.
Note: Some Dashboard Descriptions in the dashboards that come loaded with the
WebTrends software contain strings surrounded by %% signs, for example,
%%GeneralStats_ShortDescription%%. These strings are used as tokens that refer
to localized text. If you change these tokens, the localized text function does not work.
Also, the tokens are specific to the dashboards and templates that contain them. If you
copy a dashboard containing a token, replace the token with your own text.
• Add External Link icon: Use this dialog box to specify a Web page or image to be
included in the report. The linked information displays in the report in a space that's the
same size as the other dashboard items.
• Name links: Click on the folder or individual item's name to see details. This also works
for the folder names on the left side of the tab.
The icons to the right of the items tell the default graph style and whether a table is included.
Language/Style tab
Use this tab to specify how your reports will look, including their colors, format, and
language.
• Style Sheets (text/css): Select the style sheet that you want to use for this template.
Style sheets define colors as well as the format of the report. You can view the style by
clicking Style Preview.
• Default Language: From the drop-down list, select the default language to use for this
template. If desired, users can change the language in the Report Viewer.
• Word Wrap: Select wether to wrap long strings of text or cut them off. Wrapping text
will provide a more complete story while trimming long strings makes for a shorter,
cleaner report.
• Report Graphs: Select whether to include graphs in the report. If the length of your
reports is an issue, this can help reduce their size.
• Help Cards: Select this check box to include help cards in reports that use this template.
Help cards explain the tables of the report and describe how to use the information in
the report. The information in the Help cards is relative to the data being shown in the
report.

• Numeric Alignment: Select how the numbers in the report are aligned.
Apply templates
You apply templates in the Report Template settings for the profile. For more information,
see “Report Templates” on page 64.
Note: For information on how to add, edit, and delete templates, please refer to the online
Help.
Managing Profile Processing

You can view the profiles currently being processed and those waiting to be processed in the
Job Queues dialog box. From there you can stop profile processing, rearrange the order of
the profiles to be processed, or remove profiles from the processing queue. Changes made in
this dialog box only affect these instances. The profiles will be processed at their next
scheduled interval.
Stop processing profiles

The Current Analysis Queue lists the profiles that are currently being processed. You can
select to stop processing specific profiles or all of the listed profiles.
To stop processing profiles:
1. From the links along the top of the AdminConsole, click Job Queues. The Job Queues
dialog box opens.
Note: You can also access the Job Queues dialog box by clicking Administration > Job
Queues from the links at the top of the AdminConsole.

− To stop processing specific profiles, from the Current Analysis Queue, select the
profile (or press the Ctrl key and click to select multiple profiles) and click Stop.
− To stop processing all of the listed profiles, click Stop All.
You’re asked if you want to stop processing the selected profiles.

3. Click OK.
4. To acknowledge that the process has been stopped, click OK again.
Arranging the order of the profiles in the Waiting

Queue
The Waiting Queue lists the profiles in line for processing in the order they will be
processed. You can send a profile to the top or the bottom of the queue according to your
priorities.
To send a profile to the top or bottom of the Waiting Queue:
1. From the Waiting Queue, select the profile to be moved.
2. Click either Top Of Queue or Bottom Of Queue.
You are asked if you want to move the selected profile.
3. Click OK.
4. To acknowledge that the profile has been moved, click OK again.
Removing a profile from the queue

If there is are profiles in the Waiting Queue that you don’t want to process, you can remove
them from the queue. You can select to remove specific profiles or all of the listed profiles.
To remove profiles from the Waiting Queue:
− To remove specific profiles, from the Waiting Queue, select the profile (or press
the Ctrl key and click to select multiple profiles) and click Remove.
− To remove all of the listed profiles, click Remove All.
2. You’re asked if you want to remove the selected profiles from the Waiting Queue.
3. Click OK.
4. To acknowledge the profiles removal from the queue, click OK again.
5. Click Close.

Viewing Reports
Reports present the data analyzed by the profiles. Report settings determine when the reports
are generated and how this data is presented. This includes the colors, fonts, format, and
storage location for reports. Reports can be viewed through Netscape Navigator or Microsoft
Internet Explorer.
Using the WebTrends Desktop

Use the WebTrends Desktop to see the reports generated for a selected profile. To view a
profile's reports, select the profile and click View Reports from the Profiles menu on the left
side of the AdminConsole. The WebTrends Desktop opens (Figure 8-1 on the following
page) showing all the information you need to navigate reports of that profile’s activity.
Note: To view reports for a Parent-Child profile, select the parent profile then click the Show
Children link from the Profiles menu on the left. You’ll see the child profiles in the profiles
list. Select a child profile and click View Reports.

Figure 8-1. The WebTrends Desktop report viewer
The WebTrends Desktop consists of:

• a Report Calendar, in the upper left pane
• a Table of Contents in the lower left pane
• either a “dashboard” of popular reports—which you can click through to quickly drill
down to the data you need—or the individual report you have currently selected, in the
right pane.
You can find instructions for working with these three parts of the WebTrends Desktop in
the following sections.
The Report Calendar

Use the Report Calendar to select which data you want reported on, and how to view it.

There are three steps to viewing reports using the calendar. First, define which mode you
want to use. This tells the software what action to take with the report data. Next, select the
time period—or date range you want reports on—from the body of the calendar. This
defines the scope of the data you want to view. The HTML-formatted report dashboard then
appears in the right pane for you to view, or drill down through. You can then take the
optional third step of converting your report to an alternate format (see “Converting reports
to alternate formats” on page 165).
Choosing the Reporting Mode

• Non-comparative Mode This is the standard mode for report viewing. In this
mode, you can select from standard date ranges that the Report Center already recog-
nizes: day, week, month, and quarter.
You can also work with the following navigational aids in this mode:
− Select Report Dates Nearest Today icon: Click this to see the report for the most
recent time period that has data.
− Searchable Month and Year lists: Click the arrows above the Calendar to change
the month, or click the arrows below the Calendar to change the year.
− Day, Week, Month, Quarter, and Year links: If a report is available, a link appears
in the calendar for that interval (e.g., day, week, month, quarter, or year). Click a date
or interval link. The selected link is highlighted and the corresponding report will
appear.
• Comparative Mode : Click this icon to toggle between viewing comparative
reports (side-by-side comparisons of a set reports from one time period to another) and
viewing a single report.
In comparative mode, once you’ve selected the two time periods that you want to work
with, you can click the Transpose Comparison icon to swap the dates between
the two calenders. The resulting reports can help you deepen your understanding of your
web traffic data.
Note: Depending on your license to use your WebTrends software, you may not have
access to Comparative Reports. Please see your administrator if you have licensing or
permissions issues.
• Custom Date Mode Click this icon ( ) to

view a report for a single custom date period (for example, the last three days of an ad
campaign.)

• Comparative Custom Mode Click this icon
( ) to compare two custom date ranges (for example, weekend activity between two
different weeks.) You will be prompted to correct your date range inputs if they are
invalid.
The Table of Contents

Use this to navigate to the dashboard or individual report you want to view.
The Dashboard/Report viewing area

The right pane of the WebTrends Desktop also includes:
• Language drop-down list: Use this to specify the language the report is displayed in.
The default language for this list is specified in Templates options
(Templates>Edit>Style/Language tab.)
• Report Template drop-down list: Use this to specify which report template is used to
display the report. The templates available for this profile are specified in the individual
profile settings. (Profile>Edit>Report Settings tab.)
• Links to full reports: Click the titles at the top of the dashboard graphs to see the corre-
sponding full reports.
Note: To be able to view a report for a profile, the user must have access to that profile. For
information about providing profile access, see “Profile Access” on page 63, or see your
system administrator.
Converting reports to alternate formats

WebTrends software reports are in HTML format. With a click of a button, they can be easily
converted to Microsoft Word or Excel documents, a CSV (comma separated values) text file,
or to PDF. This makes it easier to include the report’s information in presentations or other
documentation, or—in the case of the CSV file—for import into a database.
As a part of the conversion process, the WebTrends Document Utility is loaded on to your
computer and used to convert the reports. Also, the workstation running the remote interface
needs to meet the following criteria for the conversion to work properly:
• The “System requirements” on page 23 must be met.

• Microsoft Office must be installed on the workstation.
• Microsoft Windows 95/98, Windows ME, Windows 2000, or Windows NT must be
running on the workstation running the remote interface.
To convert reports from HTML to an alternate format:
1. From the AdminConsole, select a profile.
2. From the Profiles menu on the left, click View Reports.
3. You can convert the whole report or just the currently displayed chapter. If you want to
report on only a specific chapter, navigate to it now.
4. From the upper-right of the Report Calendar, click the Export icon .
5. Specify the format and content of the report.
6. Click Auto.
Note: If you do not already have Sun’s JVM 1.4 installed on your system, you will be
prompted to install it. Macintosh OS X users must go to System Preferences, and use
Software Update to install JVM 1.4, if they have not already done so.
7. Follow the additional prompts to complete the installation process.

The WebTrends Document Utility is installed (if necessary) and the report is downloaded and
converted to the specified format.
Uninstalling the Document Utility

To uninstall the Document Utility—not the entire WebTrends program—
follow these steps:
From the command prompt of the Document Utility’s installation directory, type:
Windows
uninstall.bat
Mac OS X
uninstall.sh

The default location of the installation directory is:
Windows
C:\Program Files\WebTrends Document Utility II
MacOS X
/Applications/WebTrends Document Utility
The Document Utility is deleted from the system.
Report Data and Help Cards

There are hundreds of different ways to analyze your web site’s log file. For a complete list of
available tables and graphs, generate a report on one of the sample profiles included with the
WebTrends software.
To generate a sample report:
1. From the AdminConsole, select a sample profile.
2. From the Profiles menu on the left, click View Reports. A report will be generated for
the profile you have selected.
By default, generated reports include Help Card data: descriptions of a table and graph you
are viewing, and how the data can be used to help improve your site.
You may find tables and graphs in your report which do not contain any data, due to a variety
of configuration factors. Empty tables and graphs do not necessarily signal an administrative
error; it could be that your profile has not been configured to track the missing information.

Chapter 9
Configuring Options
As an Administrator, you have access to all program settings. Use the Options button and
menu to modify settings that impact performance and processing as well as define new
profiles.
The settings defined here are used as the default settings for the Add New Profile wizard.
Note: The default settings used when creating a profile are taken from your selections in the
Options dialog box. Any changes made in Options affect all default values, including those
you accepted when creating a profile. Be aware that the changes you make affect all of your
profiles.
User Access settings override the settings defined here. See “Adding Users” on page 185 for
details.
Options Tabs
The following sections describe the functions available through Options.
Archiving tab
WebTrends software will only access data in chronologically order. If there are days where log
files aren’t present, it causes gaps in the reports. This can happen if a file isn’t available at the
time of analysis, or if there are issues with permissions.
Once the missing log files are available, Archiving enables you to perform the analysis more
efficiently. Instead of having to reanalyze the entire database, use Archiving to go back only as
far as the missing log files, include them in the analysis, and reanalyze the data from that date
forward.
Use this dialog box to specify how often archives are performed and the number of archives
that are maintained for each profile. You can also set a default for the Enable Archiving
setting that appears in the profile settings.
• Configuring Options 169

To define archive settings:
1. From the links at the top of the AdminConsole, click Options.
You see the Options dialog box.
2. Select the Archiving tab.
3. In the Frequency, In Days text box, specify how often archives are made for each
profile.
4. In the Max Number Of Archives Per Profile field, specify the maximum number of
archives to maintain for each profile.
Note: Once the maximum number of archives is reached, the oldest archives are deleted
to make room for new archives.
5. To enable archiving of new profiles by default, select By Default, Enable Archiving

For Profiles.
6. Click OK.
Compressed Log File Cache tab

WebTrends software extracts compressed log files before it analyzes them. By default, before
analysis is performed, the log file is extracted to a temporary storage directory unique to the
profile. Once the extracted log file is analyzed, it is deleted from the directory.
When multiple profiles use the same compressed log file, you can save time and resources by
storing the extracted log file in a global cache that all of the profiles can access. This way, the
file is extracted only once, and is deleted when the conditions specified in Cache Limits are
met. (In Cache Limits, you can define how long the log file can remain unaccessed before
it’s deleted and/or how large the cache size can become before the oldest files are deleted. See
step step 3 in the following procedure.)
Note: To store extracted log files in a global cache, the compressed files must contain only one
log file. If there are multiple log files in a compressed file, the WebTrends software will revert
to its default behavior of extracting and deleting the log files on a per profile basis, regardless
of the settings.
Use the Compressed Log File Cache tab to define how to store extracted log files.

To define how to store extracted log files:
2. Select the Compressed Log File Cache tab.
3. Select one of the following methods for storing extracted log files:
− Use Global Cache To Store Uncompressed Log Files: Select this to temporarily
store extracted log files, making them available for multiple profiles to process. For
Cache Limits, select the appropriate check boxes and define how long to store
unaccessed files and/or the maximum size the cache may grow to before the oldest
files are deleted.
Note: If you select this method and do not select either check box under Cache
Limits, the extracted log file will never be deleted.
− Delete Uncompressed Log Files After Each Analysis: Select this to extract log
files on a per profile basis. The extracted files are deleted immediately after analysis.
4. Click OK.
Database Directory tab

Use the Database Directory tab to define the default directory for the database containing the
profile’s data.
Note: If you change this location, WebTrends software re-analyzes the log file from the
beginning. The original databases remain in the old directory and are not copied to the new
location.
To define the default directory for a profile’s database:

2. Select the Database Directory tab.
3. In the Database Directory text box, type the default directory to use for profile data. To
maintain a separate directory for each profile, use the %profile% macro in your entry.

4. To allow non-administrators to define this directory on a per-profile basis, select the
Allow Non Administrators... check box.
5. To allow administrators to define this directory on a per-profile basis, select the Allow
Administrators... check box.
6. Click OK.
Domain tab
Use the Domain tab to modify how domains are reported in graphs and tables (for example,
the Organization Breakdown graph and table).
To define domain groups:
2. Select the Domain tab.
3. Select the domain grouping and click Edit. The Edit Domains dialog box opens
displaying the domain suffixes included in the selected grouping.
4. To add a domain suffix to this group, click Add and type the suffix.
5. To remove a domain suffix from this group, select the suffix and click Delete.
6. Click OK.
File Types tab

Use the File Types tab to define which types of files relate to downloaded files, document
files, or Stream documents. It determines what is in the Top Documents report. Use this
function to focus reports on what’s important to you.
To define file types:
2. Select the File Types tab.

3. Select the file type that you would like to modify:
− Page File Types: This list identifies files that qualify as page views. This data
appears in the Top Pages table and graph.
− Download File Extensions And Types: This list identifies the file types that are
associated with downloaded files. This data appears in the Top Downloaded Files
table and graph.
− Stream Document File Extensions And Types: These file types are included in
WebTrends report tables and graphs that pertain to streaming media log file content.
4. Click Edit.
You see the list of file extensions and the conditions when they are considered this file
type.
5. To add a file extension to this file type, click Add and type the extension. No period is
required before the extension.
6. To delete a file extension from this file type, select the extension you wish to remove and
click Delete.
7. For the selected file extension, specify whether to include all or part of the query string in
the reports.
8. Click OK.
FTP Log File Cache tab

Use the settings in the FTP Log File Cache tab to minimize downloads for log files that are
accessed using FTP. Log files can be downloaded either every time the profile is processed or
only when changes in the file are detected.
To define FTP log file cache settings:
2. Select the FTP Log File Cache tab.
3. Select which method to use for caching remote log files.
− Store FTP Logs In Global Cache: To use disk space more efficiently, select this
option.

Sometimes the same log file is downloaded for different profiles. Multiple copies of
the same log file can unnecessarily take up disk space. This option cleans the cache
and saves disk space by eliminating duplicate log files and using one log file to
process all appropriate profiles.
When using this option, you can specify the following cache limits by selecting the
appropriate check boxes:
• Delete Cached Copies Not Accessed In The Last text box Days: In the
text box, type the number of days for the server to wait before deleting log files.
The server will keep track from the last time the log file has been accessed.
• On Server Start-up, Trim Cache To text box Megabytes: In the text box,
type the number of megabytes for the size limit of this cache. When the server
starts up, if the cache is larger than specified, the oldest files will be deleted first
until the limit is reached. All of the log files in the Global Cache contribute to
this limit.
− Store FTP Logs In Per Profile Cache: To save every log file that is downloaded
for this profile, select this option.
This option is less efficient in managing disk space but it’s safer because different
profiles aren’t sharing log files when they process. The log files are stored separately,
per profile.
When storing local copies, you can specify the following options:
• Cache Limits: Select the Limit The Size Of The Log File Cache To text
box Megabytes check box. In the text box, type the number of megabytes to
be the size limit for this cache. The limit applies to the log files for this profile
only.
• Download Remote Log Files: Select whether the log files will be downloaded
every time or only when changes to the remote file are detected. (You may need
to scroll down to see these options.) For better performance, select to download
only when there are changes.
4. Click OK.
FTP Options tab

Use the FTP dialog box to define how log files that are accessed using FTP are handled.

To define FTP options:
2. Select the FTP Options tab.
3. In the FTP Cache Directory text box, specify where to store the log files accessed using
FTP. By default, log files are downloaded to:
./wtm_wtx/datfiles/ftp.
4. In the FTP Timeout text box, type (in seconds) the length of the timeout for FTP
activity. If a successful connection to the FTP server cannot be made before this limit is
reached, the connection to the FTP server is dropped.
5. In the FTP Connections area, specify one of the following FTP connection methods.
− Use Passive FTP: When this is used, the server opens a port, and the client
connects to the server. Passive FTP is preferable where there is a firewall between
the client and the server. This is because firewalls are typically configured to block
incoming connections that are not recognized. Although some firewalls can parse
the FTP data requests and allow active FTP connections, many require passive FTP
connections.
− Use Active FTP: When active FTP is used, the client opens a port and the server
connects to the client.
6. For FTP Paths, select whether to use absolute or relative paths.
Absolute paths are the exact paths to the log files while relative paths provide the
location of the log files relative to the FTP server being used. For example, if you have a
profile pointing to
ftp://ftpserver/logs/log1.log, the absolute path used is
/logs/log1.log while the relative path is ./logs/log1.log. (Note the period in
front of this path that indicates a relative path.)
7. Click OK.
General tab
Use the General tab to define whether to include HTML titles in reports, the maximum
number of titles to cache, and the number of days to keep the cache. Also specify whether or
not to retrieve HTML titles for forms.

To define general settings:
2. Select the General tab.
3. In the Session Termination Timeframe text box, type the number of minutes that a
user needs to be inactive before their session is considered finished.
4. If you wish to adjust for differences in time zones between where the log files were
created and where they are analyzed, complete the following steps:
Note: This feature is used for log files that are local time only. It doesn’t apply to W3C log
files or any log files that have a time zone offset in them.
a. In the Time Zone area, select the Override The GMT Offset To Use For
Processing Reports check box.
b. In the text box that appears, enter the offset value, in hours, that you want the
WebTrends software to use.
Note: To adjust for times moving west from GMT, use a positive value. To adjust for
times moving east from GMT, use a negative value.
5. To retrieve web page titles in your reports, select the Retrieve HTML Page Titles
check box. Type the number of titles to store in the cache, and specify how long the
entries should be saved.
Note: Retrieving page titles can slow report creation. Choose this option only when it is
important to identify HTML pages by their titles.
6. Click OK.
Internet Resolution tab

Use the Internet Resolution tab to define the default IP resolution settings for profiles. IP
Resolution is the process of translating the numeric IP addresses into domain names. Domain
names are more descriptive so they can be more useful in reports, especially if you don't know
the individual IP addresses for your servers.

Once a numeric address has been resolved, the result is stored in a permanent cache to
expedite all subsequent reports. The default cache size is 50,000 entries; once this limit is
reached, the oldest addresses are replaced with the new entries.
It’s most efficient for your web server to resolve IP addresses when it logs activity but if this
is not possible, the addresses can be resolved by the WebTrends software when it analyzes the
log files. If the WebTrends software resolves the addresses, it may slow reporting.
To define Internet Resolution settings:
2. Select the Internet Resolution tab.
3. To provide domain names in your reports, select the Perform A DNS Lookup For
each Unresolved IP Address check box. If your web server doesn't resolve IP
addresses and you don't select this check box, your reports display visitor's IP addresses.
4. To include company and demographic information in your reports, select the Company
Location Resolution check box. If this box is not selected, your reports will contain no
company and demographic information.
Note: The Company Location Resolution check box is available only if WebTrends
GeoTrends is installed. To install GeoTrends, go to the AdminConsole and from the
Accessories menu in the upper-right, select GeoTrends.
5. Click OK.
Locale tab
Use the Locale tab to define the default for your organization's country of origin. This default
is for all profiles created after the setting is specified. It does not affect profiles created before
the setting has been changed.
To define web site locales:
2. Select the Locale tab.
3. From the Your Country drop-down list, select the country to be considered domestic.

4. Click OK.
Performance tab
Use the Performance tab to modify settings that may improve performance in your
environment.
To configure system performance settings:
2. Select the Performance tab.
3. For Maximum Number of Simultaneous Analyses, type the maximum number of
profiles that can be processed concurrently. If your system has fast processing or multiple
CPUs, increasing this number may improve performance.
4. Click OK.
Profiles tab
The Profiles tab allows you to define the directory for storing profiles.
Note: If you change the profile directory, only new profiles are stored here. All previously
created profiles remain in the original directory unless you copy them to the new location.
To define profile directories:

2. Select the Profiles tab.
3. In the Profile Directory field, specify the directory for storing profiles. To indicate that
the directory is relative to the program directory,
enter ./ before the name of the directory.
4. Click OK.

Proxy tab
If you access the Internet through a proxy server, you must configure these settings. For
example, if you enabled page title retrieval in the General tab, the WebTrends software must
be able to access the Internet in the same manner that you do.
To define proxy server settings:
2. Select the Proxy tab.
3. Select the Connect Through A Proxy Server check box.
4. In the Address text box, specify the URL for the proxy server to use. For example,
portland.com might be the URL of the server.
5. In the Port text box, type the port number for the server.
6. In the Proxy Server Login Information text boxes, type the user name and password
required to access the server. This information is required only for servers that authen-
ticate their users.
7. Click OK.
Report Header tab

Use the Report Header tab to specify an image to include in your reports. You can also
specify a URL to reference when a visitor clicks on the image. The WebTrends logo is
provided by default.
To change report headers:
2. Select the Report Header tab.
3. For Primary, specify the following options:
− Report Image: To include an image in the header of the report, specify the absolute
path to the graphic in this text box. The image is automatically resized for the Report
Viewer.

− Report Image Alt: Type text to be displayed when the image isn't available or is
being loaded. In some browsers, this text may be displayed as a tool-tip over the
image.
− Associated URL: Type the URL to reference when the visitor clicks on the graphic
in the Report Image field. For example, you can specify your company logo in the
Report Image field, and the URL to your home page in this field.
4. For Secondary, specify the following options:
− Report Image: To include an image in the header of the report, specify the absolute
path to the graphic in this text box. The image is automatically resized for the Report
Viewer.
− Report Image Alt: Type text to be displayed when the image isn't available or is
being loaded. In some browsers, this text may be displayed as a tool-tip over the
image.
− Associated URL: Type the URL to reference when the visitor clicks on the graphic
in the Report Image field. For example, you can specify your company logo in the
Report Image field, and the URL to your home page in this field.
5. Click OK.
Report Template tab

Use the Report Template dialog box to define the default report template for new profiles.
Report Templates define the colors, fonts, and content of the report. You can create your
own templates in the Report Templates dialog box. “Report templates” on page 158 for
details.
To select a template to use with reports:
2. Select the Report Templates tab.
3. From the Web Profile Templates drop-down list, select the template to use as the
default for Web Server profile types.
4. From the Stream Profile Templates drop-down list, select the template to use as the
default for Streaming Media Server profile types.
5. From the Report Week Starts On area, select the day of the week you want the Report
Calendar to display as the start of the week.

6. To allow non-administrators to define the report template on a profile basis, select the
Allow Non Administrators check box.
7. Click OK.
Reports tab
Use the Reports tab to define the default reports for new profiles. Each time a profile is
analyzed, the WebTrends software updates each of the reports selected. Once the data is used
to create the reports, it is no longer needed and is discarded. For example, if daily, weekly, and
monthly are selected, the daily report is updated each time the log is analyzed during the day.
Then, at the end of the day, the weekly and monthly reports are updated using the completed
daily report and the data used for the daily report is discarded.
Because disk space and memory are needed to maintain the report data, only select the
reports that you need.
To define the defaults for how often to generate reports and how many reports to save:
2. Select the Reports tab.
3. Select the check boxes for the Report Types to be maintained.
4. For each selected report type, from the Reports To Store list, specify the number of
reports to save.
If you run a large number of reports, you might limit the number of reports that are
saved. Using this option, you can select the number of reports saved for each interval.
For example, if you select to keep six month's worth of monthly reports at a time, once
the report for July 1 is created, the report for January 1 is deleted, and so on.
When determining how many reports to store, consider how much disk space you want
to devote to reports and how long you want to save them.
5. To allow Non-administrators to modify these settings for their profiles, select the Allow
Non Administrators To Configure check box.
6. In the Maximum Number Of Elements Available In Report Tables text box, type
the maximum number of elements that you want queried for each table.
7. Click OK.

Scheduler tab
Use the Scheduler tab to define the default schedule for processing profiles.
To set a schedule:
2. Select the Scheduler tab.
3. In the Initial Start Time text box, specify when to generate the reports. Type the time
using the 24-hour format. For example, 3:30 p.m. would be entered as 15:30.
4. From the Frequency drop-down list, specify how often to generate the reports. This
value should match the typical traffic on the web sites being analyzed.
5. From the Priority drop-down list, select the priority for processing the profiles. When
more than one profile is scheduled to be analyzed, profiles with a high priority will be in
the front of the queue while low-priority profiles will be placed at the back.
6. To allow non-administrators to modify these settings for their profiles, select the Allow
Non Administrators To Configure check box.
7. If you want the reports to start immediately, select the Start Initial Analysis check box.
If this check box is not selected, the first reports for new profiles will run according to
the scheduled time.
8. Click OK.
Table Limiting tab

Use the Table Limiting tab to specify the default size limit for some of the larger tables.
Limiting table size helps the WebTrends software run more efficiently.
To set limits on memory usage:
2. Select the Table Limiting tab.
3. For each category to be limited, clear the No Limit check box.

4. In the corresponding Number Of Elements (In Thousands) text boxes, type the
limiting number.
5. Click OK.
For more information on Limit Memory Usage, see “Table Limiting” on page 66.
(UNIX only) GeoTrends tab

When running the WebTrends software on a UNIX system, you need to specify where the
WebTrends GeoTrends database is installed. After installing WebTrends GeoTrends database,
type its location in the Installation Directory text box.
To specify where the GeoTrends database is installed:
2. Select the GeoTrends tab.
3. In the Installation Directory text box, type the location of the GeoTrends database.
4. Click OK.

Chapter 10
Setting User Access
Overview
The User Access and Privileges feature enables you to set up users in the WebTrends
software. For each user, you specify the features they can access, their default profile settings,
and the dialog boxes they see. If you are using Custom Authentication (defined in the
Webserver Configuration dialog box, see “Configuring web server settings” on page 261), you
specify user names and passwords as well.
Note: If your web server is configured for Operating System Authentication, users must be
present on the local machine or have a domain account. (If you choose not to set up a local
user account, use Custom Authentication.) For full details on setting up a local user, please
refer to your operating system’s documentation.
Adding Users
To add a user:
1. From the links at the top of the AdminConsole, click Administration > User Access.
You see the Configure User Access And Privileges dialog box with a Users list of the
current administrators and users.
2. Click the Add button next to the Users list. The Add New User dialog box opens.
3. In the Username text box, type the login name for the user. If the Password and
Confirm Password text boxes are displayed, type the password for the user.
Note: The password field appears only if Custom Authentication is enabled. See “Config-
uring web server settings” on page 261 for more information.
• Setting User Access 185

− If you are giving the user no other permissions except to view reports, click Finish
and skip to step step 10. (For information about users with only View Reports
permission, see “About Users’ View Only Permissions” on page 189.)
− To specify privileges for this user, select from the following options:
Global Configuration
• Administrator Rights: Gives the user access to all the WebTrends software
functions.
• Advanced Features: Allows the user to access the Advanced Features (see
page 81).
• Filters: Allows the user to access filters (see page 109).
• Templates: Allows the user to access Templates (see page 158)
• Campaigns: Allows the user to access Campaigns definitions (see page 191).
Profile Level
• View Reports: All users are given access to view reports (see page 162).
Note: To be able to view a report for a profile, the user must have access to that
profile. For information about providing profile access, see “Profile Access” on
page 63.
• Add Profiles: Allows the user to create profiles (see page 44).
• Edit Profiles: Allows the user to modify profiles (see page 68).
• Delete Profiles: Allows the user to remove profiles (see page 69).
− To customize the default settings for a non-administrator’s profile, continue with
step step 6. (This option is only available for users you have given permission to add
or edit profiles.)
− To complete this user’s profile using current default settings, click Finish and skip to
step step 10.
6. Select the Enable Advanced Configuration check box and click Next.
You see the Restrictions dialog box.
7. To limit the number of profiles this user can create, select the check box and type the
maximum number of profiles.

8. Continue to click Next to configure the default profile settings for this user. For details
on these settings, see “Using Profiles” on page 43.
Note: Whenever you see the Hide This Tab From User check box, you have the option
to prevent the user from seeing that dialog box when they are working with profiles. In
that case, their profiles use the default settings for that feature.
9. At the User Summary dialog box, click Finish.

10.Click OK.
The user is added to the Users list.
11.To allow anonymous viewers to see your reports, select the Allow All Reports Enabled
For Public Access check box.
Note: This feature works in conjunction with the Enable Reports Generated By This
Profile check box in the Profile Access dialog box. Both features must be selected
before reports for that profile can be viewed anonymously. For information on the
Profile Access dialog box, see “Profile Access” on page 63.
12.To apply the Allow All Reports Enabled For Public Access check box, click Update
Public Access.
Note: You must click Update Public Access for the Allow All Reports check box to
take effect. Selecting the check box without clicking the button will not activate the
setting.
13.Click Close.
14.Click OK.
Note: Once a user has been added, they must be given access to the profiles they will be
working with. (Unless the user has Administrator Rights, then they have access to all
profiles.) For more information, see “Profile Access” on page 63.
To log in to the WebTrends software as a different user, close both the AdminConsole dialog
box and the initial Log In dialog box before relaunching the WebTrends software.

Editing User Information
This section describes changing a WebTrends software user’s information.You cannot modify
your own settings, only another Administrator may do so.
To edit a user’s information:
You see the Configure User Access And Privileges dialog box.
2. From the list, select the user to be modified.
3. Click Edit.
4. Make your changes, and click OK.
Note: Wherever you see the Hide This Tab From User check box, you can define the
options and prevent the user from seeing the dialog box when they are working with
profiles.
Deleting Users
Complete the following procedure to delete a user from WebTrends software.
Note: If the deleted user was created on your local system solely to access WebTrends
software, it’s recommended that you remove them from your local system. This is a Best
Practices for network maintenance that helps with the security of your system. For full details
on removing local users, please refer to your operating system’s documentation.
To delete a user from WebTrends software:

You see the Configure User Access And Privileges dialog box.
2. From the Users list, select the user to be deleted.
3. Click Delete.
You’re prompted to confirm the deletion.
4. Click OK

You see a note that the Access List has been updated.
5. Click OK.
Note: Changes affecting any users who are currently logged in will occur after five minutes of
inactivity.
About Users’ View Only Permissions

Users who have no other permissions than View Reports automatically use the WebTrends
Desktop (Report Viewer) instead of the AdminConsole. While they can view the reports, they
do not have access to any of the other controls.
A stand-alone user’s guide, called WebTrends Getting Started Guide, is available to help orient
view-only users to the WebTrends Desktop. This User’s Guide can be found on the product
CD in the Documentation directory or on the web at

Chapter 11
Campaigns
Campaigns Overview
Campaigns tracks the forecasted revenue of specific products or pages, and determines where
your most valuable web site traffic originates. It is particularly well suited for forecasting the
revenue of online campaigns.
Note: Access Campaigns by clicking Campaigns from the links at the top of the Admin-
Console.
Campaigns is based on the following three definitions:

• Campaign Definitions: which describe your campaigns (see the following section,
Campaign Definitions).
• Product Definitions: is an obsolete feature and will be removed in future versions of
the WebTrends software. Much of the legacy Product Definition functionality can be
achieved through the use of Custom Reports and Scenario Analysis.
− Refer to “Using Custom Reports” on page 133 for information on custom reports.
− Refer to “Scenario Analysis” on page 94 for information on scenario analysis.
• Shopping Cart Definitions: Shopping Cart Definitions is an obsolete feature and will
be removed in future versions of the WebTrends software. Much of the legacy Shopping
Cart Definition functionality can be achieved through the use of Scenario Analysis. Refer
to “Scenario Analysis” on page 94 for information on scenario analysis.
The following sections describe how to work with these definitions and settings.
• Campaigns 191
Campaign Definitions
Campaigns describe a single campaign, such as a banner ad, that might bring visitors to your
web site. By combining a Campaigns definition with Custom Reports, you can generate
reports that:
• Calculate the revenue projection of your E-Commerce sites and on-line campaigns.
• Calculate the ROI projection of campaigns based on their cost and generated traffic
value.
• Determine the amount of traffic resulting from campaigns and calculate the
forecasted revenue of that traffic.
• Make simple projections for future results for in-progress campaigns.
Campaign definition components

To create a Campaign definition, you must provide the following information about your
campaigns:
• Type of campaign
• Whether to identify campaign activity by its entry page or the referring page
• URL of the entry page or referring page
• Cost of the campaign
• Starting and ending date
• Image to display in your reports that represents the campaign
Adding campaign definitions

To create a campaign definition:
1. From the links at the top of the AdminConsole, click Campaigns. The Campaigns
dialog box opens.
2. Select the Campaigns tab, and click Add.
The New Campaign wizard is launched and you see the General dialog box.
3. In the Name text box, type the name as you would like it to appear in the reports.
4. From the Type Of Campaign drop-down list, select a type of campaign.
5. Click Next.
You see the Identification Method dialog box.

6. Select a method of tracking visitor activity:
− Entry Page: This is the page the visitor first enters when they access your web site.
Example entry page for a single campaign:
http://yourwebsite.com/redirect/yahoo_ad.htm.
− Referrer: This is the page the visitor accessed just before entering your web site.
This is typically the actual page that the ad appears on, or it can be a redirect on the
web site hosting your ad.
Example referrers for a single campaign:
http://www.mktnghost.com/games/productform.asp?
search_value=2&search_type=s_category
http://www.mktnghost.com/toys/
productform.asp?search_value=2&search_type=
s_category
http://www.mktnghost.com/books/productform.asp?
search_value=2&search_type=s_category
The entry page method is preferred because you can track user activity more accurately
and easily. The referrer works as well as entry pages but some advertisements may have
several possible referring pages with long, complicated URLs. This makes it more
difficult for you to look up and define when you set up your campaign definition. Also, it
makes it more error-prone should you forget a referring URL.
7. Click Next.
You see the Entry Page or Referrer dialog box, depending on your selection in step step
6.
8. In the Page Expression text box, type the URL for the entry page or referrer to be
tracked.
9. If you’re using a regular expression, select the Regular Expression check box. (For
more information on regular expressions, see “Regular Expression Syntax” on page 253.)
Click Test to confirm that the regular expression matches a test URL from your log file.
10.If desired, configure the entry page or referrer’s URL parameter. This enables you to
refine what you’re tracking, only capturing pages that contain your parameters. For more
information on URL parameters, see “About dynamic pages and parameters” on page 83.
11.Click Next.
You see the Cost And Duration dialog box.
• Campaigns 193
12.In the Cost text box, type the total cost of your campaign.
13.In the Start Date text box, type the date that your campaign started. Type the date in the
mm/dd/yyyy format.
14.In the End Date text box, type the date that your campaign ended. Type the date in the
mm/dd/yyyy format.
Note: The duration of the campaign includes the start date up to, but not including, the
end date. For example, a campaign that starts on 5/1/99 and ends on 5/2/99 is exactly
one day in length.
15.Click Next.
You see the Image dialog box.
16.If necessary, in the Image Path text box, specify the path to the image that represents
this campaign in generated reports. This field is optional. You may click the folder button
to browse to the location of the image file.
17.Click Finish.
Editing campaign definitions

To edit campaign definitions:
1. From the AdminConsole, click Campaigns. You see the Campaigns dialog box.
2. Select the Campaigns tab.
3. Select the campaign definition to be modified.
4. Click Edit.
5. Navigate the tabs to edit the appropriate settings.
6. Click OK.
Deleting campaign definitions

To delete campaign definitions:
1. From the AdminConsole, click Campaigns. You see the Campaigns dialog box.
2. Select the Campaigns tab.

3. Select the campaign definition to be deleted.
4. Click Delete.
5. To confirm the deletion, click OK.
The campaign definition is deleted.
Product Definitions
Product Definitions is an obsolete feature and will be removed in future versions of the
WebTrends software. Much of the legacy Product Definition functionality can be achieved
through the use of Custom Reports and Scenario Analysis.
In previous versions, each product was defined in a time consuming manner. Now, with
Custom Reports you can configure product recognition simply by using URLs or query
parameters. Custom Reports also give you additional flexibility in tailoring your product-
based reports. This feature was not offered in the legacy Product Definition functionality.
Scenario Analysis lets you track the progress of steps taken along a path, replacing legacy
qualification-levels aspect of Product Definitions.
• Refer to “Using Custom Reports” on page 133 for information on custom reports.
• Refer to “Scenario Analysis” on page 94 for information on scenario analysis.
Shopping Cart Definitions

Shopping Cart Definitions is an obsolete feature and will be removed in future versions of the
WebTrends software. Much of the legacy Shopping Cart Definition functionality can be
achieved through the use of Scenario Analysis.
Instead of the three-step process that was used in the legacy Shopping Cart definition,
Scenario Analysis offers greater flexibility, because it is not confined to a given number of
steps. You can also integrate Scenario Analysis and Custom Reports to create reports that are
more customized (for example, integrating transactions, mixing and matching with other
dimensions).
Refer to “Scenario Analysis” on page 94 for information on scenario analysis.
• Campaigns 195
Chapter 12
Using the WebTrends Map
Overview
The WebTrends Map is a utility included in the WebTrends software which integrates
seamlessly into your Internet Explorer (IE) browser. You can use the WebTrends Map as you
browse to update or add to many of the most-frequently used URL-based WebTrends
software profile settings.
You may find it is more efficient to update certain settings using the WebTrends Map utility in
lieu of launching the WebTrends software user interface.
Whether you are an experienced WebTrends user, or newer to the products, you will find that
the WebTrends Map is an efficient way to access five major profile settings. After installing
and configuring the utility, it is ready to use. When you launch your IE browser, click the
WebTrends Map icon on the IE toolbar. The WebTrends Map dialog box opens at the
bottom of your screen, pre-populated with the current settings for the web page you are
browsing, for the active profile.
As you browse, the WebTrends Map will update itself to show which profile settings apply to
the web page you are visiting. You may find you want to update certain profile settings as you
continue to browse your site. You can use the WebTrends Map dialog boxes to update:
• Content Groups settings
• Paths Analysis settings
• Campaigns settings
• Scenario Analysis settings
• Filters
Your updates will be captured by the WebTrends software so you can continue to work with
them either through the WebTrends Map, or with the full selection of profile settings via the
WebTrends software.
Note: Changes to these settings only affect analysis from the time they are made forward. If
you update profile settings, you may want to reanalyze any profiles affected by these changes
to avoid old data being included in those profile’s reports. For details on reanalysis see “Re-
analyzing Profiles” on page 76.
• Using the WebTrends Map 197

Installation
You will need to complete the following steps in order to successfully install the WebTrends
Map:
• Browser modifications (page 198)
• Installing the utility(page 199)
• Initial configuration
− Recognizing local installations (page 200)
− Enabling WebTrends Map options (page 201)
• Launching the utility (page 203)
Note: WebTrends Map requires Java Virtual Machine (JVM)--bundled with most operating
systems--to be installed in order for it to work correctly. WinXP users should apply SP1,
which includes JVM, to help ensure that their copy of WebTrends Map works with full
functionality.
Browser modifications
Before installing the WebTrends Map, you must configure your IE browser to work with the
utility.
You will need to be running IE 5.5 or greater to make full use of the WebTrends Map.
To modify Internet Explorer:
1. Launch Internet Explorer.
2. Select Tools > Internet Options > the Security tab.
3. Select the web zone appropriate for how you access WebTrends software. Typically, this
will be Local Intranet.
4. Click Custom Level.
5. Scroll to Run ActiveX Controls And Plug-ins, and select Enable.
6. Scroll to Script ActiveX Controls Marked Safe For Scripting, and select Enable.

7. Click OK to close the Security Settings dialog box; click OK to close the Internet
Options dialog box.
Your modifications to Internet Explorer are now active.
Installation
To install the WebTrends Map:
1. If you are currently running WebTrends software, close the program.
2. By default, WebTrends software starts certain Windows services at login. Stop the two
WebTrends services before continuing with installing the WebTrends Map. To do this:
a. Open the Services panel (Programs > Administrative Tools > Services).
b. Select the WebTrends software service.
c. Stop the service either by clicking the Stop icon on the toolbar, or by right-clicking
and selecting Stop from the drop-down menu.
d. Repeat step step b and step step c, selecting the WebTrends Reporting UI service.
e. Close the Services panel. Your changes are now active.
3. Locate the WebTrends Map setup.exe file on your copy of the WebTrends software CD.
4. Double-click setup.exe to begin installing the utility.
Note: You will need to reboot your computer after installing the WebTrends Map in order
for the utility to work.

Initial configuration
Recognizing the local installation of the WebTrends

software
To launch the WebTrends Map:
1. Click the WebTrends icon on the end of your IE toolbar.
The WebTrends Map dialog box opens in the bottom half of the screen (Figure 12-1 on
the following page).
Note: There are instances when the IE browser will not automatically add the WebTrends
icon to the IE toolbar, although it is available. As a work-around, you can add the
WebTrends icon manually:
1. From the IE toolbar, select View > Toolbars > Customize. The Customize
Toolbar dialog box opens.
2. Select the WebTrends icon from the Available Toolbar Buttons menu, and click Add.
3. Click Close.
The WebTrends icon now appears at the right end of the IE toolbar.
2. If this is the first time you have launched the WebTrends Map, you will need to configure
the utility to recognize and work with WebTrends software. (If you have already added
the WebTrends software, skip to the step step 3, page 201). To do this:
a. Enter a description in the Description text box. (This text will appear on the main
console; see Figure 12-1 on the following page.)
b. In the URL text box, enter the URL and port number of your WebTrends software
server in the following format:
http://<machine name>:1099
You can also launch the WebTrends Map using the IP address:
c. Click Add WebTrends Application. Your instance of the WebTrends software is

now listed on the main console of the WebTrends Map.

Figure 12-1. The WebTrends Map main console
3. The WebTrends Map and WebTrends software are now operating in synch with each
other. To begin working with WebTrends software settings, simply click on the
WebTrends software server in the list.
WebTrends Map options

Note: Only users with full administrative rights for WebTrends software will be able to enable
WebTrends Map options. If you have questions regarding your user rights in WebTrends
software, see your network administrator.
If you select any of the available options, an additional URL field will be displayed in the
applicable dialog box.

To enable WebTrends Map options:
1. Select Options from the WebTrends Map toolbar to open the WebTrends Map Options
dialog box.
Figure 12-2. WebTrends Map Options dialog box
2. Select any of the following options to add a URL field to each setting’s dialog box:
− Path Analysis
− Content Groups
− Campaigns
− Scenario Analysis
− Filters
This feature when enabled displays the URL that WebTrends Map retrieved for the web
page you are currently viewing and permits you to make any changes needed to the URL.
This can help you create a setting including the URL for a page you are no longer
viewing, such as settings for a redirect page.
By default, the URL field is included in the Campaign settings dialog box.

Launching the utility
To launch the WebTrends Map:
1. Launch your browser.
2. Click the WebTrends Map icon on the right end of your IE Explorer toolbar.
Depending on how your instance of WebTrends software was configured, one of the
following occurs:
− The WebTrends Map dialog box opens in the bottom half of the screen.
− You may be required to provide your network User Name and Password before the
WebTrends Map dialog box opens.
3. Click the descriptive text you entered at step step a, page 200 to open the WebTrends
Map. The utility opens with a list of the profiles you have administrative rights to edit.
Figure 12-3. List of available profiles
4. Click the profile you want to work with. The WebTrends Map opens the profile,
displaying the five features, pre-populated with the current profile’s settings that match
the web page you are currently using. You can use the WebTrends Map to update these as
you browse.
The features that you can edit using the WebTrends Map include:
• “Using the WebTrends Map” on page 204
• “Content Groups” on page 205
• “Campaigns” on page 206

• “Scenario Analysis” on page 207
• “Filters” on page 209
Refer to the sections below for details on reconfiguring these settings.
Using the WebTrends Map

Toolbar
Use the toolbar to quickly change views:
• Main: click to return to the WebTrends Map main console.
• Logout: allows a secure logout from the current session, so subsequent users will not
have access (as the prior user) to the WebTrends Map—and WebTrends software
settings—when they launch the browser.
• Profiles: click to return to the Profiles pages.
• Options: click to open the WebTrends Map Options dialog box. See “WebTrends Map
options” on page 201 for instructions on how to use this dialog box to configure the
WebTrends Map for initial use.
• Feedback: click to send feedback about the WebTrends Map utility to NetIQ
Corporation. The Feedback page of the NetIQ web site will open in a separate browser
window.
• Support: click to open the Support Services page of the NetIQ web site. The Support
Services page of the NetIQ web site will open in a separate browser window.
• Help: click to open the online Help system for the WebTrends Map. (You can also find
an overview of the WebTrends Map—and the settings it works with—in the main
WebTrends Help system. From the WebTrends AdminConsole, select Accessories >
WebTrends Map to open this.)
Path Analysis
If this option is enabled in the WebTrends Map, this box will be pre-populated with the path
analysis definitions that apply to the web page you are currently viewing.

Table 12-1. Path Analysis icons
Icon Description
Expand
Click to view additional information on how Path
Analysis definitions work. You can add new Path Anal-
ysis definitions from the expanded Path Analysis dialog
box.
New
Click to create a new Path Analysis definition.
Edit
To edit an existing Path Analysis definition, select the
definition you want to work with, and click this icon.
This option may be greyed out if not applicable to this
page view, or if you do not have rights to these settings.
Delete
Click to delete a selected Path Analysis definition from
the profile.
Content Groups
If this option is enabled in the WebTrends Map, this box will be pre-populated with the
Content Groups that include the web page you are currently viewing.

Table 12-2. Content Group icons
Icon Description
Expand
Click to view additional information on how Content
Groups work.
You can add new Content Groups—or add a web page
to an existing Content Group—from the expanded
Content Group dialog box.
New
Click to create a new Content Group.
Add to existing Content Group

Click to add a web page to an existing Content Group.
Remove
Click to delete this Content Group from the active
profile.
Campaigns
Campaign definitions that include the web page you are currently viewing.

Table 12-3. Campaigns icons
Icon Description
Expand
Click to view additional information on how Campaign
definitions work.
You can add new Campaign definitions from the
expanded Campaigns dialog box.
New
Click to create a new Campaign definition including
the web page you are currently viewing.
Edit
To edit an existing Campaign definition, select the def-
inition you want to work with, and click this icon.
Note: You cannot remove a Campaign definition from a profile using The WebTrends Map.
To do this, you will need to edit this profile’s settings via the WebTrends software’s user
interface. See Profiles:Editing, in the index of the online Help for details.
Scenario Analysis
Scenario Analysis definitions that include the web page you are currently viewing.

Table 12-4. Scenario Analysis icons
Icon Description
Expand
Click to view additional information on how Scenario
Analysis definitions work.
You can add a new Scenario Analysis definition—or
add a step to an existing Scenario Analysis definition—
from the expanded Scenario Analysis dialog box.
New Scenario Analysis

Click to create a new Scenario Analysis definition.
Add Step
Click to add a web page to an existing Scenario Analy-
sis definition.
Edit Parameters
To edit parameters of an existing Scenario Analysis
definition, select the definition you want to work with,
and click this icon.
Remove Step
Click to delete the web page you are currently viewing
as a step from the selected Scenario Analysis defini-
tion.
page view, or if you do not have delete rights to these
settings.

Filters
Filters that currently apply to the web page you are currently viewing.
Table 12-5. Filters icon

Icon Description
Expand
Click to view additional information on how Filters
work.
You can add a new filter—or edit an existing one—
from the expanded Filters dialog box.
New
Click to create a new Filter for the active profile.
Edit
To edit an existing filter, select the filter you want to
work with, and click this icon.
page view, or if you do not have delete rights to these
settings.
Note: You cannot remove a profile’s filters using The WebTrends Map. To do this, you will
need to edit this profile’s settings via the WebTrends software’s user interface. See
Profiles:Editing, in the index of the online Help for details.
For further information on using the WebTrends Map, please refer to the Help that accom-
panies the Map user interface, or “Using Profiles” on page 43.

Chapter 13
Running From the Command Line
About the Command Line Capability

Although WebTrends software provides a graphical user interface (GUI) for viewing reports
and administering the program, you can perform all functions from the command line. Most
likely you’ll configure the program from the command line for immediate results and better
speed. Using the command line, you can run a profile without having to start the web server
that provides the interface.
Using the commands available and configuration text files, you can:
• Start and stop the program.
Use the configuration text files, discussed in the .pdf file “Advanced WebTrends Configu-
ration Using .ini Files”, which can be found in the Documentation directory of the
WebTrends CD, to:
• Configure program settings.
• Set up user accounts.
• Create profiles.
• Review program and profile audit files.
• Create report style sheets.
• Define Internet advertising to track.
• Enter information about your internet to include in reports.
• Customize the company database used for reports.
Note: While the settings and parameters this chapter are all listed in lower case, the settings
themselves are not case sensitive. They can be typed in lower or upper case and it won’t affect
performance.
• Running From the Command Line 211

Directory Structure
The table below briefly describes the top level program directories.
Table 13-1. Directory structure
Directory Sub-directory Contains
scripts cgi-inc
general layout
wtm_wtx language, layout, res, and .pl files
utils Scripts for migrating settings for program upgrades.
wt_script wt_report.pl and .pm files
wtm_wtx CordaJava apfiles, com, corda, popchart

datfiles adviews, campaigns, contentgroups, customtables,
databases, dynamicpages, econfig, interestpaths, intra-
net, pathsanalysis, profiles, reports, samples, session-
tracking, statuslogs, urlreplacement, users
debug
images .html files and .gifs for reports
MSword Installation package for the WebTrends Document
Utility
style_sheets
template .var and .rpl files for report templates
wtmigrate Migration files

Directory Sub-directory Contains
wwwroot help ecm, general, roi, troubleshooting, wtm_wtx help

directories
images ico, tabs, toolbar, tools, and .gifs for program
Command Line Options

The following subsections describe the scripts and executables available to run the program
and their parameters.
Scripts
The following scripts are provided for the Linux and Solaris versions:
wtrs.server
The wtrs.server script invokes both the wtrs_ui.server script and the wtengine.server script.
Using the parameters available you can control both the analysis engine and the remote
interface.
Here are the service names for the WebTrends software:
Web server:
long name: WebTrends UI Server
short name: wtrs_ui
Engine:
long name: WebTrends Reporting Center
short name: wtrs
wtengine.server
The wtengine.server script calls the wtrs executable, which controls the analysis engine.

wtrs_ui.server
The wtrs.server script calls the wtrs_ui executable, which controls the user interface.
Table 13-2. Script parameters
Parameter Description
start Starts the service.
stop Stops the service.
status Provides the status of the service.
Syntax
Scripts require the following syntax:
<script> <parameter>
For example,
wtengine.server start
Executables
wtrs
The executable, wtrs, performs the analysis and other program processes such as generating
reports and updating files for changes made through the remote interface.
Run wtrs using the available parameters. It also can be called by wtrs.service or
wtengine.service.

Syntax
The wtrs executable requires the following syntax:
wtrs [-parameter] <profile> ...
where the variables are defined as follows:

• [-parameter] refers to one of the program parameters defined in the following
table.
Table 13-3. wtrs executable parameters
-archivenow Archives a profile’s database.
(Windows NT/2000) -install Installs the service.
(Windows NT/2000) -remove Removes the service.
-reset Resets a profile.
-restore Restores an archive.
-start Starts the service.
-stop Stops the service.
• <profile> can be the name of a single profile (for example, profile 1) or the
wildcard specification of a profile group (for example, profile*.wlp).
Note: Type * to specify all profiles. Spaces are not allowed in profile file names.

You can specify any number of profile names. If the reset, archivenow, or restore
parameters are specified, at least one profile name must be specified.
If the restore parameter is specified, it must also be accompanied by
-tag=<archive to restore> , as is shown in the following example:
profile1 -restore -tag=19990208.
If you would like to restore the archive into a new profile, type
add -new=<new .wlp filename>, as is shown in the following example:
profile1 -restore -tag=19990208 -new=newprofile.wlp.
wtrs_ui
The executable, wtrs_ui, controls the graphical user interface using the options available. It
communicates with the analysis engine through the port specified during installation.
wtrs_ui can be called by wtrs_ui.server or wtrs.server.
Syntax
The wtrs_ui executable requires the following syntax:
wtrs_ui [-parameter]
where [-parameter] refers to one of the program options defined in the table below.
Table 13-4. wtrs_ui executable parameters
-start Starts the remote interface service.
-stop Stops the remote interface service.
-status Provides the status of the remote interface service.

(Windows NT/ Installs the remote interface service.

2000) -install
(Windows NT/ Removes the remote interface service.

2000) -remove

Chapter 14
Using the Data Source Splitter (DSS)
The Data Source Splitter (DSS)

The DSS feature makes it easier and more efficient for a company to run several profiles over
the same set of log files. For example, a corporation with several virtual domains all served by
the same set of web servers, and all logged into the same set of log files. DSS enables an
administrator to create profiles for each of the virtual domains, to split the log files into
smaller logs based on the domain names or URLs, then run the profiles on the smaller logs.
To use DSS, the user needs to create a DSS profile instead of a standard Reporting Server
profile. DSS profiles specify Data Source Splitter files—instead of the log files directly—
giving the user full flexibility in using all profile features. In this way, multiple profiles can
point to the same Data Source Splitter file. Otherwise, a user would need to configure a full
standard profile—defining the same set of log files each time—for each analysis.
Note: Data Source Splitter definitions must be created before DSS profiles. Once the Data
Source Splitter definitions are created, you add the profiles that will use them.
The only place where DSS modifies the profile is the log file paths. DSS modifies the profile's
logfilepath setting to match the location where it is splitting the profile's log files. The
remainder of the profile settings are the same as a standard profile.
Using the DSS

Use DSS to analyze several domains over the same set of log files. DSS profiles point to DSS
definitions that specify which domains in the log file to track. Because you manually create
DSS profiles, you have full flexibility in using all profile features.
Note: Parent-Child profiles also analyze several domains over the same set of log files but the
profiles for each domain are automatically created. (For more information on Parent-Child
profiles see “Using Parent-Child Profiles” on page 231.)
• Using the Data Source Splitter (DSS) 219

To use DSS:
1. Create a DSS definition (see instructions directly below, “Adding a DSS Definition”).
2. Create a profile which specifies the DSS definition (see “Adding DSS profiles” on
page 227).
3. Analyze the profile to split the logs.
Adding a DSS Definition

To add a new DSS definition, complete these steps:
1. From the links at the top of the AdminConsole, select Data Source Splitter. You see the
Data Source Splitter Definitions dialog box.
2. Click New. The Add New DSS Definition dialog box opens to the Options tab.
3. In the Description text box, type a name for your Data Source Splitter definition. This
name will appear in the Profiles lists of available Data Source Splitter definitions.
4. From the Split Field drop-down list, select either Domain or URL to specify which
field will be used in splitting the log file.
5. In the Split Tolerance text box, type the number of minutes that separate log file splits.
The default value is 120. To save processing time, you may want to increase this so that
the log files aren’t split as often.
6. In the Split Log Directory text box, type the path to the directory where the split log
files will be stored. The default setting is:
./wtm_wtx/datfiles/econfig_logs
7. Select the Log Data Sources tab.

8. Click Log Data Sources.
9. From the Select Log Data Sources list, select the check boxes to the left of the log data
sources that you want included with this DSS definition.
10.If necessary, add or edit existing log data sources as needed for this DSS definition.

11.Click OK then OK again to confirm saving your changes.
12.Select the Virtual Domains tab.
13.Select a virtual domain for this definition to use in its processing. You must select at least
one.
For instructions on adding or editing virtual domains, see “Adding Virtual Domains” on
page 221.
14.Click Save. The new DSS definition appears in the Data Source Splitter Definitions
dialog box.
Editing a Data Source Splitter definition

To edit a Data Source Splitter definition:
1. From the Data Source Splitter definitions dialog box, select the definition to be edited.
2. Click Edit.
You see the Edit DSS definition dialog box.
3. Select any tabs containing the settings you need to edit, and make your changes.
4. Click Save, then OK.
You are returned to the Data Source Splitter definitions dialog box.
Adding Virtual Domains

To add a virtual domain:
1. From the links at the top of the AdminConsole, select Data Source Splitter.
2. Either select a definition and click Edit, or click New.
3. Select the Virtual Domains tab.
4. Click New.
5. In the Description text box, type a description of this virtual domain. (For example,
Marketing/Houston, TX.) This description shows in the Data Source Splitter defini-
tions dialog box.

6. In the Pattern text box, type the pattern to use as split criteria (For example:
www.hou-mar.com. If you wish to use regular expressions to for your pattern entry,
select the Regular Expression check box. (For example, using regular expressions you
might enter, www.site[1-3].com.)
7. If you are using a regular expression in defining your pattern, click Test to confirm your
data.
Note: See “Regular Expression Syntax” on page 253 for information on using regular
expressions.
8. When you have completed your testing your settings, click OK. Your new virtual domain
information appears in the Data Source Splitter definitions dialog box.
Editing Virtual Domains

To edit a virtual domain:
1. From the Data Source Splitter definitions dialog box, select the definition that contains
the virtual domain to be edited.
2. Click Edit.
4. Select the virtual domain to be edited and click Edit.
5. Make your changes and click OK.
You are returned to the Virtual Domains tab.
6. Click Save, then OK.
Deleting Virtual Domains

To delete a virtual domain:
1. From the Data Source Splitter definitions dialog box, select the definition that contains
the virtual domain to be deleted, and click Edit.
3. Select the virtual domain you want to delete, and click Remove.

4. To confirm the deletion, click OK.
The virtual domain no longer appears in the Data Source Splitter Definitions dialog box.
Example
The following example describes a scenario for adding an Data Source Splitter definition. For
this example, WebTrends has multiple web sites that contribute to the same log file. You want
to split the log file so that you can analyze each of these web sites individually.
WebTrends has three specific web sites (www.live.webtrends.com,
www.intranet.webtrends.com, and www.webtrends.net) that you want to analyze. Also, you
want to analyze any web sites with the domain suffix of .org. Add an Data Source Splitter
definition with the following values to help achieve this task.
From the Data Source Splitter Definitions dialog box, click New and enter the following
settings:
• On the Options tab:
− Description: WebTrends
− Split Field: Domain
− Split Tolerance: 120
− Split Log Directory: .wtm_wtx/datfile/econfig_logs
• On the Log Data Source tab, click the Select Log Data Sources button then create and
enable a log data source with the following properties:
−Choose Content Type: Web Server
−Log Data Source Type: Log File
−Log Data Source Name: WebTrends
−Log File Specification: Add both ftp://webserver/logfiles/ex*.log and L:/
logfiles/ex*.log
− FTP Server Login Information:
• Username: admin
• Password: 1234
− Log File Format: Auto-detect Log File Type
• On the Virtual Domains tab, click New to add the following:
− Entry #1:
• Description: Live
• Pattern: live.webtrends.com

− Entry #2:
• Description: Intranet
• Pattern: intranet.webtrends.com
− Entry #3:
• Description: .Net
• Pattern: www.webtrends.net
− Entry #4:
• Description: .Org
• Pattern: www*org
• Select the Regular Expression check box
Entries #1-3 are for the specific web sites while entry #4 uses a regular expression to
capture all web sites with the domain suffix of .org.
Save your settings and you’re ready to create a master profile that points to this definition. For
information on creating profiles, see “Using Profiles” on page 43.
Note: When creating a master profile that uses Data Source Splitter definitions, select Data
Source Splitter Profile for Profile Type.
Sample Data Source Splitter Definition File

The values in this sample file correspond to the values entered in “Example” on page 223.
Explanations for each section follow the sample file.
Note: Changes made to a definition file do not take affect until the profile using the definition
file is re-analyzed.

[defaults]
description = Webtrends
ecmprofilecount = 4
[logs]
logfilepath1 = ftp://webserver/logfiles/ex*.log
logfilepath2 = L:/logfiles/ex*.log
logfileusername = admin
logfilepassword = D960E2FECDBCBF881DB19C87F4479F4F9CAB
logfilecount = 2
logfileformat = 0
[split]
logdirectory = ./wtm_wtx/datfiles/ecmlogs
tolerance_time = 120
split_field = domain
[ecmprofile0]
regexp = 0
id = rt0AIHIRW45
pattern = live.webtrends.com
name = Live
[ecmprofile1]
regexp = 0
id = hDTirLiRW45
name = Intranet
pattern = intranet.webtrends.com
[ecmprofile2]
regexp = 0
id = HBrX9wJRW45
pattern = www.webtrends.net
name = .Net
[ecmprofile3]
regexp = 1
id = 0V5M86KRW45
name = .Org
pattern = www*org

Logs section
Use this section to specify which logs files to split.
The value for logfilepassword is the encrypted version of what was entered for Password
in the example on page 223.
Note: Since reports on DSS profiles do not include server cluster reporting, the log file paths
do not need to be organized by server.
Split section
Use this section to specify split parameters. The example shows a split field (the domain
name) and a split-tolerance time of 120 minutes (or 2 hours). The split-tolerance time is the
amount of time log files will be allowed to age before starting another splitting operation.
A value of 2 hours means that after the logs are split, every profile analyzing those logs for the
next 2 hours will use the results of the last splitting operation instead of starting a new split.
Once the 2 hours have passed, the next profile which uses these logs will split them prior to
analysis.
ecmprofilex section
The [ecmprofilex] sections are required for each profile that will analyze using the split logs.
These sections form the association between a profile and a set of split logs.
The name key specifies the name used in creating the profile name and directory names.
This is a required field.
The id key is the GUID.
Records with split fields that match the pattern field will be included in the profile. This
is a mandatory field.
The regexp key controls whether the pattern field should be interpreted as a regular
expression—value of 1—or not—value of 0.
Note: The profile name, and by extension, the database directory, report directory, status log,
etc., are all based on this value. That means that the value of the name field must be able to be
formed into a file—it cannot contain characters like ‘/’, ‘\’, or ‘:’.

Adding DSS profiles
Create new DSS profiles with the Add Profile wizard. For information on creating other
types of profiles, see the following:
• Standard and streaming media profiles: “Using Profiles” on page 43
• Parent-Child profiles: “Adding Parent profiles” on page 238
To add a new DSS profile:
1. From the Profiles menu on the left of the AdminConsole, click New. The Add New
Profile wizard opens.
2. Select the type of content to be analyzed:
− Web Server: Use this for standard web content.
− Streaming Media Server: Use this for analyzing streaming media server log files.
3. For Choose The Type Of Web Server Profile, select Data Source Splitter Profile
(DSS).
4. Click Next.
You see the General dialog box.
5. In the Name text box, type a name for the profile. This name also serves as a default
profile title in reports.
6. Specify how much of the log to analyze.
− To analyze the entire log file, select From Start Of Log File(s).
− To analyze the log beginning with the date specified, select From The Following
Date. Type the date in day/month/year format.
7. If you need to adjust for time zone differences, in the Time Zone area, select the
Override The GMT Offset To Use For Processing Reports check box. In the text
box that appears, enter the value, in hours, that you want the WebTrends software to use.
Note: For more information on time zone differences and GMT offsets, see “About
General settings” on page 49.
8. In the Profile File Name text box, type the name for this profile. This name is listed in
the Profile Statistics section below the list of profiles on the AdminConsole.

9. If you want to archive this profile, select Enable Archiving. For information about
restoring archives see “Restoring profiles” on page 79.
10.If you do not want this profile to be included in analysis, select Disable This Profile.
Note: When you are ready to use a disabled profile for analysis, you can activate it by
selecting it at the AdminConsole then selecting Edit and the General tab.
11.To capture web page titles for inclusion in reports, select Retrieve HTML Page Titles.
Note: Retrieving page titles can slow report creation. Choose this option only when it is
important to identify HTML pages by their titles.
12.Click Next
13.The Data Source Splitter dialog box opens.
14.Select the Data Source Splitter definition and virtual domain that refers to the log file for
this profile.
15.Click Next.
16.Finish creating your new DSS profile by following the directions in “Adding Profiles”,
starting with “Home” on page 53.
Profile Settings
Use the following settings to configure DSS through the command line.
[profile]
isecm = [1]
ecmfile = 7
ecmdefinition = 9qfG7PB0z15
isecm = tells whether or not there is a DSS file. A value of 0 means there is not a DSS file
while a value of 1 means there is.
ecmfile = identifies the DSS file. The default directory where the file is stored is:
./wtm_wtx/datfiles/econfig
ecmdefinition = a GUID matching one of the ID fields within an [ecmprofilex] section of

the DSS definition file.

These profile settings identify the DSS file, which includes general settings such as the log
files to be split and the split time tolerance. The profile also identifies the ecmprofile within
the DSS file, which contains the settings that indicate which set of split log files will be
analyzed by this profile.

Chapter 15
Using Parent-Child Profiles
Parent-Child profiles
Use Parent-Child profiles to automate the creation of profiles and reports for multiple
domain names contained in one or more log files. This is helpful when an ISP or web hosting
service hosts multiple customer sites on their web servers. To a web site visitor, a customer’s
site can appear as a distinct, standalone domain, but often the web activity data for each
customer site is recorded and lumped together in the service provider’s main web server log
file.
If service providers want to offer their customers a set of basic web activity reports with data
specific to each customer’s site, they need a means of breaking out data by customer. Because
service providers also want to reduce management and maintenance of this data splitting
process, they want their software to auto-discover and split out these data subsets while
parsing the log file. Parent-Child profiles provide this auto-discovery functionality, and also
creates profiles, called Child profiles, for these data subsets.
Currently supported criteria for splitting out data subsets are:
• URL (does not support auto-discovery)
• Domain Name
• SmartSource Site ID
• URL Query Parameter
With the exception of URL, the split criteria you specify is used to auto-discover and
automatically create the Child profiles. URL requires you to configure each Child profile,
specifying the URL strings to parse for in the log file. For more information on configuring a
Child profile, see “Creating and Editing a Child Profile” on page 246.
• Using Parent-Child Profiles 231

Parent-Child profiles work best when the Child profiles don’t need very much customizing.
Because it’s mostly an automated process, Parent-Child profiles simplify how service
providers can create and administer profiles for multiple users. After Child profiles are
created, either automatically or manually, these Child profiles are used to analyze and report
on their associated web activity data.
Note: Data Source Splitter (DSS) profiles also analyze several domains over the same set of log
files, but you manually create the profiles. For more information on DSS profiles, see “Using
the Data Source Splitter (DSS)” on page 219.
Parent-Child profiles enable administrators to:

• Improve configuration: easily create new profiles and reports. For example, when a
service provider adds a new customer, a profile will be automatically created for them,
and reports based on that profile will be automatically generated without the WebTrends
software or the server needing to be restarted.
• Improve performance: splits log file data into subsets of the data, with each data subset
being associated with a Child profile. Because the WebTrends software only analyzes
these data subsets instead of the entire log file, each Child profile’s data is more quickly
analyzed and reported upon. In addition, each Child profile can be individually updated
and reconfigured at any time.
• Streamline reporting: Child reports are smaller than standard reports. This is useful for
clients who may not need the full scope of report data that the WebTrends software can
provide.
• Simplify user interface for users: Users can only read reports. They do not have access
to the WebTrends software or profile configuration.
Parent-Child Terminology
Parent-Child profiles introduce some new terminology into the product:
• Parent profile: This profile automatically creates smaller Child profiles, which point to
subsets of the log file data or a limited set of log files (for example, only the log files of a
specific customer).
• Child profile: This is a profile that is usually automatically created by a Parent profile. A
Child profile analyzes subsets of a log file or a limited set of log files (for example, only
the log file records that relate to a specific customer).

• Split field: The field in a log file record that contains the string that determines how to
split the log file. This is specified when you build a Parent profile. This can be a domain
name, URL, SmartSource site ID, or URL query parameter.
• Split log file: This is a subset of the log file or set of log files pointed to by the Parent
profile. It’s created when the WebTrends software first analyzes the Parent profile.
Note: Split log files are only created for Parent profiles that use Full-featured Analysis. For
more information on the types of Parent profiles, see “Two Types of Parent Profiles”
below.
• Child profile key: This is the key that file names and profile names are based on for a
Child profile. In most cases this will be the split field.
• Parent-Child execution: The process of analyzing a Parent profile. It includes the full
cycle of splitting the log file data, creating the Child profiles, analyzing the Child profiles,
and cleaning up.
Two Types of Parent Profiles

You can create either Full-featured Analysis or Express Analysis profiles. Both let you split the
log file data into Child profile data sets so that you can produce individual reports on each
Child profile. The difference is that Full-featured Analysis physically creates individual log
files for each Child profile, and then uniformly applies any standard profile settings—
Advanced Features, Filters, Campaigns, etc.—to all of its Child profiles. In effect, the Parent
profile settings function as a template that is applied to the associated Child profiles. To
customize any of these settings for an individual Child profile, you must modify that Child
profile. For more information on configuring Child profiles, see “Creating and Editing a
Child Profile” on page 246.
In contrast, Express Analysis does not split a web server log file into smaller files. Instead, it
relies on the SmartSource tags embedded in your web site pages to create a database into
which Child profile data is aggregated upon analysis. While aggregrating the data, Smart-
Source tags embedded in each page trigger the generation of content groups, filter appli-
cation, campaign creation, and the application of other standard profile features. The result is
that Express Analysis more fully automates profile creation, although individual customers
will need to include the SmartSource tags in the pages they want to associate with Advanced
Features or other settings.

Because these profiles differ in how they handle configuring standard profile settings, you will
find that when editing an Express Analysis Parent profile, many user interface options will be
unavailable or grayed out. Specifically, the following tabs will be unavailable:
• Advanced Features
• Campaigns
• Custom Reports
• Filters
• Home
• Post-processing
• Pre-processing
• Site Configuration
In addition, because Express Analysis does not physically split the logs into smaller logs, there
is no need for the Delete Split Logs After Child Analysis Complete option.
How Parent-Child Profiles Work

Parent profiles point to a main log file (or files). When the WebTrends software analyzes the
Parent profile, it parses the log file and automatically splits the data into either smaller files
(Full-featured Analysis) or places that data in a database (Express Analysis). The WebTrends
software performs the split based on the criterion that you specified—either domain name,
URL, SmartSource site ID, or URL query parameter.
Note: If you selected Full-featured Analysis, and selected URL, you must configure each Child
profile manually. WebTrends software does not support auto-discovery of Child profiles
when URL is the split criterion. For instruction on configuring Child profiles, see “Creating
and Editing a Child Profile” on page 246.
Analysis of the Parent profile also results in the creation of a Parent-Child configuration file,
the creation of Child profiles for each split out data set (which often equates to a customer's
web site), and the analysis of each Child profile.
This process is explained in further detail in the following sections.
1. Building the Parent profile

The Parent profile is built using the same Add New Profile wizard used for standard profiles.
(See “Adding Parent profiles” on page 238 for details.) The settings configured in the Parent
profile will be applied to any Child profiles that are created from it.

2. The Parent-Child configuration file
When the Parent profile is run, the WebTrends software parses the log file (or files) specified
by the Parent profile, creates the Parent-Child configuration file, and splits the log file data
into data subsets for each Child profile.
This configuration file, which is a list of Child profiles that the WebTrends software will
create, is saved to the
.wtm_wtx/datfiles/ehost
directory using the naming convention <profile name>.ini, and is the basis for how the
WebTrends software administers the Parent profile’s children. See “Editing Parent Profiles”
on page 239 for details on the configuration file.
3. Editing the Parent-Child configuration file

The Parent-Child configuration file controls how a Parent profile executes. You can, for
example:
• Split files by domain name, URL, SmartSource site ID, or URL query parameters.
• Exclude or specifically include certain records from its analysis based on split
criterion strings that you specify. For example, if you want to exclude a specific
domain from analysis, you could specify the domain name.
• Delete split log files after analysis (Full-featured Analysis only).
• Create Child profiles without splitting or analyzing the log file data.
• Specify which character separates multiple entries so the WebTrends software doesn’t
search for one long match criteria string.
Typically you only have multiple split criteria for one Child profile when using domain as the
split criterion. For example, you would want www.webtrends.com and webtrends.com to
be viewed as the same customer site. You would therefore enter these two strings as the
match pattern, but then you would need to tell the software what character separated them so
that it did not read the match pattern as one long string. See “Editing Parent Profiles” on
page 239 for details.
4. Parent-Child execution
The WebTrends software parses the log files specified by the Parent profile and either creates
split log files for each Child profile (Full-featured Analysis) or aggregates Child profile data
into a database (Express Analysis) for each Child profile. It also creates user entries in the
Parent-Child configuration file, which administrators can modify to update user access to the
Child profile reports.

After the WebTrends software has completed creating the Child profiles, it analyzes each of
them. Reports based on these Child profiles are posted to the default directory.
File and Directory Names

File names
A Child profile will be given the name <parent profile name_split field
value>.wlp, where parent profile name is the name of the Parent profile file (minus the
file extension) and split field value is the string used to split or the name field if there
is a [profile] section in the Parent-Child configuration file. Split field value is modified
by having spaces and periods converted to underscores. For example:
Parent profile: mspparent.wlp
Split field value: www.webtrends.com
Child profile name: mspparent_www_webtrends_com.wlp
Following the naming convention of a standard profile, the Child profile dictates the name of
the report directory, the database directory, and the status log file.
Directory location of split log files (Full-featured

Analysis)
The root directory for split log files created with Parent-Child Full-featured Analysis can be
specified in either wtm_wtx.ini or the Parent profile. The key is:
[profile]
ehostlogfiledirectory =
The default directory is:

./wtm_wtx/datfiles/ehost_logs.
Under the root log file directory, subdirectories are created for each Parent profile. Under
these Parent profile directories, subdirectories are created for each Child profile. As above,
the Child name is based on the split key or the name field if specified in the [profile] section
of the Parent-Child configuration file. Periods and spaces in the Child name are converted to
underscores.

An example:
Parent profile: mspparent.wlp
Split keys: www.webtrends.com, www.auditrack.com,

www.webtrendslive.com, www.egsoftware.com
Root log file directory: ./wtm_wtx/datfiles/msptrends_logs
The resulting directories will be created for log files:

./wtm_wtx/datfiles/ehost_logs/mspparent/www_webtrends_com/
./wtm_wtx/datfiles/ehost_logs/mspparent/www_audittrack_com/
./wtm_wtx/datfiles/ehost_logs/mspparent/www_webtrendslive_com/
./wtm_wtx/datfiles/ehost_logs/mspparent/www_egsoftware_com/
Limitations of Parent-Child Profiles

• New users are not automatically created. During the profile creation process, blank
entries are created in the users section of the configuration file for any profiles that are
not already listed in the section. You need to add user names to the configuration file to
grant new users access to the reports.
• The Parent-Child profiles cannot be used for analyzing data stored in a WebTrends
Warehouse database. Unlike standard profiles, Parent profiles cannot read from
WebTrends Warehouse database data, and cannot save split log files to a WebTrends
Warehouse database.
• A Child profile will not have server clusters, even if the Parent profile is configured to use
them.

Adding Parent profiles
Create Parent profiles with the Add Profile wizard.
Note: For information on creating other types of profiles, see the following:
• Standard and Streaming Media profiles: “Using Profiles” on page 43
• Data Source Splitter (DSS) profiles: “Adding DSS profiles” on page 227.
To add a Parent profile:

1. From the Profiles menu on the left of the AdminConsole, click New. The Add New
Profile wizard opens.
2. Select one of the following types of content to be analyzed:
− Web Server: Use this for standard web content.
− Streaming Media Server:
Use this for analyzing streaming media server log files.
3. Under Choose The Type Of Profile To Create, select Parent-Child then select one of
the following options that appear.
− Express Analysis (SmartSource Files Only): Use this to create a Parent profile
that uses SmartSource tags to configure profile settings such as Advanced Features,
Filters, and Campaigns. You need to include the SmartSource tags in the web site
pages you want to associate with Advanced Features or other settings.
− Full-featured Analysis: Use this to create a Parent profile that has all the standard
profile settings available for configuration. Full-featured Analysis uniformly applies
any standard profile settings configured for the Parent profile to all of its Child
profiles.
4. Click Next.
5. Finish creating your new Parent profile by following the directions in “Adding Profiles”,
starting with “General settings” on page 48 for Express Analysis profiles and “Site
Configuration” on page 47 for Full-featured Analysis profiles.
The first time the WebTrends software analyzes a Parent profile, Child profiles are created. To
customize settings for an individual Child profile, you must modify that Child profile. Also, if
you chose to split the log file data by URL, you must manually create your Child profiles. See
“Creating and Editing a Child Profile” on page 246.

Also, Child profiles can be customized individually at the command line as an efficient means
of administering profiles. See “Customizing Child profiles” on page 250 for more infor-
mation.
Note: Once you have created a Parent profile, if you select that profile from the profiles list, a
Show Children link appears at the bottom of the Profiles menu on the left of the Admin-
Console. Click that link to view a list of the Child profiles associated with the selected Parent
profile.
Splitting by URL
Splitting by URL is helpful in situations where you're segmenting your customers by directory.
For example, you may have a www.hostname.com/~customername type of structure.
If you split by URL, WebTrends software does not parse the log file nor automatically create
Child profiles (through auto-discovery). Instead, you need to manually configure each Child
profile by indicating its associated URL. See “Creating and Editing a Child Profile” on
page 246 more information.
Editing Parent Profiles

Edit Parent profiles to specify settings for Child profiles, users, and log files. These settings
include:
• How to split the log files
• What to use to split the log files
• Profile names
• Which users have access to which profiles
• Which log records to exclude from analysis

You may either edit Parent profiles through WebTrends software, just as you would edit a
standard profile (See “Editing Profiles” on page 68), or you can configure them manually
using the configuration file. The configuration file is located in the:
.wtm_wtx/datfiles/ehost
directory, and uses the <profile name>.ini naming convention. The following section discusses
editing a Parent profile using its configuration file.
Sample Parent-Child configuration file, splitting by

domain name
This sample shows a configuration file where you would like to accomplish the following.
• Use several different domain names to split the log file.
• Exclude certain domain names from analysis.
• Delete the split log files once the processing is finished.

Sample file
An explanation of each of the sections in this sample file follow the sample.
[general]
split = 1
split_field = domain
delete_logs = 1
[profile1]
name = webtrends.com
pattern = www.webtrends.com 210.0.36.35 www.egsoftware.com
regexp = 0
[profile2]
name = webtrends.net
pattern = www.webtrends.net webtrends.net 210.0.36.36
regexp = 0
[users]
www.audittrack.com = usern, usery
www.security.com = usern, userz
www.ctrs.com = usern
www.wtrs.com = usern
webtrends.net = userz, userc
webtrends.com = userz, userc, usera
[ignore]
key1=www.virtualwebtrends.com
key2=virtualwebtrends.com
[split_only]
key1=www.audittrack.com
General section
split = indicates whether the log files will be split. A value of 0 means they won’t be split
while a value of 1 means they will.
split_field = indicates what will be used to split the files, domains or URLs.
delete_logs = indicates whether the split log files will be deleted. A value of 0 means they
won’t be deleted while a value of 1 means they will. The original log files remain intact.

Profilex sections
Each profilex section explains how domains are grouped into a single log file set and profile.
name = specifies the name used in creating the profile name and directory names.
pattern = this value is matched with split field values to group similar records in a single
profile. This is a mandatory field. In the [profile1] example, records with a domain name of
www.webtrends.com, 210.0.36.35, and www.egsoftware.com will be grouped into a single
profile.
regexp = specifies whether the pattern key should be interpreted as a regular expression—
value of 1—or not—value of 0. If the pattern key is not a regular expression, the value of the
name field becomes the child profile key.
Important: The profile name, and by extension, the database directory, report directory, status
log, etc., are all based on the name field value. That means it must be able to become a file
name, i.e., it cannot contain characters like ‘/’, ‘\’, or ‘:’.
If the field being split matches the profile/log set, no profilex section is needed. In this case,
the value of the split_field from the log file record becomes the child profile key.
Users section
Use these settings to specify which users have view-only access to reports based on the "split"
log files. Use a comma between each user entry to separate them. The maximum length of a
value string is 500 characters.
During the profile creation process, blank entries will be created in the users section for any
profiles that are not listed in the section. You will need to add user names to the configuration
file to grant new users access to the reports.
Ignore section
The ignore section is used to specify which log records are not considered during analysis.
The keys in this section are given the names key1, key2, …, keyn. In the example given above,
records with the domain name www.virtualwebtrends.com and
virtualwebtrends.com will be ignored.

Split_only section
Use this section to specify log records that will be split, but have no profile created for them,
therefore no analysis will performed on the split log file data.
This feature allows full-fledged, user-created profiles to take advantage of the Parent-Child
log file splitting process.
To use this feature, point the profile at the log file directory that will be populated by the
splitting process. The scheduling of this profile will not be coordinated with the execution of
the Parent profile. You may choose to coordinate the scheduling of the Parent profile and the
profile they create to achieve the best results.
The format of this section is the same as the format of the [ignore] section. The values are
child profile keys that will be matched against log file records. If the pattern matches, the
record is ignored.

splitting by URL
The following is a sample of a configuration file that specifies splitting the Parent profile by
URL.

Sample file
The sections in this sample file are the same as those in the previous sample for splitting by
domain name.
[general]
split = 1
split_field = url
delete_logs = 1
[profile1]
name = Marketing
pattern = mktg isale
regexp = 0
[profile2]
name = Outside_Sales
pattern = osale
regexp = 0
[profile3]
name = Combined_Sales
pattern = isale osale
regexp = 0

without splitting
There may be instances where you want to set up Parent-Child profiles for log files that have
already been split. The Parent profile will execute according to the instructions of the Parent-
Child configuration file, i.e. it will create Child profiles and control their analysis, but no
splitting of the log files will take place.
If you use Parent-Child profiles in this fashion, it is your responsibility to edit the Parent-
Child configuration file to ensure that every profile you want created is mentioned in the file.
Parent-Child profiles perform no discovery when used post-split.

Sample file
This sample shows a configuration file for when you have a web server that is hosting
multiple domains and splits the log files by itself. An explanation of each of the sections in
this sample file follow the sample.
[general]
split = 0
logfilepath = d:\weblog\server1\%profile_key%\*.log
d:\weblog\server2\%profile_key%\*.log
[profile1]
name = webtrends_com
profile_key = webtrends.com
[profile2]
name = webtrends_net
profile_key = webtrends.net
[profile3]
name = audittrack_com
logfilepath = f:\adt\server1\*.log f:\adt\server2\*.log
[users]
webtrends_com = usern, usery
webtrends_net = usern, userz
audittrack_com = usern
[section_name]
profile_1_name = value1
General section
split = indicates whether the log files will be split. A value of 0 means they won’t be split
while a value of 1 means they will.
logfilepath = a key used only in no-splitting mode. Use this key to specify a generalize log
file path, using a %profile_key% macro.
If some of your profiles do not fit the general form of the logfilepath, override that setting by
adding a logfilepath entry to the appropriate profilex section. (See the [profile3] section of
sample file on page 244 for an example.)

Profilex sections
You can create as many profile sections as needed. Each profile section includes the data
needed to create a Child profile.
The name key specifies the name used in creating the profile name and directory names. This
is a required field.
Users section
Use these settings to specify which users have view-only access to the reports generated by
the Child profiles. The maximum length of a value string is 500 characters.
During the profile creation process, blank entries will be created in the users section for any
profiles that are not listed in the section. You will need to add user names to the configuration
file to grant new users access to the reports.
Ignore section
This section of the Parent-Child configuration file does not apply when log files are not split.
Anything not already explicitly mentioned in the Parent-Child configuration file is ignored, so
an ignore section is not necessary.
Split_only section
This section does not apply when not splitting.
Section_name section
See “Customizing Child profiles” on page 250 for details on how to use this section to take
advantage of full Parent-Child profiles functionality.
Creating and Editing a Child Profile

The following procedure explains how to manually create Child profiles. You’ll need to do
this if you have selected URL as the split criteria for defining Child profiles. In addition, you
will likely need to modify user access for Child profiles that were auto-discovered.

To create a new Child profile:
1. From the AdminConsole, select the Parent profile that you want to create Child profiles
for.
2. From the Profiles menu on the left, click Show Children.
You see the Parent profile at the top of the Profiles list with its Child profiles listed below
it.
3. From the Profiles menu, click New Child. The New Child Profile wizard opens to the
General dialog box.
4. In the Child Profile Description text box, type a description to identify the Child
profile.This description appears in the Profiles list on the AdminConsole when showing
child profiles and is used as the default profile title in reports.
5. In the Match Pattern text box, enter the text string to be used to separate this Child
profile's data from the main log file data. You can use regular expressions.
6. In the Time Zone area, select the Override The GMT Offset To Use For Processing
Reports check box if you wish to override the GMT (Greenwich Mean Time) offset for
the WebTrends software's server. And in the text box that appears, enter the offset value,
in hours, that you want the WebTrends software to use.
By default, the WebTrends software uses either the time zone of the server you are
running the analysis on or the time zone specified on the General tab in Options.
Selecting this override option helps create more accurate reports if the time zone where
your log files are created differs from where they are analyzed.
Note: This feature is used for log files that are local time only. It doesn't apply to W3C log
files or any log files that have a time zone offset in them.
To adjust for times moving west from GMT, use a positive value. To adjust for times
moving east from GMT, use a negative value.
7. In the IP Filters area (only available with Express Analysis) select the appropriate option
to either include or exclude specific IP addresses from analysis and reporting.
− Include All IP Addresses Except The Following. Select this, and in the IP
Addresses text box, type the IP addresses (e.g., 192.167.12.3) or computer names
(e.g., pdxbob05.domain_name.com) that you wish to exclude from analysis and
reporting.

− Include Only The Following IP Addresses. Select this, and in the IP Addresses
text box, type the IP addresses (e.g., 192.167.12.3) or computer names (e.g.,
pdxbob05.domain_name.com) that you wish to include in analysis and reporting. Only
records containing these IP addresses will be included in analysis and reporting.
Note: You can specify multiple IP or computer addresses to include or exclude. For
examples of specifying multiple addresses, see “Address” on page 121.
8. Click Next. The Report dialog box opens. Use this dialog box to specify a title for the
Child profile's report. The items appear in the header of the Child profile's HTML-based
report.
9. In the Report Title text box, specify the title for the report.
10.In the Report Week Starts On area, select the day of the week that reports will start on.
11.Click Next. You see the Profile Access dialog box.
12.If necessary, do one of the following:
− Add a user.
1) Select a User from the Users Without Access list
2) Click the left arrow (<) to move it to the Users With Access list.
− Remove a user.
1) Select a User from the Users With Access list
2) Click the right arrow (>) to move it to the Users Without Access list.
13.If desired, select the Enable Reports Generated By This Profile To Be Viewed
Anonymously By The General Public check box to allow public users to view this
profile's reports. For this feature to work, the Allow All Reports Enabled For Public
Access check box in the Configure User Access And Privileges dialog box must be
selected. (To access the Configure User Access And Privileges dialog box, click User
Access from the Administration menu near the top of the AdminConsole.)
14.Click Finish, then click OK.
To edit an existing Child profile:
1. From the AdminConsole, select the Parent profile that you want to create Child profiles
for.

2. From the Profiles menu on the left, click Show Children.
You see the Parent profile at the top of the Profiles list with its Child profiles listed below
it.
3. Select the Child profile that you want to edit, and click Edit from the Profiles menu on
the left. The tabbed set of dialog boxes for editing a Child profile opens. Select the
appropriate tab and modify settings as needed:
− General dialog box. See 4 through 7 of the previous instructions for information on
this dialog box.
− Reports dialog box. See 9 through 10 of the previous instructions for information
on using this dialog box.
− Profile Access dialog box. See 12 through 13 of the previous instructions for infor-
mation on using this dialog box.
4. Click OK then click OK again.
Viewing Child profiles for a Parent profile

Once a Parent profile has been analyzed, you can see the Child profiles that it creates.
To review currently available Child profiles:
1. In the profiles list of the AdminConsole, select the Parent profile whose Child profiles
you want to view.
2. From the Profiles menu on the left side of the AdminConsole, select Show Children.
The profiles list changes to show the children of the selected Parent profile.
Note: If no Child profiles exist, you will receive a note indicating that "No Child profiles
were found." This can occur if the analysis has not yet run, or if the split criteria match
pattern resulted in no matches.
3. To return to the main profile list, click Show Main List at the bottom of the Profiles
menu.
Viewing reports for a Child profile

Complete the following steps to view Child profile reports.

To view a Child profile’s reports:
1. In the profiles list of the AdminConsole, select the Parent profile for the Child profiles to
be viewed.
2. From the Profiles menu on the left side of the AdminConsole, select Show Children.
The profiles list changes to show the children of the selected Parent profile.
3. Select the Child profile you want to view report data on.
4. From the Profiles links on the left side, click View Reports.
As with the other profiles, the server running the WebTrends software does not need to be
running in order for a remote user to view Child profile reports.
Customizing Child profiles

You can customize the Child profiles that a Parent profile creates by adding entries to the
[section_name] section of the Parent-Child configuration file.
Section_name section
The format of this section is:
[section_name]
Section names include:

Reptitle = value will be used as the title of the report for that profile.
Repimage = value is the path to an image file used in the report.
Repimagealt = value is the path to an image file to display over the Repimage.
Repimageurl = value is used as link, within the report, to a web site.
Reptitle2 = value will be used as the secondary title of the report for that profile.
Repimage2 = value is the path to a secondary image file used in the report.
Repimagealt2 = value is the path to an image file to display over the Repimage2.
Repimageurl2 = value is used as a secondary link, within the report, to a web site.

Description = value is the description that appears in the UI for the profile.
Reportfile = value is the .wct file that will be used for the profile’s reports.
Dailyreport = value is true or false, depending on whether or not daily reports should be
produced for the profile.
Weeklyreport = value is true or false, depending on whether or not weekly reports should be
Monthlyreport = value is true or false, depending on whether or not monthly reports should
be produced for the profile.
Quarterlyreport = value is true or false, depending on whether or not quarterly reports
should be produced for the profile.
Yearlyreport = value is true or false, depending on whether or not yearly reports should be
Homepagebasedir = home page URL for doing HTML title retrieval.
The Parent-Child Profile Report

Command line utilities
WebTrends software includes three utilities for generating reports on Parent-Child profiles.
These can greatly simplify tracking activity of sub-domains.
• Profile_activity
− profile=name [-begindate=yyyymmdd] [-enddate=yyyymmdd]
[-count=x] [-sortby=hits|bytes]
List domains sorted by either hits or bandwidth. This information is found in the
profile's msptrends_stats.csv file.
− -begindate = yyyymmdd
Start the report with log file data from this date. If not supplied, use data from the
beginning of msptrends_stats.csv.
− -enddate = yyyymmdd
End the report with log file data from this date. If not supplied, use data up to the
end of msptrends_stats.csv.

− -count = x
Report on this many domains.
− -sortby = hits | bytes
Sort the report either by hits or by bytes transferred (bandwidth).
• least_active_domains
− profile=name [-days_inactive=x | -count=y]
List domains sorted by their least recent analysis activity. The utility uses the last
analysis time recorded in the profile_list.ini file to make this determination.
− -days_inactive = x
Include in the report only domains whose last analysis was at least x days ago.
− -count = y
Include y domains in the report.
• reports_viewed
profile=name [-begindate=yyyymmdd] [-enddate=yyyymmdd]
List Child profiles sorted by the number of reports viewed. This utility takes the current
list of Child profiles from the profile_list.ini file, then examines the on-demand status
logs for each of the Child profiles.

Appendix A
Regular Expression Syntax
This appendix contains descriptions and examples of the regular expression syntax that can
be used with campaign definitions. It should handle any pattern-matching needs that you may
have.
Regular Expression Components

Basic elements
Table A-1. Basic Element Examples
Basic element Example
a single character Matches anything containing the single character to be

matched. For example, a matches cause. You could also
combine several characters together, such as couch.
• Regular Expression Syntax 253

\ followed by a sin- Lets special characters be used as a single character.

gle character For example, to use this character:
.
as a period, precede it by a back slash:
\
This is especially useful when describing paths. For example
\.html$ matches anything ending in .html.
The following characters need to be preceded by a back slash if
they are to be used without special meaning:
\ . $ * ? + [ ] ( ) |
$ Matches anything that ends with the value. For example,

cause$ matches cause and because.
^ Matches anything that begins with the value. For example,

^couch matches couches and couch.
* Matches any single character. For example, cou*h matches

couth, couch, cough.
range [ ] Matches a sequence of characters that are enclosed in these

brackets. For example, [0-9] matches on any decimal digit.
If the sequence is preceded by a carat:
^
it matches any single character not from the sequence. For
example, [^a-z] matches anything that isn’t a letter of the
alphabet.
| Indicates an OR operator. For example: couch|chair finds

couch or chair.

a regular expression The expression (couch[0-9])|(bed[0-9]) matches the

in parenthesis () following: couch36A or full_bed33b, but not couch.
Qualifying characters
The next level of a regular expression is any element which is qualified by one of the
following three characters: *, +, or ?.

Table A-2. Qualifying Character Examples
Qualifying character Example
* Matches 0 or more occurrences of the element it follows.

For example, couch_[a-z0-9]* matches couch fol-
lowed by one or more alphanumeric values: couch_0,
couch_aaa, couch_a33, and couch_.
Caution! Don’t confuse the * with the command-line wild-
card character. If you were trying to match all html files in a
path:
Wrong: /mydir/*.html
Correct: /mydir/.*\.html$
In the correct instance, you are specifying anything contain-
ing the following: /mydir/ followed by 0 or more of any
character, followed by a literal period, and ending with
html. This locates /mydir/index.html, for example.
+ Matches 1 or more occurrences of the element it follows.

For example, couch_[a-z0-9]+ matches couch_ fol-
lowed by one or more alphanumeric values: couch_0,
couch_aaa, couch_a33, but not couch_.
? Matches 0 or 1 occurrences of the element it follows.

For example, couch_[a-z0-9]? matches couch fol-
lowed by 0 or 1 alphanumeric values: couch_0,
couch_, couch_a, but not couch_bb.
Note: Since all campaign parameter names and values are case-insensitive, you don’t need
to match case in your regular expressions.

Building Regular Expressions
Most regular expressions that you use with WebTrends software will be very simple, often
consisting of a few basic elements.
Example 1
If you wanted to match all of the values that begin with couch, your regular expression is:
^couch
Example 2
If you wanted to match all of the values that end with couch, your regular expression is:
couch$
Note: These examples emphasizes how regular expressions work. If the match must begin or
end with the value, you must specifically indicate that by using ^ or $.
Example 3
In some cases, you may have an either/or situation. In this case you would use the pipe
symbol to combine two regular expressions. For example, couch|chair matches a value
containing either couch or chair:
blue_chair, chair_55, big_couch_55
Example 4
In this example, you are trying to match on three months of your product news. You might
use the following regular expression to define a qualifying page URL that contains any
product news HTML pages from January, February, or March:
/product/news/(jan|feb|mar)/.+\.htm
Literally, this means to match any item (most likely a URL), containing the string /product/
news/, followed by either jan, feb, or mar, followed by / and one or more of any character
(.+), followed by .htm.

This would return the following URLs:
/product/news/jan/chair.htm
/product/news/feb/mirror.htm
/product/news/mar/couch.htm
/product/news/jan/table.htm
/product/news/jan/table.html
but not these URLs:

/product/news/jan/chair.asp
/product/news/jan/chair.gif
/product/news/apr/chair.htm
Example 5
In this example, we want to match all URLs that indicate that an individual product in the
furniture category has been registered. We would use the following regular expression to
define our qualifying page URL:
^/product/furniture/.+/register.htm
Literally, this means to match all URLs that begin with

/product/furniture/, followed by one or more occurrences of any character, followed by
/register.htm.
The following URLs would be matched:
/product/furniture/couch/register.htm
/product/furniture/chair/register.htm
/product/furniture/couch/register.htm
/product/furniture/bedroom/armoire/register.htm
but not this URL:

/product/furniture/index.htm
Matching order rules

There are several rules involved with how regular expression matching occurs:
• The first match found takes priority over other matches found if there are two
matching input strings.
• In a list of concatenated expressions, the left-most match takes priority.

• The matches found using *, +, and ? are considered longest first.
• Nested constructs are evaluated from the outside in.
Comparing Regular Expressions and Wildcards

This table shows how you might use a wildcard or regular expression to accomplish the same
thing.
Table A-3. Regular Expression and Wildcard Comparisons
Wildcard (*) Regular expression Meaning
*chair* chair Contains chair
*chair chair$ Ends with chair
chair* ^chair Begins with chair
chair (no wildcard) ^chair$ Is exactly chair

Appendix B
Optimizing and Troubleshooting
Optimizing Performance
This section suggests the most efficient ways to use WebTrends software.
Storing data locally

Reports that use data stored locally are generated more quickly than those that use data stored
on another machine.
Improving the use of disk space and memory

Several factors affect total disk space and memory requirements:
• Number of concurrent analysis—the greater the number of analyses occurring at the
same time, the greater the demands on memory. To conserve memory, decrease the
number of concurrent analyses. Also, there should only be one concurrent analysis per
processor. See “Performance tab” on page 178 for more information.
• Report maintained—to save disk space, only maintain reports for intervals that you
need (daily, weekly, monthly). Set a limit on the number of reports that are maintained for
each interval. See “Reports tab” on page 181 for more information.
• Internet Resolution—the size of the DNS queue and the number of threads impact the
memory used for Internet Resolution. Refer to the Releasenotes.txt file, included on the
product CD, for more information.
Configuring web server settings

In the Webserver Configuration dialog box, you can work with settings for the web server
that provides the data the WebTrends software analyzes.
• Optimizing and Troubleshooting 261

To configure web server settings:
1. From the links at the top of the AdminConsole, click Administration > WebServer
Configuration.
2. In the Webserver Configuration dialog box, you can modify the following settings:
− Port—Specifies the port where the web server resides. Be sure the port is not used
by another daemon.
− Authentication—Specifies the method used to authenticate the users when the log
in. If you select Operating System, the user must have an account on the machine. If
you select Custom, you must define a password for all users in the User Access
dialog box.
− User Session Timeout—Specifies the length of the timeout before the user is
disconnected from the server.
(UNIX only) Saving hard drive space

You can save space on your hard drive by enabling the usesymlinks option. By default, each
profile creates its own set of files in the CordaJava, Images, MSWord directories. However, if
you enable symbolic links, the WebTrends software points to these shared directories rather
than copying them for each profile, saving space on your system.
To enable the usesymlinks option:
1. Open <install dir>/wtm_wtx/wtm_wtx.ini.
2. Set the usesymlinks option to true as shown here:
usesymlinks=true
Special considerations
for configuring WebTrends software
The configuration you design determines the speed and resources available for processing
and publishing reports. This section discusses two approaches.

Default configuration
By default, the WebTrends software is configured to provide all the administration and
publishing of reports on one machine. When the default configuration is used, the databases
for reports and analysis are stored locally. This configuration results in the best reporting
speed.
Using multiple web servers and storing results on

another machine
The WebTrends software can also be configured to use multiple web servers for reporting
and to maintain databases on other machines. To implement this configuration, you would
change both the default web server settings as well as the database directory setting. To
specify the database directory, from the AdminConsole, select Options > Database
Directory tab.
Troubleshooting
This section addresses potential issues and suggests ways to remedy them.
Conflicting file permissions

If you have trouble running or saving a profile, or it appears to be missing, check your owner
or group permissions. Typically, this occurs when you install the product as one user and try
to run it as another, or when you copy another user’s profile. You might avoid this and other
problems by running the WebTrends software as the user who installed it.
Initialization issues
Web server fails to initialize

If the web server fails to initialize, the wt.remote.err may provide insight (see page 265).
Failure to initialize may be caused by trying to use a privileged port or one that is already used.

Profiles fail to initialize
There are several reasons why a profile might not initialize. First, look at the status log for the
profile. It might indicate a problem in processing.
Then consider the following possibilities:
• Are the log files in a supported format? Make sure the logs are not corrupt and that the
log data is valid.
• Are you running a trial version of the WebTrends software? If you are and the trial period
expired, check the dates of the log files that you are trying to run. The dates must be
within the period of the trial.
• Can the WebTrends software find and write to the directories specified for databases?
Can it access the statuslogs directory? The WebTrends software must be able to access
the directories specified for the reports database and the profile database.
(NT only) Configuring NT for WebTrends software

If you are accessing log files through a mapped drive, you need to configure the machine that
has the profiles.
Note: NetIQ recommends UNC paths as the preferred way of accessing log files. Using
mapped drives increases the chances of permissions issues arising.
To configure a machine running the WebTrends software to access log files through a
mapped drive:
Step 1. Make sure the machine has the same user account information as the user who is
logged into the WebTrends software.
1. From the Start menu, select Settings > Control Panel.
2. Select Administrative Tools > Services. Select the WebTrends software from the list,
and click Startup.
3. In the Service dialog box, select the This Account From The Log On As group.
Specify the account to use and type the password for the account.

Step 2. Set up user rights for the account.
1. From the Start menu, select Program Settings > Administrative Tools > User
Manager.
2. Select the account the WebTrends software uses to access this machine.
3. Select Policies > User Rights. In the User Rights Policy dialog box, select the
Advanced User Rights check box.
4. Select Act as part of the operating system, and click Add. Select the user account from
the list, and click Add. Click OK.
5. Now repeat the previous step for Log On As A Service Right. Click OK to close the
User Rights Policy dialog box.
6. In the User Manager dialog box, select the Administrators from the Group list, and select
Policies > User Rights.
7. Click Add. You see the Add Users And Groups dialog box.
8. Select the user name from the list, and click Add. You may need to click Show Users to
see your name in the list. Click OK to close the dialog box.
Investigating errors
The WebTrends software maintains several logs that may record information on program
activity as a whole, the web server, and profile processing. If you have a problem, these files
might assist you.
Using the wtrs.err file

The wtrs.err file contains debug information related to the analysis engine. It contains infor-
mation about connections to the server, the reports that have been generated, and general
error messages. For example, if the server fails to start, look through this log.
This file—only created if issues arise—can be found in the root of the installation directory.
Using the wt_remote.err file

The wt_remote.err file contains debug information related to Report Center’s web server. It
contains a record of actions that the server portion of the program has performed. Look in
this log if there are problems with the server.

This file—only created if issues arise—can be found in the root of the installation directory.
Using the wtrs.audit file

As an administrator, you should check the wtrs.audit file daily. It records the profiles that are
active, connections made to the web server, and reports that are created. In addition, if dates
are missing for a log file that is analyzed, the missing date is recorded here.
This file can be found at:
/wtm_wtx/datfiles/statuslogs/wtrs.audit
Using the profile status log

The profile status log focuses on the details of profile processing. This graphic shows several
lines from one log.
Jul-16-2000 08:15:02: =-=-=-= Initializing profile

=-=-=-=
Jul-16-2000 08:15:02: Reverse DNS disabled.
Jul-16-2000 08:15:03: 1 member(s) found in log
list.
Jul-16-2000 08:15:03: 1 member(s), which have
already been analyzed, have been removed from the
log list.
Jul-16-2000 08:15:03: Logfile data is up to date --
no analysis required.
Jul-16-2000 08:15:03: Scheduling analysis of
cluster's logfiles every 0 hour, 15 minutes.
Jul-16-2000 08:15:03: cluster's next analysis is
Fri Jul 16 08:30:00 1999.
Jul-16-2000 08:15:03: 1 member(s) found in log
list.
Jul-16-2000 08:15:03: 1 member(s), which have
already been analyzed, have been removed from the
log list.
Jul-16-2000 08:15:03: Logfile data is up to date --
no analysis required.
Jul-16-2000 08:15:03: Creating summary report:
\index.html
Figure B-1. Log example

Using these details, you can determine where in the process a problem occurred.
Profile status logs are given the same name as the profile they are logging. They are located in
the <InstallDir>\wtm_wtx\datfiles\statuslogs directory.
Tip: The debuglevel option determines the level of detail provided. Set it to 10 to get the
most data.
Jan-18-00 08:21:38: =-=-=-= Creating profile =-=-=-

=
Jan-18-00 08:21:38: 1 member(s) found in logfile
list.
Jan-18-00 08:21:38: Reverse DNS disabled.
Jan-18-00 08:21:38: 1 member(s) remain to be
analyzed:
Jan-18-00 08:21:38: Using log file
.\wtm_wtx\datfiles\samples\sample.log:
Jan-18-00 08:21:40: Scheduling analysis of sample's
logfiles every 0 hour, 15 minutes.
Figure B-2. Sample profile status file
Fixing Error 500 Server Error

Error 500 Server Error states “An error occurred processing your request.” This can happen
if the WebTrends software daemon is not started by the same user who installed the program.
For example, if user johns installed the WebTrends software, and he logs in as superuser
rather than johns to start the daemon, he will get the 500 Server Error.
(Unix and Linux installations only): To solve this problem, either change the uid setting in
the wtm_wtx.ini file to uid=0, or give other write permissions to the install directory only. For
example, if the install directory is wtrs, do chmod o+w wtrs.
Note: It's best to start the server as the user who installed the WebTrends software. Setting
uid to 0, or having it run as root exposes a security risk.

Dates for reports are unexpected
If the log files don't include the GMT offset time (for example, +0000), the WebTrends
software adjusts for the time zone where it is located. For example, if you are reporting on
data for August 5, 1999, but the reports show a different date, you might check the log file for
the GMT offset. Although log files vary, the GMT field looks something like +0000 or -0000
(where zeros are replaced with the offset for your time zone.)

Appendix C
Silent Installation
An unattended, or silent installation is advantageous when you do not want to answer all of
the questions or complete all of the steps that the installation process (for Windows or for
Solaris/Linux) goes through.
Note: Silent installations are for advanced users only. Do not attempt this procedure if you are
unfamiliar with the WebTrends product or your local network.
It is the user’s responsibility to check for available disk space. You will receive a warning
message at 200 MB disk space remaining. The silent installation will abort at 50 MB if an
inadequate amount of disk space is detected.
Silent Install Instructions for Solaris/Linux

Installing as root
By installing as root, you will have administrator privileges.
To install as root, complete the following step:
From the command line:
./wtrs.install –response_file < response_file
The argument –response_file tells the install script that it is running without user inter-
action. If the –response_file argument is present, the behavior of wtrs.install is altered to
expect different input and produce different output.
The user redirects standard input to provide the input for wtrs.install from a response file.
The format of the file differs slightly depending on whether or not the user is installing as
root.
• Silent Installation 269

Response file
Table C-1 describes the format of the response file. A sample of this file is found in
wtm_wtx/datfiles/sample/root_auto_response, and it looks like this:
/usr/local/webtrends
y
y
1099
admin
9999
n
n
Table C-1. Sample response file descriptions
Sample text Description
/usr/local/webtrends This is where to install the WebTrends software. It must

be a full path, with all the same limitations on special
characters that exist in an interactive install.
y This specifies the installation of samples.

Values:
y = install samples
n = do not install samples
y This specifies the installation of the Company Database.

Values:
y = install the database
n = do not install database
1099 This specifies the UI port, which the browser points to

when bringing up the WebTrends software.
Values: integer. The default is 1099.

Sample text Description
admin This is the user name of the administrator.
9999 This specifies the engine port.

Values: integer. The default is 9999.
n This option only works with root installs.

This specifies if the WebTrends software should be
started when the system boots.
Values:
y = start the WebTrends software
n = do not start the WebTrends software
n This specifies if the WebTrends software should be

started immediately after installation.
Values:
y = start the WebTrends software immediately
n = do not start the WebTrends software immediately
Licensing issues
Silent installations do not handle licensing for the WebTrends software. To add a license to
these products, use the command-line executable wtlicman.exe.
To add a license using wtlicman.exe:
1. Complete a successful installation of the product.
wtlicman -a -k <activation key>
where activation key is the appropriate key to activate your product.

Silent Install Instructions for Windows NT/2000
Installing as root
By installing as root, you will have administrator privileges.
While some of the parameters described below are optional, some are required. Be attentive
to the order as well as the case-sensitivity of the commands. Failure to follow the required
order, case-sensitivity, or other cautions will result in a problematic installation.
To run a silent installation, complete the following steps:
1. Run the setup program with the following syntax:
setup.exe /S
/USERNAME=<USERNAME>
/UIPORT=<UIPORT NUMBER>
/ENGINEPORT=<ENGINE PORT NUMBER>
/DESTINATION=INSTALLATION DESTINATION PATH
Please note:
− The parameters must be given in the order presented.
− /S in required for silent installations of all Webtrends products.
− /USERNAME=<USERNAME>
User name for logon on and the information file. This parameter is optional.
− /UIPORT=<UIPORT NUMBER>
User Interface port number. This parameter is optional.
− /ENGINEPORT=<ENGINE PORT NUMBER>
Engine port number. This parameter is optional.
− The parameter /DESTINATION must conclude the argument. The value does not
include quotes.
2. Restart the product using the following commands:
wtrs -stop -start
wtinterface -stop -start

Licensing issues
Silent installations do not handle licensing for the WebTrends software. To add a license to
these products, use the command-line executable wtlicman.exe.
To add a license using wtlicman.exe:
1. Go to the directory where WebTrends is installed.
wtlicman -a -k <activation key>.
where activation key is the appropriate key to activate your product.

Index
A Custom Reports 56
Database Directory 57
access to profiles 63 Filters 57
active FTP connection method 175 for profiles 55
Ad Click ID String text box 87 Internet Resolution 58
Ad Views and Clicks Hit filters 123 Locale 61
ad views. see Advertising Views Post-processing 61
add-ons, installing 41 Pre-processing 62
Address Hit filters 121 Profile Access 63
administrator rights, specifying 186 Report Header 63
ads, tracking with Advertising Views 81 Report Templates 64
advanced configuration, enabling 186 Reports 65
Advanced Features Scheduler 66
Advertising Views 81 Table Limiting 66
applying globally 107 Visitor History 67
applying per profile 55 Advertising Views 81–86
applying to individual profiles 107 Analysis menu
Content Groups 88 Analyze Now command 75
Intranet Domains 90 Clear command 77
Path Analysis 92 Re-analyze command 76
Scenario Analysis 94 Stop Analysis command 76
Session Tracking 97 Analyze Now command 75
URL Parameter Analysis 100 Archive Now command 79
URL Search and Replace 104 archives
advanced settings limiting 170
Advanced Features 55 restoring profiles from 79
Campaigns 56 Archives menu
Index 275
Archive Now command 79 applying per profile 56
List Archives command 79 giving users access to 186
archiving using through WebTrends Map 206
about 78 Visit filter element 113
activating 78 Campaigns Visit filters 119
enabling 170 checking for product updates 36
managing for profiles 48 checkout page, monitoring 94
Archiving, default settings 169 Child profile key, defined 233
Authenticated User Name Hit filters 123 Child profiles
authenticated user, using to track visitor ses- adding 246
sions 97 configuring 49–51
authentication customizing 250
for home page 53 defined 232
web server setting 262 editing 248
auto status IP filters 247
re-starting 78 report settings 248
stopping 77 viewing 249
Clear command 77
B Client Only GeoTrends installation 38
clustered server site configuration 48
browser specifying servers for 51
modifications required for WebTrends combined format log files
Map 198 field definitions 156
system requirements 25 command line 211
using to view reports 162 directory structure 212
Browser Hit filters 124 executables 214
script parameters 213
UNIX program settings 216
C using to configure Data Source Splitter 228
cache limits utilities for Parent-Child profile reports
specifying for global cache 174 251
specifying for per-profile cache 174 common format log files, sample 156
cached log files, deleting from global cache company location
174 about 59
calendar reporting on 177
using to view reports 164 resolving for IP addresses 58
calendar, for reports 163 comparative mode, of report calendar 164
Campaigns 191–195 Compressed Log File Cache default settings
170

configuration file for Parent-Child profiles 235 links to full reports 165
Content Groups 88–89 Data Source Splitter
using through WebTrends Map 205 about 219
Content tab adding definitions 220
specifying information in templates 158 adding virtual domains 221
converting reports to Excel or Word 165 configuring through command line 228
Cookie Hit filters 125 deleting virtual domains 222
cookies editing definitions 221
defining for session tracking 99 editing virtual domains 222
using to track visitor sessions 97 example definition 223
costs, specifying for campaigns 194 profiles, adding 227
country of origin sample definition file 224–226
in reports 177 specifying as Profile Type 46
specifying for domestic activity 177 using 219
current analysis queue 160 data sources, adding to custom reports 147
stop processing all profiles 160 data storage method for optimal performance
stop processing individual profiles 160 261
Custom Reports Database Directory
about 133 default settings 171
applying per profile 56 specifying per profile 57
applying to all profiles 152 dates, correcting in reports 268
applying to individual profiles 152 Day Of The Week Hit filters 125
creating a definition 134 default settings
data sources, adding 147 Archiving 169
deleting a definition 148 Compressed Log File Cache 170
dimensions, addingdimensions Database Directory 171
adding to custom reports 140 Domain 172
Drilldown reports, creating 142 File Types 172
editing a definition 148 FTP Log File Cache 173
Filters, adding 145 FTP Options 174
measures, adding 143 General 175
primary dimension 133 Internet Resolution 176
secondary dimension 133 Locale 177
Performance 178
D Profile directory 178
Proxy 179
dashboards report generation and storage 181
adding items to report templates 159 Report Templates 180
Scheduler 182
Index 277
Table Limiting 182 E
delete profiles, giving users access to 186
demographic information, reporting on 177 edit profiles, giving users rights to 186
departments, tracking intranet usage 90 enabling archiving 48
dimensions end date, specifying for campaigns 194
specifying in custom reports 135 Entry Page Visit filters 118
directory entry pages
filter element examples 126 filter element examples 119
for profile database 171 using for accurate tracking 193
names for Parent-Child profiles 236 using to track a campaign 193
using filter element to include/exclude sub- Error 500 Server Error, fixing 267
directories 127 errors
Directory Hit filters 125 investigating 265
disabling archiving 48 Excel
disk space converting reports to 165
and optimizing performance 261 Exclude filters 109
required for silent install 269 Express Analysis
DNS lookups for unresolved IP addresses 177 defined 233
documentation specifying as Profile Type 46
downloading 19
typographic conventions used 18 F
Domain
default settings 172 features of WebTrends software 17
domain name File Hit filters 127
using to split Parent-Child log files 240 file names
domains for Parent-Child profiles 236
adding a suffix to a group 172 specifying for home page 53
domestic web site activity, specifying location file permissions, conflicting 263
for 177 File Types
download file extensions and types 173 default settings 172
Drilldown reports 142 file types
DSS. see Data Source Splitter download files 173
dynamic pages stream files 173
about 83 files
using URL parameters to track 100 wt_remote.err 265
dynamic sites wtrs.audit 266
using Drilldown reports 142 filter elements
Ad Views and Clicks 123

Address 121 FTP cache directory 175
Authenticated User Name 123 FTP timeout 175
Browser 124 FTP paths, specifying 175
Campaigns 119 FTP timeout, specifying length 175
Cookie 125 Full-featured Analysis
Day Of The Week 125 defined 233
Directory 125 specifying as Profile Type 46
Entry Page 118
File 127 G
Hour Of Day 128
Multi-homed Domain 129 general errors, investigating with wtrs.err file
Referrer 120 265
Return Codes 129 general section of Parent-Child configuration
URL 130 file 241, 245
filters General settings
about 109 defaults 175
adding to custom reports 145 per profile 48
applying to profiles 116 GeoTrends
combining 109 about 59
creating a Hit filter 113 installing 37–38
creating a Visit filter 110 UNIX installation 183
deleting 116 using in Drilldown reports 142
editing 115 using to resolve company location 59
Exclude, defined 109 GET HTTP Method defined 128
Hit, defined 110 Getting Started Tutorial 20
Include, defined 109 global cache
specifying user access 186 deleting log files from 174
using through WebTrends Map 209 storing remote log files in 173
Visit, defined 110 storing uncompressed log files in 171
folder name, for report content 158 trimming size 174
frequency global user access settings 186
for reports 66, 182 GMT offset
FTP cache directory 175 managing 48
FTP connection methods 175 overriding for processing reports 176
FTP Log File Cache graphs, including in reports 159
default settings 173 grouping pages
FTP Options with URL search and replace 105
default settings 174 grouping pages with content groups 88
FTP options
Index 279
H converting to Word or Excel 165
hard drive space, saving to optimize perfor- I

mance 262
HEAD HTTP Method defined 129 identification method
headers for reports entry page 193
default settings 179 preferred 193
specifying per profile 63 referrer 193
Help Cards ignore section of Parent-Child configuration
about 167 file 242, 246
describing in Dimensions 140 images
describing in Measures 135 in report headers 64
describing in Scenario Analysis definitions in reports 179
95 used by campaigns 194
including in templates 159 Include filters 109
help, accessing 20 initial start time for reports 66, 182
history of visitors 67 initialization errors
Hit filters profiles fail to initialize 264
about 110 troubleshooting 263
Ad Views and Clicks 123 web server fails to initialize 263
adding 113 installing
Address 121 add-ons 41
Authenticated User Name 123 on Linux platform 29
Browser 124 on Solaris platform 29
Cookie 125 pre-installation checklist 23
Day Of The Week 125 product add-ons 41
deleting 116 silently 269
editing 115 system requirements 23
File 127 upgrades 36
Hour Of Day 128 WebTrends Map 198
Multi-homed Domain 129 WebTrends software on Windows 2000/
Return Codes 129 XP platform 27
URL 130 WebTrends software on Windows NT plat-
Home profile settings 53 form 25
Hour Of Day Hit filters 128 Internet Resolution
HTML page titles defaults settings 176
retrieving 176 specifying per profile 58
retrieving for reports 49 intervals for reports 66
HTML reports

Intranet Domains 90–91 Linux platforms
investigating errors installing on 29
using wt_remote.err file 265 silent install 269
using wtrs.audit file 266 system requirements 24
using wtrs.err file 265 uninstalling from 38
with the profile status log 266 List Archives command 79
IP addresses List Of Servers profile settings 51
resolving 58, 176 listing profiles
resolving for company location information associated with Advanced Features 108
177 associated with custom reports 153
resolving for demographic information associated with filters 118
177 Locale
specifying resolution mode 177 default settings 177
using to track sessions 97 specifying per profile 61
IP filters Log Data Sources
for Child profiles 247 specifying per profile 52
it filters log files 155
Directory 125 accessing through mapped drives 264
common format sample 156
J contents of 155
path format examples 72
job queues resolving IP addresses 58, 177
managing profile processing 160 sample 156
using to stop processing 160 specifying paths 52
specifying storage method 47
splitting based on domain 220
L splitting based on URL 220
language Log Out
default to use in reports 159 of WebTrends software 34
used in report templates 159
used in reports 165 M
launching WebTrends software 33
licensing issues, for silent installs 271 mapped drives
limiting table size accessing log files 264
default settings 183 using with WebTrends software 264
specifying per profile 66 matching order rules for regular expressions
limiting, archives per profile 170 258
linking images in report headers 180 maximum number of simultaneous analyses
Index 281
178 by reports maintained settings 261
maximum report table elements 65 by saving hard drive space with UNIX 262
measures by storing data locally 261
about 133 by use of disk space 261
adding to custom reports 143 by use of memory 261
memory usage on UNIX platforms 262
default limiting settings 182 special configuration considerations 262
for optimal performance 261 using default configuration 263
limiting per profile 66 using Internet resolution settings 261
Microsoft Excel, converting reports to 165 using multiple servers 263
Microsoft Windows 2000/XP with concurrent analyses setting 261
assigning user rights 28 Options
configuring software services 28 Archiving 169
silent install licensing issues 273 Compressed Log File Cache 170
uninstalling from 38 Database Directory 171
Microsoft Windows NT Domain 172
assigning user rights 26 File Types 172
configuring software services 26 FTP Log File Cache 173
silent install licensing issues 273 FTP Options 174
uninstalling from 38 General settings 175
Microsoft Word, converting reports to 165 GeoTrends UNIX installation 183
Multi-homed Domain Hit filters 129 Internet Resolution 176
multiple machines site configuration 48 Locale 177
Performance 178
N Profiles 178
Proxy 179
new folder, creating in report contents 158 Report Templates 180
numeric alignment, in reports 160 Reports 181
Scheduler 182
Table Limiting 182
O ordered list of steps, adding 95
on-demand analysis 75
online help P
accessing 20
operating systems, tracking usage 90 page expression
optimizing performance for entry page 193
by maintaining databases on separate ma- for referrer 193
chine 263 Parameter Analysis 100–104

parameter match per-profile cache
defining for session tracking 99 downloading log files 174
using to track visitor sessions 97 limiting size 174
parameters 84 storing remote log files in 174
examples of values 84 port web server setting 262
Parent profiles POST HTTP Method defined 128
adding 238 Post-processing profile settings 61
defined 232 Pre-processing profile settings 62
Parent-Child configuration file 240–246 primary dimension
Parent-Child profiles of a custom report 133
about 234 using with custom reports 135
adding Child profiles 246 priority
adding Parent profiles 238 for reports 66
benefits 232 of profile analysis and reporting 182
command line utilities 251 Product Definitions
configuration file 235 about 191
configuring 49 for campaigns 195
customizing Child profiles 250 product features 17
directory names 236 product updates 36
editing Child profiles 248 Profile Access, specifying per profile 63
executing 235 profile directories, default settings 178
Express Analysis defined 233 profile initialization failures, possible causes
file names 236 264
Full-featured Analysis defined 233 profile level settings, for user access 186
how they work 234 profile name, specifying 48
IP filters use 247 profile processing
limitations 237 arranging profiles order 161
location of split log files 236 managing 160
Parent profile report 251 stopping 160
specifying as profile type 46 stopping all 160
splitting by URL sample 243 profile status
terminology 232 monitoring 77
types of Parent profiles 233 stopping automatic updates 77
viewing Child profiles 249 profile status log, using to investigate errors
passive FTP connection method 175 266
Path Analysis 92–93 Profile Type settings 45
using through WebTrends Map 204 profile-level user access settings
Performance add profiles 186
default settings 178 delete profiles 186
Index 283
edit profiles 186 Profile Type settings 45
view reports 186 re-analyze 76
profiles removing from waiting queue 161
adding 44 Report Header settings 63
Advanced Features settings 55 Report settings 65
advanced settings 55 Report Template settings 64
analyzing from a specific date 48 restoring from archive 79
analyzing on-demand 75 role in creating reports 158
applying filters 116 Scheduler settings 66
archiving 78 Site Configuration profile settings 47
Campaign settings 56 Site Logs settings 47
changing view of list 70 specifying database directory 171
clearing data from 77 stop processing 160
copying 69 stop processing all 160
Custom Report settings 56 stopping analysis 76
Database Directory settings 57 stopping auto-status updates 77
deleting 69 Summary settings 54
directory setting 178 Table Limiting settings 66
disabling 48 updating with WebTrends Map 197
editing settings 68 using filters with 109
enabling 48 Visitor History settings 67
enabling archiving for 170 profiles list
Filter settings 57 changing view of 70
General settings 48 profilex section, of Parent-Child configuration
giving users permission to add 186 file 242, 246
giving users permission to delete 186 Proxy
giving users permission to edit 186 deafult settings 179
Home settings 53 proxy
Internet Reolution settings 58 defining settings for 179
limiting archives for 170 public access to reports 187
List Of Servers settings 51 purchase process, tracking 94
list of settings, list of profile settings 44 PUT HTTP Method defined 128
Locale settings 61
locating with search bar 70 Q
Log Data Source settings 52
Post-processing settings 61 qualifying characters
preparing for analysis 44 examples for regular expressions 255
Pre-processing settings 62 of regular expressions 255
Profile Access settings 63

queues using in campaign definitions 193
current analysis 160 remote log files
job 160 downloading when changes detected 174
waiting 161 selecting a caching method 173
QuickTime, supported streaming media server storing in global cache 173
47 storing in per-profile cache 174
report calendar 163
R report errors, investigating with wtrs.err file
265
RealMedia, supported streaming media server Report Header
47 default settings 179
Re-analyze command 76 specifying per profile 63
re-analyze profiles 76 report tables
referrer default maximum number of elements 181
defining filter element 111 maximum number of elements per profile
examples 193 65
identification method 193 Report Templates 158–160
using to track campaigns 193 giving users access to 186
Referrer Visit filters 120 selecting when viewing reports 165
referring page specifying defaults for new profiles 180
examples 193 specifying per profile 64
using to track campaigns 193 report types
refresh profiles list 71 specifying per profile 65
registering reports
in trial mode 35 aligning numbers in 160
the purchased product 35 comparing 164
WebTrends software 34 converting formats 165
registration pages, monitoring 94 country of origin 177
regular expressions custom. see Custom Reports
basic syntax elements 253 Drilldown 142
comparing with wildcards 259 enable public viewing 63
components 253 frequency of updates 66
examples of qualifying characters 255 generation and storage default settings 181
examples of syntax elements 253 generation and storage settings per profile
examples of usage 257 65
matching order rules 258 Help Card settings 159
qualifying characters 255 images in headers 179
testing 193 profiles’ role in creating 158
retrieving web page titles 49
Index 285
scheduler default settings 182 search bar
scheduling per profile 66 using to locate profiles 70
searching time periods to view 164 Searchable Month and Year list 164
start time for generating 182 secondary dimension, of a custom report 133
stopping analysis 76 Select Report Dates Nearest Today icon 164
style specifications 159 server add-ons, installing 41
template configuration 158 Server and Client GeoTrends installation 37
template management default settings 180 server connection errors, investigating with
template management per profile 64 wtrs.err file 265
time offset 49 servers, managing from profiles 51
troubleshooting incorrect dates 268 Session Tracking 97–100
using word wrap 159 Shopping Cart definitions 195
view with report calendar 164 about 191
viewing 162 shopping cart sequence
requirements, system 23 using URL search and replace with 105
resolution modes, specifying for IP addresses shopping cart sequence, tracking 94
177 Shutting Down
response file WebTrends software 34
for installing as root 270 silent installation 269–273
sample 270 simultaneous analyses, maximum number 178
restore archived profiles 79 single machine site configuration 48
restrictions for user access 186 Site Configuration, profile settings 47
return codes Site Logs, profile settings 47
list of pre-defined 129 Solaris platforms
managing in post-processing 62 installing on 29
managing in pre-processing 62 silent install on 269–271, ??–273
Return Codes Hit filters 129 system requirements 24
uninstalling from 39
S split field
defined 233
Scenario Analysis 94–97 specifying in DSS definitions 220
using through WebTrends Map 207 split log directory, specifying for DSS defini-
Scheduler tions 220
default settings 182 split log file, defined 233
specifying per profile 66 split tolerance, specifying for DSS definitions
SDC 220
using Drilldown reports 142 split_only section, of Parent-Child configura-
search and replace, URL strings in reports 104 tion file 243
splitting Parent-Child log files

by domain name 240 system requirements 23
by URL 243 for browsers 25
Stand-alone GeoTrends installation 37 for Microsoft Windows platforms 24
standard profiles, adding 44 for silent install 269
start date, specifying for campaigns 194 for Solaris platform 24
starting time for reports 66
starting up WebTrends software 33 T
status
monitoring for profiles 77 Table Limiting
status menu default settings 182, 183
Stop Auto Status command 77 specifying per profile 66
status menu, Profile Status command 77 templates, report 158–160
steps, adding 95 giving users access to 186
stop all profile processing 160 selecting when viewing reports 165
Stop Analysis command 76 specifying defaults for new profiles 180
Stop Auto Status command 77 specifying per profile 64
stop processing selected profile 160 testing
stream file extensions and types 173 regular expressions 193
streaming media servers url replacement definitions 106
selecting default templates for profiles 180 time intervals
specifying per profile 46 selecting for viewing report 164
specifying profile type 45 specifying for report generation, per profile
supported types 47 65
style time zone
applying to reports 159 about GMT offset 49
used in report templates 159 correcting in reports 268
sub-directories, including/excluding with di- specifying for reports 176
rectory filter 127 timeout, for user session 262
summary of profile settings 54 title, adding to reports 63
Sun Solaris platforms Top Domain Names, limiting table size 67
installing on 29 Top Pages, limiting table size 67
silent install on 269–271, ??–273 Top Visitors, limiting table size 67
system requirements 24 tracking, Advertising Views 81
uninstalling from 39 translation files 103
supported streaming media servers 47 translation files for parameters 103
syntax for regular expressions 253 trial mode, registering 35
system performance troubleshooting
improving 178 conflicting file permissions 263
settings 178
Index 287
dates in reports 268 defining URL parameter for 130
Error 500 Server Error 267 deleting URL parameter from 131
initialization errors 263 editing URL parameter 131
investigating errors 265 URL Hit filters 130
profile initialization failures 264 URL match
reviewing activity logs 265 defining for session tracking 98
using the profile status log 266 using to track visitor sessions 97
using wt_remote.err file 265 URL Parameter Analysis 100–104
using wtrs.audit file 266 URL parameters 84
using wtrs.err file 265 adding to URL filter element 130
web server initialization failure 263 deleting from URL filter element 131
WebTrends software 263 editing in URL filter element 131
Tutorial 20 examples of values 84
typographic conventions for this guide 18 filtering on 112
URL Search and Replace 104–106
U URL string, searching and replacing in reports
104
uncompressed log files, deleting after analysis user access 185–189
171 per profile settings 63
uninstalling to Child profiles 248
from Linux platform 38 user accounts, configuring access 185
from Solaris platform 39 user rights
from Windows 38 assigning on Windows 2000/XP 28
WebTrends software 38 assigning on Windows NT 26
UNIX platforms user sessions
optimizing WebTrends software perfor- filtering 110
mance 262 logging out 34
usesymlinks option 262 timeout server setting 262
using GeoTrends with 183 user’s guide, downloading 19
UNKNOWN HTTP Method defined 129 users, managing 185–189
updates
checking for 36 V
stopping auto-status updates 77
upgrades, installing 36 version upgrades, installing 36
URL view reports
specifying root of web site 53 giving users access to 186
splitting log files sample 243 user access settings 186
URL filter element view reports permissions 189

virtual domains, managing 221 web site URL
Visit filters about 54
about 110 specifying root of web site 53
adding 110 webhouse
Campaigns 119 storing log files in 47
deleting 116 WebTrends Desktop 162
editing 115 WebTrends Document Utility 165
Entry Page 118 WebTrends Getting Started Guide, download-
Referrer 120 ing 19
Visitor History, specifying per profile 67 WebTrends Map
visitor sessions, tracking length 97 about 197
browser modifications 198
W Campaigns 206
configuring 200
waiting queue, managing 161 Content Groups 205
web activity log files 155 features to edit 203
sample 156 Filters 209
web page titles installing 198
retrieving for reports 49 launching 203
web server Path Analysis 204
selecting default templates for profiles 180 Scenario Analysis 207
specifying per profile 46 starting up 203
specifying profile type 45 toolbar 204
web server errors, investigating with using 204
wt_remote.err file 265 WebTrends software service
web server log files 155 configuring on Windows 2000/XP 28
sample 156 configuring on Windows NT 26
web server settings WebTrends software, purchasing 35
authentication 262 WebTrends Warehouse, storing log files in 47
configuring 261 week, defined for processing 180
port 262 wildcards
user session timeout 262 comparing with regular expressions 259
web site configuration matching strings 119
on multiple machines 48 Windows 2000/XP
on single machine 48 assigning user rights 28
specifying single or multiple servers 47 configuring software services 28
web site location, specifying 177 uninstalling from 38
web site logs, specifying where stored 47 Windows 2000/XP platforms
installing WebTrends software on 27
Index 289
silent installation on 272 installing WebTrends software on 25
Windows Media, supported streaming media silent installation on 272
server 47 Word
Windows NT converting reports to 165
assigning user rights 26 word wrap, using in reports 159
configuring software services 26 wt_remote.err file, using to investigate errors
uninstalling from 38 265
Windows NT platforms wtrs.audit file, using to investigate errors 266
accessing log files via mapped drives 264

NetIQ TD WRC Admin Guide

Caricato da

Informazioni sul documento

Descrizione originale:

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

NetIQ TD WRC Admin Guide

Caricato da

Copyright:

Formati disponibili

Reporting Service–Enterprise Edition v6.

Reporting Center–Enterprise Edition v6.1

Log Analyzer–Advanced Edition v8.1

October 2003 Edition

viii Administrator’s Guide

xii Administrator’s Guide

Index .................................................................................................... 275

xiv Administrator’s Guide

About WebTrends software

How to use this guide

Table 1-1. Edition Icons

This icon: Represents this product:

WebTrends Reporting Center - Enterprise Edition

WebTrends Reporting Service - Enterprise Edition

WebTrends Reporting Center - e-Business Edition

WebTrends Reporting Service - e-Business Edition

Log Analyzer - Advanced Edition

How WebTrends Software Works

WebTrends Software Features

New and Improved Features in This Version

Documentation and Help

This text Represents

Lucinda Source code examples, program output, or anything typed by the

“in quotes” The title of a chapter or section.

Making documentation available to non-administrators

To download the .pdf version of this manual:

Getting help in the program

About NetIQ Corporation

Product Accessories and Plug-ins

Security Management and Administration

VoIP Management and Network Testing

Web Analytics and Management

Windows and Exchange Management

Table 1-3. Support Contact Information

Department Contact Information

Sales E-mail info@netiq.com

NetIQ Web site www.netiq.com

Before You Begin

• Installation and Setting Up 23

Minimum Screen Resolution

Installing WebTrends software

where X is the drive letter of your CD-ROM drive.

• Installation and Setting Up 25

Configuring WebTrends software service

Giving your user account necessary rights

Installing on Windows 2000/XP

Installing WebTrends software

where X is the drive letter of your CD-ROM drive.

• Installation and Setting Up 27

Giving your account necessary rights

Installing on Linux and Solaris

• Installation and Setting Up 29

To install WebTrends software using the installation script:

to change to the tempdirectoryname directory location.

to copy the files and directory to the temporary installation directory.

to uncompress the files.

to extract the files from the .tar file.

to change to the wt-wrc-6.1 directory location.

The installation begins.

Important: If a message displays with the heading “PREVIOUS VERSION WARNING,”

• Installation and Setting Up 31

Running WebTrends software