Configuring the eG Agent to Monitor the Web Transactions to Web Sites on an IIS Web Server Operating on Windows 2008

To perform web site transaction monitoring on an IIS web server executing on Windows 2008, you need to install and configure Advanced Logging on the target IIS web server, soon after you create the Web Server role on the Windows 2008 server. 

IIS Advanced Logging is an extension for Internet Information Services (IIS) 7 that provides enhanced data collection and real-time server and client-side logging capabilities. It can be managed by using IIS Manager and other tools that can work with the IIS 7 configuration system.

The Advanced Logging feature supports complex Web and media delivery scenarios that demand flexibility and control. These scenarios may require custom logging fields, real-time access to data, greater control over what gets logged and when, extensibility for new sources of data, the ability to consolidate log data posted by clients and correlate it to server data, the option of sharing data from various sources and storing it in multiple logs, capturing system-state information, inclusion of canceled requests in logs, and even logging multiple times per request.

In order to monitor the web transactions to IIS 7 (that is bundled with the Windows 2008 server), the eG agent requires that the Advanced Logging be installed and configured on IIS 7. The steps in this regard have been discussed below:

  1. Login to the IIS host.
  2. Download the executable that installs the Advanced Logging feature from any of the following URLs, depending upon whether the IIS 7 installation is a 32-bit one or a 64-bit one:

    32-bt/64-bit URL
    32-bit HTTP://www.microsoft.com/downloads/en/details.aspx?FamilyID=4d110e78-95cb-4764-959c-b8afc33df496&displaylang=en
    64-bit HTTP://www.microsoft.com/downloads/en/details.aspx?FamilyID=793051A8-36A0-4342-BDFE-47A6B0E3488F
  3. Once the download is complete, go to the directory to which the executable was downloaded and double-click on it.
  4. Figure 1 will then appear. Accept the license by selecting the I accept the terms in the License Agreement check box, and click on the Install button to proceed with the installation.

    Figure 1 : Accepting the license agreement

  5. Once the installation ends, Figure 2 will appear indicating the successful installation of the Advanced Logging feature. Click the Finish button to exit the wizard.

    Figure 2 : Finishing the installation

  6. Next, proceed to configure the Advanced Logs. For that, first, open the Internet Information Services (IIS) Manager console using the menu sequence: Start -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager. Figure 3 will then appear.

    Figure 3 : The Internet Information Services (IIS) Manager console

  7. Click on the node representing the IIS web server host in the tree-structure in the left panel of the console. The right panel will change to display a variety of options. In the iis section of the right panel, click on the Advanced Logging option. Figure 4 will then appear. In the Actions list in the right panel, click on the Add Log Definition option (as indicated by Figure 4) to add a new log definition.

    Figure 4 : Viewing the list of log definitons that pre-exist

  8. In the Log Definition page that appears, specify WebAdapterFile as the Base file name. Check the Enabled option, the Publish real-time events option, and the Write to disk sub-option.

    Figure 5 : Adding a new log file definition

  9. Then, click on the Select Fields button at the bottom of the Log Definition page to select he server-side and client-side logging fields to be logged in the specified log file. Doing so will invoke Figure 6, from which you wil have to select the following fields:

    • UserName
    • URI-Stem
    • URI-QueryString
    • Time-Local
    • Time Taken
    • Status
    • Server-IP
    • Server Port
    • Server Name
    • Site Name
    • CPU-utilization
    • Bytes Sent
    • Bytes Received
    • Host
    • Client Ip
    • Date-local

    Figure 6 : Selecting the logging fields to be logged

  10. Click on the ok button in Figure 6 to confirm the selection. When this is done, the Selected Fields section of the Log Definition page will get updated with your selection (see Figure 7). Use the Move First, Move Up, Move Down, and Move Last buttons adjacent to your selection to re-arrange the sequence of the logging fields. The desired sequence is as follows:

    • Time-Local
    • Host
    • Server-IP
    • Server Port
    • Status
    • URI-stem
    • URI-QueryString
    • CPU-utilization
    • Bytes Sent
    • Bytes Received
    • Time Taken
    • Server Name
    • Site Name
    • User Name
    • Client Ip
    • Date-local

    Figure 7 : Re-arranging the sequence of the logging fields

  11. Then, apply the changes by clicking on the Apply button indicated by Figure 7 above. Once the changes are saved, click on the Return to Advanced Logging option indicated by Figure 7 above. Figure 8 will then appear. In the right panel of Figure 8, you will find that the newly added WebAdapterFile is appended to the list of log file definitions that pre-exist.

    Figure 8 : The newly added log definition displayed in the list of log files that pre-exist

  12. Now, select the WebAdapterFile entry in Figure 8 and click on the Edit Log Directory option in the Actions list, as indicated by Figure 8. When Figure 9 appears, change the default values of the Server log directory and Default site log directory text boxes to <eg_install_dir>\agent\logs\IISAdvlogs directory. Then, click the ok button therein.

    Figure 9 : Changing the server log and default site log directories

  13. You will then return to Figure 8. Select the WebAdapterFile entry yet again, and this time, click on the View Log Files option in the Actions list. This will invoke Figure 10, where all the log files saved to the <eg_install_dir>\agent\logs\IISAdvlogs directory will be displayed.

    Figure 10 : List of log files saved to the AdvancedLogs directory

  14. To view a log file, click on any of the log files in the list of Figure 10. The chosen log file will then open in Notepad as depicted by Figure 11.

Figure 11 : Viewing the log file