TIBCO ActiveSpaces Monitoring and Management Console …...Monitoring and Management Console Guide Software Release 2.2 May 2016 Two-Second Advantage ® Important Information SOME

TIBCO ActiveSpaces® Monitoring and ManagementConsole GuideSoftware Release 2.2May 2016

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCHEMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (ORPROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THEEMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANYOTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS ANDCONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTEDSOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THECLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOADOR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USERLICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THESOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, ANDYOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BEBOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright lawsand treaties. No part of this document may be reproduced in any form without the writtenauthorization of TIBCO Software Inc.

TIBCO, Two-Second Advantage, The Power of Now, TIB, Information Bus, Rendezvous, TIBCORendezvous, and Messaging Appliance are either registered trademarks or trademarks of TIBCOSoftware Inc. in the United States and/or other countries.

Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform EnterpriseEdition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks ofOracle Corporation in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of theirrespective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOTALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASEDAT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWAREVERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSOR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCOSOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S)AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 1997 - 2016 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information

2

TIBCO ActiveSpaces® Monitoring and Management Console Guide

Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

The TIBCO ActiveSpaces Monitoring and Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Accessing the ActiveSpaces Monitoring and Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Monitoring a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Details of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

General Information about a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Overview of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Top Spaces by Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Top Spaces by Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Top Member by Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Top Average Member Get Latency by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Top Average Member Put Latency by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Top Average Member Get Throughput by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Top Average Member Put Throughput by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Advisories of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Activity Monitor of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Space Put and Take Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Space Get and Query Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Average Put Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Average Get Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Average Member Put Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

Average Member Get Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

The Details View of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Details View of the Space and Members Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Details View of Entries and Replicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Details View of the Members Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Details View of the Space Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Details View of the Member Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Details View of the Member System Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Summary of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Closing a Metaspace Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Monitoring a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Details of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

General Information of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Overview of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40

3


Viewing the Detailed Information of Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Viewing the Entries and Replicas Information of Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Viewing the Space Seeder Operation Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

Viewing the Space Seeder Lock/Unlock Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Viewing the Member Operation Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Viewing the Member Average Latency Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Activity Monitor of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Space Put and Take Operations of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Space Get and Query Operations of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Average Put Throughput of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Average Get Throughput of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Average Member Put Latency of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Average Member Get Latency of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

The Space Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Creating a Query using the Filter Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Creating a Query using the Custom Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Sorting Queries in Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

4


Figures

The Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Metaspace Details Categorized in Three Panes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

General Information about a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Overview of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Top Spaces by Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Top Spaces by Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Top Member by Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Top Average Member Get Latency by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Top Average Member Put Latency by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Top Average Member Get Throughput by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Top Average Member Put Throughput by Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Advisories of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

Monitoring the Activity of Space Put and Take Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Top Graph of the Space Put and Take Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Bottom Graph of the Space Put and Take Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Monitoring Space Get and Query Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Monitoring Average Put Throughput of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Monitoring Average Get Throughput of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Monitoring the Average Member Put Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Monitoring the Average Member Get Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Details View Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Details View of the Space and Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Details View of Entries and Replicas of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Details View of Members Operations of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Details View of Space Operations of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Details View of the Member Latency of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Details View of the Member System Monitors of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Summary of a Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Details a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

General Information of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Space Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40

Viewing the Detailed Information of Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Entries and Replicas Information of Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

Space Seeder Operation Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Space Seeder Lock/Unlock Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Member Operation Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Member Average Latency Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Put and Take Operations of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

5


Get and Query Operations of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Average Put Throughput of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Average Get Throughput of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

Average Member Put Latency of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Average Member Get Latency of a Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Space Query Menu Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

The Query Builder is Displayed on the Right Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Query Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Filter Expression Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

The Space Custom Filter Expression Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54

6


TIBCO Documentation and Support Services

Documentation for this and other TIBCO products is available on the TIBCO Documentation site. Thissite is updated more frequently than any documentation that might be included with the product. Toensure that you are accessing the latest available help topics, please visit:

https://docs.tibco.com

Product-Specific Documentation

The following documents for this product can be found on the TIBCO Documentation site:

● TIBCO ActiveSpaces® Installation

● TIBCO ActiveSpaces® Administration

● TIBCO ActiveSpaces® Monitoring and Management Console Guide

● TIBCO ActiveSpaces® Developer's Guide

● TIBCO ActiveSpaces® C API Reference

● TIBCO ActiveSpaces® Java API Reference

● TIBCO ActiveSpaces® .NET API Reference

● TIBCO ActiveSpaces® Release Notes

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support:

● For an overview of TIBCO Support, and information about getting started with TIBCO Support,visit this site:

http://www.tibco.com/services/support

● If you already have a valid maintenance or support contract, visit this site:

https://support.tibco.com

Entry to this site requires a user name and password. If you do not have a user name, you canrequest one.

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is aplace to share and access the collective experience of the TIBCO community. TIBCOmmunity offersforums, blogs, and access to a variety of resources. To register, go to the following web address:

https://www.tibcommunity.com

7


https://docs.tibco.com

http://www.tibco.com/services/support

https://support.tibco.com

https://www.tibcommunity.com

The TIBCO ActiveSpaces Monitoring and ManagementConsole

The TIBCO ActiveSpaces® Monitoring and Management (ASMM) Console provides an administrativeinterface and a console interface. The Console is a web-based utility that connects to one or moremetaspaces, and displays information about metaspaces, metaspace members, and connected spaces. Inaddition, you can use the console to monitor performance. Monitoring information includes detailedstatistics about members and spaces and performance graphs for space operations.

