Membase Features 1.7

8/2/2019 Membase Features 1.7

1/17

1

Membase Server 1.7 Features

Copyright 2010, 2011 Couchbase, Inc. Contact [email protected].

For documentation license information, see Section 5.1, Documentation License. For all license information, see

Section 5, Licenses.

Abstract

This manual documents main features of Membase Server 1.7, including changes and new functionality.

Last document update: 28 Feb 2012 15:39;Document built: 28 Feb 2012 15:48.

Documentation Availability and Formats. This documentation is available online:HTML Online . For other documentation from

Couchbase, see Couchbase Documentation Library

Contact:[email protected] or couchbase.com

Table of Contents

1. Improved Statistical Monitoring ...... ..... ...... ..... ...... ...... ..... ...... ..... ...... ...... ..... ...... ..... ...... ...... ..... ...... ..... ..... . 1

1.1. Monitoring UI Improvements ........................................................ ................................................. 1

1.2. Bucket Monitoring ................................................... ........................................................ ............. 2

1.3. Server Monitoring .................................................................................. ...................................... 9

2. Membase Server States ........................................................... ........................................................ ....... 12

3. Update Notifications ................................................................... ........................................................ ... 13

4. Membase Server Warnings and Alerts ........................................................ .............................................. 15

5. Licenses .................................... ..................................................... ..................................................... 175.1. Documentation License ................................................................................................................ 17

1. Improved Statistical Monitoring

Membase Server 1.7 includes a range of new statistics, and an updated statistic monitoring user interface that shows im-

proved overview and detail information so that administrators can better understand the current state of individual nodes

and the cluster as a whole.

1.1. Monitoring UI Improvements

The monitoring section of the Membase Web Console has been updated to provide more detailed information. The moni-

tor section of the website is now divided into four sections:

Cluster Overview

Provides an overview of your Membase cluster, including RAM and disk usage, bucket activity and server status.

Data Buckets (updated in 1.7)

Provides overview statistics on all the configured buckets with a cluster. Clicking on a bucket within this view provides

a much more detailed overview of the bucket statistics for your cluster. The statistics and graphs in this section have

been expanded, and per-server as well as per-cluster statistics are now supported.
mailto:[email protected]://www.couchbase.com/http://www.couchbase.com/docshttp://www.couchbase.com/mailto:[email protected]://www.couchbase.com/docshttp://www.couchbase.com/docs/membase-features-1.7mailto:[email protected]


2/17


2

For more information, see Section 1.2, Bucket Monitoring.

Server Nodes (new in 1.7)

A new overview screen showing overall server statistics for your cluster. Selecting an individual server within the list

displays a combined view of individual server statistics, and overall cluster statistics.

For more information, see Section 1.3, Server Monitoring.

Log

The Membase cluster log showing cluster events.

Withing the Data Bucket monitor display, information is shown by default for the entire Membase Server cluster. The in-

formation is aggregated from all the server nodes within the configured cluster for the selected bucket.

The standard Data Buckets monitor screen is shown below. Each individual graph is updated in real-time according to the

selected time interval.

The following functionality is available through this display, and is common to all the graphs and statistics display within

the web console.

Bucket Selection

The Data Buckets selection list allows you to select which of the buckets configured on your cluster is to be used as the

basis for the graph display.

Server Selection

The Server Selection option enables you to enable the display for an individual server instead of for the entire cluster.

You can select an individual node, which displays the Section 1.3, Server Monitoring for that node. Selecting All

Server Nodes shows the Section 1.2, Bucket Monitoring page.

Interval Selection

The Interval Selection at the top of the main graph changes interval display for all graphs displayed on the page. For ex-ample, selecting Minute shows information for the last minute, continuously updating.

Note

As the selected interval increases, the amount of statistical data displayed will depend on how long

your cluster has been running.

Statistic Selection

All of the graphs within the display updatre simultaneously. Clicking on any of the smaller graphs will promote that

graph to be displayed as the main graph for the page.

Individual Server Selection

Clicking the blue triangle next to any of the smaller statistics graphs enables you to view the statistics on each individ-

ual server, instead of the default view which shows the entire cluster information for a given statistic.

1.2. Bucket Monitoring

Bucket monitoring within the Membase Web Console has been updated to show additional detailed information. The fol-

lowing statistic groups are available for Membase bucket types.


