Enable Diagnostic Logging on a Unified Messaging Server

  • Article

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

You can use EMC, Shell or a registry editing tool to enable diagnostic logging on a Microsoft Exchange Server 2010 Unified Messaging (UM) server. By default, diagnostic logging is enabled on a UM server but is set to the lowest level. However, if you're troubleshooting an issue on a UM server, you may have to increase the diagnostic logging level to help you locate the source of the problem.

Event Viewer maintains logs about program, security, and system events on your computer. These logs include errors and events that occur on a UM server. You can use Event Viewer to view and manage the event logs, gather information about hardware and software problems, and monitor Unified Messaging errors and events. Although Event Viewer is a Microsoft Windows operating system tool and not a Microsoft Exchange tool, Event Viewer is useful when you troubleshoot problems with Unified Messaging. For more information about Unified Messaging errors and events, see Error and Event Reference for Unified Messaging Servers.

Warning

Incorrectly editing the registry can cause serious problems that may require you to reinstall your operating system. Problems resulting from editing the registry incorrectly may not be able to be resolved. Before editing the registry, back up any valuable data.

Looking for other management tasks related to UM servers? Check out Managing Unified Messaging Servers.

What Do You Want to Do?

  • Use the EMC to set logging levels

  • Use the Shell to set logging levels

  • Use the Registry to set logging levels

Use the EMC to set logging levels

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Shell infrastructure permissions" section in the Exchange and Shell Infrastructure Permissions topic.

  1. In the console tree, navigate to Server Configuration > Mailbox.

  2. In the Actions pane, select Manage Diagnostic Logging Properties.

  3. On the Manage Diagnostic Logging Properties wizard page, click the Exchange service for which you want to change the logging level.

  4. Select the logging level, and then click Configure.

    Note

    You can return to the default logging levels by selecting Reset all services to default logging levels and then clicking Configure.

  5. On the Completion page, confirm whether the process completed successfully. A status of Completed indicates that the wizard completed the task successfully. A status of Failed indicates that the task wasn't completed. If the task fails, review the summary for an explanation, and then click Back to make any configuration changes.

  6. Click Finish to complete the Manage Diagnostic Logging Level wizard.

Use the Shell to enable diagnostic logging on a Unified Messaging server

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Shell infrastructure permissions" section in the Exchange and Shell Infrastructure Permissions topic.

This example enables diagnostic logging for the UMCore DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMCore" -level <Lowest | Low | Medium | High | Expert>

This example enables diagnostic logging for the UMWorkerProcess DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMWorkerProcess" -level <Lowest | Low | Medium | High | Expert>

This example enables diagnostic logging for the UMManagement DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMManagement" -level <Lowest | Low | Medium | High | Expert>

This example enables diagnostic logging for the UMService DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMService" -level <Lowest | Low | Medium | High | Expert>

This example enables diagnostic logging for the UMClientAccess DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMClientAccess" -level <Lowest | Low | Medium | High | Expert>

This example enables diagnostic logging for the UMCallData DWORD value.

Set-EventlogLevel "MyUMServer\MSExchange Unified Messaging\UMCallData" -level <Lowest | Low | Medium | High | Expert>

This example lets you see the current logging level for a Unified Messaging server.

Get-EventlogLevel "MyUMServer\MSExchange Unified Messaging"

For more information about syntax and parameters, see Set-EventLogLevel.

Use Registry Editor to enable diagnostic logging on a Unified Messaging server

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "UM server" entry in the Unified Messaging Permissions topic.

  1. Start Registry Editor (regedit).

  2. Locate the following registry key: HKeyLocalMachine\System\CurrentControlSet\services\MSExchange Unified Messaging\Diagnostics

  3. In the details pane, double-click the appropriate registry value, and then use the following values to configure the appropriate logging level:

    Logging level Value

    Expert

    7

    High

    5

    Medium

    3

    Low

    1

    Lowest

    0

Other Tasks

After you enable diagnostic logging on a Unified Messaging server, you may also want to:

 © 2010 Microsoft Corporation. All rights reserved.