Search

Page tree
Skip to end of metadata
Go to start of metadata

To ensure efficient management and high availability of Adeptia Suite for various business requirements, you may need to monitor the status and performance of Adeptia Suite. For this, you need to understand the usage of various resources such as memory, log database, and repository database, and more.

Adeptia Suite enables you to monitor the performance of Adeptia server with the help of various parameters. To monitor various parameters of Adeptia Suite, you need to give your request in the form of HTTP request. The current values of these parameters are returned in the XML data.

This section enables you to understand how can you monitor the performance of Adeptia server and which parameters are displayed. In addition, it also explains how this information is presented to the user.

Prerequisites

You must start Kernel and WebRunner before monitoring Adeptia server.

Adeptia Suite enables you to monitor the performance of the Kernel and WebRunner separately. In addition, you can also monitor the performance of the complete cluster as well.

To monitor the performance of Adeptia Suite, you need to send a request as a HTTP URL in the below format:

http://<hostname>:<port>/adeptia/control/monitorMatrix?monitorFlag=<monitorflag>&matrixFlag=<matrixflag>
where,
<hostname> is the name of the server on which Adeptia Suite is running.
<port> is the Web server HTTP port number on which HTTP Adeptia Suite WebRunner is running. By default, Adeptia Suite WebRunner runs at 8080.
<monitorflag> is used to define JVM for which you want to monitor the performance. It can have any of the following three values:

    • kernel
    • webrunner
    • cluster
  • When you set kernel as the monitorflag, then parameters of Kernel JVM are displayed.
  • When you set webrunner as the monitorflag, the parameters of WebRunner JVM are displayed.
  • When you set cluster as the monitorflag, status of all nodes of the cluster are displayed.
  • When you set <monitorflag> to cluster then do not provide any value to the <matrixflag>. Then the format for the HTTP URL is:

    http://<hostname>:<port>/adeptia/control/monitorMatrix?monitorFlag=<cluster>


<matrixflag> is used to define the category of parameters for which you want to monitor. Each category of parameter has a set of properties. The <matrixflag> can have any of the following values:

  • memory
  • gc
  • thread
  • repositoryDB
  • logDB
  • all
  • default


The table below lists these categories and the parameters displayed in each category.

Category

Parameter

Description

 

memory

UP-TIME OF JVM

Up-time of the JVM shows how long the JVM has been running.

 

 

HEAP MEMORY

Heap Memory is the storage for Java objects. Heap memory is the run-time data area from which JVM allocates memory for all class instances and arrays.

 

 

MAX MEMORY

MAX Memory is the maximum amount of memory to which heap can grow.

 

 

USED MEMORY

USED Memory is the amount of heap memory in use.

 

 

COMMITTED MEMORY

Committed Memory is the amount of memory allocated to heap.

 

 

INIT MEMORY

Init Memory is the amount of memory, which JVM initially requests from Operating System for memory management.

 

 

NON-HEAP MEMORY

Non-heap memory includes a method area shared among all threads and memory required for the internal processing or optimization for JVM. Non-heap Memory is used by Java to store loaded classes and other meta-data.

 

 

MAX MEMORY

MAX Memory is the maximum amount of memory that can be used for memory management.

 

 

USED MEMORY

USED Memory is the amount of memory currently used. Memory used includes the memory occupied by all objects.

 

 

COMMITTED MEMORY

Committed Memory is the amount of memory guaranteed to be available for use by JVM.

 

 

INIT MEMORY

Init Memory is the amount of memory, which JVM initially requests from Operating System for memory management.

 

gc

GARBAGE COLLECTION

Garbage Collection (GC) is how JVM frees memory occupied by objects that are no longer referenced. It is the process of releasing memory used by dead objects.

 

 

GARBAGE COLLECTOR NAME

Garbage Collector Name is the name of the memory manager.

 

 

GARBAGE COLLECTIONS

Garbage Collections are the total number of collections that have occurred.

 

 

TOTAL TIME SPENT

Total Time Spent is the approximate accumulated collection elapsed time.

 

thread

PEAK THREAD

Highest number of live threads since JVM started.

 

 

PEAK THREAD COUNT

Counts the peak live thread since JVM started or peak was reset.

 

 

LIVE THREAD

Current number of live daemon threads plus non-daemon threads.

 

 

LIVE THREAD COUNT

Counts the current number of live threads including both daemon and non-daemon threads.

 

 

DAEMON THREAD

Threads that work in the background to support the runtime environment.

 

 

THREAD DEADLOCK COUNT

Counts the number of threads that are in deadlock waiting to acquire object monitors or synchronizers that can be owned.

 

logDB/ repositoryDB

DATABASE MATRIX TYPE

Shows the type of database. The database can be log database and repository database.

 

 

STATUS

Shows whether the connection to database is active or not. Its values are UP/DOWN.

 

 

ACTIVE CONNECTION COUNT

Counts the current number of active connections that have been allocated from the data source.

 

 

IDLE CONNECTION COUNT

Counts the current number of idle connections that are waiting to be allocated from the data source.

 

 

QUERY RESPONSE TIME

It describes the response time of SQL statement issued to database. By default, Query Response Time is not displayed. For information on how to view Query Response Time, refer to Monitoring Query Response Time.

 

cluster

CLUSTER NODE MATRIX

A cluster is a group of independent Adeptia Suites working collectively as a single system.

 

 

NODE NAME

Shows the IP address of the nodes that are a part of cluster.

 

 

TYPE

Specifies the type of node - PRIMAY (SERVER) or SECONDARY (MEMBER).

 

 

STATUS

Specifies if a node is up (running) or not. Its values are UP/DOWN.

 

 

NETWORK LINK

Specifies if network link to this node is UP/DOWN.

 

all

Displays every parameter of all categories.

default

Displays set of default parameter. For information on how to define default parameters, refer to Configuring Default Monitoring Parameters.


The performance of Adeptia Server is presented in the XML format. In response to the request sent to Adeptia Suite in the form of URL, an XML page is displayed. This XML page displays the information with respect to the flags passed in the URL.

For example, if Adeptia Suite is running on your local machine and if you hit the following URL:
http://localhost:8080/adeptia/monitorMatrix?monitorFlag=kernel&matrixFlag=memory

The following XML response is returned. This page displays values of different memory parameters of kernel.



Values for parameters are displayed in the default units. For example, value of memory is displayed in MB. To change this unit, open the monitoring-matrix.properties file and change the required properties.

Following are the major subsections:

Section NameDescription

Configuring Default Monitoring Parameters

Configuring default monitoring parameters.

Monitoring Query Response Time

Introduction to Query Response Time and step-by-step instructions to configure SQL query are also provided.

Enabling Authentication

Authorizing users to monitor the performance parameters.
  • No labels