3/17


3

Summary

The summary section provides a quick overview of the cluster activity. For more information, see Section 1.2.1, Buck-

et Monitoring Summary Statistics.

vBucket Resources

This section provides detailed information on the vBucket resources across the cluster, including the active, replica andpending operations. For more information, see Section 1.2.2, Bucket Monitoring vBucket Resources.

Disk Queues

Disk queues show the activity on the backend disk storage used for persistence within a data bucket. The information

displayed shows the active, replica and pending activity. For more information, see Section 1.2.3, Bucket Monitoring

Disk Queues.

TAP Queues

The TAP queues section provides information on the activity within the TAP queues across replication, rebalancing and

client activity. For more information, see Section 1.2.4, Bucket Monitoring TAP Queues.

Top Keys

This shows a list of the top 10 most actively used keys within the selected data bucket.

For Memcached bucket types, the Memcached static summary is provided. See Section 1.2.5, Bucket Monitoring

Memcached Buckets.

1.2.1. Bucket Monitoring Summary Statistics

The summary section is designed to provide a quick overview of the cluster activity. Each graph (or selected graph) shows

information based on the currently selected bucket.

Figure 1. Membase Server 1.7 - Summary Statistics

The following graph types are available:

ops per second

The total number of operations per second on this bucket.

cache miss %

Percentrage of reads per second to this bucket which required a read from disk rather than RAM.

creates per second

Number of new items created in this bucket per second.


4/17


4

updates per second

Number of existing items updated in this bucket per second.

disk reads

Number of reads per second from disk for this bucket.

back-offs per second

Number of 'back-offs' sent per second to clients due to out of memory situations for this bucket.

1.2.2. Bucket Monitoring vBucket Resources

The vBucket statistics provide information for all vBucket types within the cluster across three different states. Within the

statistic display the table of statics is organized in four columns, showing the Active, Replica and Pending states for each

individual statistic. The final column provides the total value for each statistic.

Figure 2. Membase Server 1.7 - vBucket Resources statistics

The Active column displays the information for vBuckets within the Active state. The Replica column displays the sta-

tistics for vBuckets within the Replica state (i.e. currently being replicated). The Pending columns shows statistics for

vBuckets in the Pending state, i.e. while data is being exchanged during rebalancing.

These states are shared across all the following statistics. For example, the graph news items per sec within the Active

state column displays the number of new items per second created within the vBuckets that are in the active state.

The individual statistics, one for each state, shown are:


5/17


5

active vBuckets

The number of vBuckets within the specified state.

active items

Number of items within the vBucket of the specified state.

% resident items

Percentage of items within the vBuckets of the specified state that are resident (in RAM).

new items per second

Number of new items created in vBuckets within the specified state. Note that new items per second is not valid for the

Pending state.

ejections per second

Number of items ejected per second within the vBuckets of the specified state.

user data in RAM

Size of user data within vBuckets of the specified state that are resident in RAM.

metadata in RAM

Size of item metadata within the vBuckets of the specified state that are resident in RAM.

1.2.3. Bucket Monitoring Disk Queues

The Disk Queues statistics section displays the information for data being placed into the disk queue. Disk queues are used

within Membase Server to store the information written to RAM on disk for persistence. Information is displayed for each

of the disk queue states, Active, Replica and Pending.

Figure 3. Membase Server 1.7 - Disk Queue Statistics

The Active column displays the information for the Disk Queues within the Active state. The Replica column displays the

statistics for the Disk Queues within the Replica state (i.e. currently being replicated). The Pending columns shows statis-

tics for the disk Queues in the Pending state, i.e. while data is being exchanged during rebalancing.


6/17


6

These states are shared across all the following statistics. For example, the graph fill rate within the Replica state column

displays the number of items being put into the replica disk queue for the selected bucket.

The displayed statistics are:

items

The number of items waiting to be written to disk for this bucket for this state.

fill rate

The number of items per second being added to the disk queue for the corresponding state.

drain rate

Number of items actually written to disk from the disk queue for the corresponding state.

average age

The average age of items (in seconds) within the disk queue for the specified state.

1.2.4. Bucket Monitoring TAP QueuesThe TAP queues statistics are designed to show information about the TAP queue activity, both internally, beetween clus-

ter nodes and clients. The statistics information is therefore organized as a table with columns showing the statistics for

TAP queues used for replication, rebalancing and clients.

Figure 4. Membase Server 1.7 - TAP Queue Statistics


7/17


7

The statistics in this section are detailed below:

# tap senders

Number of TAP queues in this bucket for internal (replica), rebalancing or client connections.

# items

Number of items in the corresponding TAP queue for this bucket.

fill rate

Number of items per second being put into the corresponding TAP queue for this bucket.

drain rate

Number of items per second being sent over the corresponding TAP queue connections to this bucket.

back-off rate

Number of back-offs per second received when sending data through the corresponding TAP connection to this bucket.

# backfill remaining

Number of items in the backfill queue for the corresponding TAP connection for this bucket.

# remaining on disk

Number of items still on disk that need to be loaded to service the TAP connection to this bucket.

1.2.5. Bucket Monitoring Memcached Buckets

For Memcached buckets a separate suite of Memcached-specific statistics are displayed.


8/17


8

Figure 5. Membase Server 1.7 - Memcached Statistics

The Memcached statistics are:

Operations per sec.

Total operations per second serviced by this bucket

Hit Ratio %

Percentage of get requests served with data from this bucket

Memory bytes used

Total amount of RAM used by this bucket

Items count

Number of items stored in this bucket

RAM evictions per sec.

Number of items per second evicted from this bucket

Sets per sec.

Number of set operations serviced by this bucket

Gets per sec.

Number of get operations serviced by this bucket


9/17


9

Net. bytes TX per sec

Number of bytes per second sent from this bucket

Net. bytes RX per sec.

Number of bytes per second sent into this bucket

Get hits per sec.

Number of get operations per second for data that this bucket contains

Delete hits per sec.

Number of delete operations per second for data that this bucket contains

Incr hits per sec.

Number of increment operations per second for data that this bucket contains

Decr hits per sec.

Number of decrement operations per second for data that this bucket contains

Delete misses per sec.

Number of delete operations per second for data that this bucket does not contain

Decr misses per sec.

Number of decr operations per second for data that this bucket does not contain

Get Misses per sec.

Number of get operations per second for data that this bucket does not contain

Incr misses per sec.

Number of increment operations per second for data that this bucket does not contain

CAS hits per sec.

Number of CAS operations per second for data that this bucket contains

CAS badval per sec.

Number of CAS operations per second using an incorrect CAS ID for data that this bucket contains

CAS misses per sec.

Number of CAS operations per second for data that this bucket does not contain

1.3. Server Monitoring

In addition to monitoring buckets over all the nodes within the cluster, Membase Server 1.7 also includes support for mon-

itoring the statistics for an individual node.


10/17


10

The Server Nodes monitoring overview shows summary data for the Swap Usage, RAM Usage, CPU Usage and Active

Items across all the nodes in your cluster.

Figure 6. Membase Server 1.7 - Monitor Servers view

Selecting a server from the list shows a server-specific version of the Bucket Monitoring overview, showing a combina-

tion of the server-specific performance information, and the overall statistic information for the bucket across all nodes.


11/17


11

Figure 7. Membase Server 1.7 - Data Bucket/Server view

The graphs specific to the server are:

swap usage

Amount of swap space in use on this server.

free memory

Amount of RAM available on this server.

CPU utilization

Percentage of CPU utilized across all cores on the selected server.


12/17


12

connection count

Number of connects to this server of all types for client, proxy, TAP requests and internal statistics.

By clicking on the blue triangle against an individual statistic within the server monitoring display, you can optionally se-

lect to view the information for a specific bucket-statistic on an individual server, instead of across the entire cluster.

Figure 8. Membase Server 1.7 - Server specific view

For more information on the data bucket statistics, see Section 1.2, Bucket Monitoring.

2. Membase Server States

Membase Server nodes can be in a number of different states depending on their current activity and availability. The dis-

played states are:

Up

Host is up, replicating data between nodes and servicing requests from clients.

Down

Host is down, not replicating data between nodes and not servicing requests from clients.


13/17


13

Figure 9. Down Status

Pend

Host is up and currently filling RAM with data, but is not servicing requests from clients. Client access will be support-

ed once the RAM has been pre-filled with information.

Figure 10. Pend Status

You can monitor the current server status using both the Manage: Server Nodes and Monitor: Server Nodes screens within

the Web Console.

3. Update Notifications

During installation you can select to enable the Update Notification function. Update notifications allow a client accessing

the Membase Web Console to determine whether a newer version of Membase Server is available for download.

If you select the Update Notifications option, the Web Console will communicate with Couchbase servers to confirm theversion number of your Membase installation. During this process, the client submits the following information to the

Couchbase server:

The current version of your Membase Server installation. When a new version of Membase Server becomes available,

you will be provided with notification of the new version and information on where you can download the new version.

Basic information about the size and configuration of your Membase cluster. This information will be used to help us

prioritize our development efforts.


14/17


14

Note

The process occurs within the browser accessing the web console, not within the server itself, and no

further configuration or internet access is required on the server to enable this functionality. Provid-

ing the client accessing the Membase server console has internet access, the information can be com-

municated to the Couchbase servers.

The update notification process the information anonymously, and the data cannot be tracked. The in-

formation is only used to provide you with update notification and to provide information that will

help us improve the future development process for Membase Server and related products.

If the browser or computer that you are using to connect to your Membase Server web console does

not have Internet access, the update notification system will not work.

Update Notification

If an update notification is available, the counter within the button display within the Membase Console will be displayed

with the number of available updates, as shown in the image below.

Figure 11. Available Update Notifications


15/17


15

Viewing Available Updates

To view the available updates, click on the Update Notifications link. This displays your current version and update avail-

ability. From here you can be taken to the download location to obtain the updated release package.

Figure 12. Available Update Notifications

Enabling and Disabling Update Notifications

You can enable or disable Update Notifications by checking the Enable software update notifications checkbox within the

Update Notifications screen. Once you have changed the option, you must click Save to record the change.

If update notifications are disabled then the Update Notifications screen will only notify you of your currently installed

version, and no alert will be provided

4. Membase Server Warnings and Alerts

A new alerting systems has been built into the Membase Web Console. This is sued to highlight specific issues and prob-

lems that you should be aware of and may need to check to ensure the health of your Membase cluster.

Alerts are provided as a popup within the web console. A sample of the IP address popup is shown below:


16/17


16

Figure 13. Warning Notification

The following errors and alerts are supported:

IP Address Changes

If the IP address of a Membase Server in your cluster changes, you will be warned that the address is no longer avail-

able. You should check the IP address on the server, and update your clients or server configuration.

OOM (Hard)

Indicates if the bucket memory on a node is entirely used for metadata.

OOM (Temporary)

Indicates when a bucket on a node is temporarily unable to accept new items and is now waiting for additional items to

be ejected to disk to free up active memory.

Commit Failure

Indicates that writing data to disk for a specific bucket has failed.

Metadata Overhead

Indicates that a bucket is now using more than 50% of the allocated RAM for storing metadata and keys, reducing the

amount of RAM available for data values.


17/17


17

Disk Usage

Indicates that the available disk space used for persistent storage has reached at least 90% of capacity.

5. Licenses

This documentation and associated software is subject to the following licenses.

5.1. Documentation License

This documentation in any form, software or printed matter, contains proprietary information that is the exclusive prop-

erty of Couchbase. Your access to and use of this material is subject to the terms and conditions of your Couchbase Soft-

ware License and Service Agreement, which has been executed and with which you agree to comply. This document and

information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Couchbase with-

out prior written consent of Couchbase or as specifically provided below. This document is not part of your license agree-

ment nor can it be incorporated into any contractual agreement with Couchbase or its subsidiaries or affiliates.

Use of this documentation is subject to the following terms:

You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is al-lowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documenta-

tion in any form or on any media, except if you distribute the documentation in a manner similar to how Couchbase dis-

seminates it (that is, electronically for download on a Web site with the software) or on a CD-ROM or similar medium,

provided however that the documentation is disseminated together with the software on the same medium. Any other use,

such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, re-

quires the prior written consent from an authorized representative of Couchbase. Couchbase and/or its affiliates reserve

any and all rights to this documentation not expressly granted above.

This documentation may provide access to or information on content, products, and services from third parties. Couchbase

Inc. and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party

content, products, and services. Couchbase Inc. and its affiliates will not be responsible for any loss, costs, or damages in-

curred due to your access to or use of third-party content, products, or services.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any

errors, please report them to us in writing.

Membase Features 1.7

Documents

Transcript of Membase Features 1.7