GHC.Stats — Haskell 9

Авторское право	(c) The University of Glasgow 1994-2000
Лицензия	см. libraries/base/LICENSE
Сопровождающие	ghc-devs@haskell.org
Стабильность	внутренняя
Переносимость	непереносимый (расширения GHC)
Безопасный Haskell	Безопасный
Язык	Haskell2010

Содержание

Статистика времени выполнения

Описание

Этот модуль предоставляет доступ к внутренней статистике сборки мусора и использования памяти. Эта статистика доступна только в том случае, если программа запущена с флагом RTS -T.

API этого модуля нестабилен и тесно связан с внутренним устройством GHC. Если вы зависите от него, обязательно укажите строгую верхнюю границу версии, например base < 4.X вместо base < 5, поскольку интерфейс может быстро измениться без особого предупреждения.

Этот модуль является слоем совместимости. Он предназначен для временного использования, чтобы в дальнейшем можно было объявить эти объявления устаревшими, как описано в предложении CLC № 289. Теперь эти объявления доступны из пакета ghc-experimental.

Начиная с: base-4.5.0.0

Статистика времени выполнения

data RTSStats Источник

Статистика активности среды выполнения с момента запуска программы. Это копия C-структуры struct RTSStats из RtsAPI.h

Начиная с: base-4.10.0.0

Конструкторы

RTSStats

Поля

gcs :: Word32
Общее число сборок мусора
major_gcs :: Word32
Общее число крупных сборок мусора (сборок поколения с наибольшим возрастом)
allocated_bytes :: Word64
Общее число выделенных байтов
max_live_bytes :: Word64
Максимальный объём живых данных в куче (включая большие объекты и компактные области). Обновляется после крупной сборки мусора.
max_large_objects_bytes :: Word64
Максимальный объём живых данных в больших объектах
max_compact_bytes :: Word64
Максимальный объём живых данных в компактных областях
max_slop_bytes :: Word64
Максимальный объём неиспользуемой памяти
max_mem_in_use_bytes :: Word64
Максимальный объём памяти, использованной RTS
cumulative_live_bytes :: Word64
Суммарное число живых байтов во всех крупных сборках мусора. При делении на major_gcs получается средний объём живых данных за время работы программы.
copied_bytes :: Word64
Суммарное число copied_bytes во всех сборках мусора
par_copied_bytes :: Word64
Суммарное число copied_bytes во всех параллельных сборках мусора
cumulative_par_max_copied_bytes :: Word64
Суммарное число par_max_copied_bytes во всех параллельных сборках мусора. Устарело.
cumulative_par_balanced_copied_bytes :: Word64
Суммарное число par_balanced_copied bytes во всех параллельных сборках мусора
init_cpu_ns :: RtsTime
Общее время ЦП, затраченное на этап инициализации @since base-4.12.0.0
init_elapsed_ns :: RtsTime
Общее прошедшее время, затраченное на этап инициализации @since base-4.12.0.0
mutator_cpu_ns :: RtsTime
Общее время ЦП, затраченное мутатором
mutator_elapsed_ns :: RtsTime
Общее прошедшее время, затраченное мутатором
gc_cpu_ns :: RtsTime
Общее время ЦП, затраченное на сборку мусора
gc_elapsed_ns :: RtsTime
Общее прошедшее время, затраченное на сборку мусора
cpu_ns :: RtsTime
Общее время ЦП (на момент предыдущей сборки мусора)
elapsed_ns :: RtsTime
Общее прошедшее время (на момент предыдущей сборки мусора)
nonmoving_gc_sync_cpu_ns :: RtsTime
Общее время ЦП, затраченное на фазу паузы после маркировки конкурентной невытесняющей сборки мусора.
nonmoving_gc_sync_elapsed_ns :: RtsTime
Общее прошедшее время фазы паузы после маркировки конкурентной невытесняющей сборки мусора.
nonmoving_gc_sync_max_elapsed_ns :: RtsTime
Максимальная длительность любой фазы паузы после маркировки конкурентной невытесняющей сборки мусора.
nonmoving_gc_cpu_ns :: RtsTime
Общее время ЦП, затраченное на невытесняющую сборку мусора.
nonmoving_gc_elapsed_ns :: RtsTime
Общее время, в течение которого выполнялась невытесняющая сборка мусора.
nonmoving_gc_max_elapsed_ns :: RtsTime
Максимальное время выполнения любого цикла невытесняющей сборки мусора.
gc :: GCDetails
Сведения о последней сборке мусора

