Apache Geode CHANGELOG

Using Pulse Views

Pulse provides a variety of different views to help you monitor Geode clusters, members, and regions.

The following sections provide an overview of the main Pulse views:

Cluster View

The cluster view is a high-level overview of the cluster. It is displayed immediately after you log into Pulse. Information displays around the perimeter of the cluster view show statistics such as memory usage, JVM pauses, and throughput. You can use the cluster view to drill down into details for individual members and regions in the cluster.

Use these basic controls while in Cluster view:

  1. Click Members or Data to display information about Geode members or data regions in the cluster.
  2. Click the display icons to display the Geode members using icon view, block view, or table view. Note that icon view is available only when displaying Members.

    For example, the following shows Geode Members displayed in table view:

    • While in block view or table view, click the name of a Geode member to display additional information in the Member View.
    • Click Topology, Server Groups, or Redundancy Zones to filter the view based on all members in the topology, configured server groups, or configured redundancy zones. The following shows Geode Regions displayed in table view:
    • While in block view or table view, click the name of a Geode region to display additional information in the Region View.
  3. While in icon view, click a host machine icon to display the Geode members on that machine.

  4. In the Alerts pane, click the severity tabs to filter the message display by the level of severity.

Cluster View Screen Components

The following table describes the data pieces displayed on the Cluster View screen.

Screen Component Description
Cluster Status Overall status of the cluster being monitored. Possible statuses include Normal, Warning, or Severe.
Total Heap Total amount of memory (in GB) allocated to the Java heap across all members.
Members Total number of members in the cluster.
Servers Total number of servers in the cluster.
Clients Total number of clients in the cluster.
Locators Total number of locators in the cluster.
Regions Total number of regions in the cluster.
Functions Total number of functions registered in the cluster.
Unique CQs Total number of unique CQs. Corresponds to the UNIQUE _CQ_QUERY statistic.
Subscriptions Total number of client event subscriptions.
Cluster Members Graphical, block, or table view of the members in the cluster.
Topology Organizes cluster members by DistributedMember Id.
Server Groups Organizes cluster members by server group membership. If no server groups are configured, all members appear under the “Default” server group.
Redundancy Zones Organizes cluster members by redundancy zones. If no redundancy zones are configured, all members appear under the “Default” zone.
Host Machine When you mouse over a machine icon in Topology View, a pop-up appears with the following machine statistics:
  • CPU Usage. Percentage of CPU being used by Geode processes on the machine.
  • Memory Usage. Amount of memory (in MB) being used by Geode processes.
  • Load Avg. Average number of threads on the host machine that are in the run queue or are waiting for disk I/O over the last minutes. Corresponds to the Linux System statistic loadAverage1. If the load average is not available, a negative value is shown.
  • Sockets. Number of sockets currently open on the machine.
Member When you mouse over a member icon in Graphical View, a pop-up appears with the following member statistics:
  • CPU Usage. Percentage of CPU being used by the Geode member process.
  • Threads. Number of threads running on the member.
  • JVM Pauses. Number of times the JVM used by the member process has paused due to garbage collection or excessive CPU usage.
  • Regions. Number of regions hosted on the member process.
  • Clients. Number of client currently connected to the member process.
  • Gateway Sender. Number of gateway senders configured on the member.
  • Port. Server port of the cache server member where clients can connect and perform cache operations.
  • GemFire Version. The version of the Geode member.
Member In List View, the following data fields are displayed for each member:
  • ID. DistributedMember Id of the member.
  • Name. Name of the member.
  • Host. Hostname or IP address where the member is running.
  • Heap Usage. Amount of JVM heap memory being used by the member process.
  • CPU Usage. Percentage of CPU being used by the Geode member process.
  • Uptime. How long the member has been up and running.
  • Clients. Number of clients currently connected to the member. It will have a value only if the member acts as a CacheServer.
Key Statistics Displays a few key performance measurements of the cluster (over the last 15 minutes).
Write/Sec Number of write operations per second that have occurred across the cluster. Each put/putAll operation counts as a write; for example, a putAll of 50 entries is counted as one write.
Read/Sec Number of read operations per second that have occurred across the cluster.
Queries/Sec Number of queries per second that have been executed across the cluster.
No. of JVM Pauses Number of times the JVM has paused during the last five minutes to perform garbage collection.
WAN Information If you have configured gateway senders or receivers for a multi-site (WAN) deployment, this box displays whether the remote cluster is reachable (working connectivity represented by a green triangle).
Disk Throughput Total disk throughput for all disks in cluster.
Alerts View Displays alerts for the cluster.

