tracemalloc.md
1> **Источник:** https://python-all.ru/3.13/library/tracemalloc.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `tracemalloc` – Трассировка выделений памяти89Добавлено в версии 3.4.1011**Исходный код:** [Lib/tracemalloc.py](https://python-all.ru/src/3.13/Lib/tracemalloc.py)1213---1415Модуль tracemalloc – инструмент отладки для трассировки блоков памяти, выделяемых Python. Он предоставляет следующую информацию:1617- Трассировка места выделения объекта18- Статистика по выделенным блокам памяти для каждого имени файла и номера строки: общий размер, количество и средний размер выделенных блоков памяти19- Вычисление различий между двумя снимками для обнаружения утечек памяти2021Чтобы трассировать большинство блоков памяти, выделяемых Python, модуль следует запускать как можно раньше, установив переменную окружения [`PYTHONTRACEMALLOC`](https://python-all.ru/3.13/using/cmdline.html#envvar-PYTHONTRACEMALLOC) в `1` или используя опцию командной строки [`-X`](https://python-all.ru/3.13/using/cmdline.html#cmdoption-X) `tracemalloc`. Функцию [`tracemalloc.start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start) можно вызвать во время выполнения, чтобы начать трассировку выделений памяти Python.2223По умолчанию трасса выделенного блока памяти сохраняет только самый последний кадр (1 кадр). Чтобы сохранить 25 кадров при запуске: установите переменную окружения [`PYTHONTRACEMALLOC`](https://python-all.ru/3.13/using/cmdline.html#envvar-PYTHONTRACEMALLOC) в `25` или используйте опцию командной строки [`-X`](https://python-all.ru/3.13/using/cmdline.html#cmdoption-X) `tracemalloc=25`.2425## Примеры2627### Показать 10 лучших2829Показать 10 файлов, выделяющих больше всего памяти:3031```python32import tracemalloc3334tracemalloc.start()3536# ... запустить приложение ...3738snapshot = tracemalloc.take_snapshot()39top_stats = snapshot.statistics('lineno')4041print("[ Top 10 ]")42for stat in top_stats[:10]:43 print(stat)44```4546Пример вывода тестового набора Python:4748```python49[ Top 10 ]50<frozen importlib._bootstrap>:716: size=4855 KiB, count=39328, average=126 B51<frozen importlib._bootstrap>:284: size=521 KiB, count=3199, average=167 B52/usr/lib/python3.4/collections/__init__.py:368: size=244 KiB, count=2315, average=108 B53/usr/lib/python3.4/unittest/case.py:381: size=185 KiB, count=779, average=243 B54/usr/lib/python3.4/unittest/case.py:402: size=154 KiB, count=378, average=416 B55/usr/lib/python3.4/abc.py:133: size=88.7 KiB, count=347, average=262 B56<frozen importlib._bootstrap>:1446: size=70.4 KiB, count=911, average=79 B57<frozen importlib._bootstrap>:1454: size=52.0 KiB, count=25, average=2131 B58<string>:5: size=49.7 KiB, count=148, average=344 B59/usr/lib/python3.4/sysconfig.py:411: size=48.0 KiB, count=1, average=48.0 KiB60```6162Мы видим, что Python загрузил `4855 KiB` данных (байт-код и константы) из модулей, а модуль [`collections`](https://python-all.ru/3.13/library/collections.html#module-collections) выделил `244 KiB` для построения типов [`namedtuple`](https://python-all.ru/3.13/library/collections.html#collections.namedtuple).6364Дополнительные параметры см. в [`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics).6566### Вычисление различий6768Сделать два снимка и отобразить различия:6970```python71import tracemalloc72tracemalloc.start()73# ... запустить приложение ...7475snapshot1 = tracemalloc.take_snapshot()76# ... вызвать функцию, приводящую к утечке памяти ...77snapshot2 = tracemalloc.take_snapshot()7879top_stats = snapshot2.compare_to(snapshot1, 'lineno')8081print("[ Top 10 differences ]")82for stat in top_stats[:10]:83 print(stat)84```8586Пример вывода до и после запуска некоторых тестов из набора тестов Python:8788```python89[ Top 10 differences ]90<frozen importlib._bootstrap>:716: size=8173 KiB (+4428 KiB), count=71332 (+39369), average=117 B91/usr/lib/python3.4/linecache.py:127: size=940 KiB (+940 KiB), count=8106 (+8106), average=119 B92/usr/lib/python3.4/unittest/case.py:571: size=298 KiB (+298 KiB), count=589 (+589), average=519 B93<frozen importlib._bootstrap>:284: size=1005 KiB (+166 KiB), count=7423 (+1526), average=139 B94/usr/lib/python3.4/mimetypes.py:217: size=112 KiB (+112 KiB), count=1334 (+1334), average=86 B95/usr/lib/python3.4/http/server.py:848: size=96.0 KiB (+96.0 KiB), count=1 (+1), average=96.0 KiB96/usr/lib/python3.4/inspect.py:1465: size=83.5 KiB (+83.5 KiB), count=109 (+109), average=784 B97/usr/lib/python3.4/unittest/mock.py:491: size=77.7 KiB (+77.7 KiB), count=143 (+143), average=557 B98/usr/lib/python3.4/urllib/parse.py:476: size=71.8 KiB (+71.8 KiB), count=969 (+969), average=76 B99/usr/lib/python3.4/contextlib.py:38: size=67.2 KiB (+67.2 KiB), count=126 (+126), average=546 B100```101102Мы видим, что Python загрузил `8173 KiB` данных модулей (байт-кода и констант), и это на `4428 KiB` больше, чем было загружено до тестов, когда был сделан предыдущий снимок. Аналогично, модуль [`linecache`](https://python-all.ru/3.13/library/linecache.html#module-linecache) закешировал `940 KiB` исходного кода Python для форматирования трассировок – всё это с момента предыдущего снимка.103104Если в системе мало свободной памяти, снимки можно записать на диск с помощью метода [`Snapshot.dump()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.dump) для анализа снимка в автономном режиме. Затем используйте метод [`Snapshot.load()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.load) для перезагрузки снимка.105106### Получить трассировку блока памяти107108Код для отображения трассировки самого большого блока памяти:109110```python111import tracemalloc112113# Сохранить 25 фреймов114tracemalloc.start(25)115116# ... запустить приложение ...117118snapshot = tracemalloc.take_snapshot()119top_stats = snapshot.statistics('traceback')120121# выбрать самый большой блок памяти122stat = top_stats[0]123print("%s memory blocks: %.1f KiB" % (stat.count, stat.size / 1024))124for line in stat.traceback.format():125 print(line)126```127128Пример вывода набора тестов Python (трассировка ограничена 25 кадрами):129130```python131903 memory blocks: 870.1 KiB132 File "<frozen importlib._bootstrap>", line 716133 File "<frozen importlib._bootstrap>", line 1036134 File "<frozen importlib._bootstrap>", line 934135 File "<frozen importlib._bootstrap>", line 1068136 File "<frozen importlib._bootstrap>", line 619137 File "<frozen importlib._bootstrap>", line 1581138 File "<frozen importlib._bootstrap>", line 1614139 File "/usr/lib/python3.4/doctest.py", line 101140 import pdb141 File "<frozen importlib._bootstrap>", line 284142 File "<frozen importlib._bootstrap>", line 938143 File "<frozen importlib._bootstrap>", line 1068144 File "<frozen importlib._bootstrap>", line 619145 File "<frozen importlib._bootstrap>", line 1581146 File "<frozen importlib._bootstrap>", line 1614147 File "/usr/lib/python3.4/test/support/__init__.py", line 1728148 import doctest149 File "/usr/lib/python3.4/test/test_pickletools.py", line 21150 support.run_doctest(pickletools)151 File "/usr/lib/python3.4/test/regrtest.py", line 1276152 test_runner()153 File "/usr/lib/python3.4/test/regrtest.py", line 976154 display_failure=not verbose)155 File "/usr/lib/python3.4/test/regrtest.py", line 761156 match_tests=ns.match_tests)157 File "/usr/lib/python3.4/test/regrtest.py", line 1563158 main()159 File "/usr/lib/python3.4/test/__main__.py", line 3160 regrtest.main_in_temp_cwd()161 File "/usr/lib/python3.4/runpy.py", line 73162 exec(code, run_globals)163 File "/usr/lib/python3.4/runpy.py", line 160164 "__main__", fname, loader, pkg_name)165```166167Мы видим, что больше всего памяти было выделено в модуле [`importlib`](https://python-all.ru/3.13/library/importlib.html#module-importlib) для загрузки данных (байт-кода и констант) из модулей: `870.1 KiB`. Трассировка указывает место, где модуль `importlib` загрузил данные последний раз: на `import pdb` строке модуля [`doctest`](https://python-all.ru/3.13/library/doctest.html#module-doctest). Трассировка может измениться, если будет загружен новый модуль.168169### Удобный просмотр170171Код для отображения 10 строк с наибольшим выделением памяти в удобном формате, игнорируя файлы `<frozen importlib._bootstrap>` и `<unknown>`:172173```python174import linecache175import os176import tracemalloc177178def display_top(snapshot, key_type='lineno', limit=10):179 snapshot = snapshot.filter_traces((180 tracemalloc.Filter(False, "<frozen importlib._bootstrap>"),181 tracemalloc.Filter(False, "<unknown>"),182 ))183 top_stats = snapshot.statistics(key_type)184185 print("Top %s lines" % limit)186 for index, stat in enumerate(top_stats[:limit], 1):187 frame = stat.traceback[0]188 print("#%s: %s:%s: %.1f KiB"189 % (index, frame.filename, frame.lineno, stat.size / 1024))190 line = linecache.getline(frame.filename, frame.lineno).strip()191 if line:192 print(' %s' % line)193194 other = top_stats[limit:]195 if other:196 size = sum(stat.size for stat in other)197 print("%s other: %.1f KiB" % (len(other), size / 1024))198 total = sum(stat.size for stat in top_stats)199 print("Total allocated size: %.1f KiB" % (total / 1024))200201tracemalloc.start()202203# ... запустить приложение ...204205snapshot = tracemalloc.take_snapshot()206display_top(snapshot)207```208209Пример вывода тестового набора Python:210211```python212Top 10 lines213#1: Lib/base64.py:414: 419.8 KiB214 _b85chars2 = [(a + b) for a in _b85chars for b in _b85chars]215#2: Lib/base64.py:306: 419.8 KiB216 _a85chars2 = [(a + b) for a in _a85chars for b in _a85chars]217#3: collections/__init__.py:368: 293.6 KiB218 exec(class_definition, namespace)219#4: Lib/abc.py:133: 115.2 KiB220 cls = super().__new__(mcls, name, bases, namespace)221#5: unittest/case.py:574: 103.1 KiB222 testMethod()223#6: Lib/linecache.py:127: 95.4 KiB224 lines = fp.readlines()225#7: urllib/parse.py:476: 71.8 KiB226 for a in _hexdig for b in _hexdig}227#8: <string>:5: 62.0 KiB228#9: Lib/_weakrefset.py:37: 60.0 KiB229 self.data = set()230#10: Lib/base64.py:142: 59.8 KiB231 _b32tab2 = [a + b for a in _b32tab for b in _b32tab]2326220 other: 3602.8 KiB233Total allocated size: 5303.1 KiB234```235236Дополнительные параметры см. в [`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics).237238#### Записывает текущий и пиковый размер всех отслеживаемых блоков памяти239240Следующий код неэффективно вычисляет две суммы наподобие `0 + 1 + 2 + ...`, создавая список этих чисел. Этот список временно потребляет много памяти. С помощью [`get_traced_memory()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traced_memory) и [`reset_peak()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.reset_peak) можно наблюдать небольшой расход памяти после вычисления суммы, а также пиковый расход памяти во время вычислений:241242```python243import tracemalloc244245tracemalloc.start()246247# Пример кода: вычисление суммы с большим временным списком248large_sum = sum(list(range(100000)))249250first_size, first_peak = tracemalloc.get_traced_memory()251252tracemalloc.reset_peak()253254# Пример кода: вычисление суммы с малым временным списком255small_sum = sum(list(range(1000)))256257second_size, second_peak = tracemalloc.get_traced_memory()258259print(f"{first_size=}, {first_peak=}")260print(f"{second_size=}, {second_peak=}")261```262263Вывод:264265```python266first_size=664, first_peak=3592984267second_size=804, second_peak=29704268```269270Использование [`reset_peak()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.reset_peak) позволило точно записать пик во время вычисления `small_sum`, хотя он намного меньше общего пикового размера блоков памяти после вызова [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start). Без вызова `reset_peak()` значение `second_peak` осталось бы пиком от вычисления `large_sum` (то есть равнялось бы `first_peak`). В данном случае оба пика значительно превышают конечное использование памяти, что говорит о возможности оптимизации (удалив ненужный вызов [`list`](https://python-all.ru/3.13/library/stdtypes.html#list) и записав `sum(range(...))`).271272## API273274### Функции275276#### `tracemalloc.clear_traces()`277278Очищает записи о блоках памяти, выделенных Python.279280См. также [`stop()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.stop).281282#### `tracemalloc.get_object_traceback(obj)`283284Возвращает трассировку, где был выделен объект Python *obj*. Возвращает экземпляр [`Traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback) или `None`, если модуль `tracemalloc` не отслеживает выделения памяти или не отслеживал выделение данного объекта.285286См. также функции [`gc.get_referrers()`](https://python-all.ru/3.13/library/gc.html#gc.get_referrers) и [`sys.getsizeof()`](https://python-all.ru/3.13/library/sys.html#sys.getsizeof).287288#### `tracemalloc.get_traceback_limit()`289290Возвращает максимальное количество фреймов, сохраняемых в трассировке записи.291292Модуль `tracemalloc` должен отслеживать выделения памяти, чтобы получить ограничение, иначе возбуждается исключение.293294Ограничение устанавливается функцией [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start).295296#### `tracemalloc.get_traced_memory()`297298Возвращает текущий размер и пиковый размер блоков памяти, отслеживаемых модулем `tracemalloc`, в виде кортежа: `(current: int, peak: int)`.299300#### `tracemalloc.reset_peak()`301302Устанавливает пиковый размер блоков памяти, отслеживаемых модулем `tracemalloc`, равным текущему размеру.303304Ничего не делает, если модуль `tracemalloc` не отслеживает выделения памяти.305306Эта функция изменяет только записанный пиковый размер и не изменяет и не очищает никакие записи, в отличие от [`clear_traces()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.clear_traces). Снимки, полученные с помощью [`take_snapshot()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.take_snapshot) до вызова `reset_peak()`, можно осмысленно сравнивать со снимками, полученными после вызова.307308См. также [`get_traced_memory()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traced_memory).309310Добавлено в версии 3.9.311312#### `tracemalloc.get_tracemalloc_memory()`313314Возвращает объём памяти в байтах, используемый модулем `tracemalloc` для хранения записей о блоках памяти. Возвращает [`int`](https://python-all.ru/3.13/library/functions.html#int).315316#### `tracemalloc.is_tracing()`317318`True`, если модуль `tracemalloc` отслеживает выделения памяти Python, иначе `False`.319320См. также функции [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start) и [`stop()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.stop).321322#### `tracemalloc.start(nframe: int = 1)`323324Начинает отслеживание выделения памяти Python: устанавливает перехватчики в распределители памяти Python. Собираемые трассировки записей будут ограничены *nframe* фреймами. По умолчанию запись блока памяти хранит только самый последний фрейм: ограничение равно `1`. Значение *nframe* должно быть больше или равно `1`.325326Исходное количество всех фреймов, из которых состоит трассировка, можно прочитать через атрибут [`Traceback.total_nframe`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback.total_nframe).327328Хранение более `1` фреймов имеет смысл только для вычисления статистики, сгруппированной по `'traceback'`, или для вычисления накопительной статистики: см. методы [`Snapshot.compare_to()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.compare_to) и [`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics).329330Хранение большего числа фреймов увеличивает потребление памяти и загрузку процессора модулем `tracemalloc`. Используйте функцию [`get_tracemalloc_memory()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_tracemalloc_memory), чтобы измерить, сколько памяти использует модуль `tracemalloc`.331332Переменная окружения [`PYTHONTRACEMALLOC`](https://python-all.ru/3.13/using/cmdline.html#envvar-PYTHONTRACEMALLOC) (`PYTHONTRACEMALLOC=NFRAME`) и опция командной строки [`-X`](https://python-all.ru/3.13/using/cmdline.html#cmdoption-X) `tracemalloc=NFRAME` могут использоваться для запуска отслеживания при старте.333334См. также функции [`stop()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.stop), [`is_tracing()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.is_tracing) и [`get_traceback_limit()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traceback_limit).335336#### `tracemalloc.stop()`337338Останавливает трассировку выделений памяти Python: удаляет хуки на аллокаторах памяти Python. Также очищает все ранее собранные трассы блоков памяти, выделенных Python.339340Необходимо вызвать функцию [`take_snapshot()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.take_snapshot), чтобы сделать снимок трасс перед их очисткой.341342См. также функции [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start), [`is_tracing()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.is_tracing) и [`clear_traces()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.clear_traces).343344#### `tracemalloc.take_snapshot()`345346Делает снимок трасс блоков памяти, выделенных Python. Возвращает новый экземпляр [`Snapshot`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot).347348Снимок не включает блоки памяти, выделенные до того, как модуль `tracemalloc` начал трассировку выделений памяти.349350Трассировки следов ограничены [`get_traceback_limit()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traceback_limit) кадрами. Для хранения большего количества кадров используется параметр *nframe* функции [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start).351352Модуль `tracemalloc` должен трассировать выделения памяти, чтобы сделать снимок. См. функцию [`start()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.start).353354См. также функцию [`get_object_traceback()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_object_traceback).355356### DomainFilter357358#### `class tracemalloc.DomainFilter(inclusive: bool, domain: int)`359360Фильтрует следы блоков памяти по их адресному пространству (домену).361362Добавлено в версии 3.6.363364#### `inclusive`365366Если *inclusive* равно `True` (включать), то совпадают блоки памяти, выделенные в адресном пространстве [`domain`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.DomainFilter.domain).367368Если *inclusive* равно `False` (исключать), то совпадают блоки памяти, не выделенные в адресном пространстве [`domain`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.DomainFilter.domain).369370#### `domain`371372Адресное пространство блока памяти (`int`). Свойство только для чтения.373374### Filter375376#### `class tracemalloc.Filter(inclusive: bool, filename_pattern: str, lineno: int = None, all_frames: bool = False, domain: int = None)`377378Фильтр для следов блоков памяти.379380См. функцию [`fnmatch.fnmatch()`](https://python-all.ru/3.13/library/fnmatch.html#fnmatch.fnmatch) для синтаксиса *filename\_pattern*. Расширение файла `'.pyc'` заменяется на `'.py'`.381382Примеры:383384- `Filter(True, subprocess.__file__)` включает только следы модуля [`subprocess`](https://python-all.ru/3.13/library/subprocess.html#module-subprocess)385- `Filter(False, tracemalloc.__file__)` исключает следы модуля `tracemalloc`386- `Filter(False, "<unknown>")` исключает пустые трассировки387388Изменено в версии 3.5: Расширение файла `'.pyo'` больше не заменяется на `'.py'`.389390Изменено в версии 3.6: Добавлен атрибут [`domain`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter.domain).391392#### `domain`393394Адресное пространство блока памяти (`int` или `None`).395396tracemalloc использует домен `0` для отслеживания выделений памяти, сделанных Python. Расширения C могут использовать другие домены для отслеживания других ресурсов.397398#### `inclusive`399400Если *inclusive* равно `True` (включать), то совпадают только блоки памяти, выделенные в файле с именем, соответствующим [`filename_pattern`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter.filename_pattern), на строке номер [`lineno`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter.lineno).401402Если *inclusive* равно `False` (исключить), игнорировать блоки памяти, выделенные в файле с именем, соответствующим [`filename_pattern`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter.filename_pattern), по номеру строки [`lineno`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter.lineno).403404#### `lineno`405406Номер строки (`int`) фильтра. Если *lineno* равно `None`, фильтр соответствует любому номеру строки.407408#### `filename_pattern`409410Шаблон имени файла фильтра (`str`). Свойство только для чтения.411412#### `all_frames`413414Если *all\_frames* равно `True`, проверяются все фреймы трассировки. Если *all\_frames* равно `False`, проверяется только самый последний фрейм.415416Этот атрибут не действует, если предел трассировки равен `1`. См. функцию [`get_traceback_limit()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traceback_limit) и атрибут [`Snapshot.traceback_limit`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.traceback_limit).417418### Фрейм419420#### `class tracemalloc.Frame`421422Фрейм трассировки.423424Класс [`Traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback) представляет собой последовательность экземпляров `Frame`.425426#### `filename`427428Имя файла (`str`).429430#### `lineno`431432Номер строки (`int`).433434### Снимок435436#### `class tracemalloc.Snapshot`437438Снимок трасс блоков памяти, выделенных Python.439440Функция [`take_snapshot()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.take_snapshot) создает экземпляр снимка.441442#### `compare_to(old_snapshot: Snapshot, key_type: str, cumulative: bool = False)`443444Вычисляет различия со старым снимком. Возвращает статистику в виде отсортированного списка экземпляров [`StatisticDiff`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff), сгруппированных по *key\_type*.445446См. метод [`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics) для параметров *key\_type* и *cumulative*.447448Результат отсортирован от наибольшего к наименьшему по: абсолютному значению [`StatisticDiff.size_diff`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff.size_diff), [`StatisticDiff.size`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff.size), абсолютному значению [`StatisticDiff.count_diff`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff.count_diff), [`Statistic.count`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic.count) и затем по [`StatisticDiff.traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff.traceback).449450#### `dump(filename)`451452Записывает снимок в файл.453454Снимок перезагружается с помощью [`load()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.load).455456#### `filter_traces(filters)`457458Создает новый экземпляр `Snapshot` с отфильтрованной последовательностью [`traces`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.traces). Параметр *filters* – список экземпляров [`DomainFilter`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.DomainFilter) и [`Filter`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Filter). Если *filters* – пустой список, возвращается новый экземпляр `Snapshot` с копией трасс.459460Все включающие фильтры применяются одновременно; трасса игнорируется, если ни один включающий фильтр ей не соответствует. Трасса также игнорируется, если ей соответствует хотя бы один исключающий фильтр.461462Изменено в версии 3.6: [`DomainFilter`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.DomainFilter) теперь также принимаются в *filters*.463464#### `classmethod load(filename)`465466Загружает снимок из файла.467468См. также [`dump()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.dump).469470#### `statistics(key_type: str, cumulative: bool = False)`471472Возвращает статистику в виде отсортированного списка экземпляров [`Statistic`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic), сгруппированных по *key\_type*:473474| key\_type | описание |475| --- | --- |476| `'filename'` | filename |477| `'lineno'` | имя файла и номер строки |478| `'traceback'` | traceback |479480Если *cumulative* установлен в `True`, размер и количество блоков памяти суммируются для всех фреймов traceback трассы, а не только для самого последнего. Накопительный режим можно использовать только с *key\_type*, равным `'filename'` и `'lineno'`.481482Результат сортируется от наибольшего к наименьшему по: [`Statistic.size`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic.size), [`Statistic.count`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic.count), а затем по [`Statistic.traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic.traceback).483484#### `traceback_limit`485486Максимальное количество фреймов, хранящихся в traceback [`traces`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.traces): результат [`get_traceback_limit()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traceback_limit) на момент создания снимка.487488#### `traces`489490Трассы всех блоков памяти, выделенных Python: последовательность экземпляров [`Trace`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Trace).491492Последовательность имеет неопределённый порядок. Используйте метод [`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics) для получения отсортированного списка статистики.493494### Статистика495496#### `class tracemalloc.Statistic`497498Статистика по выделениям памяти.499500[`Snapshot.statistics()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.statistics) возвращает список экземпляров `Statistic`.501502См. также класс [`StatisticDiff`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.StatisticDiff).503504#### `count`505506Количество блоков памяти (`int`).507508#### `size`509510Общий размер блоков памяти в байтах (`int`).511512#### `traceback`513514Трассировка, где был выделен блок памяти, экземпляр [`Traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback).515516### StatisticDiff517518#### `class tracemalloc.StatisticDiff`519520Разница статистики по выделениям памяти между старым и новым экземпляром [`Snapshot`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot).521522[`Snapshot.compare_to()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.compare_to) возвращает список экземпляров `StatisticDiff`. См. также класс [`Statistic`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Statistic).523524#### `count`525526Количество блоков памяти в новом снимке (`int`): `0`, если блоки памяти были освобождены в новом снимке.527528#### `count_diff`529530Разница количества блоков памяти между старым и новым снимками (`int`): `0`, если блоки памяти были выделены в новом снимке.531532#### `size`533534Общий размер блоков памяти в байтах в новом снимке (`int`): `0`, если блоки памяти были освобождены в новом снимке.535536#### `size_diff`537538Разница в общем размере блоков памяти в байтах между старым и новым снимками (`int`): `0`, если блоки памяти были выделены в новом снимке.539540#### `traceback`541542Трассировка, где были выделены блоки памяти, экземпляр [`Traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback).543544### Trace545546#### `class tracemalloc.Trace`547548Трассировка блока памяти.549550Атрибут [`Snapshot.traces`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Snapshot.traces) – это последовательность `Trace` экземпляров.551552Изменено в версии 3.6: Добавлен атрибут [`domain`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Trace.domain).553554#### `domain`555556Адресное пространство блока памяти (`int`). Свойство только для чтения.557558tracemalloc использует домен `0` для отслеживания выделений памяти, сделанных Python. Расширения C могут использовать другие домены для отслеживания других ресурсов.559560#### `size`561562Размер блока памяти в байтах (`int`).563564#### `traceback`565566Трассировка, где был выделен блок памяти, экземпляр [`Traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback).567568### Traceback569570#### `class tracemalloc.Traceback`571572Последовательность экземпляров [`Frame`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Frame), отсортированных от самого старого кадра до самого нового кадра.573574Трассировка содержит как минимум `1` кадр. Если модуль `tracemalloc` не смог получить кадр, используется имя файла `"<unknown>"` на строке `0`.575576При создании снимка трассировки следов ограничены [`get_traceback_limit()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.get_traceback_limit) кадрами. См. функцию [`take_snapshot()`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.take_snapshot). Исходное количество кадров трассировки хранится в атрибуте [`Traceback.total_nframe`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback.total_nframe). Это позволяет узнать, была ли трассировка усечена ограничением на количество кадров.577578Атрибут [`Trace.traceback`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Trace.traceback) – это экземпляр `Traceback`.579580Изменено в версии 3.7: Кадры теперь сортируются от самого старого к самому новому, а не от самого нового к самому старому.581582#### `total_nframe`583584Общее количество кадров, составлявших трассировку до усечения. Этот атрибут может быть установлен в `None`, если информация недоступна.585586Изменено в версии 3.9: Добавлен атрибут [`Traceback.total_nframe`](https://python-all.ru/3.13/library/tracemalloc.html#tracemalloc.Traceback.total_nframe).587588#### `format(limit=None, most_recent_first=False)`589590Форматирует трассировку как список строк. Используйте модуль [`linecache`](https://python-all.ru/3.13/library/linecache.html#module-linecache) для получения строк из исходного кода. Если задан *limit*, форматирует *limit* самых новых кадров, если *limit* положителен. Иначе форматирует `abs(limit)` самых старых кадров. Если *most\_recent\_first* равно `True`, порядок отформатированных кадров меняется на обратный, возвращая сначала самый новый кадр, а не последний.591592Аналогично функции [`traceback.format_tb()`](https://python-all.ru/3.13/library/traceback.html#traceback.format_tb), за исключением того, что `format()` не включает символы новой строки.593594Пример:595596```python597print("Traceback (most recent call first):")598for line in traceback:599 print(line)600```601602Вывод:603604```python605Traceback (most recent call first):606 File "test.py", line 9607 obj = Object()608 File "test.py", line 12609 tb = tracemalloc.get_object_traceback(f())610```611