Monitoring includes a summary of the currently connected metaspaces, and a set of monitoring viewsthat show various statistics for the connected metaspaces, such as Top Spaces by Entries, Top Spaces byGet, Take, and Put Operations, Average Get and Put Latency and Throughput.

8


Accessing the ActiveSpaces Monitoring and ManagementConsole

Procedure

● Login to the Console by using the URL shared by your administrator.

Result

The ASMM Console is displayed. The Home page lists the metaspace available on the server. Thegeneral information of the metaspace appears on the left pane.

The Home Page

9


Monitoring a Metaspace

Procedure

1. Connect to the Console with the URL provided by your Administrator or if you have administrativeprivileges, access it directly from the ASMM Admin main page.

2. From the Home page, select the metaspace from the summary list in the center pane you want tomonitor.

3. Hover around the bottom portion of the pane, and click Monitor.

Result

The Metaspace details page is displayed. The left pane lists the spaces under the metaspace. The centerpane lists details of the metaspace, and the right pane lists some general information about themetaspace.

Metaspace Details Categorized in Three Panes

10


Details of a Metaspace

When you click a Metaspace, the details about the metaspace are displayed in the center, and the rightpane.

The center pane is divided into the following panes:

● Overview

● Advisories

● Activity Monitor

The General Information shown on the right pane is divided into the following headers:

● Connection

● Time

● Spaces

11


General Information about a Metaspace

The general information of the metaspace is shown on the right pane and it comprises the following:Connection, Time, and Spaces.

Connection

The Connection header comprises the following:

● Discovery: The Discovery URL. The discovery URL can be unicast or multicast. If unicast discoveryis used, then a list of 'well known' IP addresses and ports must be passed in a URL with thefollowing syntax:tcp://ip1:port1;ip2:port2;...

If multicast discovery is to be used then the URL must be one of the following depending on whichreliable multicast transport is to be used:

The tibrv (multicast) URL takes three parameters: service, network, and daemon. In many cases, thedefault values are sufficient.tibrv://service=service/network=network/daemon=daemon

● Listen: The Listen URL. Specifies which interface and port the administrative process should createits listening TCP socket on.

● Manager: The host and port of the manager process connected to the metaspace.

● Members: Lists the servers and clients associated with a metaspace. Servers refer to memberprocesses connected to the metaspace. Clients refer to remote client member processes connected tothe proxy of the metaspace.

● Hosts: Lists all distinct server host machines and the corresponding number of members connectedto the metaspace.

● Agents: Shows the number of as-agent processes connected to the metaspace.

● Admins: Shows the number of as-admin processes connected the metaspace.

● Hawks: Shows the number of as-hawk-agent processes connected to the metaspace.

Time

The Time header comprises the following:

● Start Time: The joining time of the first member that joined the metaspace.

● Uptime: The time elapsed since the first member joined the metaspace.

Spaces

The Spaces header comprises the following:

● Space Definitions: Number of user spaces defined in the metaspace.

● Persistence: Number of space definitions that are enabled for persistence categorized by Shared AllPersistence type and Shared Nothing Persistence type.

12


General Information about a Metaspace

13


Overview of a Metaspace

The overview of a metaspace shows the following:

1. Total Number of Entries: Total number of entries stored and distributed in the metaspace from alluser defined spaces. This total excludes the number of replicas. The value updates automatically asentries are added and removed from the metaspace.

2. Total Number of Put/Get/Take Operations : Total number of Put, Get, and Take operationsperformed on all user-defined spaces. The value increments automatically as operations areperformed on any user space in the metapsace.

3. Based on the page you are on, a graphical representation of the top five spaces based on differentlayers of the metaspace.

4. Seven pages of information that can be run as a slideshow. The following table lists the nature of thecontent displayed on every page that updates periodically as the statistics changes:

Page Content on the page

1 Top spaces by entries

2 Top spaces by operations

3 Top members by operations

4 Top average member Get latency by space

5 Top average member Put latency by space

6 Top average member Get throughput by space

7 Top average member Put throughput by space

Overview of a Metaspace

14


Top Spaces by EntriesThe page one of the Overview section shows the top five spaces by entries. The spaces are listed in thedescending order of the number of entries contained in the metaspace. Alongside the number ofentries, you are also shown the percentage of entries with respect to the metaspace.

The listing comprises the top five spaces that contain the highest number of entries and itscorresponding percentage based on the total number of entries stored in the metaspace. The pie charton the left displays the percentage distribution of the entries stored for all user spaces.

Top Spaces by Entries

Top Spaces by OperationsThe page two of the overview shows the top five spaces by operations. The page contains informationabout the Get, Put, and Take operations performed on a space.

The listing comprises the top five spaces that had performed the highest number of Put, Get and Takeoperations by all members connected to the metaspace and the corresponding percentage distribution.The corresponding percentage distribution of Put, Get, and Take operations are also displayed on eachof the top five spaces. The pie chart on the left displays the percentage distribution of the operationsperformed for all user spaces.

Top Spaces by Operations

Top Member by OperationsThe page three of the Overview section shows the members by operations. In an integrated system,there can be many members.

