If you’re trying to troubleshoot an error in your SharePoint 2013 environment and you’ve been struggling to find the error in the logs, you’re going to love this free utility from Microsoft that lets you quickly and easily monitor your SharePoint 2013 trace logs. Today I’ll introduce you to ULS Viewer, I’ll show you how to download it, and I’ll share some configuration tips.
ULS Viewer is a free utility created by Microsoft that runs on your SharePoint server and connects to the log files that are created by SharePoint 2013. It actually works on previous versions of SharePoint just as well as it does on 2013. You can download and run ULS Viewer on the SharePoint server, or it can run on your workstation and connect to the SharePoint logs from across the network.
When run on a SharePoint server, ULS Viewer can automatically connect to the SharePoint logs on the local server. If you run it from your workstation, it takes just a couple of extra steps to connect from across the network. You can also connect to more than one server to get a look at the bigger picture. All in all, ULSViewer is a great utility for any SharePoint administrator.
The only catch is that the software is offered with no support. If it doesn’t work for you for some reason, Microsoft isn’t going to put in effort to resolve your issues with it. That said, it works for most people; even if you do run into problems with it you may be able to get a fix for it from the user community.
Lucky you can download the ULSViewer from Microsoft for free. If you’re looking for installation steps, there’s not much to it. Just download it and run the executable.
If you have a single server farm, you can go straight to the server and run ULSViewer from there. Just move the ULSViewer executable to the server and run it.
This is where the ULS Viewer really shines. Since you’re able to connect across servers, you can see all of the logs from all of your SharePoint servers in real time without having to collate or switch between RDP sessions!
You’ll now be connected to your SharePoint servers and will start getting real time updates to all of your SharePoint 2013 events.
Here’s how I use ULS Viewer to get a really fast look into what’s going on in the SharePoint logs.
Notifications can be used to give you a popup notification when a specific event occurs.
If you’re looking away or don’t have the window active, your notifications window will give you a popup that indicates you have new events. The notifications window is collected from all open tabs.
You can choose many different filtering options for your notification list. The default adds only critical events to your notifications list, but you could very easily include only notifications from a specific product, category, or correlation ID by choosing Tools >> Notification Filters from the menu.
Just like the filters that you can add to the notifications tab, you can apply filters to any of the tabs in your workspace.
Available keys to filters on are Time, Process, Thread, Product, Category, EventID, Level, Correlation, Message and Server. You can use the operation tab column to specify Equals, Not Equals, Contains, Not Contains, a Regex Match, or Greater or Less than a specific time. Then you can set your value to compare in your filter. Finally, you can specify whether your filtering conditions have to match all of your rules or whether being “true” on even a single condition means will apply the filter.
On each open tab, you can add a correlation tree that lists all of the correlation ID in a tree view and lets you quickly scan through just the correlation IDs. Find the correlation ID you’re looking for and select it to get all of the events that have that same ID. This is a really fast way to find out what’s going on with a repeatable error that you or one of your users is experiencing. To enable the correlation ID tree, you can click the Correlation ID Tree View icon from the toolbar menu.
If you prefer to always have the correlation ID tree view enabled, you can make it enabled by default from the Tools >> Options menu.
Running the ULS Viewer does take up some resources, so you should close out your sessions when you’re not using them anymore.
If you forget to close out your sessions, you’ll get a notice at the two-hour mark to let you know that your session should be closed out, and if you’re still using it to close out the tabs and re-open them.