Member View

When you select an individual Geode member in Cluster View, Pulse displays the regions available on that member, as well as member-specific information such as the configured listen ports.

Use these basic controls while in Member View:

  1. Click the display icons to display regions using block view or table view.
  2. Use the drop down menu to select a specific member or search for specific members by name.
  3. Click Cluster View to return to Cluster View. See Cluster View.
  4. Click Data Browser to query region data. See Data Browser.

Member View Screen Components

The following table describes the data elements displayed on the Member View screen.

Screen Component Description
Member Status Overall status of the member being monitored. Possible statuses include Normal, Warning, or Severe.
Regions Total number of regions hosted on the member.
Threads Total number of threads being executed on the member.
Sockets Total number of sockets currently open on the member.
Load Avg. Average number of threads on the member that are in the run queue or are waiting for disk I/O over the last minute. Corresponds to the Linux System statistic loadAverage1. If the load average is not available, a negative value is shown.
Clients Current number of client connections to the member.
Member Regions Block or table view of the regions hosted on the member.
Regions When you mouse over a region in block view, a pop-up appears with the following data fields:
  • Name. Region name.
  • Type. For example, REPLICATE, PARTITION.
  • EntryCount. Number of entries in the region.
  • EntrySize. The aggregate entry size (in bytes) of all entries. For replicated regions this field provides a value only if the eviction algorithm is set to EvictionAlgorithm#LRU_ MEMORY. All partition regions can report entry size, but note that the value includes redundant entries and also counts the size of all the secondary entries on the node.
Regions In table view, the following fields are listed for each region:
  • Name. Region name.
  • Type. For example, REPLICATE, PARTITION.
  • EntryCount. Number of entries in the region.
  • EntrySize. The aggregate entry size (in bytes) of all entries. For replicated regions this field provides a value only if the eviction algorithm is set to EvictionAlgorithm#LRU_ MEMORY. All partition regions can report entry size, but note that the value includes redundant entries and also counts the size of all the secondary entries on the node.
  • Scope. Scope configured for the region.
  • Disk Store Name. Name of disk stores (if any) associated with the region.
  • Disk Synchronous. True if writes to disk are set to synchronous and false if not. This field reflects the configured disk-synchronous region attribute.
  • Gateway Enabled. Whether gateway sender and receiver configurations have been defined on members hosting this region.
Member Clients In table view, the following fields are listed for each client:
  • Id. DistributedMember ID of the client process.
  • Name. Name of the client process.
  • Host. Hostname or IP address of the client process.
  • Connected. Whether the client process is currently connected to the member.
  • Queue Size. The size of the queue used by server to send events in case of a subscription enabled client or a client that has continuous queries running on the server.
  • CPU Usage. Percentage of CPU being used by the client process.
  • Uptime. Amount of time the client process has been running.
  • Threads. Threads being used by the member clients
  • Gets. Total number of successful get requests completed.
  • Puts. Total number of successful put requests completed.
Key Statistics Displays a few key performance measurements for the member (over the last 15 minutes).
% CPU Usage Percentage of CPU used by the member.
Read/Sec Number of read operations per second that have occurred on the member.
Write/Sec Number of write operations per second that have occurred on the member. Each put/putAll operation counts as a write; for example, a putAll of 50 entries is counted as one write.
Memory Usage Total memory used on the member in MB.
No. of JVM Pauses Number of times the JVM has paused during the last five minutes due to garbage collection or excessive CPU usage.
WAN Information Displays cluster information. This dialog box only appears if you have configured WAN functionality (gateway senders and gateway receivers).
Disk Throughput Rate of disk writes on the member.

Region View

The Pulse Region View provides a comprehensive overview of all regions in the cluster:

Use these basic controls while in Region View:

  1. Click the display icons to display all members that host the region using block view or table view.

    (Click the name of a member to change to that member’s Member View.)

  2. Search for specific members that host the current region.

  3. Hover over a member name to display information such as the region entry count, entry size, and throughput on that member.

  4. Click Cluster View or Data Browser to go to those screens.

