Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 5BD72200C68 for ; Wed, 19 Apr 2017 07:31:27 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 5A55D160BA1; Wed, 19 Apr 2017 05:31:27 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 54AD7160BB6 for ; Wed, 19 Apr 2017 07:31:26 +0200 (CEST) Received: (qmail 16513 invoked by uid 500); 19 Apr 2017 05:31:25 -0000 Mailing-List: contact commits-help@kudu.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@kudu.apache.org Delivered-To: mailing list commits@kudu.apache.org Received: (qmail 15081 invoked by uid 99); 19 Apr 2017 05:31:16 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 19 Apr 2017 05:31:16 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 3B610DFF0F; Wed, 19 Apr 2017 05:31:16 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: todd@apache.org To: commits@kudu.apache.org Date: Wed, 19 Apr 2017 05:32:00 -0000 Message-Id: <710cc70054a945c5bd25cb2e203b2cfd@git.apache.org> In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [46/51] [partial] kudu git commit: Add 1.3.1 release and docs archived-at: Wed, 19 Apr 2017 05:31:27 -0000 http://git-wip-us.apache.org/repos/asf/kudu/blob/2826dff0/docs/administration.html ---------------------------------------------------------------------- diff --git a/docs/administration.html b/docs/administration.html index 16bda0a..05c3115 100644 --- a/docs/administration.html +++ b/docs/administration.html @@ -2,7 +2,7 @@ title: Apache Kudu Administration layout: default active_nav: docs -last_updated: 'Last updated 2017-03-01 12:43:33 PST' +last_updated: 'Last updated 2017-04-18 21:59:26 PDT' --- + + +
+
+
+ +

Apache Kudu Background Maintenance Tasks

+
+
+
+

Kudu relies on running background tasks for many important automatic +maintenance activities. These tasks include flushing data from memory to disk, +compacting data to improve performance, freeing up disk space, and more.

+
+
+
+
+

Maintenance manager

+
+
+

The maintenance manager schedules and runs background tasks. At any given point +in time, the maintenance manager is prioritizing the next task based on the +improvement needed at that moment, such as relieving memory pressure, improving +read performance, or freeing up disk space. The number of worker threads +dedicated to running background tasks can be controlled by setting +--maintenance_manager_num_threads.

+
+
+
+
+

Flushing data to disk

+
+
+

Flushing data from memory to disk relieves memory pressure and can improve read +performance by switching from a write-optimized, row-oriented in-memory format +in the MemRowSet to a read-optimized, column-oriented format on disk. +Background tasks that flush data include FlushMRSOp and +FlushDeltaMemStoresOp.

+
+
+

The metrics associated with these ops have the prefix flush_mrs and +flush_dms, respectively.

+
+
+
+
+

Compacting on-disk data

+
+
+

Kudu constantly performs several types of compaction tasks in order to maintain +consistent read and write performance over time. A merging compaction, which combines +multiple DiskRowSets together into a single DiskRowSet, is run by +CompactRowSetsOp. There are two types of delta store compaction operations +that may be run as well: MinorDeltaCompactionOp and MajorDeltaCompactionOp.

+
+
+

For more information on what these different types of compaction operations do, +please see the +Kudu Tablet +design document.

+
+
+

The metrics associated with these tasks have the prefix compact_rs, +delta_minor_compact_rs, and delta_major_compact_rs, respectively.

+
+
+
+
+

Write-ahead log GC

+
+
+

Kudu maintains a write-ahead log (WAL) per tablet that is split into discrete +fixed-size segments. A tablet periodically rolls the WAL to a new log segment +when the active segment reaches a configured size (controlled by +--log_segment_size_mb). In order to save disk space and decrease startup +time, a background task called LogGCOp attempts to garbage-collect (GC) old +WAL segments by deleting them from disk once it is determined that they are no +longer needed by the local node for durability.

+
+
+

The metrics associated with this background task have the prefix log_gc.

+
+
+
+
+

Tablet history GC and the ancient history mark

+
+
+

Because Kudu uses a multiversion concurrency control (MVCC) mechanism to +ensure that snapshot scans can proceeed isolated from new changes to a table, +periodically old historical data should be garbage-collected (removed) to free +up disk space. While Kudu never removes rows or data that are visible in the +latest version of the data, Kudu does remove records of old changes that are no +longer visible.

+
+
+

The point in time in the past beyond which historical MVCC data becomes +inaccessible and is free to be deleted is called the ancient history mark +(AHM). The AHM can be configured by setting --tablet_history_max_age_sec.

+
+
+

There are two background tasks that GC historical MVCC data older than the AHM: +the one that runs the merging compaction, called CompactRowSetsOp (see +above), and a separate background task that deletes old undo delta blocks, +called UndoDeltaBlockGCOp. Running UndoDeltaBlockGCOp reduces disk space +usage in all workloads, but particularly in those with a higher volume of +updates or upserts.

+
+
+

The metrics associated with this background task have the prefix +undo_delta_block.

+
+
+
+
+ +
+
\ No newline at end of file http://git-wip-us.apache.org/repos/asf/kudu/blob/2826dff0/docs/configuration.html ---------------------------------------------------------------------- diff --git a/docs/configuration.html b/docs/configuration.html index 2d6f9bf..a23182f 100644 --- a/docs/configuration.html +++ b/docs/configuration.html @@ -2,7 +2,7 @@ title: Configuring Apache Kudu layout: default active_nav: docs -last_updated: 'Last updated 2017-02-03 13:18:53 PST' +last_updated: 'Last updated 2017-04-10 16:00:03 PDT' ---