This tool is used to automate the process of collecting xperf traces easy without the user worring about the various settings and configuration options.
The tool does not package XPerf.exe, perfctrl.dll, xbootmgr.exe, xbootmgrSleep.exe or xperfview.exe. Please download the Windows Performance Toolkit separately from
http://msdn.microsoft.com/en-us/performance/cc752957 and then run this tool from the same location as the files.
Why this tool?
Collecting ETW traces was never this easy. With this new utility, xperf/xbootmgr logs can be collected without breaking a sweat. Just a few clicks and the required data gets collected. You no longer need to enter complicated commands to collect the data. Just
select the kind of data/monitoring you desire and XPerf123 is going to get that data for you just like 1 - 2 - 3.
It also creates a simultaneous perfmon running at 5 seconds interval.
.NET Framework 3.0
Administrator rights on the machine.
Windows 2003/Windows Vista/Windows 7/Windows Server 2008/Windows 2008R2.
So how do I use it????
1. Follow the wizard interface of the tool.
2. From the drop down menu, select the kind of trace you want to capture.
3. Click on Start button.
4. Reproduce the issue.
5. Click on Stop button.
6. The file is will be created in the same location as the XPerf123.exe
- In Normal mode, the default paramaters for BufferSize, MinBuffers and MaxBuffers is 1024.
- It can be customized for advanced settings.
- There is option to have log the trace file in circular mode which is enabled by default. If required, it can be unchecked.
- Logs are created in the same directory by default.
- We can also save the logs to a different location then from the location where we run it from.
- It also creates a perfmon counter and starts it when we start the xperf capture.
- If Perfmon was also collected, the Perfmon logs are located in the C:\PerfLogs\ directory with the name perflognnnnnn.blg
- If we select stack walk, then the default stack walks for the respective traces will be enabled unless the user manually selects the stackwalk parameters. This is benifical for someone who wants to do stack tracing but doesn’t know what all the options to
select for stack walk.
- The creation of the registry and the reboot prompts for stack walks have been automated. In the next build, I will try to log that information as well to the log file so that we know what registries were modified or created.
- Advanced options in the xbootmgr parameters to set the Buffer Options and the Enable Property .
- The Pool Trace will only work if we are using a version of xperf that supports the feature.
What do I need to get started
We need to have all the files in the same directory as xperf123.exe -
Unless necessary, the General option should be able to get all the required information.
The program is designed to auto elevate, but if not getting the required results, please try running it as an administrator.
For reviewing XPerf logs, we need the xperfview.exe.
Starting up the Xperf123.exe
Select the kind of data collection you need
Enable Perfmon logging ( If you want )
And we are done. Click Start to start the capture