Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-1719

Improve Circular Write Mode Compaction information.

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • None
    • None
    • storage

    Description

      The documentation should better reflect the following explanation as given by engineering:

      The overall goal of circular write mode is to reduce storage fragmentation by allowing reuse of stale blocks.
      And this allows for compaction to be run less frequently. Here are the factors at play:

      block_reusing_threshold
      Circular block reusing threshold in the unit of percentage (%), which can be
      represented as '(stale data size)/(total file size)'. When stale data size
      grows beyond the threshold, circular block reusing is triggered so that stale
      blocks are reused for further block allocation.
      The default for this threshold is 65. That means once the fragmentation reaches 65%, block
      reuse will kick in. This is the reason you'll see most indexes hanging around with 65% fragmentation.
      This configuration cannot be changed via settings.

      days_of_week
      The days of week setting determines which days the "full" compaction is run. And that is limited to ONCE per day.
      With block reuse in place, there is not much need to run compaction more frequently than that.
      UI settings "Start Time"/"End Time" and "Abort compaction if run time exceeds the set time interval" work along with the "days_of_week" setting.
      Fragmentation Percent setting only applies to "Append-only Write Mode" and is ignored for "Circular Write Mode"(as can be seen from the UI).

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            matt.carabine Matt Carabine (Inactive)
            oliver.downard Oliver Downard (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty