Editing Server Profiling
From Eco - English Wiki
Your changes will be displayed to readers once an authorized user accepts them. (help)
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
[[File:In-Game Profiling Commands.png|thumb|595x595px|In-game Admin commands that can be used to invoke profiling sessions|alt=]][[File:EcoServer Profiling Menu.png|thumb|595x595px|Various profiling options as seen in Server UI (Windows only)|alt=]]The profiling tools allow Server Owners and Admin to run profiling sessions to gather diagnostic data that is especially useful when | [[File:In-Game Profiling Commands.png|thumb|595x595px|In-game Admin commands that can be used to invoke profiling sessions|alt=]][[File:EcoServer Profiling Menu.png|thumb|595x595px|Various profiling options as seen in Server UI (Windows only)|alt=]]The profiling tools allow [[Server|Server Owners]] and [[Admin|Admins]] to run profiling sessions to gather diagnostic data that is especially useful when server is experiencing performance problems. | ||
''' | You can use this generated data to compliment issue reports for [[Strange Loop Games|SLG]]. | ||
'''Introduced in version 9.5.''' | |||
==Requirements== | ==Requirements== | ||
For profiling to work, you need | For profiling to work, you need 2 [https://docs.microsoft.com/en-us/dotnet/core/diagnostics/#net-core-diagnostic-global-tools .NET Core diagnostic global tools] installed on your system: | ||
*[https://docs.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump <code>dotnet-dump</code>] - to take memory dumps | |||
*[https://docs.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-trace <code>dotnet-trace</code>] - to profile CPU | |||
You have to make sure | You have to make sure both of the tools are installed globally or available on your [[wikipedia:PATH_(variable)|systems PATH]] so the server can run them. | ||
== Memory dumps == | ==Memory dumps== | ||
For when the server is consuming too much memory. | For when the server is consuming too much memory. | ||
| Line 18: | Line 18: | ||
For when the server is consuming too much CPU. | For when the server is consuming too much CPU. | ||
CPU profiling can be initiated by: | CPU profiling can be initiated by: | ||
*As an admin, by issuing <code>/profiler cpu</code> command | *As an admin, by issuing <code>/profiler cpu</code> command | ||
*Invoking <code>Profiler -> Profile CPU</code> via Server UI Menu (Windows only) | *Invoking <code>Profiler -> Profile CPU</code> via Server UI Menu (Windows only) | ||
CPU profiling will start the <code> | CPU profiling will start the <code>dotnet-trace</code> process, running it for '''1 minute''', capturing everything going on with the process for the time being. | ||
==Full profile == | ==Full profile== | ||
Full profile will simply take memory dump followed by CPU profiling, as if they were invoked in succession. | Full profile will simply take memory dump followed by CPU profiling, as if they were invoked in succession. | ||