The top five members on which the maximum operations are performed are displayed here. The listingcomprises the top five members that had performed the highest number of Put, Get and Takeoperations on all user spaces defined in the metaspace and the corresponding percentage distribution.The pie chart on the left displays the percentage distribution of operation performed by membersconnected to the metaspace.

15


Top Member by Operations

Top Average Member Get Latency by SpaceThe Get latency is the execution time required for a Get operation. The page four shows the top fivemembers with an average get latency. The average time displayed is in microseconds.

The listing comprises the top five spaces that had the highest average latency in performing Getoperations executed by all space members measured in microseconds. Latency is measured based onthe time elapsed on executing a Get operation on a user space performed by a space member. The barchart on the left provides a graphical presentation on the five spaces with the highest average Getoperation latency. The space members can either be leeches or seeders of the space. The higher thelatency, slower the performance.

Top Average Member Get Latency by Space

Top Average Member Put Latency by SpaceThe Put latency is the execution time required for a Put operation.

The page five shows the top five members with an average Put latency. The average time displayed is inmicroseconds. The Put operation might take longer time than a Get operation.

The listing comprises the top five spaces that had the highest average latency in performing Putoperations executed by all space members measured in microseconds. Latency is measured based onthe time elapsed on executing a Put operation on an user space performed by a space member. The barchart on the left provides a graphical presentation on the five spaces with the highest average Putoperation latency. The space members can either be leeches or seeders of the space. The higher thelatency, slower the performance.

16


Top Average Member Put Latency by Space

Top Average Member Get Throughput by SpaceThe Get throughput is the number of Get Operations you can perform in a second. The page six showsthe top average member get throughput.

The listing comprises the top five spaces that had the highest average throughput in performing the Getoperations executed by all the space members. This is measured in the number of Get operations persecond. Throughput is the number of Get operations that can be performed by a space member basedon the latency in executing each Get operation. The bar chart on the left provides a graphicalpresentation on the five spaces with the highest average Get throughput. The space members can eitherbe leeches or seeders of the space. The higher the throughput, higher the performance.

Top Average Member Get Throughput by Space

Top Average Member Put Throughput by SpaceThe Put throughput is the number of Put Operations you can perform in a second. The page sevenshows the top average member get throughput.

The listing comprises the top five spaces that had the highest average throughput in performing the Putoperations executed by all space members. This is measured in the number of Put operations persecond. Throughput is the number of Put operations that can be performed by a space member basedon the latency in executing each Put operation. The bar chart on the left provides a graphicalpresentation of the five spaces with the highest average Put throughput. The space members can eitherbe leeches or seeders of the space. The higher the latency, higher the performance.

17


Top Average Member Put Throughput by Space

18


Advisories of a Metaspace

The Advisories section notifies you when a new member joins or leaves the server, or when a new spaceis created.

When you click the icon and click Show More, you see more such notifications.

The Advisories section notifies you when the following events are detected:

● A member joins or leaves the metaspace.

● A member joins or leaves a user space.

● A space is newly defined or dropped.

Advisories of a Metaspace

19


Activity Monitor of a Metaspace

The activity monitor can be used to see how some operations were performing over a point in time.

The activity monitor provides a set of charts capturing the historical statistics of the activities on a spaceoperation that are performed by members of a metaspace. The statistics is gathered continuously overtime and aggregated on the server.

The following set of activities can be monitored:

● Space Put and Take Operations

● Space Get and Query Operations

● Average Get Throughput

● Average Put Throughput

● Average Member Get Latency

● Average Member Put Latency

The recent statistics is always displayed on the rightmost pane for each data series. Data is capturedperiodically in regular intervals on the ASMM server. Each graph is a view that continuously rolls topresent near real-time data. You are presented with a graphical view of the statistics on the browserbased on the selected category of activities. Each presented graph contains a fixed number of datapoints based on the selected time periods.

You can view the historical data of the operations mentioned in the bulleted list over the followingperiods in time:

● last 10 minutes

● last 1 hour

● last 4 hours

● last day

For example, you can see the Space Put and Take Operations of the last 1 hour.

Space Put and Take OperationsSpace Put and Take Operations takes into account all the updates for all spaces that are performed byall members connected to the metaspace.

You can see a graphical representation of the Put and Take operations performed on all spaces over apoint in time. For example, to see the Put and Take Operations performed in the last 10 minutes, clickActivity Monitor > Space Put and Take Operations > Last 10 minutes.

The graph shows the operations that have taken place in the last ten minutes. Similarly you can see datafor the past one hour, four days, or the last day.

20


Monitoring the Activity of Space Put and Take Operations

The top graph shows 2 data series representing the Put and Take operations over time. Put counts arepresented as positive values and the Take counts are presented as negative values.

Top Graph of the Space Put and Take Operations

The bottom graph shows the corresponding total number of entries stored in the metaspace sharing thesame time line.

Bottom Graph of the Space Put and Take Operations

21


Space Get and Query OperationsSpace Get and Query Operations takes into account all the queries made to a metaspace.

You can see a graphical representation of the Get and Query operations performed on a space over apoint in time. For example, to see the Get and Query Operations performed in the last 1 hour, clickActivity Monitor > Space Get and Query Operations > Last 1 hour. The graph shows the operationsthat have taken place in the last one hour. Similarly you can see data for the past one hour, four days, orthe last day.

Monitoring Space Get and Query Operations

The top graph shows two data series representing the Get and Query operations over time.

