This is an automated email from the ASF dual-hosted git repository.
dmagda pushed a commit to branch IGNITE-7595
in repository https://gitbox.apache.org/repos/asf/ignite.git
The following commit(s) were added to refs/heads/IGNITE-7595 by this push:
new 7fe5ed9 cosmetic changes in the description of the page-list related
system views
7fe5ed9 is described below
commit 7fe5ed913b00b468c80efff97bfdb6c15698affd
Author: Denis Magda <dma...@gridgain.com>
AuthorDate: Wed Sep 30 14:20:03 2020 -0700
cosmetic changes in the description of the page-list related system views
---
docs/_docs/monitoring-metrics/system-views.adoc | 23 +++++++++++++++--------
1 file changed, 15 insertions(+), 8 deletions(-)
diff --git a/docs/_docs/monitoring-metrics/system-views.adoc
b/docs/_docs/monitoring-metrics/system-views.adoc
index 0a56886..a9f3e21 100644
--- a/docs/_docs/monitoring-metrics/system-views.adoc
+++ b/docs/_docs/monitoring-metrics/system-views.adoc
@@ -610,9 +610,16 @@ The INDEXES view contains information about SQL indexes.
== PAGE_LISTS
-Page list is a data structure used to store a list of partially free data
pages (free-lists) and fully free allocated pages (reuse-lists). The purpose of
free lists and reuse lists is to quickly locate a page with enough free space
to save an entry or to determine that no such page exists and a new page should
be allocated.
-Page lists organized in buckets. Each bucket group pages with about the same
size of free space.
-If persistence is enabled page lists are created for each partition of each
cache group, to view such page lists cacheGroupPageLists system view (SQL name
CACHE_GROUP_PAGE_LISTS) can be used. If persistence is disabled page lists are
created for each data region, in this case, dataRegionPageLists system view
(SQL name DATA_REGION_PAGE_LISTS) can be used. These views contain information
about each bucket of each page list what is useful to understand how much data
can be inserted into the [...]
+The page-list is a data structure used to store a list of partially free data
pages (free-lists) and fully free allocated
+pages (reuse-lists). The purpose of the free-lists and reuse lists is to
quickly locate a page with enough free space
+to save an entry or to determine that no such page exists and a new page
should be allocated.
+The page-lists organized in buckets. Each bucket group references pages with
about the same size of a free space.
+
+If Ignite persistence is enabled, the page-lists are created for each
partition of each cache group. To view such page lists
+use the `CACHE_GROUP_PAGE_LISTS` system view. If Ignite persistence is
disabled, the page-lists are created for each data region.
+In this case, the `DATA_REGION_PAGE_LISTS` system view needs to used. These
views contain information about each bucket
+of each page list that is useful to understand how much data can be inserted
into a cache without allocating new pages
+and also helps to detect skews in page-lists utilization.
=== CACHE_GROUP_PAGE_LISTS
@@ -622,11 +629,11 @@ If persistence is enabled page lists are created for each
partition of each cach
|Column | Data type | Description
|CACHE_GROUP_ID | int| Cache group ID
|PARTITION_ID | int| Partition ID
-|NAME | string| Page list name
+|NAME | string| Page-list's name
|BUCKET_NUMBER | int| Bucket number
|BUCKET_SIZE | long | Count of pages in the bucket
|STRIPES_COUNT | int| Count of stripes used by this bucket. Stripes are used
to avoid contention.
-|CACHED_PAGES_COUNT | int| Count of pages in onheap page list cache for this
bucket
+|CACHED_PAGES_COUNT | int| Count of pages in an on-heap page-list cache for
this bucket.
|===
=== DATA_REGION_PAGE_LISTS
@@ -634,16 +641,16 @@ If persistence is enabled page lists are created for each
partition of each cach
[{table_opts}]
|===
|Column | Data type | Description
-|NAME | string| Page list name
+|NAME | string| Page-list's name
|BUCKET_NUMBER | int| Bucket number
|BUCKET_SIZE | long | Count of pages in the bucket
|STRIPES_COUNT | int| Count of stripes used by this bucket. Stripes are used
to avoid contention.
-|CACHED_PAGES_COUNT | int| Count of pages in onheap page list cache for this
bucket
+|CACHED_PAGES_COUNT | int| Count of pages in an on-heap page-list cache for
this bucket.
|===
== PARTITION_STATES
-This view exposes information about distribution of cache group partitions
across cluster nodes.
+This view exposes information about the distribution of cache group partitions
across cluster nodes.
[{table_opts}]
|===
