base on Capture and analyze the high-level performance characteristics of graphics applications on Windows. []() [](https://github.com/GameTechDev/PresentMon/releases/latest) []() []() []() # PresentMon PresentMon is a set of tools to capture and analyze the high-level performance characteristics of graphics applications on Windows. PresentMon traces key performance metrics such as the CPU, GPU, and Display frame durations and latencies; and works across different graphics API such as DirectX, OpenGL, and Vulkan, different hardware configurations, and for both desktop and UWP applications. This repository contains several components: - The PresentData/ directory contains the **PresentMon Collection and Analysis library**: a library that performs the lowest-level collection and analysis of [ETW](https://msdn.microsoft.com/en-us/library/windows/desktop/bb968803%28v=vs.85%29.aspx?f=255&MSPPError=-2147217396) events. See [PresentData/PresentMonTraceConsumer.hpp](PresentData/PresentMonTraceConsumer.hpp) for more information. - The PresentMon/ directory contains the **PresentMon Console Application**: a standalone console application that can be used to collect CSV data from target applications. See [README-ConsoleApplication.md](README-ConsoleApplication.md) for more information. - The IntelPresentMon/ directory contains the **PresentMon Service** and **PresentMon Capture Application**: an easy-to-use GUI that can be used to collect and analyze target applications. See [README-Service.md](README-Service.md) and [README-CaptureApplication.md](README-CaptureApplication.md) for more information. There are also several other programs that build on this functionality and/or help visualize the resulting data. For example, see: - [AMD OCAT](https://gpuopen.com/ocat/) - [CapFrameX](https://capframex.com/) - [Guru3D RTSS RivaTuner Statistics Server](https://www.guru3d.com/files-details/rtss-rivatuner-statistics-server-download.html) - [Microsoft PIX on Windows System Monitor](https://devblogs.microsoft.com/pix/system-monitor/) - [NVIDIA FrameView](https://www.nvidia.com/en-us/geforce/technologies/frameview/) Binaries for the main releases of PresentMon are provided on [intel.com](https://game.intel.com/story/intel-presentmon/) or [github.com](https://github.com/GameTechDev/PresentMon/releases/latest) ([list of all releases](https://github.com/GameTechDev/PresentMon/releases)). See [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to request features, report issues, or contribute code changes. See [BUILDING.md](BUILDING.md) for information on how to build PresentMon components from source. ## License Copyright (C) 2017-2024 Intel Corporation Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ## Troubleshooting See [GitHub Issues](https://github.com/GameTechDev/PresentMon/issues) for a current list of reported issues. ### User access denied PresentMon needs to be run by a user who is a member of the "Performance Log Users" user group. If neither of these are true, you will get an error "failed to start trace session (access denied)". To add a user to the "Performance Log Users" user group: 1. Run `compmgmt.msc` as administrator. 2. In the "Computer Management" window, expand "System Tools", expand "Local Users and Groups", and then click "Groups". 3. Double-click "Performance Log Users", and then click "Add". 4. In the "Enter the object names to select" text box, type the name of the user account or group account that you want to add, and then click "OK". 5. Sign out and log back in for the changes to take effect. If PresentMon is not run with administrator privilege, it will not have complete process information for processes running on different user accounts or for processes that are short-lived. Such processes will be listed in the console and CSV as "\<unknown>", and they cannot be targeted by name (`--process_name`). ### Analyzing OpenGL and Vulkan applications Applications that report *Runtime* of "Other" (e.g., as is typical with OpenGL or Vulkan applications) have less instrumentation in the frame presentation process. As a result, *CPUFramePacingStall* will always report 0 and *CPUFrameTime* may be slightly less accurate. This inaccuracy also impacts latency calculations based off of *CPUFrameTime* (e.g., *GPUBeginLatency*, *GPUEndLatency*, and *DisplayLatency* but not *InputLatency*). ### Tracking GPU work with Hardware-Accelerated GPU Scheduling enabled GPU execution metrics are less accurate when running on a system that uses Hardware-Accelerated GPU Scheduling (HWS). When HWS is enabled, *msUntilRenderStart*, *msUntilRenderComplete*, *msGPUActive*, and *msGPUVideoActive* measurements may be later/larger than they should be. For example, in a GPU-bound scenario the frame's *msGPUActive* may be reported ~0.5ms larger than the true GPU work duration, though the specific amount of the inaccuracy will be workload- and GPU-dependent. An improved solution is WIP. ### Shutting down PresentMon on Windows 7 Some users have observed system stability issues when forcibly shutting down PresentMon on Windows 7. If you are having similar issues, they can be avoided by using Ctrl+C in the PresentMon window to shut it down. ", Assign "at most 3 tags" to the expected json: {"id":"9115","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"