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 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.

You can use Advanced Logging to extend logging functionality for logging user requests and client data in the following ways:

Installation Notes

This section describes the installation requirements for IIS Advanced Logging.

Requirements

The following prerequisites must be fulfilled to install IIS Advanced Logging:

  • You must use IIS 7 running on one of the following operating systems:

    • Windows Server 2008

    • Windows Server 2008 R2

    • Windows Vista with SP1

    • Windows 7

  • To manage the Advanced Logging feature using the IIS Manager user interface, the IIS Management Console for IIS must be installed.

  • You must be an administrator on the computer. This can be accomplished by logging on to the computer using either the Administrator account or an account with administrative privileges.

Note
Advanced Logging cannot be installed if the previous version of the software (IIS Advanced Logging 1.0 – Beta) is installed on your computer. When you uninstall the Beta Advanced Logging software, your log definitions and any log files that have been created will be retained; however, other program settings may not be retained.

To uninstall the software, in Control Panel > Programs > Programs and Features, under Uninstall or change a program, click IIS Advanced Logging, and then click Uninstall.

Downloading and Installing

IIS Advanced Logging can be installed by using either Microsoft Web Platform Installer 2.0 (Web PI) or Windows Installer.

Install Using Web PI

  1. Go to the Microsoft Web Platform Installer 2.0 Web Page and click Download It Now to download and run Web Platform Installer 2.0.

  2. In the lower-left corner of the Web Platform Installer 2.0 dialog box, click Options.

  3. In the Change Options dialog box, under Display additional scenarios, make sure that the Media check box is selected, and then click OK.

  4. In the Web Platform Installer 2.0 dialog box, on the Media Platform tab, under Host and Deliver Media Content, click Customize.

  5. Select Advanced Logging 1.0, and then click Install.

Install Using Windows Installer

Two separate downloadable installation packages are available for IIS Advanced Logging. Click one of the following links to download the Windows Installer (.msi) file for your edition of Windows:

To run the Windows Installer file that you downloaded, do the following:

  • Double-click the Windows Installer (.msi) file that you downloaded, and then complete the Setup wizard.

-or-

  1. Open an elevated command prompt (click Start, click All Programs, click Accessories, right-click Command Prompt, and then click Run as administrator).

  2. In the Administrator: Command Prompt window, navigate the command prompt to the folder where the Windows Installer (.msi) file is stored.

  3. Type one of the following commands to run the installation: msiexec /I AdvancedLogging32.msi (for the 32-bit edition of the operating system) or msiexec /I AdvancedLogging64.msi (for the 64-bit edition of the operating system).

Note
If you encounter any problems during installation, type one of the following commands in the command prompt to create a log file that contains information about the installation process: msiexec /L AdvancedLogging.log /I AdvancedLogging32.msi (for the 32-bit edition of the operating system) or msiexec /L AdvancedLogging.log /I AdvancedLogging64.msi (for the 64-bit edition of the operating system).

Analyze this log file after a failed installation to help determine the cause of the failure.

Uninstalling

To remove the Advanced Logging feature, in Control Panel > Programs > Programs and Features, under Uninstall or change a program, click IIS Advanced Logging 1.0, and then click Uninstall.

Known Issues

This section describes the known issues for IIS Advanced Logging.

  • Applying configuration changes in IIS Manager. If you change an Advanced Logging setting in IIS Manager and the change does not take effect, you may need to restart the Web server:



    1. In IIS Manager, in the Connections pane, click the server name.

    2. In the Actions pane, click Restart.



    This issue may occur if you change Advanced Logging settings while the feature is actively logging requests.



  • Enabling and disabling logging for Web sites. The Advanced Logging feature can be enabled or disabled at the server level in IIS Manager, which also enables or disables logging at lower levels (matching the server-level setting). If you want to disable logging for certain Web sites or directories, while enabling logging for others, enable the Advanced Logging feature at the server level, and then disable the log definition files for the Web sites/directories for which you want to disable logging. To disable a log definition, do the following:



    1. In the Connections pane, click the Web site or directory for which you want to disable logging.

    2. In the Web site or directory Home page, double-click the Advanced Logging icon.

    3. In the Advanced Logging feature page, click the log definition, and then in the Actions pane, click Edit Log Definition.

    4. In the Log Definition page, clear the Enabled check box.

    5. In the Actions pane, click Apply.

    6. Repeat steps (3) through (5) for additional log definitions, if desired.



  • Specifying the source name for custom logging fields. If you specify the same Source name for two or more custom logging fields that you add to the Available fields list, and then add all of them to a log definition, Advanced Logging will only parse the data for the last logging field displayed in the log definition's Selected logging fields list and write its data to log file. The data for the preceding logging fields that use the same source name will not be parsed and the information for these logging fields in the log file will contain a hyphen (-) character. Note that this occurs even if two logging field source names are written in a different case (for example, SOURCENAME vs. sourcename).



  • Logging string values with quotation marks. You can specify the maximum size for logging fields that record string values. Strings that are larger than this value will be truncated to the maximum size that you specify, which allows applications that have string size limits consume the data. Advanced Logging follows the W3C Extended Log File Format and surrounds string values with quotation marks, which causes further truncation of the strings that are consumed by these applications, reducing the amount of usable data.



  • Unsupported logging fields for filtering. The filtering feature cannot be used to filter logging fields that have the following log data types: TypeDate, TypeTime, TypeDateTime, TypeLPCGuid. In Advanced Logging, the following built-in logging fields are affected:



    • BeginRequest-UTC

    • Date-Local

    • Date-UTC

    • EndRequest-UTC

    • Time-Local

    • Time-UTC



    Custom logging fields that you create with these log data types cannot be filtered.



  • Creating disabled log definitions. If you create a new log definition, clear the Enabled check box to disable it, and then click Apply in the Actions pane to save the changes, the Enabled setting is reselected. Clear the Enabled check box and click Apply again to save the log definition in a disabled state.

Product Support

You can obtain support for IIS Advanced Logging by using the following resources:

Self Support

Microsoft Support

To obtain support from Microsoft, go to Microsoft Help and Support.

For More Information

To keep up-to-date with the latest Advanced Logging news and feature developments, go to the IIS Advanced Logging Home page.