Экземпляры

Сведения об экземплярах

Generic RTSStats Исходный код

Сведения об экземпляре

Определён в GHC.Stats

Связанные типы

type Rep RTSStats

Начиная с: base-4.15.0.0

Сведения об экземпляре

Определён в GHC.Stats

Методы

from :: RTSStats -> Rep RTSStats x Исходный код

to :: Rep RTSStats x -> RTSStats Исходный код

Read RTSStats Исходный код

Начиная с: base-4.10.0.0

Сведения об экземпляре

Определён в GHC.Stats

Методы

readsPrec :: Int -> ReadS RTSStats Исходный код

readList :: ReadS [RTSStats] Исходный код

readPrec :: ReadPrec RTSStats Исходный код

readListPrec :: ReadPrec [RTSStats] Исходный код

Show RTSStats Исходный код

Начиная с: base-4.10.0.0

Сведения об экземпляре

Определён в GHC.Stats

Методы

showsPrec :: Int -> RTSStats -> ShowS Исходный код

show :: RTSStats -> String Исходный код

showList :: [RTSStats] -> ShowS Исходный код

type Rep RTSStats Исходный код

Начиная с: base-4.15.0.0

Подробности экземпляра

Определено в GHC.Stats

data GCDetails Источник

Статистика об одной сборке мусора. Это копия C struct GCDetails в RtsAPI.h; перед именем поля добавлен префикс gc_, чтобы избежать конфликтов с RTSStats.

Конструкторы

GCDetails

Поля

gcdetails_gen :: Word32
Номер поколения этой сборки мусора
gcdetails_threads :: Word32
Количество потоков, использованных в этой сборке мусора
gcdetails_allocated_bytes :: Word64
Количество байтов, выделенных после предыдущей сборки мусора
gcdetails_live_bytes :: Word64
Общий объём живых данных в куче (включая большие и компактные данные). Обновляется после каждой сборки мусора. Данные в непроверенных поколениях (при сборках мусора младших поколений) считаются живыми.
gcdetails_large_objects_bytes :: Word64
Общий объём живых данных в крупных объектах
gcdetails_compact_bytes :: Word64
Общий объём живых данных в компактных областях
gcdetails_slop_bytes :: Word64
Общий объём потерь (неиспользуемой памяти)
gcdetails_mem_in_use_bytes :: Word64
Общий объём памяти, используемой RTS
gcdetails_copied_bytes :: Word64
Общий объём данных, скопированных во время этой сборки мусора
gcdetails_par_max_copied_bytes :: Word64
При параллельной сборке мусора — максимальный объём данных, скопированных одним потоком. Устарело.
gcdetails_par_balanced_copied_bytes :: Word64
При параллельной сборке мусора — объём сбалансированных данных, скопированных всеми потоками
gcdetails_block_fragmentation_bytes :: Word64
Объём памяти в байтах, потерянной из-за фрагментации блоков. Фрагментация блоков — это разница между количеством блоков, удерживаемых RTS, и количеством используемых блоков. Это происходит, когда мегаблоки используются лишь частично, например, когда перемещение данных невозможно и поэтому мегаблок остаётся занятым.

Начиная с: base-4.18.0.0
gcdetails_sync_elapsed_ns :: RtsTime
Время, затраченное на синхронизацию перед сборкой мусора
gcdetails_cpu_ns :: RtsTime
Время процессора, затраченное непосредственно на сборку мусора
gcdetails_elapsed_ns :: RtsTime
Время, затраченное непосредственно на сборку мусора
gcdetails_nonmoving_gc_sync_cpu_ns :: RtsTime
Время процессора, затраченное на фазу паузы после маркировки при конкурентной немобильной сборке мусора.
gcdetails_nonmoving_gc_sync_elapsed_ns :: RtsTime
Время, затраченное на фазу паузы после маркировки при конкурентной немобильной сборке мусора.