Skip to content

Struct MDBX_commit_latency.gc_prof

ClassList > MDBX_commit_latency.gc_prof

Information for GC profiling. More...

Classes

Type Name
struct MDBX_commit_latency.gc_prof.pnl_merge_self
Metrics of the amount of work and cost of merging lists of pages.
struct MDBX_commit_latency.gc_prof.pnl_merge_work
Metrics of the amount of work and cost of merging lists of pages.

Public Attributes

Type Name
uint32_t coalescences
The number of iterations of merging GC items.
uint32_t flushes
The number of forced commits to disk to avoid the database growth when working outside of MDBX_UTTERLY_NOSYNC mode.
uint32_t kicks
The number of accesses to the Handle-Slow-Readers mechanism to avoid void the database growth.
uint32_t max_reader_lag
The maximum observed difference between the latest and oldest read MVCC-snapshots.
uint32_t max_retained_pages
The maximum noticed number of pages withheld from reclaimed due to reading old MVCC-snapshots.
struct MDBX_commit_latency::@011154311350011351127350035060377076047213131345::@154343016212112041155271126166260340025124200304 pnl_merge_self
Merging page lists for the GC maintenance itself.
struct MDBX_commit_latency::@011154311350011351127350035060377076047213131345::@154343016212112041155271126166260340025124200304 pnl_merge_work
Merging page lists for the transactions being committed.
uint32_t self_counter
The GC's slow path execution count is for the purposes of maintaining and updating the GC itself.
uint32_t self_majflt
The number of page faults within the GC when allocating and preparing pages for the GC itself.
uint32_t self_rsteps
The number of search iterations inside the GC when allocating pages for the purposes of maintaining and updating the GC itself.
uint32_t self_rtime_monotonic
The time "by the wall clock" spent reading and searching inside the GC for the purposes of maintaining and updating the GC itself.
uint32_t self_xpages
The number of page sequences allocation requests for the GC itself.
uint32_t self_xtime_cpu
The CPU time in user mode spent preparing pages taken from the GC for the purposes of maintaining and updating the GC itself, including swapping from disk.
uint32_t wipes
The number of previous reliable/stable committed points erased when working in MDBX_UTTERLY_NOSYNC mode.
uint32_t wloops
The number of GC update iterations is greater than 1 if there were repeats/restarts.
uint32_t work_counter
Number of slow/deep path GC search for the sake of placement user's data.
uint32_t work_majflt
The number of page faults inside the GC when allocating and preparing pages for user's data.
uint32_t work_rsteps
The number of search iterations inside GC when allocating pages for the sake of user's data.
uint32_t work_rtime_monotonic
The time "by the wall clock" spent reading and searching inside the GC for the user's data.
uint32_t work_xpages
The number of requests to allocate page sequences for the sake of user's data.
uint32_t work_xtime_cpu
The CPU time in user mode spent for preparing pages taken from the GC for user data, including paging ones from disk.

Detailed Description

Note:

This data is shared for all processes working with a given database and stored in LCK-file.

Statistic is accumulated when all transactions are committed, but only in libmdbx builds with the MDBX_ENABLE_PROFGC option enabled. The collected statistics are returned to any process when using mdbx_txn_commit_ex() or mdbx_txn_checkpoint(), and at the same time they are reset to zero when top-level transactions (not nested) are committed.

Public Attributes Documentation

variable coalescences

The number of iterations of merging GC items.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::coalescences;

variable flushes

The number of forced commits to disk to avoid the database growth when working outside of MDBX_UTTERLY_NOSYNC mode.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::flushes;

variable kicks

The number of accesses to the Handle-Slow-Readers mechanism to avoid void the database growth.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::kicks;

See also: MDBX_hsr_func


variable max_reader_lag

The maximum observed difference between the latest and oldest read MVCC-snapshots.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::max_reader_lag;

variable max_retained_pages

The maximum noticed number of pages withheld from reclaimed due to reading old MVCC-snapshots.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::max_retained_pages;

variable pnl_merge_self

Merging page lists for the GC maintenance itself.

struct MDBX_commit_latency::@011154311350011351127350035060377076047213131345::@154343016212112041155271126166260340025124200304 MDBX_commit_latency::@011154311350011351127350035060377076047213131345::pnl_merge_self;

variable pnl_merge_work

Merging page lists for the transactions being committed.

struct MDBX_commit_latency::@011154311350011351127350035060377076047213131345::@154343016212112041155271126166260340025124200304 MDBX_commit_latency::@011154311350011351127350035060377076047213131345::pnl_merge_work;

variable self_counter

The GC's slow path execution count is for the purposes of maintaining and updating the GC itself.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_counter;

variable self_majflt

The number of page faults within the GC when allocating and preparing pages for the GC itself.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_majflt;

variable self_rsteps

The number of search iterations inside the GC when allocating pages for the purposes of maintaining and updating the GC itself.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_rsteps;

variable self_rtime_monotonic

The time "by the wall clock" spent reading and searching inside the GC for the purposes of maintaining and updating the GC itself.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_rtime_monotonic;

variable self_xpages

The number of page sequences allocation requests for the GC itself.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_xpages;

variable self_xtime_cpu

The CPU time in user mode spent preparing pages taken from the GC for the purposes of maintaining and updating the GC itself, including swapping from disk.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::self_xtime_cpu;

variable wipes

The number of previous reliable/stable committed points erased when working in MDBX_UTTERLY_NOSYNC mode.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::wipes;

variable wloops

The number of GC update iterations is greater than 1 if there were repeats/restarts.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::wloops;

variable work_counter

Number of slow/deep path GC search for the sake of placement user's data.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_counter;

variable work_majflt

The number of page faults inside the GC when allocating and preparing pages for user's data.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_majflt;

variable work_rsteps

The number of search iterations inside GC when allocating pages for the sake of user's data.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_rsteps;

variable work_rtime_monotonic

The time "by the wall clock" spent reading and searching inside the GC for the user's data.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_rtime_monotonic;

variable work_xpages

The number of requests to allocate page sequences for the sake of user's data.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_xpages;

variable work_xtime_cpu

The CPU time in user mode spent for preparing pages taken from the GC for user data, including paging ones from disk.

uint32_t MDBX_commit_latency::@011154311350011351127350035060377076047213131345::work_xtime_cpu;


The documentation for this class was generated from the following file mdbx.h