The bottom graph shows the corresponding total number of entries stored in the metaspace sharing thesame time line.

Average Put ThroughputThe Average Put Throughput is used to display the average Put throughput over a point in time.

You can see this information for the last 10 minutes, last 1 hour, last 4 hours, or last day. The top graphshows two data series representing the Space Average Put Throughput and Member Average PutThroughput.

22


Monitoring Average Put Throughput of a Metaspace

The bottom graph shows two data series showing the number of Put operations performed by the spacemembers and the number of seeding space members sharing the same time line.

The Space Average Put Throughput is computed based on the total number of Put operations issued byall space members over time. The unit of measurement is the number of Put operations per second. TheSpace Put Throughput represents how fast your applications are issuing Put operations to the spaces.

The Member Average Put Throughput is computed based on the average Put latency performed by allspace members over time. The unit of measurement is the number of Put operations per second. TheMember Put Throughput represents how fast the underlying ActiveSpaces engine performs a Putoperation taking into account the following:

● the latency of the network connection performance independent of how often a Put operation isissued by your applications.

Average Get ThroughputThe Average Get Throughput is used to display the average Get throughput over a point in time for allspaces and all members.

You can see this information for the last 10 minutes, last 1 hour, last 4 hours, or last day. The top graphshows two data series representing the Space Average Get Throughput and Member Average GetThroughput.

23


Monitoring Average Get Throughput of a Metaspace

The bottom graph shows two data series showing the number of Get operation performed by all spacemembers and the number of seeding space members sharing the same time line.

The Space Average Get Throughput is computed based on the total number of Get operations issued byall space members over time. The unit of measurement is the number of Get operations per second. TheSpace Get Throughput represents how fast your applications are issuing Get operations to the spaces.

The Member Average Get Throughput is computed based on the average Get latency performed by allspace members over time. The unit of measurement is the number of Get operations per second. TheMember Get Throughput represents how fast the underlying ActiveSpaces engine performs a Getoperation taking into account the following:

● the latency of the network connection performance independent of how often a Get operation isissued by your applications.

Average Member Put LatencyAverage Member Put Latency is used to display the average Put latency for a member. Latency refers tothe time elapsed to complete a Put operation performed by a space member.

You can see this information for the last 10 minutes, last 1 hour, last 4 hours, or last day.

24


Monitoring the Average Member Put Latency

The top graph shows the average latency for all Put operations performed by all space members inmicroseconds. The average member Put latency represents how fast the underlying ActiveSpacesengine performs Put operations irrespective of how often a Put operation is issued by yourapplications.

The bottom graph shows two data series showing the number of Put operation performed by all spacemembers and the number of seeding space members sharing the same time line.

Average Member Get LatencyAverage Member Get Latency is used to display the average Get latency for a member. Latency refers tothe time elapsed to complete a Get operation performed by a space member.


25


Monitoring the Average Member Get Latency

The top graph shows the average latency for all Get operations performed by all space members inmicroseconds. The average member get latency represents how fast the underlying ActiveSpacesengine can perform Get operations irrespective of how often a Get operation is issued by yourapplications.


26


The Details View of a Metaspace

You can use the Details view of a metaspace to see details about spaces and members, entries andreplicas, member operations, and so on.

Use the icon next to the Metaspace name to see the details view.

Details View Icon

Details of the following are displayed:

● Space and Members Info

● Entries and Replicas

● Member Operations

● Space Operations

● Member Latency

● Member System Monitors

A Summary is displayed on the right pane for all these options.

Details View of the Space and Members InfoThe Details View of the Space and Members Info shows the Space, Operations, and Distribution in atabular format.

The top section shows the details of the user Spaces and a pie chart of the corresponding Spaceoperation distribution. The bottom table shows the following Member Details:

● Member - member name.

● Member ID - unique identification of a member.

● Type - Server or Client. Server represents a full peer member in the metaspace. A Client represents aremote client connected through a proxy member on the metaspace.

● Host - Host name or IP address of the machine that this member resides.

● Port - Listening port opened for data communication.

● Process - The process name is one of the following: as-agent, as-java, as-admin, as-hawk.

● Process ID - Unique identifier of the process for this member.

● Join Time - Time when this member joined the metaspace.

27


Details View of the Space and Members

Details View of Entries and ReplicasThe Details View of the Entries and Replicas shows the Members, Entries, and Distribution in a tabularformat.

The top section shows the details of the number of entries stored on all the Members and a pie chartdisplaying the corresponding distribution by Members.

Details View of Entries and Replicas of a Metaspace

28


The bottom table displays the details entries and replicas information group by Space:

● Space: name of the space

● Entries: total number of entries stored in all seeder space members

● %Distribution: percentage distribution of all entries stored in the metaspace

● Replicas: total number of replicas stored in all seeder space members

● %Distribution: percentage distribution of all replicas stored in the metaspace

● %Seeders: number of seeder space members that store the entries and replicas

● Capacity: Maximum capacity (for the Space definition if defined) per seeder space member

● Evicts: total number of evicted entries if eviction policy is enabled and capacity is defined

● %Entries/Capacity*Seeders: ratio of the total number of entries over the maximum capacityconfigured. If persistence is enabled, this represents the amount of data persisted versus residing inthe process memory of the seeder space members.

Details View of the Members OperationsThe Details View of the Members Operations shows the Space, Operations, and Distribution in atabular format.

The top section shows the details number of operation performed by each member and a pie chartdisplaying the corresponding distribution by Members. The number of operation includes Put, Get andTake performed on all Spaces. This gives you a view of the busiest applications.

Details View of Members Operations of a Metaspace

The bottom table displays the operation breakdown performed by all member group by Space:

● Space - name of the space

29


● Puts - Put operation count

● Gets - Get operation count

● Takes - Take operation count

● Queries - Browser Queries count

● Locks - Lock operation count

● Unlocks - unlock operation count

● Invokes - remote invocation count

Details View of the Space OperationsThe Details View of the Space Operations shows the Space, Operations, and Distribution in a tabularformat.

The top section shows the details number of operation performed on each Space by all space membersand a pie chart displaying the corresponding distribution by Space. The number of operation includesPut, Get and Take performed on all Spaces. This gives you a view of the busiest Space.

Details View of Space Operations of a Metaspace

The bottom table displays the operation breakdown performed on all Spaces group by Member:

● Member – name of the member

● Puts - put operation count

● Gets - get operation count

● Takes - take operation count

● Total - total number of put/get/take

● % Distribution

30


Details View of the Member LatencyThe Details View of the Member Latency shows the Member, Operations, and Distribution in a tabularformat.

The top section shows the details number of operation performed by each member and a pie chartdisplaying the corresponding distribution by Members. The number of operation includes Put, Get andTake performed on all Spaces. This gives you a view of the busiest applications.

Details View of the Member Latency of a Metaspace

The bottom table displays the operation breakdown and the corresponding latency performed by allspace member group by Space:

● Space - name of the space

● Member Puts - number of Put operation perform by all space members

● Average Latency - average time elapsed for a member to complete a Put operation in microseconds

● Total Time - total number of time spent on executing Put operations by all space members

● Average Throughput - average number of put operations per second computed based on the latency

● Member Gets - number of Get operation performed by all space members

● Average Latency - average time elapsed for a member to complete a Get operation in microseconds

● Total Time - total number of time spent on executing Get operations by all space members

● Average Throughput - average number of get operations per second computed based on the latency

● Member Takes - number of Take operation performed by all space members

● Average Latency - average time elapsed for a member to complete a Take operation in microseconds

● Total Time - total number of time spent on executing Take operations by all space members

● Average Throughput - average number of Take operations per second computed based on thelatency

31


Details View of the Member System MonitorsThe Details View of the Member Latency shows the Member, Operations, and Distribution in a tabularformat.

The top section shows the details of the number of operations performed by each member and a piechart displaying the corresponding distribution by Members. The number of operation includes Put,Get and Take performed on all Spaces. This gives you a view of the busiest applications.

Details View of the Member System Monitors of a Metaspace

The bottom table displays the System Statistics group by member when enabled. System statisticsmonitor is enabled through the as-admin console.

● AS Version - software version of AS

● User - owner of the process

● PID - process identifier

● #Threads - number of threads for the process

● #CPU - number of CPU processor

● %CPU - percentage CPU utilization

● Memory - memory used

● %Load - percentage load of the system

● Record Time - recording time of this entry

Right Click the <<Add Menu Icon>> to increase or decrease the number of columns shown in thestatistics.

Summary of a MetaspaceA summary of the metaspace is displayed on the right pane.

The summary lists the following:

● Number of Space Definitions

● Total number of entries and replicas

32


● Total number of Put, Get, and Take operation

● Total number of members

Summary of a Metaspace

33


Closing a Metaspace Session

When you close a metaspace, this ends your session with the metaspace. The metaspace is stillconnected to the server for serving other users connected to the console.

Procedure

● Select a metaspace, select and click Close.

34


Monitoring a Space

Prerequisites

Follow the Monitoring a Metaspace procedure to monitor the metaspace.

Procedure

1. From the left pane, click the metaspace to list the spaces defined under the metaspace.

2. Click one of the spaces to monitor the space.

Result

The Space details page is displayed. The left pane lists the spaces under the metaspace. The center panelists details of the space, and the right pane lists some general information about the space.

35


Details of a Space

When you click a space, the details about the space are displayed in the center and the right pane.

The center pane is divided into the following panes: Overview, Members, and Activity Monitor. TheGeneral Information shown on the right pane is divided into the following headers: Data in Memory,Persistence, Replication, Timeouts, Query, Locks, Field Definition, and Key Definition.

Details a Space

36


General Information of a Space

The general information of a space contains the following: Data in Memory, Persistence, Replication,Timeouts, Query, Locks, Field Definition, and Key Definition.

Data in Memory

The Data in Memory header contains the following information:

● Distribution Policy: The type of distributed policy. Select one of the following types of policies:

— DISTRIBUTED: Storage of entries is distributed amongst the seeder members of the space. Theentries are distributed uniformly according to the values of the primary key fields.

— NON-DISTRIBUTED: Storage of entries is assigned to a single seeder member of the Space.● Min Seeder Count: The minimum seeder count. The default is 1 that means at least one seeder

member must be assigned for storing the entries.● Time to live: The Time to Live (TTL) is specified in milliseconds. It represents the lifetime of each

entry created in the space. If TTL is set in the space definition, each entry is automatically deletedfrom the space when it expires. The default is -1 which means the entries never expire by default.

