Add/Edit Logging Field Dialog Box

Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista

Use the Add Logging Field dialog box to make custom logging fields available for adding to log definitions. Use the Edit Logging Field dialog box to change the properties of the selected custom logging field.

Note

The logging fields with the Built-In source type cannot be edited.

UI Element List

Element Name Description

Field ID

Enter a friendly name for the logging field. This value is used as the logging field name when it is displayed in logging field lists in the Advanced Logging feature.

Category

Enter a category name for the related set of logging fields (for example, Custom) when you add a logging field that belongs to a related set of logging fields, or select an existing category name in the drop-down list. The Default category name in the drop-down list includes all the logging fields that are included in a default installation of the Advanced Logging feature. Assigning related logging fields to categories lets you sort them by category in the Edit Logging Fields dialog box.

Source type

Select the source of information for the logging field. Information can be provided from the following source types:

  • Module. Information published by IIS modules.

  • Performance Counter. Measurements of system state or activity provided by the operating system or individual applications near the time of a request.

  • Request Header. Standard and custom HTTP headers that are included in a client request.

  • Response Header. Standard and custom HTTP headers that are included in a response to a client request.

  • Server Variable. IIS Server Variables.

Source name

Enter the name of the source that provides the information for the logging field. For example, if the Source type is a performance counter, you can enter the name of the performance counter.

Performance counter type

Select the performance counter type in the drop-down list, if you selected a performance counter Source type. Select Rate if the performance counter provides frequency-based data, such as number of requests-per-second. Otherwise, select Other.

Advanced Properties

The Advanced Properties area of the dialog box displays the following optional elements that you can configure for custom logging fields. To display these elements, click Show Advanced Properties. To hide these elements, click Hide Advanced Properties.

Element Name Description

Log header name

Enter a unique identifier for the logging field that will be included in the #Fields directive in the log file header. If you do not specify a log header name, the Source name value is used as the unique identifier.

Default value

Enter a string value that will be recorded in the log file if the logging field contains no data. This value replaces the hyphen character that is typically used to mark missing logging field data.

Description

Enter a description for the logging field.

See Also

Concepts

Edit Logging Fields Dialog Box