@@ -72,23 +72,23 @@ New features
7272
7373.. _whatsnew314-sampling-profiler :
7474
75- High frequency statistical sampling profiler
75+ High frequency statistical sampling profiler
7676--------------------------------------------
7777
78- A new statistical sampling profiler has been added to the :mod: `profile ` module as
79- :mod: `profile.sample `. This profiler enables low-overhead performance analysis of
78+ A new statistical sampling profiler has been added to the :mod: `profile ` module as
79+ :mod: `profile.sample `. This profiler enables low-overhead performance analysis of
8080running Python processes without requiring code modification or process restart.
8181
82- Unlike deterministic profilers (:mod: `cProfile ` and :mod: `profile `) that instrument
83- every function call, the sampling profiler periodically captures stack traces from
84- running processes. This approach provides virtually zero overhead while achieving
85- sampling rates of **up to 200,000 Hz **, making it the fastest sampling profiler
82+ Unlike deterministic profilers (:mod: `cProfile ` and :mod: `profile `) that instrument
83+ every function call, the sampling profiler periodically captures stack traces from
84+ running processes. This approach provides virtually zero overhead while achieving
85+ sampling rates of **up to 200,000 Hz **, making it the fastest sampling profiler
8686available for Python (at the time of its contribution) and ideal for debugging
8787performance issues in production environments.
8888
8989Key features include:
9090
91- * **Zero-overhead profiling **: Attach to any running Python process without
91+ * **Zero-overhead profiling **: Attach to any running Python process without
9292 affecting its performance
9393* **No code modification required **: Profile existing applications without restart
9494* **Real-time statistics **: Monitor sampling quality during data collection
@@ -160,10 +160,10 @@ The profiler generates statistical estimates of where time is spent::
160160 10581.7x call magnification, 116388 indirect calls from 11 direct: test_ast.py:(AST_Tests.test_ast_recursion_limit)
161161 9740.9x call magnification, 418815 indirect calls from 43 direct: case.py:(TestCase.run)
162162
163- The profiler automatically identifies performance bottlenecks through statistical
163+ The profiler automatically identifies performance bottlenecks through statistical
164164analysis, highlighting functions with high CPU usage and call frequency patterns.
165165
166- This capability is particularly valuable for debugging performance issues in
166+ This capability is particularly valuable for debugging performance issues in
167167production systems where traditional profiling approaches would be too intrusive.
168168
169169(Contributed by Pablo Galindo and László Kiss Kollár in :gh: `135953 `.)
0 commit comments