In this section:
- Starting the profiling session
- Working with the profiling results
PyCharm allows running the current run/debug configuration while attaching a Python profiler to it.
Besides these two tracing profilers, PyCharm supports also sampling (statistical) profiler vmprof, which should be installed on the selected Python interpreter.
Note the following:
- A profiler runs on both local and remote interpreters.
- A profiler runs in the following order:
Starting the profiling session
To start the profiling session, do one of the following:
The profiler starts in the dedicated tab of the Run tool window.
Working with the profiling results
On the toolbar of the profiler tab, click . This action results in the following:
- The snapshot is saved to the default location under
.PyCharmXX/system/snapshotsdirectory under the user's home. For CProfiler, it is saved as
- The profiling results open in the
<project name>.pstattab in the editor, which consists of two tabs: Statistics and Call Graph:
vmprof, it is saved as
Jumping to the source code
The source code of the function in question opens in the editor.
Viewing Call Graph
To increase the graph scale, click ; to show actual size of the graph, click .
Use the toolbar button to fit contents into the current diagram size.
To decrease the graph scale, use .
Note the color codes on the Call Graph. The functions marked red consume more time; the fastest functions are green.
Reviewing the existing snapshots
To open an existing snapshot, follow these steps:
- On the main menu, choose .
- In the Select PStat file dialog, choose the desired file with the extension
The profiling results open in the
<project name>.pstattab in the editor.