● Capacity: Every seeder member can specify the maximum number of entries to be stored per seedermember. On reaching the capacity, further insertion of an entry into the space by a Put operationresults in an exception. If Eviction policy is set, the member evicts another stored entry based on theEviction Policy set.

● Eviction Policy: The following are the two types of Eviction policies:

— None: This is the default. If the capacity of a seeder exceeds, the seeder throws an exception onthe space operation.

— LRU: On reaching the maximum capacity, the seeder evicts entries using the 'Least RecentlyUsed' algorithm to make room for new entries being inserted in the space.

Persistence

The Persistence header contains the following information:

● Type: The types of persistence. It is either SHARED_NOTHING or SHARED_ALL.● Persist Policy: Specifies the type of persistence policy. It is either asynchronous or synchronous. The

default is asynchronous.● Sync Interval: The synchronization interval. This is available only for SHARED_NOTHING persistence

policy. The file synchronization interval for the SHARED_NOTHING persistence file reside on eachseeder member.

Replication

The Replication header contains the following information:

● Rep Count: The number of replicas to be maintained. The default is 0 to indicate that no replicas aremaintained except for the original copy.

Timeouts

The Timeouts header contains the following information:

● Space Wait: The interval in milliseconds. Specifies the amount of time space operations wait until aspace becomes READY. For example, a space is not READY when there is no seeder or there areinsufficient number of seeders as specified by the minimum number of seeder count.

37


● Read Timeout: The interval in milliseconds for a Read operation to timeout. The default is 60000ms.

● Write Timeout: The interval in milliseconds for a Write operation to timeout. The default is 60000ms.

Query

The Query header contains the following information:

● Query Limit: The maximum number of entries to return on executing a query using the spacebrowser. The default is 10000.

● Query Timeout: The interval in milliseconds for a query to timeout. The default is 60000 ms.

Locks

The Locks header contains the following information:

● Time to live: The time in milliseconds until a lock is automatically cleared. The default of -1 is usedto indicate that a lock never expires.

● Wait timeout: Time in milliseconds to wait for the lock to be cleared if the entry is currently locked.The default is -1 to indicate that the lock operation waits forever to acquire the lock.

● Lock Scope: The scope of a lock. By default, it is the THREAD scope. It can be either of the following:

— THREAD: Only the processing thread can unlock the key that was previously locked.

— PROCESS: Any processing thread in the process can unlock the key that was previously locked.

Field Definition

The Field Definition lists all the fields defined for the space.

Key Definition

The Key Definition lists all the fields defined for the space. The Index type can be a HASH or a TREE.

38


General Information of a Space

39


Overview of a Space

The overview of a space shows the following:

● Total Number of Entries: The total number of entries stored in the Space.

● Total Number of Put/Get/Take Operations: total number of operations performed by the spacemembers.

● Average Member Latency: Average member latency for PUT, GET, and TAKE operations. Latency isthe time elapsed of an operation performed by a space member.

● Space Server Members: The number of seeders and leeches members that joined the space.

● Total Member Operation Time: Total time spent in performing the Put, Get, and Take operations byall space members that joined the space since the metaspace started.

● Space Client Members: The number of remote clients connected to a proxy member on themetaspace.

Space Overview

All values are updated periodically on the ASMM server and presented.

The pie chart on the left displays the percentage distribution of all Put, Get and Take operationperformed by all the connected Space members.

Viewing the Detailed Information of Members

Prerequisites


Procedure

1. From the left pane, click the metaspace to list the spaces under the metaspace.


3. Click Members > Detail Info to see the member details.The following details are displayed:

● Member: Name of the member that joined the space.

● Host: Host name or IP addresses where the member resides.

● Port: Listening port number of the member process for data communications.

● Process: Process name that could be one of the followings: as-java, as-admin, as-agent, as-hawk.

40


● PID: Process identifier.

● Role: Role of the space member: seeder, leech, or remote client.

● Join Time: Time when the member joined the space.

Viewing the Detailed Information of Members

Viewing the Entries and Replicas Information of Members

Prerequisites


Procedure



3. Click Members > Entries and Replicas to see the entries and their corresponding replicas.The following details are displayed:

● Seeder: Name of the seeder space member.

● Entries: Number of entries stored on the seeder.

● Distribution: Percentage distribution of entries stored.

● Replicas: Number of replicas stored on the seeder.

● Distribution: Percentage distribution of replicas stored.

● Evicts: Number of evicted entries by this Seeder.

● Distribution: Percentage distribution of the evicted entries.

Entries and Replicas Information of Members

Viewing the Space Seeder Operation Statistics

Prerequisites


Procedure


2. 2. Click one of the spaces to monitor the space.

41


3. Click Members > Space Seeder Operation Statistics to see the operation statistics on every seedercontributing to the space.The following details are displayed:

● Seeder: Name of the seeder space member.

● Puts: Number of Put operations executed by the seeder.

● Gets: Number of Get operations executed by the seeder.

● Takes: Number of Take operations executed by the seeder.

● Queries: Number of Browser Queries performed by the seeder.

● Expires: Number of entries expired on the seeder.

● Evicts: Number of entries evicted on the seeder.

Space Seeder Operation Statistics

Viewing the Space Seeder Lock/Unlock Statistics

Prerequisites


Procedure



3. Click Members > Member Operation Statistics to see the statistics of every member associated withthe space.The following details are displayed:

● Member: Name of the space member performing the operations.

● Puts: Number of Put operations performed by the space member.

● Distribution: Percentage distribution of Put operations performed by the member.

● Gets: Number of Get operations performed by the space member.

● Distribution: Percentage distribution of Get operations performed by the member.

● Takes: Number of Take operations performed by the space member.

● Distribution: Percentage distribution of Take operations performed by the member.

Space Seeder Lock/Unlock Statistics

42


Viewing the Member Operation Statistics

Prerequisites


Procedure



3. Click Members > Member Operation Latency Statistics Statistics to see the statistics of everymember associated with the space.The following details are displayed:


● Puts: Number of Put operations performed by the space member.

● Distribution: Percentage distribution of Put operations performed by the member.

● Gets: Number of Get operations performed by the space member.

● Distribution: Percentage distribution of Get operations performed by the member.

● Takes: Number of Take operations performed by the space member.

● Distribution: Percentage distribution of Take operations performed by the member.

Member Operation Statistics

Viewing the Member Average Latency Statistics

Prerequisites


Procedure



3. Click Members > Member Average Latency Statistics to see the statistics of average latency of amember associated with the space.The following details are displayed:


● Put: Average Latency on performing a Put operation in microseconds.

● Total: Total time spent in performing the Put operations by a space member that joined the spacesince the metaspace started.

● Get: Average latency on performing a Get operation in microseconds.

43


● Total: Total time spent in performing the Get operations by a space member that joined the spacesince the metaspace started.

● Take: Average latency on performing a Take operation in microseconds.

● Total: Total time spent in performing the Take operations by a space member that joined thespace since the metaspace started.

Member Average Latency Statistics

44


Activity Monitor of a Space

The activity monitor of a space can be used to show how some operations were performing over a pointin time.

The activity monitor provides a set of charts capturing the historical statistics of the activitiesperformed on the space operation activities. The data is gathered continuously over time andaggregated on the server.

The following set of activities can be monitored:

● Space Put and Take Operations

● Space Get and Query Operations

● Average Get Throughput

● Average Put Throughput

● Average Member Get Latency

● Average Member Put Latency

The recent statistics is always displayed on the rightmost pane for each data series. Data is capturedperiodically in regular intervals on the ASMM server. Each graph is a view that continuously rolls topresent near real-time data. You are presented with a graphical view of the statistics on the browserbased on the selected category of activities. Each presented graph contains a fixed number of datapoints based on the selected time periods.

You can view the historical data of the operations mentioned in the bulleted list over the followingperiods in time:

● last 10 minutes

● last 1 hour

● last 4 hours

● last day

For example, you can see the Space Put and Take Operations of the last 1 hour.

Space Put and Take Operations of a SpaceSpace Put and Take Operations take into account all the updates for a space connected to themetaspace.

You can see a graphical representation of the Put and Take operations performed on the space over apoint in time. For example, to see the Put and Take Operations performed on the space in the last 10minutes, click Activity Monitor > Space Put and Take Operations > Last 10 minutes. The graph showsthe operations that have taken place in the last ten minutes. Similarly you can see data for the past onehour, four days, or the last day.

45


Put and Take Operations of a Space

The top graph shows two data series representing the Put and Take operations over time. Put countsare presented as positive values while Take counts are presented as negative values.

The bottom graph shows the corresponding total number of entries stored in the space sharing thesame time line.

Space Get and Query Operations of a SpaceSpace Get and Query Operations take into account all the queries made to a space.

You can see a graphical representation of the Get and Query operations performed on a space over apoint in time. For example, to see the Get and Query Operations performed on the space in the last 10minutes, click Activity Monitor > Space Get and Query Operations > Last 10 minutes. The graphshows the operations that have taken place in the last ten minutes. Similarly you can see data for thepast one hour, four days, or the last day.

46


Get and Query Operations of a Space

The top graph shows two data series representing the Get and Query operations over time.

The bottom graph shows the corresponding total number of entries stored in the space sharing thesame time line.

Average Put Throughput of a SpaceThe Average Put Throughput is used to display the average Put throughput over a point in time.


Average Put Throughput of a Space

47


The bottom graph shows two data series showing the number of Put operations performed by the spacemembers and the number of seeding space members sharing the same time line.

The Space Average Put Throughput is computed based on the total number of Put operations issued byall space members over time. The unit of measurement is the number of Put operations per second. TheSpace Put Throughput represents how fast your applications are issuing Put operations to the spaces.

The Member Average Put Throughput is computed based on the average Put latency performed by allspace members over time. The unit of measurement is the number of Put operations per second. TheMember Put Throughput represents how fast the underlying ActiveSpaces engine performs a Putoperation taking into account the following:

● the latency of the network connection performance independent of how often a Put operation isissued by your applications.

Average Get Throughput of a SpaceThe Average Put Throughput is used to display the average Put throughput over a point in time.


Average Get Throughput of a Space


The Space Average Get Throughput is computed based on the total number of Get operations issued byall space members over time. The unit of measurement is the number of Get operations per second. TheSpace Get Throughput represents how fast your applications are issuing Get operations to the spaces.

The Member Average Get Throughput is computed based on the average Get latency performed by allspace members over time. The unit of measurement is the number of Get operations per second. TheMember Get Throughput represents how fast the underlying ActiveSpaces engine performs a Getoperation taking into account the following:

