Skip to content

IGNITE-28742 Document page eviction monitoring#13204

Open
ignitetcbot wants to merge 2 commits into
apache:masterfrom
ignitetcbot:ignite-28742-document-page-eviction-monitoring
Open

IGNITE-28742 Document page eviction monitoring#13204
ignitetcbot wants to merge 2 commits into
apache:masterfrom
ignitetcbot:ignite-28742-document-page-eviction-monitoring

Conversation

@ignitetcbot

Copy link
Copy Markdown
Contributor

Thank you for submitting the pull request to the Apache Ignite.

In order to streamline the review of the contribution
we ask you to ensure the following steps have been taken:

The Contribution Checklist

  • There is a single JIRA ticket related to the pull request.
  • The web-link to the pull request is attached to the JIRA ticket.
  • The JIRA ticket has the Patch Available state.
  • The pull request body describes changes that have been made.
    The description explains WHAT and WHY was made instead of HOW.
  • The pull request title is treated as the final commit message.
    The following pattern must be used: IGNITE-XXXX Change summary where XXXX - number of JIRA issue.
  • A reviewer has been mentioned through the JIRA comments
    (see the Maintainers list)
  • The pull request has been checked by the Teamcity Bot and
    the green visa attached to the JIRA ticket (see tab PR Check at TC.Bot - Instance 1 or TC.Bot - Instance 2)

Notes

If you need any help, please email dev@ignite.apache.org or ask anу advice on http://asf.slack.com #ignite channel.


=== Monitoring Page Eviction

When page eviction starts because a data region is under memory pressure, Ignite sets the `EvictionsStarted` metric to `true` for that data region.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

“When page eviction starts because a data region is under memory pressure...” sounds a bit unnatural. I would suggest rephrasing it as:

“When page eviction starts due to a data region being under memory pressure...”


When page eviction starts because a data region is under memory pressure, Ignite sets the `EvictionsStarted` metric to `true` for that data region.
The metric is available in the `io.dataregion.{data_region_name}` registry.
Use it together with `EvictionRate` to monitor whether eviction has started and how actively pages are being evicted.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is probably worth mentioning that page eviction with potential data loss, and therefore this metric, is relevant for in-memory clusters rather than persistent ones.


The warning is logged once per data region.
For monitoring, prefer the `EvictionsStarted` metric because it identifies the affected data region directly and does not depend on log parsing.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would also be useful to mention that once eviction starts, the EvictionsStarted metric remains set to true until the node is restarted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants