Home
About
Blog
Products
Forum
Support
Contact
Sunbelt Computer Software
PL/B Language Development and Support
Home
About
Blog
Products
Forum
Support
Contact
cpython/Include/cpython/pystats.h at main · wrongnull/cpython · GitHub
Skip to content
Navigation Menu
Sign in
Appearance settings
Platform
AI CODE CREATION
GitHub Copilot
Write better code with AI
GitHub Copilot app
Direct agents from issue to merge
MCP Registry
Integrate external tools
DEVELOPER WORKFLOWS
Actions
Automate any workflow
Codespaces
Instant dev environments
Issues
Plan and track work
Code Review
Manage code changes
Code Quality
Enforce quality at merge
APPLICATION SECURITY
GitHub Advanced Security
Find and fix vulnerabilities
Code security
Secure your code as you build
Secret protection
Stop leaks before they start
EXPLORE
Why GitHub
Documentation
Blog
Changelog
Marketplace
View all features
Solutions
BY COMPANY SIZE
Enterprises
Small and medium teams
Startups
Nonprofits
BY USE CASE
App Modernization
DevSecOps
DevOps
CI/CD
View all use cases
BY INDUSTRY
Healthcare
Financial services
Manufacturing
Government
View all industries
View all solutions
Resources
EXPLORE BY TOPIC
AI
Software Development
DevOps
Security
View all topics
EXPLORE BY TYPE
Customer stories
Events & webinars
Ebooks & reports
Business insights
GitHub Skills
SUPPORT & SERVICES
Documentation
Customer support
Community forum
Trust center
Partners
View all resources
Open Source
COMMUNITY
GitHub Sponsors
Fund open source developers
PROGRAMS
Security Lab
Maintainer Community
GitHub Stars
Archive Program
REPOSITORIES
Topics
Trending
Collections
Enterprise
ENTERPRISE SOLUTIONS
Enterprise platform
AI-powered developer platform
AVAILABLE ADD-ONS
GitHub Advanced Security
Enterprise-grade security features
Copilot for Business
Enterprise-grade AI features
Premium Support
Enterprise-grade 24/7 support
Pricing
Search
/
Sign in
Sign up
Appearance settings
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
{{ message }}
wrongnull
/
cpython
Public
forked from
python/cpython
Notifications
You must be signed in to change notification settings
Fork
0
Star
0
Code
Pull requests
0
Actions
Projects
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Actions
Projects
Security and quality
Insights
Files
Expand file tree
main
Breadcrumbs
cpython
/
Include
/
cpython
/
pystats.h
Copy path
Blame
More file actions
Blame
More file actions
Latest commit
History
History
History
194 lines (176 loc) · 6.32 KB
main
Breadcrumbs
cpython
/
Include
/
cpython
/
pystats.h
Copy path
Top
File metadata and controls
Code
Blame
194 lines (176 loc) · 6.32 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
// Statistics on Python performance.
//
// API:
//
// - _Py_INCREF_STAT_INC() and _Py_DECREF_STAT_INC() used by Py_INCREF()
// and Py_DECREF().
// - _Py_stats variable
//
// Functions of the sys module:
//
// - sys._stats_on()
// - sys._stats_off()
// - sys._stats_clear()
// - sys._stats_dump()
//
// Python must be built with ./configure --enable-pystats to define the
// Py_STATS macro.
//
// Define _PY_INTERPRETER macro to increment interpreter_increfs and
// interpreter_decrefs. Otherwise, increment increfs and decrefs.
//
// The number of incref operations counted by `incref` and
// `interpreter_incref` is the number of increment operations, which is
// not equal to the total of all reference counts. A single increment
// operation may increase the reference count of an object by more than
// one. For example, see `_Py_RefcntAdd`.
#ifndef
Py_CPYTHON_PYSTATS_H
# error
"this header file must not be included directly"
#endif
#define
PYSTATS_MAX_UOP_ID
1024
#define
SPECIALIZATION_FAILURE_KINDS
60
/* Stats for determining who is calling PyEval_EvalFrame */
#define
EVAL_CALL_TOTAL
0
#define
EVAL_CALL_VECTOR
1
#define
EVAL_CALL_GENERATOR
2
#define
EVAL_CALL_LEGACY
3
#define
EVAL_CALL_FUNCTION_VECTORCALL
4
#define
EVAL_CALL_BUILD_CLASS
5
#define
EVAL_CALL_SLOT
6
#define
EVAL_CALL_FUNCTION_EX
7
#define
EVAL_CALL_API
8
#define
EVAL_CALL_METHOD
9
#define
EVAL_CALL_KINDS
10
typedef
struct
_specialization_stats
{
uint64_t
success
;
uint64_t
failure
;
uint64_t
hit
;
uint64_t
deferred
;
uint64_t
miss
;
uint64_t
deopt
;
uint64_t
failure_kinds
[
SPECIALIZATION_FAILURE_KINDS
];
}
SpecializationStats
;
typedef
struct
_opcode_stats
{
SpecializationStats
specialization
;
uint64_t
execution_count
;
uint64_t
pair_count
[
256
];
}
OpcodeStats
;
typedef
struct
_call_stats
{
uint64_t
inlined_py_calls
;
uint64_t
pyeval_calls
;
uint64_t
frames_pushed
;
uint64_t
frame_objects_created
;
uint64_t
eval_calls
[
EVAL_CALL_KINDS
];
}
CallStats
;
typedef
struct
_object_stats
{
uint64_t
increfs
;
uint64_t
decrefs
;
uint64_t
interpreter_increfs
;
uint64_t
interpreter_decrefs
;
uint64_t
immortal_increfs
;
uint64_t
immortal_decrefs
;
uint64_t
interpreter_immortal_increfs
;
uint64_t
interpreter_immortal_decrefs
;
uint64_t
allocations
;
uint64_t
allocations512
;
uint64_t
allocations4k
;
uint64_t
allocations_big
;
uint64_t
frees
;
uint64_t
to_freelist
;
uint64_t
from_freelist
;
uint64_t
inline_values
;
uint64_t
dict_materialized_on_request
;
uint64_t
dict_materialized_new_key
;
uint64_t
dict_materialized_too_big
;
uint64_t
dict_materialized_str_subclass
;
uint64_t
type_cache_hits
;
uint64_t
type_cache_misses
;
uint64_t
type_cache_dunder_hits
;
uint64_t
type_cache_dunder_misses
;
uint64_t
type_cache_collisions
;
/* Temporary value used during GC */
uint64_t
object_visits
;
}
ObjectStats
;
typedef
struct
_gc_stats
{
uint64_t
collections
;
uint64_t
object_visits
;
uint64_t
objects_collected
;
uint64_t
objects_transitively_reachable
;
uint64_t
objects_not_transitively_reachable
;
}
GCStats
;
typedef
struct
_uop_stats
{
uint64_t
execution_count
;
uint64_t
miss
;
uint64_t
pair_count
[
PYSTATS_MAX_UOP_ID
+
1
];
}
UOpStats
;
#define
_Py_UOP_HIST_SIZE
32
typedef
struct
_optimization_stats
{
uint64_t
attempts
;
uint64_t
traces_created
;
uint64_t
traces_executed
;
uint64_t
uops_executed
;
uint64_t
trace_stack_overflow
;
uint64_t
trace_stack_underflow
;
uint64_t
trace_too_long
;
uint64_t
trace_too_short
;
uint64_t
inner_loop
;
uint64_t
recursive_call
;
uint64_t
low_confidence
;
uint64_t
unknown_callee
;
uint64_t
executors_invalidated
;
UOpStats
opcode
[
PYSTATS_MAX_UOP_ID
+
1
];
uint64_t
unsupported_opcode
[
256
];
uint64_t
trace_length_hist
[
_Py_UOP_HIST_SIZE
];
uint64_t
trace_run_length_hist
[
_Py_UOP_HIST_SIZE
];
uint64_t
optimized_trace_length_hist
[
_Py_UOP_HIST_SIZE
];
uint64_t
optimizer_attempts
;
uint64_t
optimizer_successes
;
uint64_t
optimizer_failure_reason_no_memory
;
uint64_t
remove_globals_builtins_changed
;
uint64_t
remove_globals_incorrect_keys
;
uint64_t
error_in_opcode
[
PYSTATS_MAX_UOP_ID
+
1
];
// JIT memory stats
uint64_t
jit_total_memory_size
;
uint64_t
jit_code_size
;
uint64_t
jit_trampoline_size
;
uint64_t
jit_data_size
;
uint64_t
jit_padding_size
;
uint64_t
jit_freed_memory_size
;
uint64_t
trace_total_memory_hist
[
_Py_UOP_HIST_SIZE
];
}
OptimizationStats
;
typedef
struct
_rare_event_stats
{
/* Setting an object's class, obj.__class__ = ... */
uint64_t
set_class
;
/* Setting the bases of a class, cls.__bases__ = ... */
uint64_t
set_bases
;
/* Setting the PEP 523 frame eval function, _PyInterpreterState_SetFrameEvalFunc() */
uint64_t
set_eval_frame_func
;
/* Modifying the builtins, __builtins__.__dict__[var] = ... */
uint64_t
builtin_dict
;
/* Modifying a function, e.g. func.__defaults__ = ..., etc. */
uint64_t
func_modification
;
/* Modifying a dict that is being watched */
uint64_t
watched_dict_modification
;
uint64_t
watched_globals_modification
;
}
RareEventStats
;
typedef
struct
_stats
{
OpcodeStats
opcode_stats
[
256
];
CallStats
call_stats
;
ObjectStats
object_stats
;
OptimizationStats
optimization_stats
;
RareEventStats
rare_event_stats
;
GCStats
*
gc_stats
;
}
PyStats
;
// Export for shared extensions like 'math'
PyAPI_DATA
(
PyStats
*
)
_Py_stats
;
#ifdef
_PY_INTERPRETER
# define
_Py_INCREF_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.interpreter_increfs++; } while (0)
# define
_Py_DECREF_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.interpreter_decrefs++; } while (0)
# define
_Py_INCREF_IMMORTAL_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.interpreter_immortal_increfs++; } while (0)
# define
_Py_DECREF_IMMORTAL_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.interpreter_immortal_decrefs++; } while (0)
#else
# define
_Py_INCREF_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.increfs++; } while (0)
# define
_Py_DECREF_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.decrefs++; } while (0)
# define
_Py_INCREF_IMMORTAL_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.immortal_increfs++; } while (0)
# define
_Py_DECREF_IMMORTAL_STAT_INC
() do { if (_Py_stats) _Py_stats->object_stats.immortal_decrefs++; } while (0)
#endif
You can’t perform that action at this time.