● the latency of the network connection performance independent of how often a Get operation isissued by your applications.

48


Average Member Put Latency of a SpaceAverage Member Put Latency is used to display the average Put latency for a member of a space.Latency refers to the time taken to complete a Put operation performed by a space member.


Average Member Put Latency of a Space

The top graph shows the average latency for all Put operations performed by all space members inmicroseconds. The average member Put latency represents how fast the underlying ActiveSpacesengine performs Put operations irrespective of how often a Put operation is issued by yourapplications.

The bottom graph shows two data series showing the number of Put operation performed by all spacemembers and the number of seeding space members sharing the same time line.

Average Member Get Latency of a SpaceAverage Member Get Latency is used to display the average Get latency for a member of a space.Latency refers to the time taken to complete a Get operation performed by a space member.


49


Average Member Get Latency of a Space

The top graph shows the average latency for all Get operations performed by all space members inmicroseconds. The average member get latency represents how fast the underlying ActiveSpacesengine can perform Get operations irrespective of how often a Get operation is issued by yourapplications.


50


The Space Browser

You can use the space browser to query the data stored on a specific space.

A space browser is contextual and is available as a menu option on every space defined for theassociated metaspace visible in the UI. When you select the Space Query option, the query builder isdisplayed on the right most pane of the page.

Space Query Menu Option

Query Builder

The Query builder is to the top-right corner of the page. The space browser gives you two ways ofconstructing a space query. You can use Custom Filter or Filter Builder to create your queries. TheCustom Filter option is used to type in the query filter expression directly. The Filter Builder option is

an UI that helps you build your query filter expression. The icon is used to edit the query and the icon is used to execute the query.

The Query Builder is Displayed on the Right Pane

Query Result

When you execute the query, the results are published under the Query Result pane. By default, theQuery Result pane shows 10 entries and can span multiple pages. You can see up to a maximum of 100entries per page. You can use the Previous and Next buttons to traverse through the query results. The

icon can be used to select the number of columns appearing on the Query Result pane. To see extra

columns, click the icon.

51


Query Result

The maximum number of entries is limited to the Query Limit set by the Administrator per metaspaceconnection. The default is 2000. You can enter a filter expression to narrow down the result set asneeded.

Creating a Query using the Filter BuilderThe Filter Builder is used to create a query using Space Query Filter Expression Builder. The query isautomatically generated with the help of the expression builder.

Procedure

1. Under a metaspace, select a space of your choice.

2. Click the icon and select Space Query.The Query Builder is displayed on the right side of the pane.

3. Select Query > Filter Builder.

4. Click the icon.The Space Query Filter Expression Builder window is displayed. The lower half of the windowshows a list of Field, Operation, and Value.

52


Filter Expression Builder

5. To build a filter expression, perform the following steps:a) From the Field list, select the field you want to base your query on.b) From the Operation list, select an appropriate operation.c) From the Value list, select or enter a value corresponding to the field type.

d) Click the icon.The query expression gets added to the top half of the Expression Builder pane.

e) (Optional). Repeat the steps a-d for adding another expression. By default, all clauses are joinedby an AND operator. So when you add 2 expressions, results are shown only if both are true.

The Filter Builder only supports the AND operator to join two or more clauses.

f) Click OK.This query is saved but not executed.

6. To execute the query, click the icon.The results are displayed in the Query Result pane.

Creating a Query using the Custom FilterThe Custom Filter option is used to type in your query without the help of an expression builder.

Procedure

1. Under a metaspace, select a space of your choice.

2. Click the icon and select Space Query.The Query Builder is displayed on the right side of the pane.

3. Select Query > Custom Filter.

4. Click icon.The Space Custom Filter Expression window is displayed.

53


The Space Custom Filter Expression Window

5. Enter the expression.

6. Click OK.The expression is visible under the Query Builder section.

7. To execute the query, click the icon.The results are displayed in the Query Result pane.

Sorting Queries in BrowsersActiveSpaces provides the ability to sort queries that are made using browsers. The sorting feature isimplemented in the filter that is used for specifying a browser query. The filter can now use order bystatements.

The order by clause is a part of the filter. It is similar to the method used with SQL. There is no changein the API.

The following are examples of order by statements in filters:

● order by key

● id < 100 order by id

● id = 5 and key < 100 order by key

● id < 10 order by id, key

Note the following points:

Syntax

<query> order by <field1>, <field2>, . . . needs to be added to the end of the filter.

There is no limit on the number of fields you can have.

Requirements

A TREE index with fields is used in the order bysection. The index can be a, b, c and where the orderby is performed on a, b.

If the index has more than one field and order by is executed only on one field, the sorting will workonly if the field name is the first entry in the index.

CURRENT time scope.

If the order by cannot be satisfied due to requirements 1 or 2 as stated above, then an exception isthrown.

54


Change in Behavior

Index selection for queries is dictated by the use of order by in the filter. The use of order by in aquery filter can override the indices that would normally be used by the query.

Consider the following query:

key<10 order by id

If the user has an index on “key” and another index on “id,” ActiveSpaces will pick the index on “id”over the index on “key” and perform a table scan to validate “key<10."

55


Documents

TIBCO ActiveSpaces Monitoring and Management Console …...Monitoring and Management Console Guide Software Release 2.2 May 2016 Two-Second Advantage ® Important Information SOME