Adding Logs
The Logs container features insert a secondary navigation bar item entitled Logs under the Maintenance primary navigation bar item on the server appliance Web UI. The Logs tab links to a navigation page which displays a link to each log that is available on the server appliance. Each log's link will typically lead to either an area page — if it is a single file, simple text log — or to an to an Object/Task Selector page if it is a multifile log or is not a simple text file. The Object/Task Selector page will lead to an area page for the selected log file. The area page allows the user to view the log, clear it, download it, or change the logging properties.
Each entry into the Logs page is defined by an element in the TabsMaintenanceLogs container. These entries are made in the registry under the HKLM\Software\Microsoft\ServerAppliance\ElementManager\WebElementDefinitions registry key.
The following table shows the possible values for the Logs page.
Value | Type | Description | Example |
---|---|---|---|
ElementID | Key | Unique identifier for this log.
Must start with TabsMaintenanceLogs and have <LogName> added. |
TabsMaintenanceLogsWebAdministration |
Container | String | TabsMaintenanceLogs | TabsMaintenaceLogs |
CaptionRID | String | Caption resource identifier for the display name of the log. | 0x40450009 |
DescriptionRID | String | Resource identifier for the description of the log | 0x4045000A |
Source | String | Name of the resource DLL for this log. | salogs.dll |
URL | String | Relative path (from Web root) to the area page file or Object/Task Selector page file for this log element. | If using the generic log area or Object/Task Selector pages, these will be Logs/Single_Log_Details.asp?logtitle=<ElementID>
-Or- Logs/Multiple_Log_Details.asp?MultiSelect=1 & Title=<ElementID>. |
ElementGraphic | String | Icon for this log. | |
Merit | DWORD | Integer indicating sort order in the container | Order logs appear in the list (0=no sorting) |
IsEmbedded | DWORD | 0 (Do not process as embedded page) | |
PropertiesURL | String | Relative path (from Web root) to the property page asp file for this log. Optional. | |
DirectoryPath | String | Absolute path to the log file directory. | %systemroot%\system32\LogFiles\W3SVC1 |
FileName | String | Two cases apply:
Single file log–This value is the name of the log file. Multiple file log–A regular expression representing the template for finding files in the DirectoryPath. |
* is all files
ex*.log is all files that start with the characters ex and end with .log |
The display name for the log is found in the resource DLL using the CaptionRID and the description is found in the resource DLL using the DescriptionRID. The link to the properties page for a given log is found in the PropertiesURL field. If PropertiesURL is empty, then the Properties button will not appear on the area page and the Properties task should not appear on the Object/Task Selector page.