GHC.Stats — Haskell 9

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

Содержание

Статистические данные выполнения

Описание

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

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

С версии: 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
Сумма скопированных байтов по всем сборкам мусора
par_copied_bytes :: Word64
Сумма скопированных байтов по всем параллельным сборкам мусора
cumulative_par_max_copied_bytes :: Word64
Сумма par_max_copied_bytes по всем параллельным сборкам мусора. Устарело.
cumulative_par_balanced_copied_bytes :: Word64
Сумма par_balanced_copied байтов по всем параллельным сборкам мусора
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.Internal.Stats

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

type Rep RTSStats	С версии: base-4.15.0.0
Подробности примера Определено в GHC.Internal.Stats

Методы

from :: RTSStats -> Rep RTSStats x Источник

to :: Rep RTSStats x -> RTSStats Источник

Read RTSStats Источник

С момента: base-4.10.0.0

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

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

Методы

readsPrec :: Int -> ReadS RTSStats Источник

readList :: ReadS [RTSStats] Источник

readPrec :: ReadPrec RTSStats Источник

readListPrec :: ReadPrec [RTSStats] Источник

Show RTSStats Источник

С момента: base-4.10.0.0

Подробности экземпляра Определено в GHC.Internal.Stats Методы showsPrec :: Int -> RTSStats -> ShowS Исходный код show :: RTSStats -> String Исходный код showList :: [RTSStats] -> ShowS Исходный код
type Rep RTSStats Исходный код	С момента: base-4.15.0.0
Подробности экземпляра Определено в GHC.Internal.Stats

data GCDetails Source

Статистические данные о единственном GC. Это зеркало 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
Время, затраченное на фазу паузы после метки при конкуретном сборщике мусора без перемещения.