Region View Screen Components

The following table describes the data elements displayed on the Region View screen.

Screen Component Description
Region Members Lists information about Geode members that host the region, either in block view or table view.
Region Member (Detail View) When you hover over a region member in block view, a pop-up appears with the following data fields:
  • Member Name. The name of the Geode member hosting the region.
  • EntryCount. Number of entries for the region on that member.
  • EntrySize. The aggregate entry size (in bytes) of all entries. For replicated regions this field provides a value only if the eviction algorithm is set to EvictionAlgorithm#LRU_ MEMORY. All partition regions can report entry size, but note that the value includes redundant entries and also counts the size of all the secondary entries on the node.
  • Accessor. Indicates whether the member is an accessor member.
  • Reads/Writes. Summary of reads and writes served from memory and from disk stores over the last 15 minutes.
Region Member (Table View) In table view, the following fields are listed for each region member:
  • ID. The unique member ID.
  • Name. Region name.
  • Host. Member hostname.
  • Heap Usage. The total amount of heap used on the member in MB.
  • CPU Usage. CPU usage as a percent of available CPU.
  • Uptime. The amount of time elapsed since the member started.
  • Accessor. Indicates whether the member is an accessor member.
Region Detail When you have selected a region, the right hand pane displays the following information about the region:
  • Name. Name of the region.
  • Region Path. Path for the region.
  • Type. For example, REPLICATE, PARTITION
  • Members. Number of members that are hosting the region.
  • Empty Nodes. Nodes where the region DataPolicy is defined as EMPTY or where LocalMaxMemory is set to 0.
  • Entry Count. Total number of entries in the region.
  • Disk Usage. Persistent data usage.
  • Persistence. Indicates whether the region’s data is persisted to disk.
  • Memory Usage. The amount of memory used and total available memory (also shown as a percentage).
  • Reads/Writes. Summary of reads and writes served from memory and from disk stores over the last 15 minutes.

Data Browser

The Pulse Data Browser enables you to query region data. Note that there are two key attributes available on DistributedSystemMXBean (see List of Geode JMX MBeans) that you can use to configure limits for the result sets displayed in Data Browser:

  • QueryResultSetLimit limits the number of rows that Data Browser queries return. 1000 rows are displayed by default.
  • QueryCollectionsDepth limits the number of elements of a collection that Data Browser queries return. This attribute applies to query results contain collections such as Map, List, and so forth. The default value is 100 elements.

See the org.apache.geode.management.DistributedSystemMXBean JavaDocs for information on available MBean methods and attributes.

The following shows an example Data Browser view:

Use these basic controls while in Data Browser view:

  1. Search for the name of a specific region.
  2. Select one or more regions to display the Geode members that host those regions. The hosting Geode members appear in the Region Members section.
  3. Select one or more members from the Region Members section to restrict query results to those members.
  4. Type in the text of a query to execute. See Querying.
  5. Display a list of previously-executed queries. Double-click on a query from the history list to copy it to the Query Editor, or delete the query from your history.
  6. Execute your query or clear the contents of the Query Editor.
  7. View the current query results.
  8. Export the query results to a text file.
  9. Return to Cluster View.

Alerts Widget

The Alerts Widget appears in the right portion of the screen and displays a list of alerts.

The alerts displayed for the cluster appear based on the alertLevel field set in the DistributedSystemMXBean. By default, log messages with the level of SEVERE are shown as alerts. You can modify the level by using the DistributedMXBean.changeAlertLevel method. See System Alert Notifications for more information.

Use these basic controls in the Alerts Widget:

  1. Select an alert level to view only alerts with a specific severity.
  2. Enter text in the search box to filter the list of alerts.
  3. Select an alert and click Clear to remove it from the alert list.
  4. Click Clear All to remove all alerts from the widget.
  5. Double-click an alert to open a pop-up window that displays the full text of the alert message.
  6. Click the check mark in an alert pop-up window to acknowledge the alert. Acknowledged alerts display a check mark in the list of alerts.
  7. Triple-click the alert in the pop-up or in the alert list to select the message text. You can then copy and paste the text into another application.
  8. Click the X to close the pop-up alert window.