You are on page 1of 1198

Applications Manager User

Guide
User Manual

Created: Thursday, June 01, 2017

Copyright © Zoho Corp.. All Rights Reserved.


Applications Manager User
Guide

copyright © Zoho Corp.. All rights reserved.


http://help.appmanager.com/

The information contained in this document is subject to change without notice.


This document contains proprietary information which is protected by copyright.
All rights are reserved. No part of this document may be photocopied, reproduced,
or translated to another language without the prior written consent of Zoho Corp..
Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Table of Contents

Applications Manager ............................................................................................................................ 1


Applications Manager 13 ................................................................................................................ 1
Introduction ............................................................................................................................. 2
Key Features .................................................................................................................... 2
Monitoring Capabilities ..................................................................................................... 3
Release Notes .................................................................................................................. 7
System Requirements ........................................................................................................... 26
Hardware and Software requirements ........................................................................... 26
Differences between Windows and Linux versions ........................................................ 28
Installation and Setup ........................................................................................................... 29
Installation and Setup .................................................................................................... 29
Installation Guide ........................................................................................................... 30
Licensing Applications Manager ..................................................................................... 35
Using Update Manager ................................................................................................... 36
Starting and Shutting Down ........................................................................................... 37
Compare the Editions ..................................................................................................... 39
Getting Started ..................................................................................................................... 40
Getting Started .............................................................................................................. 40
Prerequisites for Applications Manager .......................................................................... 41
Understanding Applications Manager ............................................................................. 73
Working with Applications Manager ............................................................................... 77
Working with Monitor Groups ................................................................................................ 78
Working with Monitor Groups ......................................................................................... 78
Associating Monitors to Monitor Groups ......................................................................... 79
Creating Monitor Groups ................................................................................................ 80
Creating New Web Application Group ............................................................................ 82
Deleting Monitor from Monitor Groups ........................................................................... 84
Editing and Deleting a Monitor Group ............................................................................ 85
VMware Virtual Infrastructure Groups ............................................................................ 86
New Monitors & Performance Metrics ................................................................................... 87
Creating a New Monitor .................................................................................................. 87
Viewing Performance Metrics ......................................................................................... 88
Application Servers ................................................................................................. 92

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Application Servers Monitoring ........................................................................ 92


Microsoft .NET .................................................................................................. 93
GlassFish Servers ............................................................................................. 96
JBoss Servers ................................................................................................... 98
Jetty Servers ................................................................................................... 103
Resin Servers ................................................................................................. 108
Oracle Application Servers ............................................................................. 112
Tomcat Servers .............................................................................................. 116
Silverstream Servers ...................................................................................... 124
VMware vFabric tc Servers ............................................................................. 127
WebLogic Servers .......................................................................................... 133
WebSphere Servers ........................................................................................ 138
Cloud Apps ............................................................................................................ 144
Cloud Applications Monitoring ........................................................................ 144
Amazon .......................................................................................................... 145
EC2 Instances .......................................................................................... 150
RDS ......................................................................................................... 154
Microsoft Azure .............................................................................................. 157
Azure Virtual Machines ............................................................................ 161
Azure Storage ......................................................................................... 170
Windows Azure Cloud Service (Classic) .......................................................... 182
Open Stack ..................................................................................................... 188
Custom Monitors ................................................................................................... 190
Custom Monitoring ......................................................................................... 190
Adding JMX MBean Attributes ......................................................................... 192
Adding SNMP OID Attributes .......................................................................... 194
File / Directory Monitors ................................................................................. 195
Database Query Monitors ............................................................................... 198
Scripts Monitors ............................................................................................. 201
Windows Performance Counters .................................................................... 213
Database Servers .................................................................................................. 215
Database Server Monitoring ........................................................................... 215
MySQL DB Monitoring ..................................................................................... 216
Oracle DB Monitoring ..................................................................................... 221
MS SQL DB Servers ........................................................................................ 244

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

IBM DB2 Servers ............................................................................................ 268


IBM Informix DB Servers ................................................................................ 273
SAP HANA DB Servers .................................................................................... 276
Sybase DB Servers ......................................................................................... 283
PostgreSQL Servers ........................................................................................ 288
Apache HBase Monitoring .............................................................................. 293
NoSQL Database Servers ............................................................................... 301
CouchBase Servers ................................................................................. 302
MongoDB Servers .................................................................................... 306
Redis Servers .......................................................................................... 310
Memcached Servers ................................................................................ 313
Oracle NoSQL Database Servers ............................................................. 316
ERP ........................................................................................................................ 323
Oracle EBS Monitor ........................................................................................ 323
SAP CCMS Monitor .......................................................................................... 330
SAP Server Monitor ........................................................................................ 332
Siebel Monitor ................................................................................................ 337
Microsoft Dynamics CRM ................................................................................ 343
Microsoft Dynamics AX .................................................................................. 348
Mail Servers .......................................................................................................... 353
Exchange Servers .......................................................................................... 353
Mail Servers ................................................................................................... 390
Middleware / Portal ............................................................................................... 391
Middleware / Portal Monitors .......................................................................... 391
Microsoft MQ (MSMQ) ..................................................................................... 392
Azure Service Bus .......................................................................................... 394
Office SharePoint Server ................................................................................ 400
WebLogic Integration ..................................................................................... 405
WebSphere MQ .............................................................................................. 407
WebSphere MQ Message Broker .................................................................... 414
VMware vFabric RabbitMQ ............................................................................. 416
Microsoft BizTalk ............................................................................................ 419
Oracle Tuxedo ................................................................................................ 424
Microsoft Lync Server ..................................................................................... 429
Apache Kafka ................................................................................................. 460

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Apache ActiveMQ ........................................................................................... 464


Servers .................................................................................................................. 469
Server Monitor ............................................................................................... 469
Windows ......................................................................................................... 474
Windows Server Cluster ................................................................................. 483
Linux .............................................................................................................. 488
AS400 / iSeries ............................................................................................... 494
Virtualization ......................................................................................................... 506
Virtualization .................................................................................................. 506
VMware ESX/ESXi Servers .............................................................................. 507
Virtual Machines ...................................................................................... 512
VMware vCenter Servers ......................................................................... 515
Microsoft Hyper-V Servers .............................................................................. 517
Virtual Machines ...................................................................................... 522
Citrix Xenserver ............................................................................................. 524
Virtual Machines ...................................................................................... 529
Docker ............................................................................................................ 532
Containers ............................................................................................... 534
Citrix XenApp ................................................................................................. 536
VMware Horizon View Connection Broker ...................................................... 544
Web Server / Services ........................................................................................... 550
Web Server / Services .................................................................................... 550
Apache Solr .................................................................................................... 560
Elasticsearch .................................................................................................. 565
ServiceDesk Plus ............................................................................................ 572
ManageEngine OpManager ............................................................................ 575
HAProxy ......................................................................................................... 579
Services ................................................................................................................ 585
Service Monitoring ......................................................................................... 585
Apache Zookeeper ......................................................................................... 595
Ceph ............................................................................................................... 600
Hadoop ........................................................................................................... 603
Oracle Coherence Servers .............................................................................. 609
Apache Spark ................................................................................................. 612
HTTP URL Monitors ................................................................................................ 619

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Java Runtime Monitors .......................................................................................... 625


Real Browser Monitor (RBM) .................................................................................. 630
Web User Experience (Beta) ................................................................................. 639
Alarms ................................................................................................................................. 642
Alarms .......................................................................................................................... 642
Alarm Details ................................................................................................................ 644
Viewing and Configuring Alarms Globally .................................................................... 645
Creating Threshold Profile ............................................................................................ 647
Actions ......................................................................................................................... 649
Creating Actions .................................................................................................... 649
Sending E-mails ............................................................................................. 650
Sending SMS .................................................................................................. 651
Executing Program ......................................................................................... 652
Sending Trap .................................................................................................. 653
Execute MBean Operation .............................................................................. 655
Log a Ticket .................................................................................................... 656
Perform Java Action ........................................................................................ 657
Amazon EC2 Instance Action .......................................................................... 658
Virtual Machine Action ................................................................................... 659
Replaceable Tags ........................................................................................... 660
Container Actions ........................................................................................... 662
Windows Services Action ............................................................................... 663
Associating Threshold and Action with Attributes ........................................................ 664
Alarm Escalation .......................................................................................................... 665
Bulk Alarms Configuration ............................................................................................ 666
Configuring Dependencies and Alarm Rules ................................................................ 667
Configuring Consecutive Polls ...................................................................................... 670
Reports ................................................................................................................................ 671
Reports ......................................................................................................................... 671
7 / 30 Reports .............................................................................................................. 673
Capacity Planning Reports ........................................................................................... 678
Forecast Reports .......................................................................................................... 681
Grouping of Reports ..................................................................................................... 682
Admin Activities .................................................................................................................. 689
Performing Admin Activities ......................................................................................... 689

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Discovery and Data Collection ..................................................................................... 691


Bulk Import of Monitors ......................................................................................... 691
Network Discovery ................................................................................................ 694
Custom Monitor Types .......................................................................................... 697
Performance Polling .............................................................................................. 700
Downtime Scheduler ............................................................................................. 708
Server Process Templates ..................................................................................... 710
Windows Service Templates ................................................................................. 712
Credential Manager ............................................................................................... 713
Alarm / Action .............................................................................................................. 714
Availability Settings ............................................................................................... 714
Action / Alarm Settings .......................................................................................... 716
Event Log Rules .................................................................................................... 718
Alarm Escalation ................................................................................................... 721
Global SNMP Trap Action ....................................................................................... 722
SNMP Trap Listener ............................................................................................... 724
Monitor Group Rules .............................................................................................. 725
Integration with Portals ................................................................................................ 726
REST API ................................................................................................................ 726
JSON Feed ............................................................................................................. 727
Dashboards ........................................................................................................... 728
World Map ............................................................................................................. 729
Product Settings ........................................................................................................... 730
Global Settings ...................................................................................................... 730
Configure Mail Server ............................................................................................ 732
Configure SMS Server ........................................................................................... 733
Configure Proxy ..................................................................................................... 734
User Administration .............................................................................................. 735
Logging ................................................................................................................. 744
Personalize Web Client .......................................................................................... 745
Product Integration ............................................................................................... 746
Add-on Settings - Help Desk Integration ............................................................... 747
ServiceDesk Plus Integration .......................................................................... 747
ServiceNow Integration .................................................................................. 751
Add-on Settings - Product Integration ................................................................... 753

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Site 24X7 Integration ..................................................................................... 753


Connector Settings ......................................................................................... 755
OpStor SAN Monitor Connector ............................................................... 755
OpManager Network Monitor Connector ................................................. 758
Reporting ..................................................................................................................... 761
Reports Settings .................................................................................................... 761
Enable Reports ...................................................................................................... 763
Schedule Reports .................................................................................................. 764
Business Hours ...................................................................................................... 765
Tools ............................................................................................................................ 766
Upload Files / Binaries ........................................................................................... 766
Self Monitoring ...................................................................................................... 767
Bulk Config ................................................................................................................... 769
Data Backup ................................................................................................................. 772
Server Settings ............................................................................................................. 775
Production Environment ............................................................................................... 782
REST APIs ............................................................................................................................ 783
Applications Manager - REST APIs ................................................................................ 783
Add Monitor .................................................................................................................. 785
AddMonitor API ...................................................................................................... 785
Application Servers ............................................................................................... 788
Cloud Apps ............................................................................................................ 796
Custom Monitors ................................................................................................... 798
Database Servers .................................................................................................. 804
ERP ........................................................................................................................ 814
EUM ....................................................................................................................... 819
Java Transaction .................................................................................................... 823
Mail Servers .......................................................................................................... 824
Middleware / Portal ............................................................................................... 826
Servers .................................................................................................................. 833
Services ................................................................................................................ 841
Virtualisation ......................................................................................................... 850
Web Server / Services ........................................................................................... 855
Downtime Scheduler Options ....................................................................................... 862
Downtime Scheduler API ....................................................................................... 862

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Create Downtime Scheduler Tasks ....................................................................... 863


Edit Downtime Scheduler Tasks ............................................................................ 867
Get Downtime Scheduler Tasks ............................................................................ 871
Delete Downtime Scheduler Tasks ........................................................................ 872
Edit Monitor .................................................................................................................. 873
Edit Monitor API ..................................................................................................... 873
Edit DNS Monitor ................................................................................................... 874
Edit Service Monitor .............................................................................................. 876
Edit SSL Certificate Monitor ................................................................................... 877
Edit URL Monitor ................................................................................................... 878
Monitor Group Opertaions ............................................................................................ 880
Add Monitor Group ................................................................................................ 880
Add Sub-Group ...................................................................................................... 881
Associate Monitor to Monitor Group ...................................................................... 882
Delete Monitor Group ............................................................................................ 883
Delete Sub-Group .................................................................................................. 884
Edit Monitor Group ................................................................................................ 885
Get Group Availability ........................................................................................... 886
Move Group ........................................................................................................... 888
Unassociate Monitor from Monitor Group .............................................................. 889
List Data ....................................................................................................................... 890
Get Downtime Details ........................................................................................... 890
Get Monitor Data ................................................................................................... 893
List Actions ............................................................................................................ 895
List Alarms ............................................................................................................ 897
List Dashboards .................................................................................................... 900
List Monitor ........................................................................................................... 902
List Monitor Groups ............................................................................................... 905
List Monitor Group Details ..................................................................................... 908
List Monitor Types ................................................................................................. 912
List Server ............................................................................................................. 914
Search ................................................................................................................... 916
Show Polled Data .................................................................................................. 918
User Management ........................................................................................................ 921
Create User ........................................................................................................... 921

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Delete User ........................................................................................................... 922


Get All User Roles ................................................................................................. 923
List User Details .................................................................................................... 924
Update User .......................................................................................................... 926
Add UserGroup ...................................................................................................... 928
Delete Usergroup .................................................................................................. 929
List Usergroups ..................................................................................................... 930
Update Usergroups ............................................................................................... 931
Perform Operations ...................................................................................................... 932
Alarm Actions ........................................................................................................ 932
Authenticator ........................................................................................................ 934
Apply License ........................................................................................................ 936
Configure Mail Server ............................................................................................ 937
Configure Proxy Server ......................................................................................... 939
Configure SMS Server ........................................................................................... 941
Delete Monitor ...................................................................................................... 942
Enable / Disable Actions ........................................................................................ 943
Execute Action ...................................................................................................... 944
Manage ................................................................................................................. 945
UnManage ............................................................................................................. 946
Ping ....................................................................................................................... 947
PollNow ................................................................................................................. 949
UnManage and Reset Status ................................................................................. 950
Admin Activities API ..................................................................................................... 951
REST APIs for Enterprise Edition ............................................................................ 951
Business Hours ...................................................................................................... 953
Configure Alarms .................................................................................................. 957
Credential Manager ............................................................................................... 959
Domain Configuration ........................................................................................... 963
Email Action Configuration .................................................................................... 966
Event Log Configuration ........................................................................................ 970
Mail Server Configuration ...................................................................................... 974
Threshold configuration ........................................................................................ 976
Error Handling .............................................................................................................. 980
Processes and Services ................................................................................................ 985

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

End User Monitoring (EUM) ................................................................................................. 986


How does End User Monitoring Work? .......................................................................... 986
Installing and Uninstalling EUM Agent .......................................................................... 988
EUM Dashboard ............................................................................................................ 991
APM Insight ......................................................................................................................... 992
APM Insight - An Overview ........................................................................................... 992
How does APM Insight work? ........................................................................................ 993
Installing the APM Insight Java Agent ........................................................................... 995
APM Insight .NET Agent .............................................................................................. 1008
APM Insight Ruby on Rails Agent ................................................................................ 1018
APM Insight Agent Configuration Options ................................................................... 1020
APM Insight Dashboard .............................................................................................. 1027
APM Insight Dashboard ....................................................................................... 1027
Web Transaction ................................................................................................. 1029
Apdex Score ........................................................................................................ 1030
ADDM ................................................................................................................................ 1031
What is Application Discovery and Dependency Mapping (ADDM)? ........................... 1031
Features of Dependency Maps ................................................................................... 1032
How to use ADDM? ..................................................................................................... 1033
Enterprise Edition .............................................................................................................. 1034
Enterprise Edition ....................................................................................................... 1034
Admin Server ............................................................................................................. 1036
Managed Server ......................................................................................................... 1040
Single Sign-On ............................................................................................................ 1043
Admin Activities ......................................................................................................... 1044
Failover Setup ............................................................................................................ 1045
Using MSSQL as Backend DB Server ................................................................... 1045
Using PostgreSQL as Backend DB Server ............................................................ 1048
Web Client ......................................................................................................................... 1054
Web Client Details ...................................................................................................... 1054
Icon Representation ................................................................................................... 1055
Custom Dashboards ................................................................................................... 1056
Custom Fields ............................................................................................................. 1062
Mobile Web/ iPhone App ............................................................................................. 1063
Appendix ........................................................................................................................... 1065

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

Applications Manager Home ...................................................................................... 1065


Data Collection - Host Resource ................................................................................. 1066
SNMP Agent Installation ............................................................................................. 1067
SNMP Agent Configuration ......................................................................................... 1071
Security/Firewall Requirements ................................................................................. 1075
User Management Security ........................................................................................ 1079
Blog / Forum Articles .................................................................................................. 1080
Applications Manager - Pricing of Add-Ons ................................................................. 1081
Easy Upgrade .................................................................................................................... 1082
Anomaly Detection ............................................................................................................ 1084
SLA Management .............................................................................................................. 1088
Applications Manager Plugin for OPM ................................................................................ 1090
Support & Product Info ...................................................................................................... 1094
Glossary ............................................................................................................................ 1098
Database Migrations ......................................................................................................... 1100
MySQL to PostgreSQL ................................................................................................. 1101
MySQL/PGSQL to MSSQL ............................................................................................ 1103
PGSQL to SQL Server migration for Applications Manager Plug-in ............................. 1105
Other ................................................................................................................................. 1106
Supported Modems .................................................................................................... 1106
Configuring Google Map ............................................................................................. 1107
Regular Expressions ................................................................................................... 1110
Enabling Powershell ................................................................................................... 1112
Tomcat Server.xml ..................................................................................................... 1113
Tomcat Users.xml ...................................................................................................... 1119
Sample CSVs ..................................................................................................................... 1120
ActiveDirectory_Example ........................................................................................... 1120
Amazon_Example ....................................................................................................... 1121
SolrServer_Example ................................................................................................... 1122
BizTalk_Example ........................................................................................................ 1123
CephStorage_Example ............................................................................................... 1124
CouchBase ................................................................................................................. 1125
DNS_Example ............................................................................................................. 1126
Docker ........................................................................................................................ 1127
DOTNET_Example ...................................................................................................... 1128

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

ESX_Example ............................................................................................................. 1129


Exchange_Example .................................................................................................... 1130
FTP_Example .............................................................................................................. 1132
GlassFish_Example ..................................................................................................... 1133
Hadoop_Example ....................................................................................................... 1134
HBase_Example ......................................................................................................... 1135
HorizonView_Example ................................................................................................ 1136
HyperV_Example ........................................................................................................ 1137
IBMWebsphere_Example ............................................................................................ 1138
DB2_Example ............................................................................................................. 1139
JavaRunTime_Example ............................................................................................... 1140
LDAP_Example ........................................................................................................... 1141
Informix_Example ...................................................................................................... 1142
Memcached_Example ................................................................................................ 1143
MSMQ_Example .......................................................................................................... 1144
MailServer_Example ................................................................................................... 1145
MSSQL_Example ......................................................................................................... 1146
JBoss_Example ........................................................................................................... 1147
Kafka_Example ........................................................................................................... 1148
MySQL_Example ......................................................................................................... 1149
Nginx_Example .......................................................................................................... 1150
OracleAS_Example ..................................................................................................... 1151
OracleEBS_Example ................................................................................................... 1152
Oracle_Example ......................................................................................................... 1153
Coherence_Example ................................................................................................... 1154
OracleNoSQL_Example ............................................................................................... 1155
Ping_Example ............................................................................................................. 1156
Postgresql_Example ................................................................................................... 1157
Rabbitmq_Example .................................................................................................... 1158
Resin_Example ........................................................................................................... 1159
RestAPI ....................................................................................................................... 1160
SAPHANA_Example .................................................................................................... 1161
SDPMonitor_Example ................................................................................................. 1162
Server_Example ......................................................................................................... 1163
Service_Example ........................................................................................................ 1165

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Sample CSVs

SharePoint_Example .................................................................................................. 1166


Siebel_Example .......................................................................................................... 1167
SilverStream_Example ............................................................................................... 1168
SSLCertificate_Example ............................................................................................. 1169
Sybase_Example ........................................................................................................ 1170
Telnet_Example .......................................................................................................... 1171
Tomcat_Example ........................................................................................................ 1172
Tuxedo_Example ........................................................................................................ 1173
URL_Example ............................................................................................................. 1174
vFabric_Example ........................................................................................................ 1175
WebLogic_Example .................................................................................................... 1176
WebService_Example ................................................................................................. 1177
WebSphere_Example ................................................................................................. 1178
WindowsAzure_Example ............................................................................................ 1179
WebLogicIntegration_Example ................................................................................... 1180
XenServer_Example ................................................................................................... 1181
XenApp_Example ....................................................................................................... 1182
OpenStack_example .................................................................................................. 1183

Copyright © 2014 Zoho Corp. Page


Applications Manager User Guide
Applications Manager User Guide Applications Manager

Introduction

ManageEngine® Applications Manager is a comprehensive application monitoring software used to monitor heterogeneous
business applications such as web applications, application servers, web servers, databases, network services, systems, virtual
systems, cloud resources, etc. It provides remote business management to the applications or resources in the network. It is a
powerful tool for system and network administrators, helping them monitor any number of applications or services running in the
network without much manual effort.
Applications Manager offers out-of-the-box discovery, availability, health, performance and fault management, and reporting of
multi--vendor applications.
Alarms are generated to notify the faults in the application and are configured to trigger actions, such as notifying the user through
e-mail, SMS, trap, executing a command and invoking a MBean operation. Through alarms, you can identify the root cause of any
problem in the network with just a few clicks. Additionally, the flexible architecture of the Applications Manager allows you to
manage any application (J2EE or J2SE) that exposes management information via JMX or SNMP through custom applications.

Copyright © 2014 Zoho Corp. Page 1


Applications Manager User Guide
Applications Manager User Guide Introduction

Key Features

The following are some of the key features of Applications Manager.


Note: Apart from the following applications, you can also monitor your own custom applications via scripts. It will be added as a
New Monitor Type.
Feature Description
Microsoft .NET, GlassFish, JBoss and Wildfly, Jetty Servers, Oracle Application Servers, Resin Server, SilverStream , Tomcat Servers, VMware vFabric tc Servers, WebLogic
Application Server Monitoring
Servers, WebSphere Servers and also web-based applications such as Servlets, JSP and EJB of the application servers.
Monitors WebLogic Integration, IBM WebSphere MQ, Microsoft Office Sharepoint , Microsoft Message Queue (MSMQ) servers, Microsoft BizTalk, Microsoft Lync Server, Oracle
Middleware / Portal Monitoring
Tuxedo, Azure Service Bus, Apache HBase and Apache Kafka.
SAP Monitoring Monitors the performance of SAP Servers and SAP CCMS servers.
Oracle EBS Monitoring Monitors the modules of Oracle E-Business Suite.
Comprehensive end-to-end monitoring of Java, Ruby on Rails and .NET web transactions. Provides an indepth view into the performance metrics of all components starting from
APM Insight Monitoring
URLs to SQLs and transaction trace histories.
Monitor VMware ESX/ESXi servers, Microsoft Hyper-V servers and their guest virtual machine instances. Support for monitoring Citrix XenServer, XenApp, Docker and virtual
Virtualization Monitoring
infrastructure components such as data center and cluster through vCenter.
Support for monitoring Amazon EC2 & RDS instances, attached EBS volumes and Amazon S3 buckets. Windows Azure monitor enables users to collect diagnostic data for the
Cloud Apps Monitoring
applications deployed in Windows Azure platform.
Supports monitoring of MySQL, MariaDB, Oracle, IBM DB2, Sybase, MS SQL, CouchBase, PostgreSQL and NoSQL database monitoring for Memcached, Cassandra, MongoDB, IBM
Database Monitoring
Informix and Redis servers.
Monitors the performance of Windows, Linux, Solaris, HP Unix, Tru64, Mac OS, Unix, IBM AIX, IBM AS400 / iSeries, Novell and FreeBSD servers. Also monitors Event Logs for
Host Resource Monitoring
Windows and Windows Server Clusters.
Java Runtime Monitor Provides out-of-the-box remote monitoring and management on the Java platform and of applications that run on it.
File System Monitor Monitors changes in the selected files and directories.
Windows Performance Counters Monitors windows performance counter values through WMI.
Ping Monitor Checks for availability of a device, server or network device.
Script Monitoring Ad-hoc Windows/Linux custom scripts, used in-house can be managed from the same web console.
Services Monitoring Monitors Services such as FTP, DNS, SFTP, Hadoop, Telnet, RMI adaptor, TCP port, JMX Applications, Ping, SNMP, Active Directory, LDAP, Apache Solr and Ceph Storage.
Mail Servers Monitoring Monitors Mail servers (including SMTP servers and POP servers) and Microsoft Exchange Server.
WebServices Monitoring Monitors Apache, IIS,PHP,SSL Certificate,Web Services (SOAP), nginx and other webservers.
End User Experience Monitoring Provides the ability to measure the experience of your end users. Includes support for Real Browser Monitor, DNS, Ping, LDAP and Mail Server monitors.
HTTP URL Monitoring Monitors any HTTP or HTTPS -based URL of web pages.
Custom Application
Groups data sources from multiple resources and displays them in a common place. The data sources can be JMX MBeans and SNMP agents.
Management
Root Cause Analysis Provides details on the different severity levels by identifying its reason/cause.
Fault Management Sends 'Alarms' based on the monitored attributes. These can be escalated through e-mail / SMS /trap/ MBean Operation/ execute a program.
The performance of the monitored application is depicted in the form of graphs and charts for easy analysis. Its powerful reporting mechanism enables you to analyze the trends
Performance Reports
over a period. Scheduling of reports is also possible.
Graphical Representation of The attribute details are represented through graphs that provides an easy approach to understand the "attribute vs time" statistics for one hour. Also the icons and
Attribute Statistics provided in the graphs represent details about the statistics for 7 days and 30 days respectively.
Intuitive Web Client Allows you to perform admin activities through Web browser interface. You can also monitor and view attributes such as the health and availability of the monitors.
Manages a wide range of business applications and network services. It provides you the flexibility to group the application and its related services to be monitored as a single
Holistic view to Monitor Group
unit.
Mobile Web/ iPhone App An optimized view of applications being monitored for all types of smart phones available in the market.
Business Service Management Helps the Manager to have an integrated high-level view of the Business Infrastructure. Location intelligence is added via World Map Business View.
It's scalable architecture provides you the ability to monitor a variety of Monitors. It uses a blend of both agent-based monitoring and agent-less monitoring depending on the
Scalable Architecture
need.
Product Integration Integration with ManageEngine ServiceDesk Plus and Site24x7.

Copyright © 2014 Zoho Corp. Page 2


Applications Manager User Guide
Applications Manager User Guide Introduction

Monitoring Capabilities

This section lists the different types that Applications Manager can monitor. The types are divided into categories based on the type
of system or component.
Note: Apart from the applications mentioned below, you can monitor your own custom applications via scripts. It will be added as a
new monitor type.
Application Servers

● Microsoft .NET
● APM Insight for Java, .NET and Ruby on Rails
● GlassFish Servers
● JBoss Servers
● Jetty Servers
● Java Runtime
● Oracle Application Servers
● Resin Application Server
● SilverStream
● Tomcat Servers
● VMware vFabric tc Server
● WebLogic Servers
● WebSphere Servers

Database Servers

● Cassandra Servers
● CouchBase
● IBM DB2 Servers
● IBM Informix Servers
● Memcached Servers
● MongoDB Servers
● MS SQL Servers
● MySQL/MariaDB Servers
● Oracle Servers
● PostgreSQL Servers
● Redis Servers
● Sybase Servers
● Apache HBase
● SAP HANA DB Servers

Middleware / Portal

● Microsoft BizTalk
● Microsoft Message Queue (MSMQ)
● Microsoft Office SharePoint

Copyright © 2014 Zoho Corp. Page 3


Applications Manager User Guide
Applications Manager User Guide Introduction

● Oracle Tuxedo
● VMware vFabric RabbitMQ
● WebLogic Integration Servers
● IBM Websphere Message Broker
● IBM WebSphere MQ
● Microsoft Lync Server
● Azure Service Bus
● Apache Kafka
● Apache ActiveMQ

ERP

● Oracle E-Business Suite


● SAP CCMS Server
● SAP Server
● Siebel Enterprise Server
● Microsoft Dynamics CRM

Virtualization Solutions

● Microsoft Hyper-V Servers


● VMware ESX/ESXi servers
● VMware Horizon View Connection Broker
● Citrix XenApp
● Citrix Xenserver
● Docker
Cloud Apps

● Amazon EC2
● Amazon RDS
● Amazon S3
● Microsoft Azure
● Windows Azure Cloud Services (Classic)
Services

● Active Directory
● Ceph Storage
● DNS Monitor
● FTP / SFTP Monitor
● Hadoop Monitor
● JMX Applications
● LDAP Monitor
● Ping Monitor
● Service Monitoring
● SNMP

Copyright © 2014 Zoho Corp. Page 4


Applications Manager User Guide
Applications Manager User Guide Introduction

● Telnet
Mail Servers

● Mail Server
● Microsoft Exchange Server

Web Server / Services

● Real Browser Monitor


● Apache Server
● HTTP(s) URL Monitors and HTTP(s) URL Sequence (Record & Playback)
● IIS Server
● Nginx
● PHP
● SSL Certificate Monitor
● Web Server
● Web Services
● Apache Solr Server
● REST API
● ServiceDesk Plus
● ManageEngine OpManager
Servers

● IBM AIX
● IBM AS400 / iSeries
● Free BSD / OpenBSD
● Linux
● Mac OS
● Novell
● Sun Solaris
● HP Unix / Tru64 Unix
● Windows Cluster
● Windows

Custom Monitors

● Database Query Monitor


● File System Monitor
● JMX / SNMP Dashboard
● Script Monitor
● Windows Performance Counters

EUM Monitors

● DNS Monitor
● LDAP Server

Copyright © 2014 Zoho Corp. Page 5


Applications Manager User Guide
Applications Manager User Guide Introduction

● Mail Server
● Ping Monitor
● Real Browser Monitoring

Copyright © 2014 Zoho Corp. Page 6


Applications Manager User Guide
Applications Manager User Guide Introduction

What's new in release 13.3 ?

● HAProxy Monitoring - Ensure proper HAProxy performance and operation is by monitoring its key metrics pertaining to Listener,
Frontend, Backend and Server.
● Microsoft Dynamics AX Monitoring - Collect information pertaining to the performance of each component of the system
architecture, i.e.: Application Object Server (AOS), the SQL Database Server, and their Server Stats.

Minor Enhancements:

● InFlight Count Value For Queue Details in Apache ActiveMQ.


● Bypass proxy option for EUM.
● Enhanced Cassandra Monitoring to collect database, request and keyspace detail metrics.
● Custom Fields support added for Log a Ticket Action.
● Enhanced Event Logs REST API monitoring to include matchcount and matchrules.
● Enhanced MySQL Database monitoring to monitor Database Index details.
● Option to add the same URL monitor to multiple Managed Servers.
● Option to Associate Trap to Monitor Group.
● Enhanced Oracle Monitoring with
● Improved RCA message for Locks now containing the Session Username and information about which sessions
are blocking which.
● Option to view entire history of database backups along with the count of currently running backup jobs.
● Option to view and export entire history of database backups along with the count of currently running backup
jobs.
● Oracle Alert log monitoring support.
● Support for Mongo DB 3.x.
● Enhanced Sybase Monitoring with metrics like User Connection Percentage, Remote User Percentage variables and Database
Details like Log Used Size, Total Log Size and Log Used Percentage.
● Windows cluster support for Windows Server 2012, 2012 R2 and 2016.
Issues fixed in 13.3

● Disabling Active Directory Services was not working. This issue is fixed.
● In AIX monitoring, the Disk busy time & Avg Queue length was wrong. This issue is fixed. | More...

What's new in release 13.2?

● Apache Spark Monitoring - Get real-time operational visibility into Spark applications,key metrics of Apache Spark clusters
(master and worker nodes) and cores.
● Azure Storage Monitoring - Monitor the health and performance of your Azure Storage account for better managing and
utilizing Azure hosted storage resources.
● Site24x7 Integration enhanced to support Authtoken based integration.
Minor Enhancements

● Option to monitor Queue Size Attribute for Apache ActiveMQ.

Copyright © 2014 Zoho Corp. Page 7


Applications Manager User Guide
Applications Manager User Guide Introduction

● Enhanced Downtime Scheduler Dashboard to display Monitors and groups currently under maintenance.
● Option to select URL Payload Type for Post form submission in HTTP URL monitor.
Issues fixed in 13.2

● Adding vCenter monitors failed when vCenter's credential contained special characters (< > ' "). This issue is fixed.
● VMWare events created on one ESX were duplicated on all the ESXs present under the vCenter. This issue is resolved.
● The issue of alarms in APM Plugin escalating to OpManager even when Alarm escalation is disabled is fixed. | More...

What's new in release 13.1?

● Apache ActiveMQ Monitoring - Collect ActiveMQ metrics, correlate your queue and broker performance with your infrastructure,
maintain configurations for high availability and scalability, and be alerted automatically of potential issues.
● ManageEngine OpManager Plus Monitoring - Monitor critical information (like CPU and memory usage, thread count and PGSQL
database details) essential to track the performance of OpManager.
● Microsoft Azure Virtual Machine Monitoring - Discover Virtual machines under an Azure subscription and monitor the health
status and other performance counters.

What's new in release 13.0?

● Apache ZooKeeper Monitoring - Manage your Zookeeper clusters and Znodes, collect all the performance stats be alerted
automatically of potential issues pertaining to resource consumption.
● Elasticsearch Monitoring - Monitor your Elasticsearch cluster and node health, track Search and Indexing and query latency
performance. Get insight into cluster runtime metrics, individual cluster nodes, real-time threads and configurations.
● ServiceDesk Plus Monitoring - Get critical information (like CPU and memory usage, thread count, mail fetch and database
details) essential to track the performance of ServiceDesk Plus.
● Enhanced MSSQL Monitoring - Track the connection stats, SQL session details, SQL session lock details, blocked lock details
and more.
● Web User Experience Monitoring - Monitor real-time and trending data about your web application's performance and the
level of satisfaction that your end users experience.
● Support for SSL Enabled Postgres Database Monitoring.
● The option to select the Managed Servers for which the Admin server is allowed to trigger e-mail actions.
● Support for Windows 2016 monitoring

What's new in release 12.9?

● Apache Kafka Monitoring - Collect Kafka Resource utilization metrics, monitor Broker, Controller and Replication stats, and be
alerted automatically of potential issues pertaining to the Network and Broker Topics.
● REST API Monitoring - Monitor the availability and response time of your REST API endpoints. Get insight into the response time
of mobile and web applications that use your API.
● MS SQL Monitoring enhanced to include Backup, Restore and SQL Replication metrics.
● SAP HANA Monitoring: enhanced to monitor disk volume, Volume IO, Backup Configuration and Latest Backup metrics.
● Oracle Database Monitoring enhanced to monitor complete Backup details, User Expiry details, Fast Recovery Area Space
usage details and Invalid Object Count.
Issues fixed

Copyright © 2014 Zoho Corp. Page 8


Applications Manager User Guide
Applications Manager User Guide Introduction

● The authentication issue in Apache Solr monitoring is fixed.


● We have increased the Address Field Length in Create Email Action from 50 to 200.| More...

What's new in release 12.8?

● Apache HBase Monitoring: Monitor the health and performance of Apache HBase with key performance indicators (KPIs) related
to HBase Master, Region servers, JVM metrics, memory usage thread details, and exceptions.
● SAP HANA monitoring: Ensure smooth operation of your SAP HANA systems. Track key metrics CPU, memory and disk usage,
HANA services, schema details, replication and backup, workload, transactions, jobs, caches, and alerts.
● Monitor Oracle NoSQL: Get deep visibility into the performance of Oracle NoSQL. Monitor important performance counters
including memory usage, thread details, admin details, replicated nodes, and storage details.
● Monitor Apache Solr Search Server: Monitor all Solr key metrics and stats related to cores such as query handler, cache, update
handler, replications, JVM usage, CPU/memory usage, and thread details.
Issues fixed in 12.8

● Fixed an issue with the “Configure Alarms -> Monitor group -> Search for subgroup” option not working.
● Addressed an issue with the data collection not working properly in MySQL due to null error message when replication is not
enabled for the MySQL database.
● Fixed an issue with process monitoring for Linux, a problem that occurred after upgrading to build 12710. | More...

What's new in release 12.7?

● Support for monitoring Oracle Coherence clusters: Get deep performance insights into Oracle Coherence cluster
implementations. Track KPIs such as clusters, partition assignment, distributed and replicated services, Extend Connections,
Extend Services, and distributed and replicated node memory details.
● OpenStack monitoring: Understand what is happening inside your OpenStack environment. Get details about the health and
state of instances, view information about images within your OpenStack deployment, track core OpenStack services such as
Nova, Keystone, glance, etc.
● Microsoft SQL Server monitor enhancements - View additional performance reports such as top queries by CPU, top slow
running queries, most frequently executed queries, most blocked queries, top components by memory usage, etc.
● Integration with ManageEngine OpManager and ManageEngine OpStor removed
Issues fixed in 12.7

● Issue fixed while creating Email action with special characters in "To Email" address field.
● Cross Site Scripting in New Anomaly Profile page is fixed.
● Thread dump and heap dump actions not working when we choose select Auto JRE Option (Tomcat and Jboss) is fixed. | More...

What's new in release 12.6?

● Azure Service Bus Monitoring: Track the flow of messages between the various applications connected on the Azure Service

Copyright © 2014 Zoho Corp. Page 9


Applications Manager User Guide
Applications Manager User Guide Introduction

Bus, both on-premise and cloud. Key components tracked include queues, relays, event hubs, topics, and subscriptions.
● Integration with ServiceNow: If you are using ServiceNow to track incidents, you can automatically convert alarms from
Applications Manager to incidents in ServiceNow.
● Enhancement to the APM Insight .Net agent: Recycling of Application Pools will be done on every restart of agent's Windows
service.
● Enhancement to the AS400 monitor: Support for monitoring multiple message queues added.
● Enhancement to the File/Directory monitor: The file/directory monitor now includes an option to provide a condition to clear a
content match alert.
● Enhancement to the Real Browser monitor: The Real Browser monitor now detects the components of a web page such as
images, style sheets, script files, etc. and shows the page load time for each of these components in a waterfall model.
● Enhancement to the Windows monitor: You can now monitor Windows tasks – both system/application defined and user-
created custom tasks. Keep track of a task's current status, last run time, last run result, next run time and the number of
times a task has failed since its creation.
Issues fixed in 12.6

● There was an issue with configuring multiple e-mail addresses in email action in build 12500. This has been fixed.
● SQL injection vulnerability in Downtime Scheduler page has been fixed.
● Issue with not receiving notifications when disk is removed from server has been fixed | More...

What's new in release 12.5?

● CouchBase Monitoring: Monitor all attributes of your CouchBase server and keep track of Server Node and Data Bucket stats
with Applications Manager.
● Hadoop Monitoring: Monitor Hadoop version 1.x as well as version 2.x and maintain the overall health of your distributed
Hadoop cluster, ensure their availability and process tasks faster and accurately.
● Docker Monitoring: Applications Manager helps to actively monitor all aspects of Docker like health, availability, running stats
etc., and take informed decisions in case of downtimes.
Issues fixed in 12.5

● In Windows Server, 'Enable Event Log Monitoring' link was missing in Event Log tab when event logs are disabled. This issue
has been fixed.
● Error in generating pdf for configuration history report has been fixed.
● Error in adding attributes to a Windows Performance Counters type monitor has been fixed. | More...

What's new in release 12.4?

● Application Discovery and Dependency Mapping - Discover all applications in your IT infrastructure and map them effortlessly
to gain a comprehensive insight into the relationships and dependencies of your IT components.
● Easy Upgrade support for Professional Edition - Upgrades to latest versions just a click away. New and improved upgrade
techniques to make your experience faster and better. Be notified about upgrades regularly and switch to newer versions
accordingly.
Issues fixed in 12.4

Copyright © 2014 Zoho Corp. Page 10


Applications Manager User Guide
Applications Manager User Guide Introduction

● The application pools were not listed due to parsing error in IIS server 7. This issue has been fixed.
● The problem in creating a threshold with multiple conditions has been resolved.
● $ATTRIBUTEVALUE replaceable tag was not getting replaced previously. This issue has been duly addressed. | More...

What's new in release 12.3?

● Microsoft Dynamics CRM Monitoring - Track the performance of WMI Performance counters, Services, Transactions and
Eventlogs for CRM Applications. Delve deeper into the performance of CRM's Authentication, Outlook Sync, e-mail Router,
Discovery, Locator, Platform Services, Sandbox counters and Async Services.
● Jetty Server Monitoring - Monitor Java applications running on your Jetty HTTP server and Servlet container, track critical
performance indicators of the Jetty Applications server like CPU usage, real-time memory utilization, garbage collection
information and be notified of thread pool exhaustion.
● Microsoft Lync Server Monitoring - Measure the performance of your Lync Server, collect metrics pertaining to it's server roles
and performance counters in one central location, detect issues, send alerts and thus prevent possible service outages or
configuration problems.
● Citrix XenApp Monitoring enhanced to support monitoring of XenApp Version 6.5, performance of critical XenApp Services, Web
Interface servers, IMA & ICAdatastores, XenApp Zones, sessions and applications.
● Web Services Monitoring enhanced to support SOAP Response processing using XSL Transformation, dynamic nonce value
generation for security and operation execution using the response of another operation as input.
● Hardware Monitoring enhanced to monitor performance pertaining to Temperature, Power, Voltage, Battery, Memory, Disk,
Array, Chassis and Processor data of DELL PowerEdge and HP Proliant servers.
Issues Fixed in 12.3

● The issue of Unix processes memory utilization showing raw value and not percentage value is fixed.
● In the At a Glance report, the Availability graphs were not being rendered properly. This issue is fixed.
● The display offset in Applications Manager details page when adding SNMP/Network device monitor is fixed. | More...

What's new in release 12.2?

● Citrix XenApp Monitoring - Track the performance of Broker Services, client and server sessions, diagnose issues like server
overload using event logs and slowness in an application running on a Citrix XenApp server.
● Microsoft BizTalk Monitoring - Monitor core components and performance counters like messaging engine, orchestration
engine, throttling and adapter performance, ensuring the overall health of BizTalk Environment.
● Oracle Tuxedo Monitoring - Monitor system and application data from key Tuxedo components like the bulletin board, queue
and communication bridge details, transaction info, ATMI operations and service details.
● IBM Informix Database Monitoring - Collect system and database performance stats of your Informix Database, session details
and identify problems at an early stage for proactive troubleshooting and performance tuning.
● Real Browser Monitor enhanced to include Mozilla Firefox browser support. Users can now import Selenium IDE test cases and
add them as RBM monitors to automate the testing process.
● SAP Monitor enhanced to monitor metrics pertaining to Remote Function Calls like Scheduler and Data details.
● Support for Windows 10 monitoring.

Issues Fixed in 12.2

Copyright © 2014 Zoho Corp. Page 11


Applications Manager User Guide
Applications Manager User Guide Introduction

● The issue with the working of PollNow Rest API for conf monitors is fixed.
● From build number 12000, for Exchange Server, Report Exchange Messages Delivered/sec and some attributes value
calculation was wrong. This issue is resolved.
● The issue of cursor scroll insensitivity for Sybase database query monitor is fixed. | More...

What's new in release 12.1?

● Ceph Storage Monitoring - Measure the performance of your distributed Ceph storage, status of OSD nodes, Placement Groups
and storage availability.
● Resin Application Server Monitoring - Increase reliability of your Resin Application Server with monitoring of all key
performance indicators like thread details, connection pool usage, session details and memory resources.
● Enhanced HTTP URL Monitoring to provide split up Response Time details like DNS Time, Connection Time, First Byte Time and
Last Byte Time.
● SAP Router string support added for SAP Server and SAP CCMS monitor.
● Applications Manager now provides monitoring support for WildFly Application Server.
● ManageEngine OpManager Network Monitoring Connector has been enhanced to handle network interfaces.
● Storage Devices category added for listing devices from OpStor SAN Monitoring Connector.
Issues Fixed in 12.1

● Increased the character limit for process displayname and processname to 250 characters
● String threshold value's size increased to support lengthy threshold conditions (1000 characters).
● Alert support added for when DBlinks are removed in Oracle DB server. | More...

What's new in release 12.0?

● Oracle EBS Monitoring enhanced to include monitoring of Oracle E-Business Suite 12.0 and 12.2.0 metrics like performance and
process details, OPMN components, webcache, applications and cluster stats.
● Exchange Server Monitoring enhanced to support monitoring of Mailbox & Database Statistics and Database Availability
Groups.
● Microsoft Office Sharepoint Servers Monitoring enhancements to monitor Sharepoint versions 2007, 2010 and 2013 with added
capabilities for Sharepoint server farms and Sharepoint services.
● ServiceDesk Plus integration now lets you maintain a Configuration Management Database (CMDB) that allows you to plot out
your IT infrastructure from Applications Manager and track malfunctioning CIs.
● New delegated administration role introduced to assign limited administrative privileges to users in your organization who
aren't administrators.
● Support for Single Sign-On mechanism to help users gain access to all their Managed Servers with a single user authentication.
● Agent auto-upgrade capabilities added for APM Insight .Net version 2.0 and Java Version 1.9 to automatically download the new
agent zip/msi file for upgrade if a new agent version available. JVM monitoring is also supported in APM Insight for Java.
● Event Logs Rules Configuration, Threshold Creation and User Administration enhanced for the Enterprise Edition - Create Event
logs, Thresholds, Add Domains and give permissions to Domain - all from the Admin Server.
● Performance Metric Widget enhanced to support multiple monitors.
● Support added for SAP JCO version 3.0.

Copyright © 2014 Zoho Corp. Page 12


Applications Manager User Guide
Applications Manager User Guide Introduction

● Administrative activities can now be performed from the Admin Server in the Enterprise Edition.
● OPM Connector enhanced to provide a minimalitic UI that lists the Device Summary, Health, Availability and Recent Alarms and
a quick snapshot of availability and health for network devices.

What's new in release 11.9?

● VMware Horizon View Monitoring to manage all VMware Horizon View components, the status of services used and the
underlying infrastructure as well.
● SAP Server Monitoring enhanced to support monitoring of background jobs.
● APM Insight .Net monitoring now features a new diagnostics tool to check the health of the agent running in the server. It also
collects logs and creates a zip file, for better troubleshooting and support.

What's new in release 11.8?

● Windows Server Cluster Monitoring - Measure the performance of all your Windows Server Cluster components - nodes in a
cluster, cluster networks, resource groups and critical cluster events.
● Siebel Server Monitor enhanced to support monitoring of active Siebel sessions and tasks.
● Cassandra Monitor enhanced to support monitoring of Operational Latency and Timeouts, Bloom Filters and Memtable Stats.
● Support for monitoring Exchange server 2013.

What's new in release 11.7?

● WebSphere MQ monitoring enhanced to monitor several new performance, queue, channel and event log attributes.
● Monitoring support for Message Broker execution groups, message flow accounting and resource statistics.
● APM Insight monitoring now includes tracking of background transactions.
● Support for NTLM Version 2 in URL Monitoring.

What's new in release 11.6?

● Applications Manager now has a slick new interface that's easier to use and performs faster than ever.
● Siebel Server Monitoring and Management with capabilities to improve productivity and gain visibility into your entire Siebel
environment.
● Oracle Database Monitoring has been extended with proactive monitoring of an Oracle Data Guard environment, RPO statistics
and more database details.
● Tomcat monitoring has been enhanced to support monitoring of memory, thread, JSP level requests, JDBC, servlets and more.
● Redesigned UI for the alarms tab with smoother filtering, easier bulk alarm actions and alarm search capability.

Copyright © 2014 Zoho Corp. Page 13


Applications Manager User Guide
Applications Manager User Guide Introduction

What's new in release 11.5?

● Applications Manager Android App - Our native application for android devices provides comprehensive application monitoring
on the go.
● Citrix XenServer infrastructure monitoring moved from Beta to GA.
● IBM AS400 / iSeries monitoring enhanced to support pre-defined system library queues - Data Queue, Job Queue and Out
Queue monitoring.
● New REST APIs introduced, for configuring mail, proxy and SMS servers, applying license and listing user roles.
● WebSphere Server monitoring extended to support JMS queues & topics monitoring, JDBC connection pool and web
application session details.

What's New in Release 11.4

● Support for monitoring Oracle Database version 12c.


● Oracle Database monitoring extended to monitor ASM Disk Groups, Jobs, PGA & corrupted blocks.
● User Administration module is enhanced to reuse the User Groups defined in Active DirectoryLDAP.

What's New in Release 11.3

● VM-to-storage maps displaying relationships between VMware vSphere Servers and underlying physical data stores
to identify problems at storage and application levels.
● Monitoring of additional VMware KPIs including resource pools.
● Enhanced event log monitoring to help you set log rules for specific monitor types.

What's New in Release 11.2

● JBoss Monitoring is extended to support JBoss 7.0


● Credential Manager is introduced to help you create/edit the various credentials like password/ snmp community, port, etc., for
all type of monitors globally.
● Support for monitoring the performance and health of the Nginx server.

What's New in Release 11.1

● Support for Redis Monitoring with capabilities to monitor connections, keyspace statistics, persistence statistics and more.
● Support for monitoring the performance and health of your Nginx server.
● IIS Monitoring is enhanced to include IIS Application Pool monitoring.
● All the report types in Applications Manager now supports PDF and CSV format.
● Global Alarm Configuration option is enhanced, to associate thresholds and actions with the attributes of a Monitor Type also.

What's New in Release 11.0

● Support for Cassandra Database Monitoring with capabilities to monitor pending tasks,node status in cluster, operation latency
and more.

Copyright © 2014 Zoho Corp. Page 14


Applications Manager User Guide
Applications Manager User Guide Introduction

● Support for MongoDB Monitoring with capabilities to monitor connections, lock statistics, journaling statistics and more.
● The default database bundled with the product is PostgreSQL from Build 11000. However, our existing customers can continue
using MySQL or migrate to Microsoft SQL Server.
● JBoss Monitoring is extended to support JBoss 6.0.
● Support for Windows 8 and Windows 2012 monitoring.
● Apache Tomcat bundled with the product is upgraded to version 7.0.21
● JRE bundled with the product is upgraded to version 1.6
● Microsoft Hyper-V monitoring is extended to support Hyper-V 2012 servers.

What's New in Release 10.8

● The new Cloud Starter Edition that supports all private/public cloud and open source apps.
● Windows Azure monitoring and APM Insight .NET transaction monitoring are moved from Beta to GA.
● Site24x7 Integration to monitor website performance both from within your corporate LAN and from multiple locations outside
your data center.
● Enhanced Server Monitoring to include hardware status details.
● Support for Weblogic 12c monitoring.
● Support for Tomcat 7.x monitoring.

What's New in Release 10.7

● Capacity planning reports for detailed capacity analysis of CPU, memory, network, disk utilization and more.
● Enhanced VMware ESX servers monitoring to include hardware and latency performance details.
● APM Insight .NET transaction monitoring for visibility into key performance metrics, user satisfaction assessment,
summarized database operations and transaction traces in minutes.
● Cloud monitoring capability is now extended to incorporate Windows Azure monitoring .
● Redesigned UI for the alarms tab with smoother filtering capability.
● Custom field-based filtering has been introduced for reports.
● Enhanced server monitoring to support network-mapped drives and volume mount points.

What's New in Release 10.6

● APM Insight is equipped with Ruby on Rails application monitoring capabilities; providing end-to-end visibility into all tiers of
your ruby transactions and insight into key performance metrics.
● New REST APIs introduced, for adding and deleting monitor group/ sub group and to associate monitor to a monitor group.
● Option to configure "Tomcat Manager" URI for monitoring Tomcat server.

What's New in Release 10.5

● Applications Manager iPhone App - Our native application for iOS-based devices provides comprehensive application
monitoring on the go. | Download App
● Option to perform bulk import of server monitors using SSH Key-based authentication.
● Option to view the SOAP response in the alarm email for SOAP threshold violation.

Copyright © 2014 Zoho Corp. Page 15


Applications Manager User Guide
Applications Manager User Guide Introduction

Issues Fixed in 10.5

● The issue with the Shared Directory monitor showing Availability Status as down has been fixed.
● The issue with raw data clean up not happening for SQL back end has been fixed. | More...

What's New in Release 10.4

● The J2EE Web Transaction Monitoring feature has been enhanced. Its now called APM Insight (Java) and comes with better
troubleshooting capabilities.
● Mobile Web Client - Access Applications Manager from your Mobile Web Browsers.
● AS400 monitoring is enhanced to support specific job, subsystem monitoring.
● SNMP V3 support for monitoring servers, sending and receiving Traps.
● File Monitoring is enhanced to support content matching for remote windows files/ rolling logs.
● REST API-based integration with ManageEngine ServiceDesk to automate Alarm Management.
● Support for Internet Explorer 9 in Real Browser Monitoring (EUM Add On).
● Rest API Enhancements to list polled data for monitor, search monitor, list monitor groups.

What's New in Release 10.3

● Out-of-the-box support for monitoring the performance and availability of VMware vFabric RabbitMQ messaging systems.
● Web client user authentication using LDAP/AD.
● Web client GUI enhancements.
● Customizing the logo in reports.
● Support for embedding different world map views.
● Support for monitoring SSLv3 enabled websites in URL monitoring.

What's New in Release 10.2

● Support for monitoring Oracle JRockit JVM in Java Runtime Monitor.


● Support for monitoring IBM JVM in Java Runtime Monitor.
● Ability to play sound for critical alarms.
● Performance Metric Widget enhanced to show graphs for additional metrics with scaling option.

What's New in Release 10.1

● Out-of-the-box support for monitoring the availability and performance of VMware vFabric tc servers and the Spring
Applications deployed on the server.
● We now support monitoring of validity and expiry dates of SSL Certificates.
● Support for Gmail in Mail Server Configuration.
● Ability to add new Event Logs other than the available default ones.
● Support for monitoring SOAP Operations with headers.

Copyright © 2014 Zoho Corp. Page 16


Applications Manager User Guide
Applications Manager User Guide Introduction

What's New in Release 10.0

● End User Experience Monitoring (EUM) add on introduced. The 'Real Browser Monitor' add-on has been rechristened as 'End
User Monitoring' add-on with enhancements that help it go beyond real browser monitoring. This now includes LDAP, DNS, Ping
and Mail Server RTT. Also, the pricing structure of RBM has been modified from an agent-based model to a flat-fee model.
● Custom fields and labels for monitors and groups. You can view this by clicking on the 'Custom Fields' button inside a monitor
or monitor group.
● We now show split up of CPU utilization by CPU cores. There is also support for viewing server configuration parameters.
● Improved web client and ability to customize tabs.
● Support for monitoring Virtual Infrastructure through vCenter server.
● Support for Amazon S3 monitoring.
● Ability to specify roles for Exchange server 2007/2010. This helps view more performance metrics.
● A 64-bit binary for Applications Manager.
● IPV6 support for most monitor types.
● Anomaly Detection is no more an add-on feature. It will be part of the basic product.
● SSL support for SMTP and POP in mail server monitor.

What's New in Release 9.5

● Ability to automatically provision virtual resources based on threshold breaches. You can create actions to automatically start,
stop and restart VMs of both VMware ESX and Hyper-V servers from Applications Manager.
● Ability to automatically provision cloud resources based on threshold breaches. You can create actions to automatically start,
stop and restart Amazon EC2 instances from Applications Manager.
● Out-of-the-box support for monitoring the availability and performance of Microsoft Message Queue (MSMQ)
● Option to associate multiple dependent devices across managed servers.
● Enhancements to fault management module including the option to execute email/SMS actions during selected business hours
and the option to execute actions for a specific number of times or repeatedly until it gets acknowledged.

What's New in Release 9.4

● Out-of-the-box support for monitoring the availability and performance of Microsoft Hyper-V servers and their guest virtual
machines. Applications Manager now supports multiple virtualization vendors such as VMware and Microsoft.
● Introduced server process templates/Windows service templates which are a pre-defined, reusable collection of processes.
They provide an easy way to add multiple server processes/templates for monitoring across a group of servers.
● Improved method of managing operations in web services. Includes the ability to specify SOAP Action and Request values
corresponding to the operation and also the ability to add custom operations.
● New REST APIs to add different monitor types, delete and list monitors.
● Options to stop, start and reboot Amazon EC2 instances from within Applications Manager.
● Additional performance metrics for MySQL DB servers including information about system variables of the MySQL server.

What's New in Release 9.3

● Out-of-the-box support for monitoring the availability and performance of Amazon EC2 and RDS instances. Applications

Copyright © 2014 Zoho Corp. Page 17


Applications Manager User Guide
Applications Manager User Guide Introduction

Manager helps you ensure your business-critical cloud-based applications and services are performing well at all times.
● Introduced new report type for monitor groups known as Availability and Downtime Trend Report. This report compares
the availability of the monitor group against target availability and also shows the downtime count and total downtime for the
monitor group.
● Enhancements to SNMP Trap listener feature including the ability to select trap severity based on threshold profiles.
● Support for monitoring Exchange server 2010.
● Option to monitor WebSphere Application Server through secure SSL mode.
● Support for associating dependent devices across managed servers in the Enterprise edition. This will help you better organize
your monitors and reduce redundant checks.

What's New in Release 9.2

● Out-of-the-box support for monitoring the availability and performance of VMware ESX/ESXi host servers and their guest virtual
machine instances. Applications Manager provides a single console for monitoring both physical and virtual components of a
heterogeneous IT environment.
● Comprehensive monitoring of Memcached servers to help you detect and diagnose problems with your caching systems faster.
● Support for monitoring PostgreSQL database servers.
● Introduced Web application group which is a new type of Monitor Group. This will be useful for grouping your web
infrastructure into logical components such as servers, databases, web servers, etc and better manage the relationship
between components.
● An improved Real Browser Monitor (RBM) dashboard that provides an overview of the status of your web transactions
from multiple locations.
● New REST APIs to create, edit and delete downtime schedulers, get monitor data, and add monitors.
● Option to send events as SNMP Traps to external SNMP Trap listeners.
● Enhancements to Java Runtime Monitor including the ability to know how garbage collection behaves in the JVM. You can also
see the impact of the GC on thread dump with history and view historical JVM configuration parameters.
● Support for monitoring Windows 7 server.
● Support for monitoring WebSphere Application Server version 7.
● Issues fixed include ServiceDesk Plus integration issue when customers enable AD authentication in ServiceDesk Plus. | More

What's New in Release 9.1

● New monitor type called Real Browser Monitor (RBM) introduced. RBM opens up a Microsoft Internet Explorer browser and
monitors a web application just like how a real user sees it. It supports playback from different geographical locations.
● Get notified of anomalies in a production application by defining anomaly profiles on performance metrics. Support for
anomalies based on fixed baseline, moving baseline and custom expressions. There is also an Anomaly Dashboard introduced
to facilitate viewing all the performance metrics.
● REST APIs introduced to make integration of Applications Manager with internal portals and other monitoring tools easier.
● At a glance Report that provide a summary of Top 10 monitors based on various performance metrics and uptime. You can
view reports by Monitors, Monitor Types and Monitor Groups.
● Alarm Management : Define dependent device for a Monitor Group or individual monitor to suppress false downtime alarms
caused by the dependent device being down.Enhanced alarm configuration rules for health and availability of Monitor Group.

Copyright © 2014 Zoho Corp. Page 18


Applications Manager User Guide
Applications Manager User Guide Introduction

● Monitor Group Template Dashboards have been introduced. This will help configure a custom dashboard and reuse it for
multiple Monitor Groups (business applications or customers) - based on how you use the product.
● New widgets called "Bookmarks" and "Custom Text and HTML" for Integrating knowledge base articles and other web links
added to Custom Dashboards.
● To enhance Web Client security, configurable Account policies has been added to the User Administration Module.

What's New in Release 9

● Microsoft SQL Server database back-end support.


● Support for monitoring Oracle E-Business Suite.
● Ability to create custom dashboards.
● Enhancements in server monitoring.
● Enhancements in WebClient look and feel.
● The MySQL DB Server bundled in the product has been upgraded from version 4.0.13 to version 5.0.52.

What's New in Release 8.6

● Monitor the performance of AS400 / iSeries.


● Support for monitoring SAP CCMS metrics.
● LDAP, DNS and FTP/SFTP Service Monitors are now supported by Applications Manager.
● Additional metrics such as Hour of day, Day of week, Statistical and Heat chart report tabs in 7,30 History data are added.
● Support for Monitor Group/Sub-Group in downtime scheduler.
● Ability to assign Sub-Group for operator role.
Issues Fixed in 8.6

● Issue in Database Query monitor is fixed. It now retains only new data collected across all rows and columns.
● Memory leak issue in JBoss monitoring is fixed.
● Issue fixed in infinite loop in URL monitors.
● Issue in associating monitors to a monitor group with same name is fixed. | More...

What's New in Release 8.5

● Database Query Monitor is now supported by Applications Manager.


● Applications Manager now supports Active Directory Monitoring.
● A new flash-based graphical view, called Business View, is added to view IT infrastructure.
● Support for database details in MySql monitors that are collected once per day based on configuration is added.
Issues Fixed in 8.5
● Issue in Configure Alarms for Script and Query monitor when scalar attributes are not available is fixed.
● Issue in collecting Performance metrics for Weblogic 9 and 10 datacollection, when WLS server is restarted without restarting
Applications Manager, is fixed.

Copyright © 2014 Zoho Corp. Page 19


Applications Manager User Guide
Applications Manager User Guide Introduction

● Issue fixed in Server Monitors when memory load increases leading to Out Of Memory.
● Issue fixed to have multiple network interface on the same host. | More...

What's New in Release 8.4

● ManageEngine Applications Manager integrates now with a comprehensive Network Monitoring Tool, ManageEngine
OpManager.
● In WebServices monitoring, added support for generating alarms based on the output of the service.
● Free Edition of Applications Manager will not support DB2, Sybase in addition to Add-ons.
● J2EE Web Transactions, IBM WebSphere MQ Series and MS Office Sharepoint have been modified as Add-ons.
Issues Fixed in 8.4
● Issue in synching of data between the Managed Servers and Admin Servers is fixed.
● Issue in showing the status in Icons View and Table view is fixed
● Fixed issue in enabling and disabling SSL in AMServer.properties is fixed Cleanup entries are added for the Script Table data
● Fixed issue in Archiving for Tomcat Session and Oracle Users. | More...

What's New in Release 8.3

● IBM WebSphere MQ, SilverStream, Microsoft Office Sharepoint Server, GlassFish Server Monitor Support added
● Windows Vista monitoring support added
● Oracle 10.1.3 monitoring support added
● Support for Custom attribute reports added
● Poll Now - option added for monitors
● Restricted access of Monitor Groups for Managers.
Issues Fixed in 8.3
● Fixed issue in Google Map display when the monitor group display name contains single quotes.
● While creating the Monitor Group (MG), the owners select box is shown empty when the latest MySQL Driver is used.
● In MySQL monitoring, when the 'last error' attribute is having sepcial characters the polling will stop for that monitor.
● The performance issue in deleting the NA rows in script monitor is fixed.| More...

What's New in Release 8.2

● Availability and Health Reports - Critical Snapshot, History reports added


● Availability Trend Report, Outage Comparison Report added
● Ability to configure Business hours for reports added
● Support for bulk import of monitor configurations
● Support for sending SMS alarms via Modem
● Network Interface monitoring in WMI mode added

Copyright © 2014 Zoho Corp. Page 20


Applications Manager User Guide
Applications Manager User Guide Introduction

What's New in Release 8.1

● Sybase Support added


● Outage Comparison Reports, Availability Trend Reports, Availability and Health Snapshot Reports added
● Support for adding custom monitor types
● MySQL monitoring enhancements added
● Network Interface monitoring added

What's New in Release 8

● SAP Server Monitoring support added


● Enhancements in Availability and Performance Dashboards
● DB2 Monitoring Enhanced
● Improvement in scalability of reports
● WebClient Enhancements

What's New in Release 7.4

● Ping Monitor support added


● Support for Secondary Mail Server configuration
● Support for creating a Monitor Group within a Monitor Group (Monitor Sub-Group)
● Support for Monitor Group creation in Admin Server (Enterprise-Edition Setup)
● Ability to treat Monitor Group as a Services Group or as an Application Cluster has been added.

What's New in Release 7.3

● Localized webclient to support German, Spanish and French languages


● Support for monitoring Windows Performance Counters in Windows 2000
● Availability and Health realtime snapshot report for Monitor Groups added
● Support for JSON Feeds for integrating Applications Manager data in corporate intranet
● $DATE tag enhancements in actions.
● Alarm Escalation added

What's New in Release 7.2

● WebLogic Integration Server Monitoring


● Support for Java Runtime Monitor
● File System Monitoring
● Failover support for Enterprise Edition
● IIS Enhancements
● WebSphere Enhancements

Copyright © 2014 Zoho Corp. Page 21


Applications Manager User Guide
Applications Manager User Guide Introduction

● Script Monitoring Enhancements - Table support added


● WebClient Enhancements

What's New in Release 7.1

● Web Services (SOAP) Monitoring


● Windows Performance Counters Monitoring
● Support for monitoring Mac OS
● JBoss 4.0.4 Support
● WebLogic 9.2 Support
● Ability to specify the attribute type for JMX and SNMP Monitors
● Windows Authentication Support for MS SQL Server monitoring
● New Plasma View of monitors added
● Ability to compare reports is added
● Customizable UI for home tab and Plasma View
● Bulk update of Poll intervals added
● More $Tags support in executing actions ($OID, $DATE, $URL)
● SSH Key based authentication for Remote Script Monitoring and Execute Program Action
● Ability to set auto refresh time interval added.
● New Simple web client layout added. Option to choose between Classic and Simple layouts.
● New Maroon color theme added for personalizing the webclient
● While creating new monitors, troubleshooting is made easy via Diagnose Link

What's New in Release 7

● Remote sessions opened in Server monitoring, issue fixed


● Script Monitoring issues fixed
● Issue in invoking MBean Operation in JMX 1.2 fixed

● Enterprise Edition - Support for large scale monitoring with a distributed setup
● Support for Windows Services monitoring
● Support for Remote Script monitoring
● Server Monitoring Enhancements (HP-UX, IBM AIX, Linux, Solaris)
● Webclient and Server Performance Enhancements
● Webclient HTTPS support
● Improved Fault Management capabilities
● Support for Authenticated JMX Agents
● Improved multi-lingual support
● Other bug fixes and minor enhancements

Copyright © 2014 Zoho Corp. Page 22


Applications Manager User Guide
Applications Manager User Guide Introduction

What's New in Release 6.6

● Support for Oracle Application Server Monitoring


● Support for Tru64 Unix Monitoring
● Support for Windows Event Log monitoring
● Support for LAMP Edition and Database Edition of ManageEngine Applications Manager
● Option to schedule daily, weekly, monthly performance and availability reports
● Option to copy and paste the configuration of one monitor to create new monitors
● Bulk update of usernames and passwords of monitors
● Ability to Manage / Unmanage a monitor
● Option to configure the number of polls for performance data collection
● Bulk alarm configuration for attributes
● More configuration support for Google Maps Business Views

What's New in Release 6.0.5

● Integration of Google Maps Business View


● Support for Weblogic 9.1
● Support for JBoss 4.0.3
● Multilingual support for Simplified Chinese and Japanese languages
● PDF report generation for attributes is provided
● Enhanced Web Client

What's New in Release 6.0.4

● Support for monitoring Microsoft .NET


● Support for monitoring WebLogic 9.
● Support for monitoring Web Transactions.
● Support for monitoring Oracle RAC.
● Integration of ManageEngine ServiceDesk Plus to track the alarms generated as trouble tickets.
● NTLM support is provided in URL monitoring.
● Reporting enhancements like Downtime History report of individual monitors and Summary Report are provided.
● Various usability enhancements like configuring prerequisites for monitoring are provided at the initial stage itself.
● Option to configure database retention parameters.

What's New in Release 6.0.3

● Support for Monitoring Microsoft Exchange Server.


● Support for Monitoring of FreeBSD Operating Systems.
● Support for Monitoring JBoss 4.0.2.
● Support for Telnet Monitoring is provided.
● Integration of AdventNet's QEngine - a platform independent Test Automation tool used for Web Functionality, Web
Performance, Java Application Functionality, Java API, SOAP, Regression, and Java Application Performance testing.
● Standalone Enhanced URL Recorder is provided.

Copyright © 2014 Zoho Corp. Page 23


Applications Manager User Guide
Applications Manager User Guide Introduction

● SSL support for Apache, IIS and PHP.


● Consoles for Manager provided to maintain SLAs.
● Option to associate multiple users to single Monitor Group is provided.
● Alarm Enhancements like Pick/Unpick alarms, Annotation of alarms have been provided.
● Polls to retry can be configured individually for any attribute of a Monitor.
● Multiple varbind support in alarm messages is provided.
● Option to export reports to CSV and PDF formats.

What's New in Release 6.0.2

● Support for Monitoring IBM AIX servers.


● Support for Monitoring HP Unix Servers.
● Support for Script Monitoring is provided.
● Support for PHP Monitoring is provided.
● WebSphere 6.0 Monitoring support is provided.
● WebSphere Monitoring in Network Deployment mode is supported.
● Maintenance Task Scheduler Provided.
● SNMP Trap Listener provided.
● JMX Notification Listener Provided.
● Introduction of new role - "User", in addition to the existing Operator & Administrator roles.
● Replaceable Tags enhancement provided in actions.
● Support for String data type for defining threshold values.
● Option to be execute an action (like email) repeatedly, till a monitor returns to normalcy.
● Alarm Template feature for bulk alarm configuration.
● Support for JBoss SSL .
● Custom Time Period reports provided.
● Option to delete known downtime reports provided.

What's New in Release 6.0.1

● Support for Monitoring Apache WebServers.


● Support for Monitoring IIS WebServers.
● Support for IBM DB2 Database Server Monitoring.
● JMX MBean Operation Support.
● Support for Monitoring JBoss 4.x.
● Support for Tomcat SSL.

What's New in Release 6

● Support for Monitoring WebSphere Application Server 5.x


● Support for Monitoring JBoss Application Server 3.2.x
● Support for Monitoring Tomcat Application Server
● Support for Monitoring WebLogic 8.1 Application Server

Copyright © 2014 Zoho Corp. Page 24


Applications Manager User Guide
Applications Manager User Guide Introduction

● Support for Monitoring MS SQL Database


● Support for Monitoring Oracle 10g Database
● Support for Monitoring MySQL Database
● Support for Monitoring Mail servers (SMTP, POP)
● Support for Monitoring Web servers
● Support for Monitoring Network Services like ftp, telnet, tcp port, etc
● Support for Monitoring Websites (URL, URL sequence, URL content monitors)
● SNMP based custom application monitoring
● JMX based custom application monitoring for MX4J / JDK 1.5, WebLogic JMX, JBossMX, WebSphere JMX
● Intuitive Web client support
● Unified view of monitors using Monitor Group

Copyright © 2014 Zoho Corp. Page 25


Applications Manager User Guide
Applications Manager User Guide System Requirements

Hardware and Software Requirements

This section lists the system requirements for installing and working with Applications Manager.

Hardware Requirements:

The performance of Applications Manager depends considerably on the CPU and memory of the system. The following table
describes the recommended configuration of the system running the product.

Up to 250 monitors (with medium load on the monitored servers)


Operating Platform Processor Speed Memory* Hard Disk Space Required
Windows / Linux 2.4 GHz and above 4 GB RAM 60 GB

250 - 1000 monitors - Enterprise Edition Setup (One Admin & 2-3 Managed Servers)
Per Managed Server/Admin Server
Operating Platform Processor Speed Memory* Hard Disk Space Required
Windows / Linux Dual Core, 2.4 GHz and above 8 GB RAM 80 GB

1000 monitors and above - Enterprise Edition Setup (One Admin & 4 Managed Servers and above)
Per Managed Server/Admin Server
Operating Platform Processor Speed Memory* Hard Disk Space Required
Windows / Linux Quad Core, 2.4 GHz and above 16 GB RAM - Managed Server 100 GB or higher based on monitors

*The above mentioned memory does not include memory used by OS which should account for another 4 GB
*If number of Managed Servers are high, 16 GB RAM for the Admin Server is recommended.

Note: It is recommended to read the Best Practices Guide before going into production.

Real Browser Monitor System requirement (for the machine where RBM Agent is to be deployed):

RBM Firefox Agents have to be installed on a dedicated Windows / Mac machine - 8 GB RAM, 40 GB HD. RBM Internet Explorer
agent (depcreated) have to be installed on a dedicated Windows machine - 4 GB RAM, 40 GB HD with Internet Explorer 6, 7 or 8
(32 bit). However, Applications Manager can be installed on Windows or Linux. This works with the Professional Edition and
Enterprise Edition (with Managed Server). Know more about Real Browser Monitor.
Software Requirements:

● Supported Operating Systems


● Windows 7, Windows 8, Windows 10, Windows Server 2008, 2012, 2012 R2, 2016 both 32 and 64 bit.
● Enterprise Linux 2.1 and above, Debian, Suse, Ubuntu, Mandriva, CentOS, Oracle Enterprise Linux, RHEL 6 and above,
Fedora Core both 32 and 64 bit.
● Supported Monitor Resolution
● Applications Manager is optimized for 1024 x 768 resolution and above.
Note:
Do take a look at the Windows Vs Linux Downloads page. Compare the capabilities of Windows and linux variations before
proceeding to download the product.

Supported Database Backends

Applications Manager supports PostgreSQL and MS SQL database backends for storing all the configuration information and data

Copyright © 2014 Zoho Corp. Page 26


Applications Manager User Guide
Applications Manager User Guide System Requirements

collected. PostgreSQL comes bundled with your download of Applications Manager from Build 11000.
The supported MS SQL database versions that you may use are:

● MS SQL Servers 2005 / 2008 / 2012 / 2016 ( SQL Standard / Enterprise Edition )
SQL Server Collation : Any case-insensitive collation. For Chinese Installation use Chinese_PRC_CI_AS

Note: Support for existing customers with MySQL database will be depcreated from March 31, 2017. Refer this post for details.

Supported Browsers

● Internet Explorer 10, 11 and Edge


● Mozilla Firefox
● Google Chrome

Copyright © 2014 Zoho Corp. Page 27


Applications Manager User Guide
Applications Manager User Guide System Requirements

Differences between Windows and Linux versions of Applications

Manager

Although most of the Applications Manager features are supported on both the Windows and Linux versions, there are
certain features which are only available in the Windows version.

Features supported only in the Windows Version

The Microsoft applications/servers listed below can be monitored only using the Windows version of Applications Manager. This is
because the data collection happens through WMI (Windows Management Instrumentation):

● Exchange Server
● Active Directory
● Microsoft .Net
● Hyper-V
● MSMQ
● SharePoint
● IIS Server
● Windows Performance Counters(any parameter related to Win32_PerfFormattedData)
● Microsoft BizTalk
● Microsoft Dynamics CRM
● Microsoft Lync
● Windows Cluster
Apart from these monitors, other features that are supported only in the Windows version are:

Event log rules: Any event can be monitored and notified when it occurs. This is useful when any application generates a failure
event in the Windows Event log viewer. This is helpful in a way that the event log comes before the application actually crashes.
This serves as a proactive mode of monitoring your applications and services.
NTLM authenticated URLs and Recording HTTP(s) Sequence/Real Browser Monitor(RBM): You can record the HTTP(s)
sequence through Recorder.exe tool which works only from a Windows OS. However, you will be able to save the sequence to
Applications Manager on a Linux OS.

NOTE

In the Linux Version of Applications Manager, Windows Server Monitoring is possible only in the SNMP mode.

Copyright © 2014 Zoho Corp. Page 28


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Installation and Setup

You can install Applications Manager with ease, by going through the following sections:

● Installing and Uninstalling


● Licensing
● Using Update Manager
● Starting and Shutting Down
● Troubleshooting

Copyright © 2014 Zoho Corp. Page 29


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Installation Guide

Contents:

● Editions of Applications Manager


● How to install Applications Manager in Windows (.exe) & Demo
● How to install Applications Manager in Linux (.bin)
● Troubleshooting your Installation process
● Uninstalling Applications Manager

Editions of Applications Manager

Meet your specific monitoring and business objectives by choosing the right edition of ManageEngine Applications Manager.
Applications Manager is available in these editions:

● Free Edition
● Professional Edition (Trial/Registered)
● Enterprise Edition (Trial/Registered)

Free Edition

The Free Edition allows you Five monitors (excluding the Monitors added by default). The Free Edition never expires and
you get most of the functionality of Professional Edition. Compare the Free and the Professional Edition.

Professional / Enterprise

You can avail 30 days of evaluation with no restrictions on the number of monitors. The Professional Edition allows you to
monitor up to 250 monitors. The Enterprise Edition allows you to monitor more number of servers and applications in a
distributed setup. You can configure independent Applications Manager installations to monitor resources and then
collectively view the data of all the independent Applications Manager installations ("Managed Server") from a single central
installation ("Admin Server"). After your 30-day free trial ends, your installation will automatically convert to the free edition
unless you apply a commercial license.
This is the registered version of the product. ManageEngine provides the Registered user file after you purchase the
product. To get the registered user file, e-mail to sales@manageengine.com.
To know the comprehensive differences between Free, Professional and Enterprise Edition features, visit our website - Feature
Comparision.
Note
You can upgrade the Professional Edition / Enterprise Edition , Trial and Free Edition to Professional / Enterprise Edition. This is
applicable, if you have purchased ManageEngine Applications Manager and hold the registered license key. To upgrade your
license, refer Licensing Applications Manager.

Copyright © 2014 Zoho Corp. Page 30


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Installing Applications Manager in Windows (.exe)

Download and execute the ManageEngine_ApplicationsManager.exe file. The Installation Wizard is displayed and will guide
you through the setup process.
1. Click Next at the Welcome Screen to proceed.
2. Read the license agreement and click Yes if you accept the terms.
3. Select the language in which you wish to install Applications Manager.
4. The next screen prompts you to select the product edition (Free Edition, Professional Edition, Enterprise Edition):
● If you select Enterprise Edition, specify if you want to install Applications Manager as an Admin Server or a Managed
Server. If you wish to install Applications Manager as a Managed Server, enter the associated admin server Host name
and SSL port number. If a proxy server is needed to contact the admin server from the Managed Server machine, enter the
Host name, Port number, username and password of the proxy server.
● If you have choosen to install the Free or Professional Edition, continue to step 7.
5. Provide the location where Applications Manager should be installed on your machine. Also, specify the name of the new
Applications Manager Folder in the installation location. Click Next.
6. Specify the Webserver port (9090 by default) and the SSL Port (8443, by default).
7. You can enter your details to Register for Technical Support. Click Next.
8. If you have chosen to install the Professional Edition of Applications Manager, you can opt for either the 30 day Trial
Edition or the Registered version. If you select Registered User, the next screen will prompt you to select the registered
license file from your system.
9. Select the Database back-end support :

● PostgreSQL- PostgreSQL is bundled with the product. Hence, you do not have to set it up.
● Microsoft SQL Server (version 2005, 2008, 2012) - If you select Microsoft SQL Server, you need to select if it is based on SQL
Authentication or Windows Authentication. If it is based on SQL Authentication, enter the Host Name, Port Number,
Database Name, User Name, Password of the SQL Server. If it is based on Windows Authentication, enter the Host Name, Port
Number, Database Name of the SQL Server and the User Name , Password of the machine in which SQL Server is running. Also
provide minimum privileges required - The user account should be the DB_Owner of the created Database.
Setup completes the installation of Applications Manager.

Demo

Copyright © 2014 Zoho Corp. Page 31


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Note
To install Applications Manager as
service in a system, you must have
administrative privileges in that
system. More Information on
'Manually Installing Applications
Manager as Service'.

Installing Applications Manager in Linux (.bin)

1. Download the product for Linux.


2. Execute the downloaded file. The Installation Wizard is displayed. Click Next to continue. Read the license agreement and
click Next.
3. The next screen prompts for the product edition (Free Edition, Professional Edition, Enterprise Edition). Select the preferred
edition to install. If Professional - is selected, follow the below given steps.
4. Select the language in which you wish to install Applications Manager. The options are English, Simplified Chinese,
Japanese, Vietnamese, French, German, European Spanish, Korean, Hungarian and Traditional Chinese.
5. Choose whether it is trial or registered. If registered, the next screen will prompt you to select the registered license file
from your system.
6. Specify the port at which web server has to be started. By default, it is 9090. This is the port at which you will connect the
web client.
7. Select the Database back-end support - PostgreSQL (Bundled with the product. No Setup required) or Microsoft SQL Server
(version 2005 and 2008).
8. If you select Microsoft SQL Server, you need to select if it is based on SQL Authentication or Windows Authentication. If
it is based on SQL Authentication, enter the Host Name, Port Number, Database Name, User Name, Password of the SQL
Server. If it is based on Windows Authentication, enter the Host Name, Port Number, Database Name of the SQL Server and
the User Name , Password of the machine in which SQL Server is running. Also provide minimum privileges required : The

Copyright © 2014 Zoho Corp. Page 32


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

user account should be the DB_Owner of the created Database.


9. Provide the location where the Applications Manager should be installed in your machine. Click Next.
10. Current Settings is displayed in the next screen. If you need to make changes, click Back, else click Next to continue
installation.
11. Click Finish to complete the installation process.
12. If you had selected Free License, follow the steps from 4 to 9 .
13. If you had selected Enterprise Edition, choose if you want install applications manager as Admin server or Managed
server.
14. If you had selected Enterprise Edition - Admin Server, next you have to enter the Admin server host name, Port number
and SSL Port number. Then follow the steps from 4 to 9.
15. If you had selected Enterprise Edition - Managed Server, enter the associated Admin server Host name and SSL port
number. If a proxy server is needed to contact the admin server from the Managed Server machine, click on the proxy
server check box. In the next screen, enter the Host name, Port number, User Name and Password of the proxy server. Then
follow steps from 4 to 9.
16. You have an option to fill up a registration form for Technical Support.
17. Finally, select if you want to view the ReadMe file or click Finish to launch Applications Manager immediately.

Note
You can install Applications Manager via Command Line also. If the file name is
ManageEngine_ApplicationsManager_11_linux.bin, then type the following command in the command prompt:
./ManageEngine_ApplicationsManager_11_linux.bin -console

Execution of this command would take you through the installation process.

Troubleshooting an Installation process


In case of problems during installation in a Linux system, follow the steps given below to produce the logs files:

● Create a text with the same name as that of the installer and with extension as ".sp". i.e, For <File Name>.bin, create a text
file named <File Name>.sp. For example, if the file name is ManageEngine_ApplicationsManager_11_linux.bin, create a text
file named ManageEngine_ApplicationsManager_11_linux.sp
● Open the ".sp" text file in an editor, add is.debug=1 as the content.
● Save the ".sp" text file in the same directory where the binary file resides.
● Change to the directory where the binary file is present by executing cd command
● Invoke the installer as ./<File Name>.bin -is:javaconsole -is:log log.txt
● The above command will create the log file named log.txt. Mail the log file to appmanager-support@manageengine.com.
Note
If the execution of the installation command throws an error such as "there may not be enough temporary space available in the
temp folder", then execute the file with the argument as
[for Windows] - <File Name>.exe -is:tempdir $DIRNAME
[for Linux] - ./<File Name>.bin -is:tempdir $DIRNAME
where $DIRNAME is the absolute path of any existing directory.
Troubleshoot: For more Installation Troubleshooting, refer Troubleshooting page on our website.

Uninstalling Applications Manager


Windows:

● Shut Down Applications Manager (Make sure that the ManageEngine ApplicationsManager service is stopped if installed as a
Windows service)

Copyright © 2014 Zoho Corp. Page 33


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

● Open a command prompt as an administrator [ Command Prompt -> right click --> Run as administrator], go to Applications
Manager Home directory and execute the following commands:
shutdownApplicationsManager.bat
shutdownApplicationsManager.bat -force

● Exit out of the command prompt and close all files, folders opened in the Applications Manager Home directory
● Click Start > Programs > ManageEngine Applications Manager > Uninstall Applications Manager
● Also from Control Panel > Add/Remove Programs.

Linux:

● From the command line, go to Applications Manager Home directory ( by default it is /opt/ManageEngine/AppManager ) and
execute the below commands
sh shutdownApplicationsManager.sh
sh shutdownApplicationsManager.sh -force

● Exit out of the command prompt and close all files, folders opened in the Applications Manager Home directory
● Execute the command ./uninstaller.bin from the AppManager/_uninst directory.
Note
You can uninstall Applications Manager via Command Line also. Type the following command in the command prompt:
./uninstaller.bin -console
Execution of this command would take you through the uninstallation process.
Here's how you can manually uninstall Applications Manager

Copyright © 2014 Zoho Corp. Page 34


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Licensing Applications Manager

When you have purchased the registered license file, you need to apply the license file over the existing version. This section
explains the procedure to apply the new license file.

Applying the New License File from the Web Client

A quick way to apply the new license file is from the web client.
1. In the web client, click on the [admin] drop-down list link provided at the top right-hand corner.
2. Click Product License link in the menu
3. A Register Applications Manager pop-up is displayed.
4. Click Browse button and locate the file (License.xml) in your local machine.
5. Click Register.

Your existing version is now changed to Professional Edition - Registered.

Note

For Enterprise Edition, it is sufficient that you apply the license in Admin Server alone, the managed servers will be taken care
automatically. The Product License link on top will disappear once you have applied the registered license. If the registered
customers, want to upgrade their license further, they can use the Product License link under Applications Manager Server
Settings in the Admin tab.

Applying the New License File using License Manager

The license manager comes handy when your license has already expired and you are not able to access the web client.

● Invoke the updateLicense.bat/.sh file located in the <Applications Manager Home>/bin directory (For Windows use 'Run as
Administrator' option). The License Manager UI is displayed.
● Click Browse button and locate the file (License.xml) in your local machine.
● Click Next and then Click Finish.
● Re-start the Applications Manager server.
Note
To invoke License Manager via Command Line, use the following command <updateLicense.bat/.sh -c>

Applying a license in a plugin build

Users must apply the OpManager license in the OpManager console to register the Applications Manager plugin (you need not
apply the OpManager license file on APM plugin license tool).

Please contact us at appmanager-support@manageengine.com for any technical query.

Copyright © 2014 Zoho Corp. Page 35


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Using Update Manager

The Update Manager is a tool which is used for installing the service packs (.ppm file) over Applications Manager. The service pack
may contain certain bug fixes and new feature additions. This document explains about how to use the Update manager to install
service packs over Applications Manager.
Note: The Update Manager also has some useful validation incorporated. This validation includes compatibility checks. You cannot
use update manager to install an incompatible service pack. For example, you cannot install a service pack of another product in
Applications Manager or a service pack of one version of Applications Manager in another version.

Installing Service Pack using Update Manager


1. Run updateManager.bat/sh file located in the <Applications Manager Home>/bin directory or invoke Start > Programs >
ManageEngine Applications Manager 10 > Update Manager in Windows (For Windows use 'Run as Administrator'
option). The Update Manager tool is displayed. Click Update.
2. Provide the service pack (.ppm file) by clicking the Browse button. Only compatible service pack file will be opened. Once the
file is specified, other buttons such as Readme and Install are enabled.
3. Click the Readme button and the Readme file related to the service pack is displayed in a separate window.
4. Click Install. This opens a new panel where the installation process is displayed. On completion, a message "Service Pack
installed successfully" is displayed and the service pack is listed in the Installed Patches section

To uninstall the service pack, click the Uninstall button and to know the service pack details, click the Details button in Update
Manager.

Installing Service Pack using Update Manager (Command Line Option)


updateManager.bat -c in Windows
sh updateManager.sh -c in Linux
shutdownApplicationsManager -force in Windows
shutdownApplicationsManager.sh -force in Linux
1. Under <Applications Manager Home>/bin, execute the following command.
2. To force quit Applications Manager execute the following command:

Using this command line option, you can install or uninstall a service pack or view its details. Press 'i' to install and specify the
absolute path of the service pack file in your machine.

Copyright © 2014 Zoho Corp. Page 36


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Starting and Shutting Down Applications Manager

Starting Applications Manager


Once installation is successful, you can start the Applications Manager by following the instructions provided for different operating
systems.

To start Applications Manager


In Windows
● Click Start > Programs > ManageEngine Applications Manager 10> Applications Manager Start (or)
● Invoke the batch file startApplicationsManager.bat file located in the <Applications Manager Home> directory.
Once the server is initialized, a tray icon is placed in the Windows system tray . After the server is started completely the icon
changes to and a message "Server Ready for Monitoring!" is displayed over the icon. Right-click on the Applications Manager
tray icon to connect to the web client or stop Applications Manager.
Starting Applications Manager as a Windows Service
In Windows, you can start Applications Manager as a service. With this feature you can start the Applications Manager server
automatically when the Windows system starts.
By default, during product installation, you can choose to install it as a service (More on Installation). If you have not enabled it
then, use the following option to setup Applications Manager as a service.
1. Go to <Applications Manager Home>/bin directory, execute the file installservice.bat. On executing this file, 'ManageEngine
Applications Manager' service is added in Windows Services and the startup type is set as 'Automatic', by default. (To ensure if it is
installed as service, check for the 'Services' under 'Windows Administrative Tools'). Note: For installing Applications Manager as
service, you need to have administrative privileges in that system.
2. Now, when you start Windows system, Applications Manager is automatically started. You can swap between Automatic and
Manual modes.
To uninstall this service, go to <Applications Manager Home>/bin directory, execute the file uninstallservice.bat.

In Linux
Execute the startApplicationsManager.sh file in the <Applications Manager Home> directory. See this blog to get tips on
starting Applications Manager when Linux boots.
Starting Applications Manager as a Linux service
You can start Applications Manager as a Linux service. With this feature you can start the Applications Manager server
automatically when the system starts. Follow the steps mentioned below to install AppManager as a service on a Linux box:
• Copy the attached AppManageLinuxService file to /etc/init.d directory as the file "AppManager".
• Edit the MDIR variable in this file which should point to the Home folder of AppManager Installation directory.Typically, the default
installation folder on a Linux box will be /opt/ME/AppManager11. Hence the value for MDIR will be: MDIR=/opt/ME/AppManager11
• Provide executable permissions for this script using: chmod 755 /etc/init.d/AppManager
• Use chkconfig command to add "AppManager" as a service: chkconfig --add AppManager or use update-rc.d AppManager defaults
Note:
Tested for Ubuntu 10.04 & above and AppManager Build No: 11 and above.
Try above steps and revert the changes if you face any problem, contac appmanager-support@manageengine.com for assistance
Troubleshoot: Having trouble starting Applications Manager? Refer to the online Troubleshooting section.

Shutting Down Applications Manager


To shutdown Applications Manager
In Windows
● Click Start > Programs > ManageEngine Applications Manager 10> Applications Manager Shutdown (or)
● In Applications Manager's Admin tab, under Tools, click on Shut Down Applications Manager icon (or)
● Invoke shutdownApplicationsManager.bat file located in the <Applications Manager Home> directory (or)
● Right-click on the Applications Manager tray icon and click Stop Applications Manager (or)
● Click Start > Run> services.msc> opens up Services console > stop ManageEngine Applications Manager

Copyright © 2014 Zoho Corp. Page 37


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

● [If Applications Manager is running as service]

In Linux
Use shutdownApplicationsManager.sh script located in the <Applications Manager Home> directory to shutdown Applications
Manager.
You can also use the Shut Down Applications Manager tool under Admin tab in Applications Manager.

Copyright © 2014 Zoho Corp. Page 38


Applications Manager User Guide
Applications Manager User Guide Installation and Setup

Compare our Editions

Meet your specific monitoring and business objectives by choosing the right edition of ManageEngine Applications Manager.
Applications Manager is available in these editions - Free, Professional and Enterprise.
Features Free Professional Enterprise
Supports monitoring up to 5 apps Supports integrated performance Supports large deployments
or servers. There is no time limit on monitoring for a heterogeneous with its distributed
Out-of-the-box support for 80+ applications
the free edition - you can use it set of applications. Ideal for monitoring capability. Ideal
forever. small to medium enterprises. for large enterprises.
Server Monitoring
Monitor open source apps & servers

Monitor commercial apps & servers


(For Five Monitors)
Application Server Monitoring
MySQL, Oracle, MS SQL,
Database Monitoring PostgreSQL, Memcached,
Cassandra, MongoDB and Redis.
Website / Web Services Monitoring
SLA Management
Exchange Server Monitoring
Virtualization monitoring VMware Monitoring Only
Cloud monitoring
WebSphere MQ Series monitoring

MS Office SharePoint monitoring

AS400 monitoring

ERP monitor

Web transactions monitoring for J2EE and .Net (APM Insight)


Web transactions monitoring for Ruby on Rails(APM Insight)
Integration with Site 24x7
End user monitoring (EUM)

URL monitoring/multi-step URL sequence monitoring

User administration, network discovery, custom dashboards

ManageEngine OpManager Connector

ManageEngine OpStor Connector

ServiceDesk Plus Integration

Anomaly detection
Admin tools: Downtime scheduler, Trap Listener, Scheduling, enabling, disabling
reports.
Updates and patches
Technical support E-mail Support (30 days)
Failover support

High scalability

Distributed architecture
Supported Operating Systems for Installation Windows, Linux Windows, Linux Windows, Linux
Starts @ $7,995 for 250
Price Free Starts @ $795 for 25 monitors
monitors

Copyright © 2014 Zoho Corp. Page 39


Applications Manager User Guide
Applications Manager User Guide Getting Started

Getting Started

When Applications Manager is started in Windows, the default browser as configured in your system is invoked and the login screen
is displayed. Login by specifying the authentication details. The default user name and password are "admin" and "admin"
respectively. To know more about the different types of user access to the product, refer to the User Administration section of
Performing Admin Activities.
In Windows, if you do not want the client to open by default, follow the steps given below to disable it.
1. Edit AMServer.properties file located in the <Applications Manager Home>/conf directory.
2. Set the value of am.browser.startup as false (by default, it is true).

After this configuration, when you restart the server the next time, the web client will not be invoked automatically. In Linux, by
itself, the client will not open by default..
To login to Web Client, when it is not opened by default
1. Connect to the Applications Manager through any browser with the host name and port number, say http://localhost:9090,
where 9090 is the default port number.

In Windows,

● Click Program Files > ManageEngine Applications Manager > Applications Manager Web Console.
● Right-click the Applications Manager tray icon and click Start Web Client.
● Then log in to the Applications Manager by filling in the User Authentication details.
Note
You can also use the startWebConsole.bat or sh file available at the <Applications Manager Home> directory that opens a default
browser of the localhost and connect to the Applications Manager at http://localhost:9090. Ensure that the Applications Manager is
started before executing this file.
Browse through the following topics which would help you understand Applications Manager better and work with it easily.

● Understanding Applications Manager


● Prerequisites for Applications Manager
● Working with Applications Manager
You can also refer our Best Practices Guide for more help on getting started with Applications Manager.
Note
User management is not supported for the Applications Manager plugin build over OpManager. At present, there are only two types
of roles available for plugin users - Administrator and Read-Only User. Operator, Delegated Admin and Manager role is not
supported. Applications Manager Plugin users cannot assign monitors to the any specific users in the Apps tab. They can view all
the default monitors only.

Copyright © 2014 Zoho Corp. Page 40


Applications Manager User Guide
Applications Manager User Guide Getting Started

Prerequisites for Applications Manager

Discussed below are the prerequisites for managing the various monitors:

● Application Servers
1. GlassFish
2. JBoss
3. Oracle Application Server
4. Tomcat
5. WebLogic
6. WebSphere
7. Java Runtime Monitor
8. Resin Server
9. Jetty Server

● Database Servers
1. MS SQL DB Servers
2. MySQL DB Servers
3. PostgreSQL
4. IBM Informix Server
5. SAP HANA

● Cloud Apps
1. Amazon CloudWatch
2. Windows Azure Cloud Service (Classic)
3. Microsoft Azure

● ERP
1. Oracle EBS
2. SAP Server, SAP CCMS
3. Microsoft Dynamics CRM

● Servers
1. Windows

● Services
1. JMX Applications
2. Ceph Monitor
3. Hadoop Monitor
4. Apache Zookeeper

● Mail Servers
1. Exchange Server

● Java / Transactions
1. APM Insight

Copyright © 2014 Zoho Corp. Page 41


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Middleware / Portal
1. IBM WebSphere MQ
2. IBM Websphere Message Broker
3. WebLogic Integration Server
4. Microsoft Office SharePoint Server
5. Microsoft BizTalk Monitoring
6. Azure Service Bus

● Virtualization
1. VMware Horizon View Connection Broker
2. Docker

● Web Server / Services


1. NTLM Authenticated URLs
2. PHP
3. Apache
4. Nginx
5. Real Browser Monitoring

Application Servers

Glassfish

While monitoring Glassfish application servers, make the following changes in the domain.xml file and then restart it:

● Change the "accept-all" property to "true" for the "jmx-connector" node : <jmx-connector accept-all="true"

The configuration line should look like this :


<jmx-connector accept-all="true" address="0.0.0.0" auth-realm-name="admin-realm"
enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="false"/>

JBoss

The prerequisites for managing the various versions of JBoss server are:

● JBoss Version 3.x and 4.x


● JBoss Version 5.x
● JBoss Version 6.x
● JBoss Version 7.x and above (EAP version 6 and above)
● JBoss Wildfly (WildFly 8 and above)

JBoss Version 3.x and 4.x

To monitor JBoss, the http-invoker.sar should be deployed in the JBoss Server. The
application (http-invoker.sar) is by default deployed in the JBoss server.

Copyright © 2014 Zoho Corp. Page 42


Applications Manager User Guide
Applications Manager User Guide Getting Started

If the http port of the JBoss server is changed then the port number in the attribute
InvokerURLSuffix should also be modified in JBOSS_HOME/server/default/deploy/http-
invoker.sar/META-INF/jboss-service.xml file.

JBoss Version 5x

To monitor JBoss 5.x version and above jbossagent.sar should be deployed in JBoss
server. To deploy, follow the steps below:

● Copy jbossagent.sar from location <Applications Manager


home>/working/resources and paste
under<JBOSS_HOME>/server/default/deploy.
● If you are running JBoss in different domain like all, then deployment target folder
would be<JBOSS_HOME>/server/all/deploy.

JBoss Version 6.x

To monitor JBoss 6.x version and above jbossagent.sar should be deployed in JBoss
server. To deploy, follow the steps below:
Example:
<bean class="org.jboss.services.binding.ServiceBindingMetadata">
<property name="serviceName">
jboss.remoting:service=JMXConnectorServer,protocol=rmi
</property>
<property name="port">1090</property>
<property name="description">RMI/JRMP socket for connecting to the JMX
MBeanServer</property>
</bean>

● Copy jbossagent.sar from location <Applications Manager


home>/working/resources and paste
under<JBOSS_HOME>/server/default/deploy.
● If you are running JBoss in different domain like all, then deployment target folder
would be<JBOSS_HOME>/server/all/deploy.
● Provide the rmiRegistryPort which is available
in
<JBOSS_HOME>/server/<domainname>/conf/bindingservice.beans/META-I
NF/bindings-jboss-beans.xml file. The default port is 1090.

JBoss Version 7.x and above


To add a new monitor for JBoss Version 7.x and above you must provide a management port. The
default port is 9990.
To add MBean attributes or operations for JBoss version 7 and above:

● Copy the jboss-client.jar from <JBoss Home>/bin/client/ and place it


under <Applications Manager Home>/working/classes/jboss/as7 directory.

Copyright © 2014 Zoho Corp. Page 43


Applications Manager User Guide
Applications Manager User Guide Getting Started

JBoss Wildfly
1. Change the Management port binding to use the network accessible interface:
● In the JBoss config file (i.e. <JBOSS_HOME>standaloneconfigurationstandalone-full.xml) change
jboss.bind.address.management:127.0.0.1 to jboss.bind.address.management 0.0.0.0
● Restart the service
2. Add a JBoss administration user for monitoring:
● <JBOSS_HOME>/bin/add-user.bat <USERID> <PASSWORD> ManagementRealm -silent

Top

Oracle Application Server

Applications Manager uses the Dynamic Monitoring Service (DMS) provided by Oracle Application Server to
monitor the same. For this reason, the DMS Servlet has to be made accessible to the system where the Applications
Manager is running.
To enable the access, please follow the instructions provided below
[The instructions are referred from the Oracle website :
http://docs.oracle.com/cd/B14099_19/core.1012/b14001/monitor.htm]
By default, the dms0/AggreSpy URL is redirected and the redirect location is protected, allowing only the localhost
(127.0.0.1) to access the AggreSpy Servlet.
To view metrics from a system other than the localhost you need to change the DMS configuration for the system
that is running the Oracle Application Server that you want to monitor by modifying the
file $ORACLE_HOME/Apache/Apache/conf/dms.conf on UNIX, or%ORACLE_HOME%ApacheApacheconfdms.conf on
Windows systems.
The following example shows a sample default configuration from dms.conf. This configuration limits AggreSpy to
access metrics on the localhost (127.0.0.1). The port shown, 7200, may differ on your installation.
Example: Sample dms.conf File for localhost Access for DMS Metrics

# proxy to DMS AggreSpy


Redirect /dms0/AggreSpy http://localhost:7200/dmsoc4j/AggreSpy
#DMS VirtualHost for access and logging control
Listen 127.0.0.1:7200
OpmnHostPort http://localhost:7200
<VirtualHost 127.0.0.1:7200>
ServerName 127.0.0.1

By changing the dms.conf configuration to specify the host that provides, or serves DMS metrics, you can allow users
on systems other than the localhost to access the DMS metrics from the location http://host:port/dms0/AggreSpy.
Caution: Modifying dms.conf has security implications. Only modify this file if you understand the security
implications for your site. By exposing metrics to systems other than the localhost, you allow other sites to
potentially view critical Oracle Application Server internal status and runtime information.
To view metrics from a system other than the localhost (127.0.0.1), do the following:

● Modify dms.conf by changing the entries with the value for localhost "127.0.0.1" shown in Example to the name
of the server providing the metrics (obtain the server name from the ServerName directive in the httpd.conf file,

Copyright © 2014 Zoho Corp. Page 44


Applications Manager User Guide
Applications Manager User Guide Getting Started

for example tv.us.oracle.com).


● Find below a sample updated dms.conf that allows access from a system other than the localhost (127.0.0.1).

Example: Sample dms.conf File for Remote Host Access for DMS Metrics

# proxy to DMS AggreSpy


Redirect /dms0/AggreSpy http://tv.us.oracle.com:7200/dmsoc4j/AggreSpy
#DMS VirtualHost for access and logging control
Listen tv.us.oracle.com:7200
OpmnHostPort http://tv.us.oracle.com:7200
<VirtualHost tv.us.oracle.com:7200>
ServerName tv.us.oracle.com
● Restart, or stop and start the Oracle HTTP Server using Application Server Control Console or using the Oracle
Process Manager and Notification Server opmnctl command.
For example,

%opmnctl restartproc process-type=HTTP_Server


or
%opmnctl stopproc process-type=HTTP_Server
%opmnctl startproc process-type=HTTP_Server
After performing the above steps, please ensure that you are able to access the
URL http://<host>:7200/dmsoc4j/AggreSpy from the Applications Manager system.
To check if a user has select privilege:
We suggest you to execute the below query directly in your Oracle machine and check if a connected user has select
privilege or not :
select TABLE_NAME,PRIVILEGE from user_tab_privs_recd where table_name in
('ALL_SCHEDULER_JOB_RUN_DETAILS','V_$RMAN_BACKUP_JOB_DETAILS
','ALL_SCHEDULER_JOBS','ALL_SCHEDULER_RUNNING_JOBS');
If there is no row selected or privilege column does not have select value for the above table_name columns, then
the user doesn't have privilege to access the table.
To grant Privilege:
Use the following query:
grant select on tablename to username;

Example: grant select on V_$RMAN_BACKUP_JOB_DETAILS to monitoruser; Note : As above, you have to give
grant permission on all the tables mentioned in the above query.

Tomcat

Applications Manager agent has to be deployed in Tomcat Servers 3.x and 4.x. More
In case of Tomcat 5.x and 6.x, an application named Manager must be running in it for Applications Manager to
monitor the Tomcat server. By default, this application will be running in the server. Moreover, the user role to
access the server must also be manager. To add a role as "manager" for any of the users such as tomcat, role1, or
both, you need to make changes in tomcat-users.xml file located in the /conf directory.

Copyright © 2014 Zoho Corp. Page 45


Applications Manager User Guide
Applications Manager User Guide Getting Started

Here is an example tomcat-users.xml, which has user tomcat with role as manager:

<?xml version='1.0' encoding='utf-8'?>


<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="manager"/>
<user username="tomcat" password="tomcat" roles="tomcat,manager"/>
<user username="role1" password="tomcat" roles="role1"/>
<user username="both" password="tomcat" roles="tomcat,role1"/>
</tomcat-users>

WebLogic

To monitor WebLogic 6.1 ,


Follow the steps given below:

1) Provide only Admin user name.


2) Copy Weblogic.jar from folder <Weblogic Home>/weblogic61/server/lib in Remote WebLogic
server version 6. Copy to <AppManager Home >workingclassesweblogicversion6 folder in the
machine where Applications Manager is running

To monitor WebLogic 7.x:

You should set


the weblogic.disableMBeanAuthorization and weblogic.management.anonymousAdminLookupEnabled variables to
true for enabling data collection.

Follow the steps given below:

1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin directory and add the following
arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click here for Sample
startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect
3) Copy Weblogic.jar from folder <Weblogic Home>/weblogic70/server/lib in Remote WebLogic server
version 7. Copy to <AppManager Home>workingclassesweblogicversion7 folder in the machine where
Applications Manager is running

To monitor WebLogic 8.x


You should set
the weblogic.disableMBeanAuthorization and weblogic.management.anonymousAdminLookupEnabled variables to
true for enabling data collection.
Follow the steps given below:

Copyright © 2014 Zoho Corp. Page 46


Applications Manager User Guide
Applications Manager User Guide Getting Started

1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin directory and add the following
arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click here for Sample
startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect
3) Copy Weblogic.jar from folder <Weblogic Home>/weblogic81/server/lib in Remote WebLogic server
version 8 Copy to <AppManager Home>workingclassesweblogicversion8 folder in the machine where
Applications Manager is running.

To monitor WebLogic 9.x,


Copy Weblogic.jar from folder <Weblogic Home>/weblogic92/server/lib in Remote WebLogic server version 9 . Copy
to <AppManager Home>workingclassesweblogicversion9 folder in the machine where Applications Manager is
running.

To monitor WebLogic 10.x , 11g , 12C ,


Copy Weblogic.jar, wlclient.jar, wljmsclient.jar, wlthint3client.jar from folder <Weblogic Home>/wlserver/server/lib in
Remote WebLogic server. Copy to <AppManager Home>workingclassesweblogicversion10 folder in machine where
Applications Manager is running.

For SSL support over Weblogic:

Weblogic certificate has to be imported to Appmanager12/working/jre/lib/security/cacerts file.


This certificate can be imported through Appmanager12/bin/WeblogicCertificate.bat/sh files.
Syntax:
WeblogicCertificate.bat [import] [Full path of weblogic server certificate] [alias name]
Example:
D:ManageEngineAPMjun26_2_t3sAppManager12bin> WeblogicCertificate.bat import
"G:OracleMiddlewareOracle_Homeuser_projectsdomainsMyDomainroot.cer" mykey

Note
• If customer is monitoring all
three versions of weblogic
(10.x, 11g, 12C), then get the
jars from latest version
of WebLogic (Version 12c).
• SSL option is enabled in the
UI only for version 9 and
above.
The ports that need to be
opened when the Weblogic
Monitor is behind the
firewall: Two-way
communication between
WebLogic listening port
(default : 7001) and
Applications Manager web
server port (default : 9090).

For WebLogic 7.x, 8.x

Copyright © 2014 Zoho Corp. Page 47


Applications Manager User Guide
Applications Manager User Guide Getting Started

"%JAVA_HOME%binjava" %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% -classpath "%CLASSPATH%" -


Dweblogic.Name=%SERVER_NAME% -Dbea.home="C:WebLogicWL7.0" -Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true -Dweblogic.management.username=%WLS_USER% -
Dweblogic.management.password=%WLS_PW% -Dweblogic.management.server=%ADMIN_URL% -
Dweblogic.ProductionModeEnabled=%STARTMODE% -Djava.security.policy="%WL_HOME%serverlibweblogic.policy"
weblogic.Server
goto finish

:runAdmin
@echo on
"%JAVA_HOME%binjava" %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% -classpath "%CLASSPATH%" -
Dweblogic.Name=%SERVER_NAME% -Dbea.home="C:WebLogicWL7.0" -Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true -Dweblogic.management.username=%WLS_USER% -
Dweblogic.management.password=%WLS_PW% -Dweblogic.ProductionModeEnabled=%STARTMODE% -
Djava.security.policy="%WL_HOME%serverlibweblogic.policy" weblogic.Server

WebSphere Application Server

For base deployment:


You have to modify the Performance Monitor Interface (PMI) Specification Level from "None" to "Standard".
Then deploy the perfServletApp.ear file, which uses the PMI infrastructure to retrieve the performance information
from WebSphere Application Server, in the WebSphere. Restart WebSphere Application Server.
For Network deployment:
You have to modify the PMI Sepcifictaion Level from "None"to "Standard" in all the WebSphere Servers in Network
Deployment. Then deploy theperfServletApp.ear file, which uses the PMI infrastructure to retrieve the performance
information from WebSphere Application Server, in any one of the WebSphere Servers in the Network Deployment.
Restart WebSphere Application Server.

Note: Steps to check whether WebSphere monitor has been correctly set

To modify PMI specification level:

● Connect to the Admin console - http://<Host>:<Port>/admin/


● On the left-side tree, expand the Servers node.
● Click on Application Servers link. This will display the list of servers running in the node.
● Click on the server for which data collection has to be enabled.
● In the Additional Properties table, click on Performance Monitoring Service.
● Change the Initial specification level to "Standard" and then apply the changes. Also enable (select) Startup.
To deploy perfServletApp.ear:

● Open the Admin console


● Go to Applications then Application Types, then WebSphere enterprise applications.
● Click Install and select local system.
● Browse the perf servlet application then click ok.
● The Default Path is <WAS_INSTALLED_PATH>/<APP_SERVER_NAME>/installableApps/PerfServletApp.ear
● Accept all default options and select Next until finish then click Save.
● After successfully installed this application, restart the node server once in order to work the perf servlet work correctly.
To check the perf servlet output, open the following url from your browser:
http://localhost:<PORT>/wasPerfTool/servlet/perfservlet?connector=SOAP&port=8880 <PORT> - 9080 (Default)

Steps to Check whether Websphere monitor has been correctly set

Copyright © 2014 Zoho Corp. Page 48


Applications Manager User Guide
Applications Manager User Guide Getting Started

For Base Deployment


To ensure whether the PMI & perfServletApp are configured properly in WebSphere, invoke the below URL & check
whether the data is returned in XML format.
http://WebSphereHost:Port/wasPerfTool/servlet/perfservlet?connector=SOAP&port=SOAP-PORT
where
WebSphere Host -> Host in which WebSphere Application Server is running
WebSphere Port -> HTTP Transport port of the WebSphere Application server [How to locate HTTP Port]
SOAP Port -> SOAP Port of WebSphere [How to locate SOAP Port]
For Network Deployment
To ensure whether the PMI & perfServletApp are configured properly in WebSphere, invoke the below URL & check
whether the data is returned in XML format.
http://WebSphereHost:Port/wasPerfTool/servlet/perfservlet?connector=SOAP&port=NetworkDeployerSOAP-PORT&HO
ST=NetworkDeployerHost
WebSphere Host -> The host of the websphere application server in which the perf servlet application is installed
Websphere Port -> HTTP Transport port of the Websphere server in which the perf servlet application is installed
[How to locate HTTP Port]
NetworkDeployer SOAP PORT -> The SOAP port of the domain manager (DMGR) [How to locate SOAP Port]
Network Deployer Host -> The host in which the domain manager is running.
Note: Also check whether WebSphere admin user is added to the monitor group of the perfservletApp.
How to locate SOAP Port?
1. Login to Admin console
2. Expand the server link on left side tree. Click on Application Servers
3. In Base mode, various WebSpheres will be listed down. Click on the WebSphere's name- > Under Additional
Properties, click on End Points link -> click on SOAP connector address. You can get the SOAP port from there.
4. In Network Deployment mode, Click DMGR - > Under Additional Properties, click on End Points link -> click
on SOAP connector address - You can get the SOAP port from there.
How to find the HTTP Transport port?
1. Login to Admin console
2. Expand the Server link on left side tree, Click on Application Servers
3. Various WebSpheres will be listed down. Click on the WebSphere's name- > Under Additional Properties, click
on Web Container link -> click on HTTP Transports link. You can get the HTTP port from there.

Resin Server

JMX MBeans are used to monitor Resin Application server's activity. To enable JMX, open Resin.XML and add the below JVM
arguments or start Resin.exe with the below JVM arguments

-Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.authenticate=false

Replace 1099 with the actual port number of the JMX agent

Copyright © 2014 Zoho Corp. Page 49


Applications Manager User Guide
Applications Manager User Guide Getting Started

Jetty Server

JMX MBeans are used to monitor Jetty server's performance. To enable JMX,

1) Add the below JVM arguments on Jetty start up:

-Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.authenticate=false

Replace 9999 with the actual port number of the JMX agent

2)Add the following line in start.ini file --module=jmx

Database Servers

MS SQL Database Server

For monitoring a MS SQL database server the user should be permitted to access
the MASTER and MSDB databases. He must log in using either thePublic and Db_datareader roles for
both MASTER and MSDB databases.
For SQL 2005, 2008 and 2012 servers the 'View Server State' permission should be also present. If you would like
to monitor SQL Server using SQL named instance, you need to ensure that the 'SQL Browser Service' is running in
the system.
To grant View Server State, you can use any of the following methods :
1) Execute the following query

GRANT VIEW SERVER STATE TO username;


2) In SQL management studio for user choose Properties -> Securables -> Click Add ( under securables ) -> choose
"All objects of the Types..." -> choose Servers -> choose Grant for "View server state" permission.
Note:
The collation option for Applications Manager's backend MS SQL Database is case-insensitive.

MySQL Database Server

While monitoring a MySQL database server ensure that you assign a user name that has permission to access the
MySQL database from the host where Applications Manager is running. An alternate way is to add a relevant user
who has the privileges to do the same.
The user should have privileges to execute SELECT, SHOW DATABASES, REPLICATION commands in the MySQL
server.
For enabling these privileges, execute the following commands in the remote MySQL Server:
INSERT INTO user (Host,User) VALUES('<host>','<user>');

Copyright © 2014 Zoho Corp. Page 50


Applications Manager User Guide
Applications Manager User Guide Getting Started

GRANT SELECT,SHOW DATABASES,REPLICATION CLIENT ON *.* TO '<user>'@'<host>';


FLUSH PRIVILEGES; (Use the host name - Applications Manager machine).

PostgreSQL

The PostgreSQL installers include the database server, pgAdmin and StackBuilder.
The 8.x installers are supported on:

● Ubuntu 6.06 and above


● Fedora 6 and above
● openSUSE 10 and above
● SLES 9 and above, CentOS/RHEL 4 and above
● Mac OS X 10.4 and above (Intel and PPC)
● Windows XP and above.
The 9.x installers are supported on:

● Ubuntu 8.04 and above


● Fedora 10 and above
● openSUSE 11 and above
● SLES 11 and above
● CentOS/RHEL 5 and above
● Mac OS X 10.5 and above (Intel 32 and 64 bit)
● Windows XP and above.
Applications Manager uses PostgreSQL's subsystem statistics collector to monitor PostgreSQL server activity. By
default, the statistics collector is accessible. If you have problems in adding a new PostgreSQL server, follow the
steps given below:
1. Open postgresql.conf under <postgres home>/data
2. Check value of configuration parameter listen address it has to be "*", if not change it to "*". Click here for
more details on configuring postgresql.conf
3. Open pg_hba.conf under /data
4. Add a new line host all all 0.0.0.0/0 md5 to allow all machines with proper password authentication to access
PostgreSQL DB server. Click here for more details on configuring pg_hba.conf

IBM Informix

JDBC Driver:
To monitor IBM Informix DB, make sure that the ifxjdbc.jar file is present in the
location:<ProductHome>workingclasses directory. The jar file can be copied from the IBM Informix installation
location, <IBM Informix Home>jdbclibjar. Restart Applications Manager after copying the file.
User Privileges:
To add an Informix DB monitor, a user requires Connect database-level privileges and he should be able to access
sysmaster database.

Copyright © 2014 Zoho Corp. Page 51


Applications Manager User Guide
Applications Manager User Guide Getting Started

SAP HANA

1. Need to copy ngdbc.jar into the location /working/classes. ngdbc.jar can be copied from installed SAP HANA
Client folder.
SAP HANA Client can be downloaded from here.
2. If HANA is running on Cloud Platform, in addition to the above ngdbc.jar, SAP Cloud platform SDK is also
needed. Copy the "lib" folder and neo.bat/sh file from SDK_HOME/tools to APM_HOME/working/hanacloud/tools/

3. Restart Applications Manager after performing the above steps.

4. Provide the below privileges for SAP HANA DB User.


● System privilege CATALOG READ.
● Object privilege SELECT on the schema _SYS_STATISTICS.

5. To grant the above privileges, execute the below statements in SAP HANA SQL console.(Replace USER_NAME
with actual HANA DB Username)
● GRANT MONITORING to < USER_NAME >
● CALL GRANT_ACTIVATED_ROLE ('sap.hana.admin.roles:Monitoring','< USER_NAME >')

CLOUD APPS

Amazon CloudWatch

The Amazon CloudWatch Monitoring scripts for Microsoft Windows Server are sample scripts for monitoring memory,
disk and performance counters on Amazon EC2 Windows instances.
Note:
The following permissions are required to configure an Amazon AWS monitor:

• AmazonS3ReadOnlyAccess
• AmazonRDSReadOnlyAccess
• AmazonEC2ReadOnlyAccess (AmazonEC2FullAccess if you plans to restart EC2 via Applications Manager GUI).

Please refer the following pages and use the scripts found
there: http://aws.amazon.com/code/7932034889155460and http://aws.amazon.com/code/8720044071969977.
Applications Manager supports mon-put-metrics-disk.ps1(disk stats) and mon-put-metrics-mem.ps1 (memory stats).
For windows scripts -

● In Line no 352, Change $monputrequest.namespace =


"System/windows" to $monputrequest.namespace = "APM/EC2"
● In Line no 277, Change $dims.Name = "InstanceID" to $dims.Name = "InstanceId".
For Linux scripts -

● In Line no 364, change $params{'Namespace'} = 'System/Linux' to $params{'Namespace'} = '


APM/EC2'.
Note:
Refer the following Document for Scheduler Configuration for Windows and Linux.

Copyright © 2014 Zoho Corp. Page 52


Applications Manager User Guide
Applications Manager User Guide Getting Started

Microsoft Azure

Discovery using Azure Organizational Account (Powershell) – Mode 1

1. Installing AzureRM Powershell module on Applications Manager server:


Open Powershell prompt with Administrator privileges
Run the following commands,

# Install the Azure Resource Manager modules from the PowerShell Gallery
Install-Module AzureRM

# Install the Azure Service Management modules from the PowerShell Gallery
Install-Module Azure

In case if you get the following error upon executing the above commands, then install the downloader from
http://aka.ms/webpi-azps

Install-Module: The term ‘Install-Module’ is not recognized as the name of a cmdlet, function, script file or
operable program

To check if the modules are installed successfully:


Open Powershell prompt with Administrator privileges. Run the following command,
Login-AzureRmAccount
If this opens a pop-up asking for Azure credentials, this means the required modules are installed
successfully.

For further troubleshooting regarding installing the module, refer https://docs.microsoft.com/en-


us/powershell/azureps-cmdlets-docs/

2. Create a Organizational account using Microsoft azure administrator permissions

● Log in to Azure Portal(https://manage.windowsazure.com) using the credentials of 'Administrator' .

● Select Active Directory


● Select the default directory

Copyright © 2014 Zoho Corp. Page 53


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Select “Users”
● Select “Add User”
● Make sure to select under “Type of user” : “New user in your organization”, Write down the user account name
of your user
● Make sure to select “Global admin”
● Note down the Email Id & temporary password of your user (Needed in next step)

3. Assign the Azure subscription to your organizational account

● Go to “Settings”-Last section of vertical pane


● Select “Administrators” in this overview
● Select “Add” on the menu below and assign the Email address of the newly created organizational account
● Select the subscription that you want to monitor.

● Sign out of the current account.


● Sign in using the newly created Email address and temporary password
● You will be prompted to change the password, when logging in for the first time

Copyright © 2014 Zoho Corp. Page 54


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Change and note down the new password


Provide this Email ID to ‘UserEmail’ field and Password to ‘Password’ field in the New monitor page, while using the
mode ‘Azure Organizational Account (Powershell)’ of Applications Manager.

Discovery using AD Application & Service Principal – Mode 2

For Microsoft documentation, refer https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-create-


service-principal-portal

1. Create Active Directory Application

● Log in to Azure Portal(https://portal.azure.com) using the credentials of 'Administrator'


● Select ‘Azure Active Directory’ from the left pane
● Select ‘App registrations’
● Select ‘Add’
● Provide a name & URL for the application (Sample SignOn URL to use : https://apm-apmtester.msappproxy.net )
● Click create.

2. Getting Client ID,Tenant ID & AppKey

● Select ‘Azure Active Directory’ from the left pane


● Select ‘App registrations’ → Select your application
● Copy the value given as ‘Application ID’ . This is your Client ID
● To get AppKey, select ‘Keys’
● Give description and duration of the key. When done, give ‘Save’
● Store the value of the key that is displayed. This is your AppKey
● Go to ‘Azure Active Directory’ → Properties
● Copy the value given as ‘Directory ID’ . This is your Tenant ID

3. Assign a role to the application

● Select ‘Subscriptions’ from the left pane


● Select ‘Access Control(‘IAM’)
● Select ‘Add’
● Select the role as ‘Owner’
● Search for your application and select it
● Select OK to finish assigning the role

Provide the Client ID, Tenant ID and Appkey in the New monitor page of Applications Manager.

Prerequisites for Enabling Guest OS

Metrics monitored when Guest OS monitoring is enabled

Copyright © 2014 Zoho Corp. Page 55


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Disk Utilization
● Disk IO Statistics
● Network Interface

Steps to be done on Applications Manager Server

1. Enabling Powershell Remoting ( To collect metrics by remoting into Azure VMs)


Open Powershell prompt with Administrator privileges
Run the following commands,
Set-ExecutionPolicy Unrestricted

#To configure Windows PowerShell for remoting, type the following command:
Enable-PSRemoting -force

#Configure the TrustedHosts setting so that appmanager can trust the connections from other servers :
Set-Item wsman:localhostclienttrustedhosts *

#To increase the maximum number of concurrent shells that a user can remotely open):
Set-Item WSMan:localhostShellMaxShellsPerUser -value 25 -WarningAction SilentlyContinue

#To set idle timeout value for sessions : Determines how long the session stays open if the remote computer does
not receive any communication from the local computer, including the heartbeat signal. When the interval expires,
the session closes:
Set-Item WSMan:localhostShellIdleTimeout -value 60000 -WarningAction SilentlyContinue

#Restart the WinRM service for changes to take effect:


Restart-Service WinRM

2. Provide outgoing access on all ports for Applications manager server machine
3. Run Applications Manager with administrator privilege
4. Powershell script execution has to be enabled on Applications manager server
Execute the below cmdlet from an administrator powershell window:
Set-ExecutionPolicy Unrestricted
If the above cmdlet produces an Error as below, you can configure Powershell Script Execution via Group Policy
Editor:

Copyright © 2014 Zoho Corp. Page 56


Applications Manager User Guide
Applications Manager User Guide Getting Started

Configure Powershell Script Execution via Group Policy Editor

● Open the Group Policy Editor from Control Panel→ Edit Group Policy (or) run gpedit.msc from Start menu.
● To configure, navigate under Computer Configuration to PoliciesAdministrative TemplatesWindows ComponentsWindows
PowerShell.
● You should see a setting called Turn on Script Execution like in the following image:

● Double-click the setting. You will want to enable it and select an option from the drop down.

Copyright © 2014 Zoho Corp. Page 57


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Set it to “Allow All Scripts”.


● Click Apply and OK.

Prerequisites for adding a Virtual Machine

Enable Diagnostics

● Log in to Azure New Portal (https://portal.azure.com)


● Navigate to your VM.
● Select ‘Diagnostics Settings’ → Make the status as ‘On’ and Select a Storage Account
● Select the check boxes of all the metrics to be monitored
● Restart the Virtual machine

GENERAL BEHAVIOUR

● Under the tab ‘Disk’, below ‘Disk spacing’ section, the disk size will be shown as 0, if disk size is not configured for the virtual
machine in portal.
● To set disk size in portal, refer https://blogs.msdn.microsoft.com/madan/2016/09/28/resize-azure-resource-manager-arm-vm-
os-data-disk-using-azure-portal/

Copyright © 2014 Zoho Corp. Page 58


Applications Manager User Guide
Applications Manager User Guide Getting Started

NOTE: In case if you change the resource group of any Virtual machine in Azure portal, then provide the updated details (Virtual
Machine ResourceID and Resource Group Name) in the Edit monitor page of that Virtual machine in APM for data collection to
happen.

Windows Azure Cloud Services (Classic)

● To add Windows Azure in Applications Manager, you must first export file of your Windows Azure Managed Certificates (eg.,
testcertificate.pfx) and password of the pfx file.
● To monitor Windows Azure in Applications Manager, invoke the batch script exportCertificateToAppManager.bat in
the <Applications Manager Home>bindirectory.

ERP

Oracle EBS

Applications Manager uses the Dynamic Monitoring Service (DMS) to monitor performance and availability of Oracle
E-Business Suite. You can access performance metrics using servlets from the following URLs for different versions of
EBS from Applications Managers:

● EBS R11 - http://<host>:<port>/dms0/AggreSpy


● EBS R12.0 - http://<host>:<port>/dms0/Spy
● EBS R12.2.0 - http://<host>:<port>/dms/Spy
For Oracle E-Business Suite Version R11i, the DMS Servlet has to be made accessible to the system where
Applications Manager is running. For Versions R12.0 and R12.2.0, the DMS Servlet should be accessible by default.
It is recommended that you test to ensure that the Servlet is accessible to the Applications Manager system. [The
instructions given below are referred from the Oracle website.]
For Oracle E-Business Suite R11i:

By default, the dms0/AggreSpy URL is protected, allowing only the localhost (127.0.0.1) to access
the AggreSpy Servlet. To view metrics from a system other than the localhost, you need to change
the DMS configuration for the system running the Oracle EBS that you want to monitor by modifying
the trusted.conf file. This can be done as follows:

● Open the trusted.conf file under $ORACLE_HOME/Apache/Apache/conf on a UNIX system,


or%ORACLE_HOME%ApacheApacheconf on a Windows system.
● Add the Applications Manager Hostname and IPaddress in the Allow from list as shown in the
following example:

<Location ~ "/(dms0|DMS|Spy|AggreSpy)">
Order deny,allow
Deny from all
Allow from localhost
Allow from <list of TRUSTED IPs>

Copyright © 2014 Zoho Corp. Page 59


Applications Manager User Guide
Applications Manager User Guide Getting Started

</Location>

● Now open the httpd.conf and httpd_pls.conf files and check if the trusted.conf file is
included. The Files are present under$ORACLE_HOME/Apache/Apache/conf on a UNIX system,
or %ORACLE_HOME%ApacheApacheconf on a Windows system. If the trusted.conf file is not
included, add the following lines in both the files and save:

# Include the trusted.conf file


include $ORACLE_HOME/Apache/Apache/conf/trusted.conf

● Restart Oracle E-Business Suite and ensure that you are able to access the
URL http://<host>:<port>/dms0/AggreSpy from the Applications Manager system.

For Oracle E-Business Suite R12.0:


Ensure that you are able to access the URL http://<host>:<port>/dms0/Spy (Hostname = Hostname with domain
name, Port number = OAS listening port) from the Applications Manager system.
For Oracle E-Business Suite R12.2.0:
Ensure that you are able to access the URL http://<host>:<port>/dms/Spy (Hostname = Hostname with domain
name, Port number = Weblogic Admin Server listening port) from the Applications Manager system. Users must
enter the credentials of their Weblogic Admin server in their Oracle E-Business Suite to access the URL.
Caution:
Modifying trusted.conf has security implications. Modify this file only if you understand the security implications for your site. By exposing metrics to
systems other than the localhost, you allow other sites to potentially view critical Oracle EBS Server internal status and runtime information.

SAP Server, SAP CCMS

SAP Server Monitoring and SAP CCMS Monitoring requires SAP JavaConnector ( JCo) to be present in Applications
Manager's classpath.
For Windows:

● Download and unzip the SAP JavaConnector [SAP JCo 3.0] from here. Depending on the hardware architecture of
host machine where Applications Manager is running, make sure you download the respective zip file.
● In the machine, where Applications Manager is running,
copy sapjco3.jar and sapjco3.dll and sapjco3.pdb under AppManager_home/working/lib directory.
● Microsoft Visual Studio C/C++ runtime libraries need to be installed in Applications Manager's host machine. To
verify, check for the presence of "Microsoft redistributable runtime DLLs VS2005 SP1" in ControlPanel ->
Program and Features. if not, follow the instructions in SAP note 684106 to install the Microsoft Visual Studio
2005 C/C++ runtime libraries in Applications Manager's host machine.
● Restart Applications Manager.

Note
Do not copy the sapjco3.dll neither into the {windows-dir}system32 nor into
the {windows-dir}SysWOW64 directory. This will break the operability of other JCo versions that are already
installed on the same system. Furthermore you would risk that the current installation also would not work
anymore, if the sapjco3.dll gets replaced in the respective Windows system directory in the future.

For Linux:

Copyright © 2014 Zoho Corp. Page 60


Applications Manager User Guide
Applications Manager User Guide Getting Started

● Download and unzip SAP JavaConnector[SAP JCo 3.0] from here. Depending on the hardware processor of the
host machine where Applications Manager is installed. make sure you download the respective zip file.
● In the machine, where Applications Manager is running,
copy sapjco3.jar and libsapjco3.so under AppManager_home/working/lib directory.
● Restart Applications Manager.

Note
The user name provided while adding SAP monitor should have sufficient privileges to access CCMS and
Background job metrics. To check this, the user can execute RZ20 transaction in the SAP GUI and see if the
CCMS monitor sets can be displayed.

Microsoft Dynamics CRM

To monitor a Microsoft Dynamics CRM application, use Administrator user account which has the permission to
excute WMI queries on 'rootCIMV2' namespace of the CRM Server.
Firewall access for monitoring:
Ports required for monitoring via WMI.

● Windows Management Instrumentation (WMI) (default : TCP 445)


● Remote Procedure Call (RPC) (default :TCP 135)
● Target server uses random port above 1024 by default to respond back for remote communication (DCOM)
(default : TCP 1025 to 1030)

Servers

Windows

Currently windows hardware performance monitoring is supported in SNMP and WMI monitoring mode:
SNMP Mode of monitoring:
Monitoring Dell hardware status:

● Dell OpenManage Server Administrator and make sure SNMP agent is enabled.
● Installation steps http://www.dell.com/downloads/global/power/ps2q06-20050112-Lou-OE.pdf.
Monitoring HP hardware status:

● HP System Insight Manager (SIM v6.2 or higher is recommended) and make sure SNMP agent is enabled
● Installation steps http://h20000.www2.hp.com/bc/docs/support/SupportManual/c00293378/c00293378.pdf
Determine if SNMP responds for the OID properly. Below are the correct OID'S for each vendor:

● For HP: 1.3.6.1.4.1.232.2.2.2.1.0


● For Dell: 1.3.6.1.4.1.674.10892.1.300.10.1.8.1
WMI mode of monitoring:
The following conditions must be met before you can proceed troubleshooting WMI nodes:

● The node has successfully been added via WMI.


● WMI is working properly on the remote server.
● HP System Insight Manager (SIM v6.2 or higher is recommended) is installed on the remote server and running.
● Dell OpenManage Server Administrator is installed on the remote server and running.

Copyright © 2014 Zoho Corp. Page 61


Applications Manager User Guide
Applications Manager User Guide Getting Started

If WMI, Execute the below cmdlet from Powershell prompt with Administrator privileges :
Set-ExecutionPolicy Unrestricted
This is to allow execution of powershell scripts, which handle proper process termination during Datacollection
For WMI Mode of Monitoring:
In Windows Server 2008 and later versions, and in Windows Vista and later versions, use the following dynamic port range:
Start port: 49152
End port: 65535
If your computer network environment uses only Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, Windows 8, Windows 7, or Windows Vista, you must enable
connectivity over the high port range of 49152 through 65535.
Windows 2000, Windows XP, and Windows Server 2003 use the following dynamic port range:
Start port: 1025
End port: 5000
If your computer network environment uses Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, Windows 8, Windows 7, or Windows Vista together with versions
of Windows earlier than Windows Server 2008 and Windows Vista, you must enable connectivity over both the following port ranges:
High port range 49152 through 65535
Low port range 1025 through 5000

Services

JMX Applications

To monitor a JMX Applications, the following java runtime options are to be added to your application

● Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099
● Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false
Replace 1099 with the actual port number of the agent
Example:

● To enable JMX Applications in JBoss:


● Edit the run.sh/bat under JBoss home/bin.
Append the following command to JAVA_OPTS,
JAVA_OPTS =-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false %JAVA_OPTS%
● To enable JMX Applications in JBoss 7 and above:
● Copy the jboss-client.jar from <JBoss Home>/bin/client/ and place it under <Applications Manager
Home>/working/classes/jboss/as7 directory.
● To enable JMX Applications in Tomcat:
● JAVA_OPTS =-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false %JAVA_OPTS%

● To enable SSL for JMX applications


● -Dcom.sun.management.jmxremote.ssl=true
● To enable authentication, use of authentication is recommended. If you do not want to use authentication, you should change
the value to false.
● -Dcom.sun.management.jmxremote.authenticate=true

● If you are using authentication, specify the location of the password file

● -Dcom.sun.management.jmxremote.password.file=c:jmxremote.password

● If you are using authentication, specify the location of the access file

● -Dcom.sun.management.jmxremote.access.file=c:jmxremote.access
Refer Oracle documentation in this regard:

Copyright © 2014 Zoho Corp. Page 62


Applications Manager User Guide
Applications Manager User Guide Getting Started

http://docs.oracle.com/javase/1.5.0/docs/guide/management/agent.html#remote

Note
To know more about
monitoring a JMX Application if
your application is behind a
firewall, check out this blog
post. Also please note that the
ping/telnet/nslookup should be
working for the remote JMX:
telnet hostname port
ping hostname
ping IPAddress
nslookup hostname
nslookup IPAddress

Ceph Storage Monitor

Ceph status command is used to collect performance stats of Ceph Storage Monitor. The user given, should have read privileage to
ceph.keyring file. Ensure the ceph.keyring file has appropriate permissions set (e.g., chmod 644) on your client machine.

Hadoop Monitor

1. To monitor Hadoop via REST API:

● No Authentication:
● URL http://<host>:<port>/jmx should be able to accessed from the Applications Manager machine for both Namenode and
Jobtracker/ResourceManager
● Simple Authentication:
● URL http://<host>:<port>/jmx?user.name=<Hadoop host username> should be able to access from the Applications
Manager machine for both Namenode and Jobtracker/ResourceManager
2. To monitor Hadoop via JMX:

● Add the following java runtime options to 'HADOOP_NAMENODE_OPTS'; 'HADOOP_JOBTRACKER_OPTS' in Hadoop-env.sh with
unique port.
● -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.port=8004

Apache Zookeeper

Prerequisites for monitoring Apache Zookeeper:

● Remote JMX should be enabled.


● To ensure that please open the ZKServer file under bin folder and check the below following:
1) JMXPORT =<PORT NO>
2) ZOOMAIN="-Djava.rmi.server.hostname=<IP address > -Dcom.sun.management.jmxremote -
Dcom.sun.management.jmxremote.port=$JMXPORT -Dcom.sun.management.jmxremote.authenticate=$JMXAUTH -

Copyright © 2014 Zoho Corp. Page 63


Applications Manager User Guide
Applications Manager User Guide Getting Started

Dcom.sun.management.jmxremote.ssl=$JMXSSL -Dzookeeper.jmx.log4j.disable=$JMXLOG4J
org.apache.zookeeper.server.quorum.QuorumPeerMain"

Note: Replace <PORT NO> with JMXPORT and <IP address > with IP address of the machine.

Java / Transactions

APM Insight

APM Insight includes a remote monitoring agent which has to be deployed in your application instances. Know more
about APM Insight Agent.

Java Runtime Monitor

To monitor a JDK1.5 JVM and above, add the following JVM arguments to your application:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false

To monitor IBM JDK1.5 JVM and above, add the following JVM arguments to your application:

-Djavax.management.builder.initial= -Dcom.sun.management.jmxremote -
Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.authenticate=false

Note: Port number '1099' can be replaced with the actual port number of the JMX agent..

● To enable Java Runtime Monitor in JBoss:

● Edit the run.sh/bat under JBoss home/bin. Append the following command to JAVA_OPTS
JAVA_OPTS =-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false %JAVA_OPTS%

● To enable Java Runtime Monitor in JBoss 7 and above:

● Copy the jboss-client.jar from <JBoss Home>/bin/client/ and place it under <Applications Manager
Home>/working/classes/jboss/as7 directory.

● To enable Java Runtime Monitor in Tomcat do the following.

● Edit the catalina.sh/bat under Tomcat home/bin. Append the following command to JAVA_OPTS
JAVA_OPTS =-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false %JAVA_OPTS%

Copyright © 2014 Zoho Corp. Page 64


Applications Manager User Guide
Applications Manager User Guide Getting Started

● To enable SSL over JMX, use the following JMX parameters in addition to the above, and restart the server.
JMX Parameters: -Dcom.sun.management.jmxremote.ssl=true -
Djavax.net.ssl.keyStore="E:/APMBuilds/certificates/jmx.keystore" -Djavax.net.ssl.keyStorePassword=password -
Djavax.net.ssl.trustStore="E:/APMBuilds/certificates/jmx.truststore" -
Djavax.net.ssl.trustStorePassword=passwordAdditionally, import the server certificate
to "<AppManager_Home>workingjrelibsecuritycacerts" file and restart the server.
Syntax:keytool -import -alias <certificat_aliasname> -file <target Application server Certificate> -keystore
"<AppManager_Home>workingjrelibsecuritycacerts" -storepass changeit -nopromptExample: keytool -import -alias jmxcert -
file "E:APMBuildscertificatesssloverjmx.cer" -keystore "C:Program Files (x86)AppManager12workingjrelibsecuritycacerts" -
storepass changeit -noprompt

In the Tomcat Environment:


Make sure the catalina-jmx-remote.jar file is present in the $TOMCAT_HOME/lib location. This jar file can be
downloaded for your version of Tomcat from the Apache website from the extras section (sample
link: http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.55/bin/extras/catalina-jmx-remote.jar).

Enable JMX in WebLogic

● Open the startWebLogic.bat file in a text editor.


● Find the JAVA_OPTS line and add the following:

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=8888
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false

● Restart WebLogic.

Mail Servers - Exchange Server

Monitoring of Exchange Server is possible only if Applications Manager is running in a Windows System. Exchange Monitoring
supports two Modes of Monitoring

● Using WMI - if WMI is enabled in the remote machine in which Exchange Server is running and
● Using Windows PowerShell technology - To use Powershell for data collection, make sure the proper steps have been
followed to enable and use remote commands in Windows PowerShell both in the Applications Manager server and the remote
server.

Creating User Accounts, adding users and assigning roles

User Account Used for Monitoring

The User Account used to add the monitor should be a member of View-Only Organization
Management group. Make sure that the group has the following Roles assigned - Mailbox Search &

Copyright © 2014 Zoho Corp. Page 65


Applications Manager User Guide
Applications Manager User Guide Getting Started

Monitoring.
For Exchange View-Only Administrators:
This role allows read access only to Exchange organization container and containers with Exchange
recipients in AD. They can verify settings, but can not change or add any settings. Only Powershell
"Get-<cmdlet>" can be executed.

Adding Users and Assigning Roles

Adding Users to the View-Only Organization Management group and assigning roles in:

● Exchange 2010/2013
● Open Exchange Mangement Console in the Exchange Server.
● To check if the user is already under View-Only Organization Management role group: Get-
RoleGroupMember "View-Only Organization Management" | where-object {$_.Name -eq
"<Username>"}
● If the user is not under the specified role group,execute the below cmdlet to add the
user: Add-RoleGroupMember "View-Only Organization Management" -Member <Username>
● Next Add the two roles for View-Only Organization Management role groupNew-
ManagementRoleAssignment -SecurityGroup "View-Only Organization Management" -Role
"Monitoring"
New-ManagementRoleAssignment -SecurityGroup "View-Only Organization Management" -Role
"Mailbox Search"
● Exchange 2007:
● Open Exchange Management Shell.
● Execute the following cmdlet: Add-ExchangeAdministrator –Identity <Username> –Role
ViewOnlyAdmin

Configuring ConnectionURI for Powershell Remoting

The ConnectionURI is used to establish a connection to a remote computer using the URI address of the related HTTP
or HTTPS endpoint.These connections are made over TCP port 80 for HTTP and TCP port 443 for HTTPS. By
default,the connection URI is of the formhttp://<Hostname/IPaddress>/powershell and uses Kerberos authentication.

● With Kerberos Authentication: When the machine running Exchange Server is joined to the same domain as
the machine running Applications Manager, either HTTP or HTTPS can be used with Kerberos Authentication.
● If Kerberos Authentication is not supported , or the machine is in another domain, the other option is to
configure Basic Authentication for powershell virtual directory. To configure basic authentication in Exchange
2013, 2010 or 2007 using IIS Manager:
● Open IIS Manager.
● In the Connections pane, expand Default Web Site, and then click PowerShell.
● Click Authentication in the results pane and enable Basic Authentication.

Note
If you decide to use Basic Authentication, HTTPS should be used as mode of connection for connectionURI. If
the connectionURI should be customized it can be done so by clicking the "Customize ConnectionURI" option in
new monitor page. To provide a different port for the connectionUri provide it in the following
format: <https://<hostname>/Powershell:<portnumber> (or) <http://<hostname>/Powershell:<portnumber>
For Example : http://win-exchange13/Powershell:4444

Copyright © 2014 Zoho Corp. Page 66


Applications Manager User Guide
Applications Manager User Guide Getting Started

Middleware / Portal

IBM WebSphere MQ Monitor

To monitor IBM Websphere MQ Series, the following jar files must be added to the respective locations:

For IBM
Webspher Location in
Location in Websphere
e MQ Jar files to be added Applications
MQ
Series Manager
version

Download the supportpac


MS0B WebSphere MQ Java
classes for PCF, the
com.ibm.mq.pcf-6.1.jar Copy the jar files
1. com.ibm.mq.jar
Version file for version 6 and older to<ProductHome>
2. com.ibm.mq.pcf-6.x.jar
5.x/6.x versions. workingjrelibext
3. connector.jar
The jar files can be found directory.
under <Websphere MQ
Home Directory>Javalib
directory.

1. connector.jar
2. com.ibm.mq.jar
3. com.ibm.mq.pcf.jar All the jar files can be found Copy the jar files
4. com.ibm.mq.jmqi.jar under<Websphere MQ to<ProductHome>
Version 7
5. com.ibm.mq.headers.jar Home Directory>Javalib workingjrelibext
6. directory. directory.
com.ibm.mq.commonservices.j
ar

1. com.ibm.mq.jar
2. com.ibm.mq.pcf.jar
3. com.ibm.mq.jmqi.jar
All the jar files can be found Copy the jar files
4. com.ibm.mq.headers.jar
under<Websphere MQ to<ProductHome>
Version 8 and
Home Directory>Javalib workingjrelibext
5.
directory. directory.
com.ibm.mq.commonservices.j
ar
6. com.ibm.mq.allclient.jar

IBM WebSphere Message Broker

To discover Message Broker, the following jars are required:

● ConfigManagerProxy.jar located at <Broker Home Directory> classes directory.


● ibmjsseprovider2.jar located at <Broker Home Directory>jrelib directory.

Copy the two jar files to <AppManager Installation>workingjrelibext directory.

Note
Copy these jar files to <JavaHome>jrelibext directory if external JDK is configured for
AppManager. Restart Applications Manager and try adding the monitor.

Copyright © 2014 Zoho Corp. Page 67


Applications Manager User Guide
Applications Manager User Guide Getting Started

WebLogic Integration Server

Note: WebLogic Integration Server needs some additional configuration and conditions to be followed for monitoring.

● For monitoring WebLogic Integration Server 8.x, you should set


the weblogic.disableMBeanAuthorization andweblogic.management.anonymousAdminLookup system
variable to true for enabling data collection.
● Follow the steps given below:
1. Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin directory and add the following
argument -Dweblogic.disableMBeanAuthorization=true and -
Dweblogic.management.anonymousAdminLookupEnabled=true (click on the link to view the
sample startWLS.cmdsh file)
2. Restart the WebLogic Integration Server for the changes to take effect.
3. Copy weblogic.jar from folder /weblogic81/server/lib in Remote WebLogic server version 8 and place it under
<AppManager Home >workingclassesweblogicversion8 folder in the machine where Applications Manager is
running.

Microsoft Office SharePoint Server

For SharePoint Standalone Server:

WMI Mode:

● WMI access to remote server is required.


PowerShell Mode:

● PowerShell remoting should be enabled. For more information, check enable and use remote commands in
Windows PowerShell.
For SharePoint Farm Server:

● Enable PowerShell remoting on both, AppManager and Remote Server.


Perform the following steps on the SharePoint Server(s).

● In the Server Manager, add the user account used for adding the Sharepoint to the following Groups:
● Remote Desktop Users
● WinRMRemoteWMIUsers__
● WSS_ADMIN_WPG
● Open the Sharepoint Management shell as an administrator and execute the below commands one by one:
● Enable-PSRemoting -Force
● Enable-WSManCredSSP –Role Server
● winrm set winrm/config/winrs '@{MaxShellsPerUser="25"}'
[This is Optional].

Copyright © 2014 Zoho Corp. Page 68


Applications Manager User Guide
Applications Manager User Guide Getting Started

● winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="600"}'


[This is Optional].
● Get-SPShellAdmin
[This command will return all the users who have the SharePoint_Shell_Access role].
● Get-SPDatabase | Add-SPShellAdmin DOMAINUserName
[Replace DomainUsername with the user used to add the SharePoint Server].
● Get-SPShellAdmin
[The added user should be listed.]
● Set-PSSessionConfiguration -Name Microsoft.PowerShell32 –ShowSecurityDescriptorUI[This command will
open up a dialog box. Add the user(s) with Read and Execute permissions then click OK].
● Run the above command again to ensure the permissions were applied correctly.
Perform the following steps on the Applications Manager Server.

● Open Windows PowerShell as Administrator.


● Execute the below commands in the Administrator PowerShell:
● Enable-WSManCredSSP -Role client -DelegateComputer “SharePointServerName”[Replace
SharePointServerName with the FQDN of the SharePoint server].
● $cred=get-Credential
● $s=new-PSsession “SharePointServerName” -authentication credssp -credential $cred[Replace
SharePointServerName with the FQDN of the SharePoint server].
● Invoke-Command -Session $s -ScriptBlock {Add-PSSnapin Microsoft.SharePoint.PowerShell;}
● Invoke-Command -Session $s -ScriptBlock {get-SPContentDatabase}[This will return all the content
databases in your SharePoint farm and ensure you have access].
● Invoke-Command -Session $s -ScriptBlock {get-spserviceinstance}[This will return the SharePoint
service instances and ensure you have access].
● Enter-PSSession -session $s[You will now see the servers name in [ ] PS: c:users\documents].
● Exit-PSSession
If there are any errors related to permissions issue while executing the above commands, resolve the same.
For any issues related to Add-SPShellAdmin, check the following link :
https://technet.microsoft.com/en-us/library/ff607596.aspx

Microsoft BizTalk Monitoring

To monitor a Microsoft BizTalk Server, the user must have Administrator privileges. To use Powershell for data
collection, make sure the proper steps have been followed to enable powershell remoting.

Azure Service Bus

To add an Azure Service Bus Namespace in Applications Manager, a .pfx file (which contains the cryptographic
information of private keys) of the certificate uploaded in Azure Management certificates is required.
In the console, execute the script <APM_HOME>/bin/exportCertificateToAppManager.sh/bat file to export the
managed certificate of your account to Applications Manager.
To know more about creating certificates and uploading in Windows Azure portal, Click here.
Example:
<APM_HOME>/bin/exportCertificateToAppManager.bat [testCertificate.pfx] [password]

Copyright © 2014 Zoho Corp. Page 69


Applications Manager User Guide
Applications Manager User Guide Getting Started

Virtualization

VMware Horizon View Connection Broker

Prerequisite for adding the Connection Broker monitor in the Applications Manager host:
VMware Horizon View Connection Broker monitor uses Windows PowerShell technology. Follow these steps to enable
Windows PowerShell Remoting in the Applications Manager server and the remotely monitored Horizon View server:

● Enable and Use Remote Commands in Windows PowerShell


● Horizon View's Domain Server and its components should be accessible (able to ping ) from the Applications
Manager server.
Enable and Use Remote Commands in Windows PowerShell in Applications Manager server and remote
server:
For using PowerShell in Applications Manager, you need Windows Management Framework (Windows PowerShell 2.0
and WinRM 2.0) on both Applications Manager server and the remote Windows server. For more details
refer http://support.microsoft.com/kb/968929. Also ensure that Windows PowerShell is enabled in both servers
(Open Control Panel. Select Programs and Features. In the Tasks list, click Turn Windows features on or off.
When the Server Manager console opens, check if Windows PowerShell is enabled)
You can verify the availability of Windows Remote Management (WinRM) service and configure PowerShell for
remoting by following these steps:

● Start Windows PowerShell as an administrator by right-clicking the Windows PowerShell shortcut and selecting
Run As Administrator.
● To configure Windows PowerShell for remoting, type the following command:
Enable-PSRemoting –force
● Configure the TrustedHosts setting on both computers, so that computers will trust each other:On Remote
Monitored Server:
Set-Item wsman:localhostclienttrustedhosts <Applications Manager hostname> On Applications Manager
Sever:
Set-Item wsman:localhostclienttrustedhosts *
● On both computers, restart the Windows Remote Management (WinRM) so the new settings will take effect:
Restart-Service WinRM

You can test the configuration and connection from Applications Manager using the Test-WSMan -ComputerName
<remote server> command. This command tests whether the WinRM service is running on the remote computer
and if Applications Manager can communicate with the remote server.

Docker

Docker and Docker Container metrics are collected via their REST API, so Docker's REST API should be enabled to
add a Docker Monitor.

To enable remote API:

Copyright © 2014 Zoho Corp. Page 70


Applications Manager User Guide
Applications Manager User Guide Getting Started

1. Open etcdefaultdocker file

2. Add the below option

DOCKER OPTS='-H tcp://0.0.0.0:4243-H=unix:///var/run/docker.sock'

3. Save the file.

4. Restart Docker.

Web Server / Services

PHP

Place the phpstats.php file in the webserver's document root. The phpstats.php can be found in <Applications
Manager Home>/working/resourcesdirectory.

Apache

Enabling the Server status and the Extended-status will give additional information for the Apache server.

To enable the Server Status, follow the steps given below:

● In Apache's httpd.conf file, locate "Location /server-status" tag.


● Remove the comment in the Location/Server-status tag, to Enable SetHandler server-status.
● Change the attribute "deny from all" to "Allow from all".
● Remove the comment in "LoadModule status_module modules/mod_status.so".
● Save the conf file and restart the Apache Server.

To enable the Extended-status, follow the steps given below:

● Locate "ExtendedStatus" Attribute in httpd.conf file.


● Remove the comment to enable the status.
● Save the conf file and restart the Apache Server.

Copyright © 2014 Zoho Corp. Page 71


Applications Manager User Guide
Applications Manager User Guide Getting Started

Nginx

To Enable the Nginx Server Status, follow the steps given below:

● Configure the location /server_status method in <NGINX_HOME>/conf/nginx.conf file, to enable server_status.


● The value of stub_status attribute should be "on".
● Change the attribute "deny all" to "Allow all".
● Save the conf file and restart the Nginx Server.

Real Browser Monitoring (RBM)

RBM requires network connectivity between the RBM agent and the Applications Manager server. This network
connectivity can be ensured with the help of the VPN or NAT or by assigning an direct IP Address to the Applications
Manager server. In the case where an agent is deployed within the local network and another one in a remote site, a
dual NIC or any one of the above means would be required to ensure this connectivity.

For any further support please contact appmanager-support@manageengine.com. You can visit Troubleshooting details.

Copyright © 2014 Zoho Corp. Page 72


Applications Manager User Guide
Applications Manager User Guide Getting Started

Understanding Applications Manager

Applications Manager is a web-based monitoring tool that manages the performance of applications, servers, databases, systems,
services, websites, and JMX/SNMP-based custom applications in a complex IT infrastructure. You can find seven module tabs at the
top which are explained as follows:

Intro Introduction Page of Applications Manager. It gives an overview of the working of Applications Manager.

Has four views: Summary, Business View, Availability and Performance

Summary: Has a dashboard that shows the health and availability of all the Monitor Groups in a snapshot . Lists all the Monitor Groups created and their details and
graphical representation of the Monitor Group with most critical alarms. Recent 5 alarms can be also be viewed.

Business View: The business view provides you a graphical snapshot of the entire business infrastructure which is being monitored. This view displays the various
Monitors associated to Monitor Groups along with its health and availability.
Home
Availability: Gives the Availability history of the Monitors/ Monitor Groups in a snapshot. You can get the data for either the last 24 hours or the last 30 days.

Performance: Gives the Health history and events of Monitor/Monitor Groups in a dashboard. You can get the data for either the last 24 hours or the last 30 days
(excluding today).

Custom Dashboards: Apart from the already available dashboards, you can create your own custom dashboards by using different widgets.

Lists all the Monitor Types supported and provides the number of Monitor being discovered in the network. You can also click on the Monitor Types to view information
Monitors of their Monitors. On clicking the Monitor Types, you can view the Availability Dashboard, Performance Dashboard and the List View that shows the performance
attributes of the Monitor in detail.

Lists the alarms generated by the Monitor and their attributes, based on predefined thresholds. The view is customizable such that you can view alarms for all or for
Alarms
particular application or Monitor Type, list 10/25/50/75/100/125 entries in a single view, etc.

Lists the Monitor Groups and the different Monitor Types for which the reports are generated. Reports can be viewed based on attributes listed for the corresponding
Reports
Monitor Type.

Provides information on getting assistance from the Applications Manager Technical center. It also provides monitoring information on Applications Manager which
Support
monitors itself.

Admin Lists the admin operations such as creating new application, new Monitor, etc. to be performed for monitoring.

The left frame consists of links for easy navigation and the top frame consists of links such as Talk back, Help, Personalize etc.
common in all the screens. To know more details on these links and icon representation, refer to the Web Client section. The
various tables in the web client can be dragged and arranged as per your requirement

Note: Have a look at Getting Started - How to Demos from Website.

Copyright © 2014 Zoho Corp. Page 73


Applications Manager User Guide
Applications Manager User Guide Getting Started

Monitor Views

Under Monitor tab, you can see all the monitors listed down in the Select View drop-down menu in the right-hand corner. There
are eight different views:

● Bulk Configuration View


● Category View
● Plasma View
● Monitor Group View
● World Map View
● Icon View
● Table View
● Business View

Lists all the details of the monitors that are monitored. From this view you can carry out bulk
Bulk Configuration View admin operations like updating user name and passwords across monitors. Refer Bulk
Configuration for further details.

Lists the monitors according to the various categories like Applications Servers, Database
Category View
Servers etc.

Copyright © 2014 Zoho Corp. Page 74


Applications Manager User Guide
Applications Manager User Guide Getting Started

In this view, the Monitors will be arranged in an default order.You can re-arrange the Monitors
and click on the floppy disk icon to save the view. You can also zoom in and out of the view,
and save the zoom level which is optimal for your viewing.

Business View has the following properties.You can edit the view by clicking on Settings icon
and selecting the Edit View from the menu to open a Customizable Business View page:

View Properties
• Update Monitor - This setting allows you to refresh the status of the Monitors and Monitor
Groups automatically by fixing some limited time (in minutes).
• Reload Interval - This setting is similar to Update Monitor except that it will reload the
entire view after the given time. The recommended interval would be 15 minutes.
• Check the Show Label for Monitors checkbox to show the labels for various monitors.
• Associated Monitor Groups - This setting allows you to add various Monitor Groups to your
view. This is only available for the "Customizable Business View".
• Under View Properties, by selecting Show only Monitor Groups and Sub Groups
allows you to include the Monitor Groups and Sub Groups in the selected view.
• By selecting Show only Critical Monitors you can show only critical Sub Groups and
Monitors inside the selected view.
Business View • By selecting Show only Monitor Groups Status you can show the status of top level
Monitor Groups (that are selected via Associated Monitor Groups) in the selected view.
• You can also select the View Type as HTML or Flash. The option is set to HTML by default.

You can create multiple views for a Monitor Group. Click on the Settings icon in the business
view and select Create New View. By providing various details like Update Monitor time
interval, Reload interval, opting to select Monitor and Monitor Groups and Sub Groups you can
create a custom view.

In addition, you can also edit its apperance of the view . Go to the Display Properties tab and
provide the following details:
1. Background color
2. Line Color
3. Label Color
4. Line Thickness
5. Line Transperancy

Publishing the View: Applications Manager allows you to embed these Business View in
intranet/internet portals by selecting the menu option 'Publish The View' from Settings and
copy the iframe details and pasting it in the webpages.

Applications Manager, integrated with online map services, provides network traffic
information at a geographical dimension. By using online map API features, Applications
World Map View
manager provides different levels of abstraction in the network data visualization.Refer to
World Map View for further details.

Lists all the monitors using icons, shows the host and the monitors assosciated with it
Icon View
symbolically

Table View Lists the monitors within the host in a tabular format.

Copyright © 2014 Zoho Corp. Page 75


Applications Manager User Guide
Applications Manager User Guide Getting Started

The plasma view enables you to have a snapshot of what is happening with the monitors, at
one glance. The view can be put up on a plasma screen, and you can have a look even when
you are not in front of the monitor.
Plasma View
The 'Customize View' option available in the top right hand corner, gives you the option to
customize the layout. By checking the option “Play sound alarm for critical events”, you can
get notified/ warned of the critical events by sound alarms.

Lists all Monitor Groups and the Sub-Groups available. You can associate Monitors, Copy Paste
Monitor, configure alarms through this Monitor Group View itself. (as like Bulk Config view). In
Monitor Group View
addition, you can enable or disable actions via this view itself, i.e, even if you have already
configured actions like sending EMail, through 'disable action' you can prevent EMail action.

Copyright © 2014 Zoho Corp. Page 76


Applications Manager User Guide
Applications Manager User Guide Getting Started

Working with Applications Manager

The following are the steps involved in monitoring:


1. Create a new Monitor Group: Create a new Monitor Group by grouping one or more Monitors.
2. Create new Monitor: Discover Monitors in the network and start collecting data (performance metrics, availability etc) for the
same.
3. Create new Monitor Type: Create new monitor type for monitoring custom applications.
4. Associate Monitor with Monitor Group: Add the discovered monitors to the Monitor Group.
5. Create threshold profile: Create thresholds to identify the status of a specific attribute.
6. Create actions: Specify what action needs to be taken in the event of an alarm.
7. Associate threshold and action with the attributes: Associate the thresholds and action to generate alarms and perform
action based on the threshold definition.
8. Configuring dependencies: Dependencies specify the rule based on which the severity of health and availability is
determined. For example, Health of a Tomcat Server may depend on the overall response time of the server or on the
response time of each of the web applications deployed on the server etc. By configuring dependencies, you can determine
the attribute, based on which the severity of health changes.

Note: Have a look at Working with Applications Manager - How to Demos from the website.

Please go through Working with Monitor Group and Configuring Alarms for detailed information on the above.

See Also

Best Practices Guide

Copyright © 2014 Zoho Corp. Page 77


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Working with Monitor Groups

Monitor Groups are a logical group of one or more Monitors that provides a holistic view of your business environment.

For example, the health of an online Web application depends on various factors, such as the health of the application server
hosting the Web application, the availability of the Web server for accessing the Web applications, the database server for storing
or getting the required information, etc. These web applications and services can be grouped together and monitored as a single
Monitor Group.

Troubleshoot: For any monitoring-related troubleshooting, refer to the online Troubleshooting section.

The following sections are the steps involved to work with a Monitor Group:

● Creating Monitor Groups


● Creating Web Application Groups
● Creating New Monitor
● Associating Monitors to Monitor Groups
● Deleting Monitor from Monitor Groups
● Editing and Deleting a Monitor Group

Copyright © 2014 Zoho Corp. Page 78


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Associating Monitors to Monitor Groups

To associate a Monitor/ Process/ Service / Database to a Monitor Group, follow the steps given below:
1. Click on the Monitor Group (from Home tab).
2. Under Monitor Group Information, click Associate Monitors link. Alternatively, select the Monitor Type by moving the mouse
over the Associate Monitor of Monitor Group Links in the left frame.
3. A list of discovered Monitors/ Processes/ Services / Databases that are available for associating and those that have
already been associated with that Monitor Group is displayed. Note: The status of Monitor Group would remain unknown,
until you associate at least one monitor to it.
4. Select the check box of the corresponding Monitor from Monitors not present in this Monitor Group list and click Add. You can
also remove a Monitor which has already been associated with the Monitor Group by selecting the check box of Monitor(s)
under Monitors present in this Monitor Group and clicking Remove.

Note:
• In order to add Processes, Services & Databases to Monitor Groups, the 'Associate Process, Service and Databases to Monitor Group' option has to be enabled
from Admin tab> Performance Polling> Servers, prior to performing the action. On disabling this option, the Processes/ Services associated previously can only be removed
manually from the Monitor Group..

• When a Process, Service or Database is down, the RCA for the Monitor Group will display the Process/ Service/Database name along with the Server Display name. The following is
a sample RCA for the Monitor Group when the Process w3wp.exe from the server with display name appvm-win7-64 is associated.

Limitations:

• Dashboards and Reports are currently not supported when Processes/ Services/Databases are associated to Monitor Groups.

• By default, Services do not have the Health attribute. It will not be displayed when viewed from Monitor Group or Web App Group.

Copyright © 2014 Zoho Corp. Page 79


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Creating Monitor Groups

This section explains how you can create a new Monitor Group. A monitor Group is particularly useful for grouping the resources of
a location say the resources available in sales office or for grouping the resources used by a business application.

Applications Manager provides two types of monitor groups - Monitor Group and Web Application Group. The steps to create a
Monitor group are explained below. To create a web application group, refer this link.

To create a new Monitor Group, follow the steps given below:


1. Click New Monitor Group.
2. Provide a Name for the Monitor Group. This is mandatory and only alphanumeric characters, dashes (-), underscores (_),
periods (.), and spaces ( ) are allowed.
3. Provide any Description, if required.
4. Under Advanced Options, Select the Owner from the list of users created. Refer User Administration topic for more
information on the different roles of users.
Note:
Operator if associated as an owner will have Read Only Access to that particular Monitor Group alone.
Admin user is a super user and will be able to see all Monitor Groups.
Manager if associated will be able to view this Monitor Group in Manager Console. Using this option, Restricted Monitor Groups
alone can be shown in Manager Console. [By default, if the Manager is not explicitly associated to a Monitor Group, the
Manager will be able to access all the Monitor Groups in the Manager Console]
5. Select the location for associating the monitor group to World Map Business View. Else by clicking on 'Add Location', world
map opens up. Here you can add and select custom locations.
6. Click Finish to create the Monitor Group and to add Monitors later.

How To Demos: Have a look at our demo on creating Monitor Group in our
website.

Creating a Sub-Group within a Monitor Group

Copyright © 2014 Zoho Corp. Page 80


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

By using this option, you can create a Monitor Sub-Group within a Monitor Group (a Monitor Group within a Monitor Group). Sub-
Groups help better organization of your resources. With Sub-Groups, you can capture advanced dependencies in your
infrastructure. You can group clustered databases or servers and create complex groups. For eg., A huge banking application
Monitor Group may contain 100 monitors (application servers, systems, databases, URLs, etc.,). All the database monitors can be
grouped under a Sub-Group for effective monitoring.

To create a sub group,

● Inside the Monitor Group Details page, click on the Monitor Group Actions button in the top right-hand corner.
● Click the New Sub-Group option under Monitor Group Actions.
● Give the Sub-Group name and the description.
● Set a group type and the location of the group. (optional)
● Click on 'Create Sub-Group'.
● Then you can associate the desired monitors to the Sub-Group.

Note: You can create up to six levels of sub-groups in a Monitor Group, by default.

Copyright © 2014 Zoho Corp. Page 81


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Creating New Web Application Group

A web application group provides a template for grouping web infrastructure into logical components. So, instead of manually
grouping your web infrastructure, you can use the web application group to categorize your infrastructure into servers, databases,
web servers, etc.

Once you create a web application group, you can view the health of the sub groups and know how each individual sub group is
performing. If there is a problem in the web application group, you can drill down and identify which component is having a
problem.The details page shows the health of all the tiers as components giving you a better perspective of the Application's
Performance and Availability. You can also configure dependencies and powerful alarm rules for intelligent alert correlation.

To create a new web application group, follow the steps given below:
1. Click New Monitor Group and select Web Application Group from the drop-down menu.
2. Provide a Name for the Monitor Group. This is mandatory and only alphanumeric characters, dashes (-), underscores (_),
periods (.), and spaces ( ) are allowed.
3. Provide a Description, if required.
4. Select the Owner from the list of users displayed. Refer User Administration topic for more information on the different roles
of users.

Note:
Operator if associated as an owner will have Read Only Access to that particular Monitor Group alone.
Admin user is a super user and will be able to see all Monitor Groups.
Manager if associated will be able to view this Monitor Group in Manager Console. Using this option, Restricted Monitor Groups
alone can be shown in Manager Console. [By default, if the Manager is not explicitly associated to a Monitor Group, the
Manager will be able to access all the Monitor Groups in the Manager Console]
5. Select Web Application Group as the group type.
6. Select the Application Components from the options displayed. The components available are End User Transaction (URL)
group, Network devices group, Edge Devices group, Web Server Group, Application Server Group, Database Group and Server
Group. The components that you select will be automatically added as sub groups within the web application group.
7. Select the Location for associating the monitor group to World Map Business View under Advanced section. Otherwise, click
the 'Add Location' link and select custom locations from the google map that opens up.
8. Click Create Monitor Group button to create the Web Application Group. You can add monitors any time using the Associate
Monitors option.

Note: You can convert a web application group to a monitor group or vice
versa by changing the Group Type. Click Monitor Group Options link from
the web application group page and select the Edit option. This will take you
to the Modify Monitor Group section. You can modify the Group Type values
from this screen.

Copyright © 2014 Zoho Corp. Page 82


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Creating a Sub-Group within a Web Application Group

If you have selected 'Application Components' while creating the web application group, the sub groups will be automatically
created based on the options you have selected. You can also add sub groups later on by following the steps given below.

● Click the Monitor Group Actions->New Sub-Group option inside the Web Application Group Details page.
● Provide the Sub-Group Name, Description and select the Owner from the list of users.
● Select the Group Type from the dropdown box.
● Select the Location for associating the sub group to from the drop-down box. You can also use the 'Add Location' option to
specify custom locations from google map.
● Click the Create Sub-Group button to create the sub group.
● You can then associate the desired monitors to the Sub-Group.

Note: You can create up to six levels of sub groups for a web application group, by default.

Copyright © 2014 Zoho Corp. Page 83


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Deleting Monitor from Monitor Groups

To delete a Monitor from a Monitor Group,


1. Click the Home module tab to display the list of Monitor Groups created.
2. Click the Monitor Group from which the Monitor has to be deleted.
3. Data of all Monitors in that Monitor Group is displayed graphically. Click Remove from Group.

This deletes the Monitor only from the Monitor Group but its monitoring will not stop.

Deleting Monitor from Applications Manager

To delete a Monitor from getting monitored by Applications Manager itself, follow the given steps:
1. Click the Monitor module tab.
2. From Select View combo box, select Monitors View - All. All the Monitor Types are listed.
3. Select the check box of the Monitor and click Delete.

Copyright © 2014 Zoho Corp. Page 84


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

Editing and Deleting a Monitor Group

To edit a Monitor Group,


1. Click the Home module tab to display the list of Monitor Groups created.
2. Click the Monitor Group to be edited.
3. On the Left-side Monitor Group Links, click Edit. .

By editing the monitor group, you can change the Name, Description, Owners and the Country (location) associated.

To delete a Monitor Group,


1. Click the Home module tab to display the list of Monitor Groups created.
2. Click the Monitor Group to be deleted.
3. On the Left-side Monitor Group Links, click Delete.

Note: In simple layout, the left side links will not be persent. In this case, move to Monitors tab, from Select View drop down box,
select Monitor Group view. Select the Monitor Groups you want to delete, then select the Delete action from the dropdown.

Note: However, the Monitor pertaining to the corresponding Monitor Group will not be deleted. You will still be able to view the
details of the Monitor that was associated with the Monitor Group. To delete the Monitor, refer to the Deleting Monitor from
Applications Manager section

Copyright © 2014 Zoho Corp. Page 85


Applications Manager User Guide
Applications Manager User Guide Working with Monitor Groups

VMware Virtual Infrastructure Groups

Applications Manager can discover your entire VMware virtual infrastructure through the vCenter server and provide dependency
mapping of its components. The ‘VMware Virtual Infrastructure Group’ allows you to quickly discover all your virtual resources and
model them the same way they are configured in the vCenter server. The VMware infrastructure will be automatically categorized
into components such as Datacenter, Cluster, ESX/ESXi hosts, VMs, etc. Once you discover the virtual infrastructure, you can easily
track the availability, health and performance metrics of its various components.

The VMware virtual infrastructure group is different from monitor groups due to the fact that you have to manually map all the
resources to a monitor group. In the VMware virtual infrastructure group, the virtual resources in your network are automatically
discovered through the vCenter server and the components mapped accordingly. When combined with the out-of-the-box support
for 50+ applications, servers, databases, and transactions spanning physical, virtual and cloud infrastructures along with auto-
provisioning of virtual systems, the VMware virtual infrastructure group becomes even more powerful.

Creating a New VMware Virtual Infrastructure Group

Follow the steps given below to create a VMware Virtual Infrastructure group:
1. Click New Monitor Group and select VMware Virtual Infrastructure from the drop-down menu. The ‘Discover Virtual
Infrastructure through vCenter’ screen will be displayed.
2. Provide a Display Name for the monitor group.
3. Specify vCenter Hostname/IP Address.
4. Specify the Port at which vCenter is running.
5. Enter the authentication credentials of the vCenter server such as User Name and Password.
6. Specify the Polling Interval in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Click Fetch ESX Hosts button to start the virtual infrastructure discovery.

For more information on the performance metrics provided by the VMware virtual infrastructure group, refer this topic.

Top

Copyright © 2014 Zoho Corp. Page 86


Applications Manager User Guide
Applications Manager User Guide New Monitors & Performance Metrics

Creating a New Monitor

Once a new Monitor Group is created, the Monitors such as WebLogic Server, JBoss Server, Tomcat Server, WebSphere Server,
MySQL DB Server, Oracle DB Server, Mail Server, etc. must be created. This discovers the Monitor from the network and starts
collecting data for monitoring.

You have to create a Monitor to discover it from the network and monitor it. This can be done by following any of the options given
below:

● All Monitors in a host.


● A specific Monitor in a host.
● All Monitors in a network

Note: If there is a problem while creating new monitors, click on Diagnose link to troubleshoot the problem.

All Monitors in a Host

To discover all Monitors running on a host, create them using the All Monitors option. Follow the given steps for discovering the
Monitor:
1. Select New Monitor.
2. Choose All Services.
3. Provide the hostname, where all the Monitors running on this host will be discovered. You can also discover monitors in
multiple hosts by providing the hostname, separated by commas. (Note: This will start discovering in the default port of the
Monitor.)
4. Enter the SubNetMask of the network.
5. Click Add Monitor(s).

Note: Adding any service will also automatically add that server and other applications in the default port in that server.

How To Demos: Have a look at our demo on creating Monitors in our website.

Copyright © 2014 Zoho Corp. Page 87


Applications Manager User Guide
Applications Manager User Guide New Monitors & Performance Metrics

Viewing Performance Metrics

Applications Manager is used to monitor different types of applications and services of Monitor running in your system/ network.
Monitoring is an activity that checks the performance of your monitors by collecting and analyzing the data at regular intervals.
These monitoring capabilities are performed by different types of Monitor Types.

This chapter lists the different types of Monitor Types supported by Applications Manager and the parameters monitored by them.

Monitor Types

Applications Manager supports the following Monitor Types:

Application Servers

● Microsoft .NET
● JBoss Servers
● Jetty Servers
● GlassFish Servers
● Oracle Application Servers
● Resin Application Server
● SilverStream
● Tomcat Servers
● VMware vFabric tc Servers
● WebLogic Servers
● WebSphere Servers

Cloud Apps

● Amazon
● EC2 Intances
● RDS
● Windows Azure
● Open Stack

Copyright © 2014 Zoho Corp. Page 88


Applications Manager User Guide
Applications Manager User Guide New Monitors & Performance Metrics

Database Servers

● Cassandra Servers
● CouchBase Servers
● IBM DB2 Servers
● IBM Informix Servers
● Memcached Servers
● MongoDB Servers
● MS SQL Servers
● MySQL/MariaDB Servers
● Oracle Servers
● PostgreSQL Servers
● Redis Servers
● Sybase Servers
● Oracle NoSQL
● SAP HANA DB Servers

Middleware / Portal

● Microsoft BizTalk
● Microsoft Message Queue (MSMQ)
● Microsoft Office SharePoint
● Oracle Tuxedo
● VMware vFabric RabbitMQ
● WebLogic Integration Servers
● IBM Websphere Message Broker
● IBM WebSphere MQ
● Microsoft Lync Server
● Azure Service Bus
● Apache Kafka
● Apache ActiveMQ

Servers

● Windows
● Linux
● Solaris
● IBM AIX
● IBM AS400 / iSeries
● HP Unix
● Tru64 Unix
● Free BSD
● Mac OS
● Novell

Copyright © 2014 Zoho Corp. Page 89


Applications Manager User Guide
Applications Manager User Guide New Monitors & Performance Metrics

● Windows Cluster

Services

● JMX Applications
● Ping Monitor
● Service Monitoring
● SNMP / Network Device
● Telnet
● Hadoop Monitor
● Active Directory
● DNS Monitor
● FTP / SFTP Monitor
● LDAP Monitor
● Ceph Storage
● Apache Zookeeper
● Oracle Coherence Servers

Mail Servers

● Exchange Server
● Mail Server

Web Server / Services

● Apache Server
● IIS Server
● Nginx
● Real Browser Monitor
● PHP
● Web Services
● Web Server
● HTTP(s) URL Monitors and HTTP(s) URL Sequence (Record & Playback)
● Elasticsearch
● ServiceDesk Plus
● ManageEngine OpManager

ERP

● SAP
● SAP CCMS
● Oracle E-Business Suite
● Microsoft Dynamics CRM

Copyright © 2014 Zoho Corp. Page 90


Applications Manager User Guide
Applications Manager User Guide New Monitors & Performance Metrics

Virtualization

● Microsoft Hyper-V Servers


● VMware ESX/ESXi servers
● VMware Horizon View Connection Broker
● Citrix XenApp
● Citrix Xenserver
● Docker

Custom Monitors

● JMX / SNMP Dashboard


● File System Monitor
● Windows Performance Counters
● Script Monitor
● Database Query Monitor

Web Transactions Monitors

● Java
● Ruby on Rails
● .NET

Other

● Java Runtime Monitor

Copyright © 2014 Zoho Corp. Page 91


Applications Manager User Guide
Applications Manager User Guide Application Servers

Application Servers

Application Servers are designed to develop web services and applications, and in real time, the productivity and performance of
such servers get affected due to failure of diagnosing any problem in the services/application running in the server.

Applications Manager enables high performance business process management by detecting and diagnosing problems of
application servers and their services faster. The following are the application servers supported:

● Microsoft .NET
● GlassFish Servers
● JBoss Servers
● Jetty Servers
● Resin Servers
● Oracle Application Servers
● SilverStream
● Tomcat Servers
● VMware vFabric tc Server
● WebLogic Servers
● WebSphere Servers

Please browse through the different application servers that provide the server information and their parameters being monitoring.

Copyright © 2014 Zoho Corp. Page 92


Applications Manager User Guide
Applications Manager User Guide Application Servers

Microsoft .NET Monitoring

To create Microsoft .NET Monitor


1. Click on New Monitor link.
2. Select Microsoft .NET Monitor.
3. Enter the IP Address or hostname of the host where .NET runs.
4. Enter the SubNetMask of the network.
5. Set the Polling Interval.
6. If you are adding a new monitor from an Admin Server, select a Managed Server.
7. Enter the User Name / Domain Name and Password of the system.
8. Choose the Monitor Group from the combo box with which you want to associate .NET Monitor (optional). You can choose
multiple groups to associate your monitor.
9. Click Add Monitor(s). This discovers .NET from the network and starts monitoring them.

Monitored Parameters

Microsoft .NET is monitored based on the attributes such as Heap Size, Threads etc. Data collection happens through WMI. The
monitoring details of Microsoft .Net are represented graphically and that helps to understand the parameters with ease. You can
also configure thresholds to the attributes monitored by the .Net, based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Parameter Description

Availability Shows the current status of the.Net - available or not available.

Threads

Shows the number of native OS threads created and owned by the CLR
Physical Threads
to act as underlying threads for .NET thread objects.

Copyright © 2014 Zoho Corp. Page 93


Applications Manager User Guide
Applications Manager User Guide Application Servers

Logical Threads Shows the number of current .NET thread objects in the application.

Memory

Shows the current memory allocated(MB)


Shows the percentage of elapsed time that was spent in performing a garbage collection (GC) since the last GC cycle. This counter is
Heap Size usually an indicator of the work done by the Garbage Collector on behalf of the application to collect and compact memory
% Time in GC

Locks

Queue Length Refers to the total number of threads currently waiting.

Contentions/Min Refers to the rate at which threads in the runtime attempt to acquire a managed lock unsuccessfully.

Exceptions

Exceptions/Min Refers to the number of exceptions per Minute

Security
Refers the total number of runtime Code Access Security (CAS) checks performed per minute.
TotalRuntimeChecks/Min

JIT
Refers to the percentage of elapsed time spent in JIT compilation since the last JIT compilation phase.
% Time In JIT

.NET Applications Details Clicking on the Names of the .NET applications, you can see their performance based on their parameters.

The various .NET application's parameters that are monitored are:

Parameter Description

Request Statistics

Requests/Min
Errors/Min Refers to number of Requests executed per minute
Requests Timeout/Min Refers to rate of errors occured
Queued Requests Refers to number of Requests Timeout per minute
Refers to number of Queued Requests

Copyright © 2014 Zoho Corp. Page 94


Applications Manager User Guide
Applications Manager User Guide Application Servers

Transactions

Refers to number of Transactions started per minute


Transactions/Min
Refers to number of Transactions aborted per minute
Abandoned Transactions/Min
Refers to number of Transactions in progress
Pending Transactions

Sessions

Active Sessions Refers to number of sessions that are active currently

Network Traffic
Refers to the number of Bytes sent per minute
Bytes Sent/Min
Refers to the number of Bytes received per minute
Bytes Received/Min

Copyright © 2014 Zoho Corp. Page 95


Applications Manager User Guide
Applications Manager User Guide Application Servers

GlassFish Servers

To create GlassFish Application Server Monitor


1. Click on New Monitor link.
2. Select GlassFish.
3. Give the Display name.
4. Enter the Hostname of the host where GlassFish runs.
5. Enter the Port
6. Enter the User Name and Password of GlassFish Server.
7. Enter the JNDI path.
8. Set the Polling Interval.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group from the combo box with which you want to associate GlassFish Monitor (optional). You can
choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers GlassFish Servers from the network and starts monitoring them.

Monitored Parameters

GlassFish servers are monitored based on the attributes such as memory, thread, etc. The monitoring details of GlassFish server
are represented graphically that helps to understand the parameters with ease. You can also configure thresholds to the attributes
monitored by the server based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Parameter Description

Monitor Information

Name The Name of the Server

Copyright © 2014 Zoho Corp. Page 96


Applications Manager User Guide
Applications Manager User Guide Application Servers

Availability Shows the current status of the server - available or not available.

Last Polled at Specifies the time when the monitoring of the server was recently done

Next Poll at Specifies the next polling time for monitoring the server

Response Time Refers to time required for the Glass Fish server to respond while monitoring

Memory Details

Used Memory Refers to JVM heap used in KB

Total Memory Refers to the JVM total heap size

Thread Details

Thread Count Total number of Threads in JVM in which GlassFish is running

Running Refers to the state of totals thread that are in runnable state in the JVM

Waiting Refers to the total no. of threads that are waiting for a monitor lock in the JVM

Blocking Refers to no. of total threads that are blocked waiting for a monitor lock

Deadlocked Refers to the no. of total threads that are blocked forever in the JVM

Refers the total threads that are waiting for another thread to perform
Timed Waiting
an action for up to a specified waiting time

Table WebApp Monitoring

Name Name of the Web Application

Session High Count Maximum number of concurrently active sessions

Session Current Count List of currently active sessions in the Web Application

Total Sessions Rejected Total number of rejected sessions

Copyright © 2014 Zoho Corp. Page 97


Applications Manager User Guide
Applications Manager User Guide Application Servers

JBoss Server Monitoring

Supported versions of JBoss Server: 3.2.x, 4.x, 4.0.x, 5, 5.1, 6.0, 7.x, Wildfly_8.x

For Applications Manager to monitor JBoss, it should be able to access the host where JBoss server runs and vice versa. For more
information, refer to online Troubleshooting section.

Prerequisite: To monitor JBoss, the http-invoker.sar should be deployed in the JBoss Server. Know more in the Prerequisite
section. Also, here are the prerqeuisites to monitor Wildfly.

To create a JBoss Server Monitor


1. Click on New Monitor link.
2. Select JBoss.
3. Enter the IP Address or hostname of the host where JBoss runs.
4. Choose the JBoss version.
5. Enter the port number for eg., 8080.
6. Check the Is Domain option, if you are using JBoss version 7.x and above.
7. Provide the name of the Host Controller and the JBoss Server Instance name.
8. Choose SSL option , if SSL is enabled in JBoss server.
9. Enter the User Name and Password , if JBoss has authentication information.
10. Set the Polling Interval.
11. If you are adding a new monitor from an Admin Server, select a Managed Server.
12. Choose the Monitor Group from the combo box with which you want to associate JBoss Server Monitor (optional). You can
choose multiple groups to associate your monitor.
13. Click Add Monitor(s). This discovers JBoss server from the network and starts monitoring them.

Troubleshoot: Having trouble in monitoring JBoss server? Refer to the online Troubleshooting section.

Supported Versions: Applications Manager supports monitoring of JBoss Servers of versions 3.2.x, 4.0.x, 4.2.2 GA, 5, 5.1, 6.0 and
7.0. Performance data is collected by deploying an agent automatically from Applications Manager to the JBoss server that needs to
be monitored.

Copyright © 2014 Zoho Corp. Page 98


Applications Manager User Guide
Applications Manager User Guide Application Servers

JBoss servers are monitored based on the attributes such as JVM heap usage, JDBC pool usage, JMS Queue, the different web
applications and EJB deployed in the server. The monitoring details of JBoss server are represented graphically that helps to
understand the parameters with ease. You can also configure thresholds to the attributes monitored by the server based on these
details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Monitor Information

This tab displays the basic information like the name of the server, host name and the port where the server is running. Additional
parameters like the JBoss version, host controller name, user name and associated groups are also displayed.

JVM Usage

This metric gives the current amount of free, used and committed memory in the JVM heap in megabytes as well as in percentage.

JDBC Pool Usage

JDBC Connection Pool details are displayed through this metric. The number of connections that are available, active, created,
timed out and destroyed are listed. Also available are the metrics pertaining to the prepared statement cache of the database
connection in the pools.

JMS Queues

The JMS tab provides an overview of the metrics related to the JMS Queues and Topics. Queues details include metrics like

Copyright © 2014 Zoho Corp. Page 99


Applications Manager User Guide
Applications Manager User Guide Application Servers

messages in queue, messages added, scheduled, paused along with current delivery percentage. Metrics with respect to topics
tracked are message count, messages added, durable and non-durable message count,etc.

EJB Stats and Servlet Details

The name, type and module of the EJB along with the number of instance created and removed, instances in passivated state,
pooled state, ready state are being captured. The servlet details specify the number of times the servlet was invoked and the
execution time for the servlet.

Custom attributes

You can view the custom attributes of the JBoss Server here. Click Add Attributes to add custom MBean attributes and associate
MBean actions. For information on adding Custom Monitors, refer to Custom Monitors topic. Below is the detailed list of parameters
monitored and the various versions of the server supported:

JBoss 4.0.x, 4.2.2


Monitored Parameters JBoss 3.2.x JBoss 5,5.1 JBoss 6.0 JBoss 7.0
GA

Memory Usage

[Used (MB), Free(MB), Commited(MB),


Maximum(MB), Used(%), Free(%)]

*metrics for non-heap memory is supported in


JBoss 6&7 only

Thread Usage

[Live Thread count, Daemon Thread count, Peak


Thread Count, Total Thread Started]

Class Loading

[Class loaded, Class Unloaded, Total Loaded,


Object Pending Finalization count]

Deployments
[sub-deployment [sub-deployment [sub-deployment
[Name, Context, Enabled, Runtime Name, [sub-deployment [servlets count not
count not count not count not
Status, Sub-Deployments, Servlets Count] count not available] available]
available] available] available]

Copyright © 2014 Zoho Corp. Page 100


Applications Manager User Guide
Applications Manager User Guide Application Servers

Web Applications

[Active Sessions, Sessions Created, Expired,


Rejected, Duplicated and Session Alive Time]

EJB Statistics [instances in


passive state,
[WebModule,Type,Instances Created, Removed, ready state, pooled
Instances in Passive State, Ready State, Pooled state, message
State, Message Count, Method Ready Count] count, method
ready count not
available]

Servlet Details

[Invocation Count, Execution Time Total,


Execution Time High,Execution Time
Low,Execution Time Average]

Persistence Units

[Connections, Transactions, Queries, Second


Level Cache]

Connection Pool Usage

[Connections - Available, Active , Created,


Destroyed, Maximum used, Timed out, Active
Connections(%), Max Connections Used (%)]

Prepared Statement Cache

[Current size, Hit count, Miss count, HitRatio]

Web Metrics

[Request Count, Error Count, Processing


time(ms), Maximum time(ms), Bytes Sent, Bytes
Received , Request Failed(%)]

[transactions [transactions
Transactions [transactions aborted, timedout, aborted, timedout,
aborted, timedout, nested, heuristics, nested, heuristics,
[Total Transacations, Commited, Aborted, nested, heuristics, inflight, inflight,
TimedOut, Nested, Heuristics, Inflight, inflight, applications applications
Applications Rollbacks, Resource Rollbacks, applications rollbacks, resource rollbacks, resource
Successful Commits] rollbacks, resource rollbacks not rollbacks not
rollbacks not available] available]
available]

JMS-Queues

[Name, Message Count, In Delivery, Messages


Added, Messages Scheduled, Consumer Count, Is
Paused, Delivering Percentage]

Copyright © 2014 Zoho Corp. Page 101


Applications Manager User Guide
Applications Manager User Guide Application Servers

JMS-Topics

[Name, Message Count, In Delivery, Messages


Added, Durable Message Count, Non- Durable
Message Count, Subscriptions, Durable
Subscribers Count, Non-Durable Subscribers
Count,Current Delivering (%), Durable
Message(%), Non-Durable Message(%)]

Custom Attributes and Server Configuration


Details

Copyright © 2014 Zoho Corp. Page 102


Applications Manager User Guide
Applications Manager User Guide Application Servers

Jetty Server Monitoring

Jetty, the lightweight open-source project hosted by the Eclipse foundation, is a full-fledged HTTP server and Servlet container that
can be easily configured to serve static and dynamic content. Unlike most Web Servers, Jetty is often used for machine to machine
communications, usually within larger software frameworks.

Applications Manager allows you to monitor your Java applications running on the Jetty HTTP server and Servlet container, track
critical performance indicators of Jetty App server like CPU usage and be notified of thread pool exhaustion. Applications Manager
also provides an in-depth view of the memory usage - heap and garbage collection information, real-time memory utilization and
even object instance information within the JVM and Jetty server.

Create a New Monitor

Supported versions of Jetty Server: Jetty 3.1 and above.

Prerequisites for monitoring Jetty Server: Click to know about the user previleges and other necessary prerequisites to
monitor Jetty Server.

To create a Jetty Server Monitor:


1. Click on New Monitor link.
2. Select Jetty Server under Application Servers.
3. Give the Display name.
4. Enter the Hostname of the server where Jetty Server is running.
5. Enter the JMX Port. For default installations of Jetty, the JMX port number is 9999.
6. You can enter your own credential details or select preconfigured credentials from details in Credentials Manager. If you
wish to enter your own credentials, specify enter the JMX User Name and Password of Jetty Server. If no authentication is
required, then leave the fields blank.
7. Enter the JNDI path. For example:- JNDIPATH for default installations of Jetty is /jmxrmi.
8. Set the Polling interval.
9. Choose the Monitor Group from the combo box with which, you want to associate Jetty Server Monitor (optional). You can

Copyright © 2014 Zoho Corp. Page 103


Applications Manager User Guide
Applications Manager User Guide Application Servers

choose multiple groups to associate your monitor.


10. Click Add Monitor(s). This discovers your Jetty Server from the network and starts monitoring it.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Jetty Server under the Applications Servers Table.
Displayed is the Jetty Server bulk configuration view distributed under three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Performance Overview
● Thread
● WebApps
● Configuration

PERFORMANCE OVERVIEW

Parameter Description

CPU Details

Available Processors The number of processors available to the JVM.

CPU Usage Percentage The percentage of CPU usage of the JVM on the server.

Uptime The uptime of the Java virtual machine.

Class Loading Details

Loaded Class Count The number of classes currently loaded in the JVM.

Unloaded Class Count The number of classes unloaded since the JVM started execution.

Heap Memory

Copyright © 2014 Zoho Corp. Page 104


Applications Manager User Guide
Applications Manager User Guide Application Servers

PS Survivor Space The pool containing objects that have survived the garbage collection of the Eden space.

PS Eden Space The pool from which memory is initially allocated for most objects.

This pool contains tenured and virtual (reserved) space and will be holding those objects which survived
PS Old Gen
after garbage collection from young generation space.

Non Heap Memory

The Permanent Generation holds all the reflective data of the virtual machine itself, such as class and
PS Perm Gen method objects. With JVMs that use class data sharing, this generation is divided into read-only and read-
write areas.

Code Cache The Code cache is the memory used for compilation and storage of native code.

Heap Memory Details

The total memory is the memory that is currently allocated to the JVM. It is the combination of used
Total Memory
memory currently occupied by objects and free memory available for new objects. It varies over time.

Free Memory (MB) The total free memory available to the JVM for new objects.

Used Memory (MB) The space that is currently occupied by Java objects.

Max Allocated Memory (MB) The currently allocated memory in MB.

Committed Memory (MB) The currently used memory in MB.

Non Heap Memory Details

The total memory is the memory that is currently allocated to the JVM. It is the combination of used
Total Memory
memory currently occupied by objects and free memory available for new objects. It varies over time.

Free Memory (MB) The total free memory available to the JVM for new objects.

Used Memory (MB) The space that is currently occupied by Java objects.

Max Allocated Memory (MB) The currently allocated memory in MB.

Committed Memory (MB) The currently used memory in MB.

Garbage Collector Details

Name The Garbage Collector Name.

Valid The Garbage Collector Status.

Collection Time (MS) Live JVM statistics about garbage collector activity like the time spend collecting objects.

Collection Count The Live JVM statistics about garbage collector activity like the number of collected objects.

Copyright © 2014 Zoho Corp. Page 105


Applications Manager User Guide
Applications Manager User Guide Application Servers

Note:

Java8 Update: When


monitoring with JDK 1.8
MetaSpace, Applications
Manager monitors and displays
new memory space called
MetaSpace instead of the
former Permanent
Generation (Heap and Non-
Heap memory). The main
difference is that Metaspace
re-sizes dynamically i.e., It can
expand at runtime. Java
Metaspace space: unbounded
(default)

THREAD

Parameter Description

JVM Threads

Live Threads The current live thread count.

Total number of Daemon Threads. A daemon thread is one that does not prevent the JVM from exiting
Daemon Threads
when the program finishes but the thread is still running.

Peak Thread Count The peak live thread count since the Java virtual machine started or peak was reset.

Threads started per sec The number of threads started per sec.

Thread Pool Details

Name The name of the thread pool.

Thread Count The total number of threads currently in the pool.

Busy Threads The number of currently busy threads in the thread pool.

Idle Threads The number of currently idle threads in the thread pool.

Max Threads The maximum number of threads in the thread pool simultaneously tasked with some work to process.

Thread Utilization The percentage of threads used by the java process.

Queue size The size of the job queue

Copyright © 2014 Zoho Corp. Page 106


Applications Manager User Guide
Applications Manager User Guide Application Servers

State The lifecycle state for this instance.

Low on Threads This value is true if the pools is at maxThreads and there are not idle threads than queued jobs.

WEBAPPS

Parameter Description

Webapps

Name The name of the Session.

Id The session Id.

Active Sessions The number of currently active sessions.

State The current lifecycle state.

CONFIGURATION

Parameter Description

Server Info

VM Name The Java virtual machine implementation name.

VM Vendor The Java virtual machine implementation vendor

VM Version The Java virtual machine Version

Name The name representing the running Java virtual machine.

Version The operating system version

OS Name The operating system name.

Start Time The start time of the Java virtual machine in milliseconds.

Jetty Version The Version of Jetty server.

Copyright © 2014 Zoho Corp. Page 107


Applications Manager User Guide
Applications Manager User Guide Application Servers

Resin Application Server Monitoring

To create a Resin Server Monitor:


1. Click on New Monitor link.
2. Select Resin Server under Application Servers.
3. Give the Display name.
4. Enter the Hostname of the server where Resin Application Server is running.
5. Enter the JMX Port. For default installations of Resin, the JMX port number is 9999.
6. You can enter your own credential details or select preconfigured credentials from details in Credentials Manager. If you
wish to enter your own credentials, specify enter the JMX User Name and Password of Resin Server. If no authentication is
required, then leave the fields blank.
7. Enter the JNDI path. For example:- JNDIPATH for default installations of Resin is /jmxrmi.
8. Set the Polling interval.
9. Choose the Monitor Group from the combo box with which, you want to associate Resin Server Monitor (optional). You can
choose multiple groups to associate your monitor.
10. Click Add Monitor(s). This discovers your Resin Server from the network and starts monitoring it.

Resin is a fast and reliable Java EE integrated high-performance application server that features load balancing for increased
reliability. Built-in Resin features include clustering for high scalability, distributed caching to reduce reliance on traditional
databases and adaptive health monitoring. Applications Manager increases the reliability of your Resin Application Server by
monitoring all of the key performance indicators like thread details, connection pool usage, session details and memory resources.

Resin Server - Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Resin Server under the Application Servers Table.
Displayed is the Resin Server bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Performance Overview
● Threads
● Memory

Copyright © 2014 Zoho Corp. Page 108


Applications Manager User Guide
Applications Manager User Guide Application Servers

● Web Applications
● Connection Pools
● Configuration

Performance Overview

Parameter Description

JVM Statistics

JVM Memory The current total amount of memory available for the JVM, in MB.

Free JVM Memory The current free amount of memory available for the JVM, in MB.

JVM Memory Used The current used amount of JVM memory, in MB.

State The current lifecycle state.

Sever Request Throughput

Request Serviced/Sec The total number of requests serviced by the server per sec.

Bytes Read/Sec The total number of bytes that requests serviced by this server have read.

Bytes Written/Sec The total number of bytes that requests serviced by this server have written.

Transcation Manager

Commited Transactions/Sec The total number of committed transactions/Sec.

Failed Commited Transactions/Sec The total number of failed committed transactions/Sec.

Rollback Transactions/Sec The total number of rolledback transactions/Sec.

In-Progress Transactions The count of in-progress transactions.

CPU Details

Available Processors Number of processors available to the JVM.

CPU Usage Percentage The CPU usage of the JVM on the server in Percentage.

Uptime The uptime of the Java virtual machine.

Class Loading Details

Loaded Class Count The Number of classes loaded.

Unloaded Class Count The Number of classes unloaded.

Garbage Collector Details

Name Garbage Collector Name.

Valid Garbage Collector Status.

Collection Time Time taken to perform garbage collection in ms.

Collection Count Total number of collections that have occurred.

Threads

Parameter Description

Total Threads Total Thread count.

Total Threads Started Total number of threads started.

Active Resin Threads The current number of active resin threads.

Copyright © 2014 Zoho Corp. Page 109


Applications Manager User Guide
Applications Manager User Guide Application Servers

Idle Resin Threads The current number of idle resin threads.

Resin Threads waiting The current number of wait threads.

Max Resin Threads The configured maximum number of threads.

Total Resin Threads The current number of managed threads.

Memory

Parameter Description

Heap Memory The Heap Memory usage in MB.

Non Heap Memory The Non- Heap Memory usage in MB.

Eden/Survivor/Tenured/CodeCache/PermGen Commited Current allocated memory in MB.

Eden/Survivor/Tenured/CodeCache/PermGen Free Current free memory in MB.

Eden/Survivor/Tenured/CodeCache/PermGen Max Max allocated memory in MB.

Eden/Survivor/Tenured/CodeCache/PermGen Commited Current used memory in MB.

Eden/Survivor/Tenured/CodeCache/PermGen Free% The percentage of currently free memory .

Eden/Survivor/Tenured/CodeCache/PermGen Used% The percentage of currently used memory .

Web Applications

Parameter Description

Name Name of the Web Application.

Active Sessions The current number of active sessions.

Invalidated Sessions The total number of sessions that have been invalidated.

Session Max The configured maximum number of sessions in memory.

Session Utilization Percentage of session's used by the webapp.

Requests/Sec The number of requests served by the web-app per sec.

Bytes Received/Sec The total number of bytes received in client requests.

Bytes Sent/Sec The total number of bytes sent to clients.

500 Errors The total number of 500 status errors.

State The current lifecycle state.

Connection Pools

Parameter Description

Name The Name of the Connection Pool.

Active Connections The current number of active connections.

Idle Connections The current number of idle connections.

Total Connections The current number of idle and active connections.

Failed Connections The current number of failed connections.

Max Connections The configured maximum number of connections.

Copyright © 2014 Zoho Corp. Page 110


Applications Manager User Guide
Applications Manager User Guide Application Servers

Pool Utilization Percentage of connection pool used.

Configuration

Parameter Description

VM Name The Java virtual machine implementation name.

VM Vendor The Java virtual machine implementation vendor.

VM Version The Java virtual machine Version.

Name The name representing the running Java virtual machine.

Boot Classpath The boot class path that is used by the bootstrap class loader to search for class files.

ClassPath The Java class path that is used by the system class loader to search for class files.

Library Classpath The Java library path.

Version The operating system version.

OS Name The operating system name.

Start Time The start time of the Java virtual machine in milliseconds.

Copyright © 2014 Zoho Corp. Page 111


Applications Manager User Guide
Applications Manager User Guide Application Servers

Oracle Application Servers

Supported Versions

Applications Manager supports monitoring of Oracle Application Servers 10g.

Applications Manager uses the Dynamic Monitoring Service(DMS) provided by Oracle Application Server to monitor the same.
For this reason, the DMS Servlet has to be made accessible to the system where the Applications Manager is running.
Refer Prerequisites Section.

To create a Oracle Application Server Monitor


1. Click on New Monitor link.
2. Select Oracle AS.
3. Enter the IP Address or hostname of the host where Oracle Application Server runs.
4. Enter the SubNetMask of the network.
5. Enter the Port number for eg., 7200.
6. If you are adding a new monitor from an Admin Server, select a Managed Server.
7. Choose the Monitor Group from the combo box with which, you want to associate Oracle Application Server Monitor
(optional). You can choose multiple groups to associate your monitor.
8. Click Add Monitor(s). This discovers Oracle Application Server from the network and starts monitoring them.

Monitored Parameters

Oracle Application servers are monitored based on the attributes listed below. The monitoring details of Oracle Application server
are represented graphically that helps to understand the parameters with ease. You can also configure thresholds to the attributes
monitored by the server based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Copyright © 2014 Zoho Corp. Page 112


Applications Manager User Guide
Applications Manager User Guide Application Servers

Parameter Description

Monitor Information

Port The port at which the Oracle Application server listens.

Last Polled at Specifies the time when the monitoring of the server was started.

Availability Shows the current status of the server - available or not available.

Request Throughput

Throughput Number of requests processed per unit of time in the server.

Current Active Connection Shows the current active connections

Average Connection Process Time Gives the average processing time of the connections

Current Active Request Shows the number of requests that are active currently

Server Response Time

Response Time Refers to the time required for the server to respond while monitoring.

Data Throughput Refers to how much data is transferred per unit time

Data Processed Refers to how much data is processed per request

Servlets Total number of servlets

OPMN Process Memory Stats (Memory statistics of the OPMN processes like dcm-daemon, WebCache, WebCache Admin, HTTP_Server, home)

Used Memory Gives the total physical memory used by the process

Status Gives the availability status of the process

oc4j JVM Statistics

Active Thread Groups Shows the number of Active Thread groups in the JVM

Active Threads Shows the number of Active Threads in the JVM

Copyright © 2014 Zoho Corp. Page 113


Applications Manager User Guide
Applications Manager User Guide Application Servers

Heap Usage Shows current heap memory usage of the process

JDBC Connections Gives the total number of JDBC Connections

Transactions Gives the total number of open, committed and aborted JDBC transactions

Web Applications

Servlets Total number of servlets in the web application

Throughput Number of requests processed per unit of time in the web application

Process Request Time taken to process the request

Active Request Current number of active requests for the web application

Active Session Number of active sessions of the web application

Session time Total time for which the sessions have been active

JMS Attributes

Deque Avg Average time to deque messages

Enque Avg Average time to enque messages

Pending Message Total number of message waiting to be processed

Message Dequeued Total number of messages dequeued

Message Enqueued Total number of messages enqueued

Message Count Number of messages in the JMS Destination

EJB Statistics

EAR Name Name of the Enterprise Application Resource

Process Name of the oc4j process to which the EJB belongs to

Type Gives the type of the EJB

Create Count Number of EJBs created

Active Count Number of active EJBs

Passive Count Number of passive EJBs

Copyright © 2014 Zoho Corp. Page 114


Applications Manager User Guide
Applications Manager User Guide Application Servers

Pooled Count Number of pooled EJBs

Response Summary Gives the count for the various HTTP responses

Copyright © 2014 Zoho Corp. Page 115


Applications Manager User Guide
Applications Manager User Guide Application Servers

Tomcat Servers

Supported Versions

The supported versions of Tomcat Servers are 3.x, 4.x, 5.x, 6.x, 7.x and above. For Tomcat Server 3.x and 4.x, agent has to
be deployed for monitoring.

Note: You can check whether the Agent is deployed, by connecting to the following URL in Tomcat Server.

http://<Tomcat-Host>:<Tomcat-Port>/adventnet/DataServlet

To deploy the agent for Tomcat Server 3.x


1. Download the Tomcat3Agent.Zip from <Applications Manager Home>/working/classes directory.
2. Unzip it in the <Tomcat Home> directory of the host in which the Tomcat server is running.
3. Restart the Tomcat Server.

To deploy the agent for Tomcat Server 4.x


1. Download the Tomcat4Agent.Zip from the <Applications Manager Home>/working/classes directory
2. Unzip it in the <Tomcat Home> directory of the host in which the Tomcat server is running.
3. Add the following tag in server.xml file located in the <Tomcat Home>/conf directory (below the Engine tag).

<Valve className="com.adventnet.appmanager.tomcatagent.ver4.valve.AdventNetHostValve"/>

[Click the link to view an example server.xml]


4. Restart the Tomcat Server.

To deploy the agent for Tomcat Server 4.x and Apache server combined
1. Download the Tomcat4Agent.Zip from the <Applications Manager Home>/working/classes directory
2. Unzip it in the <Tomcat Home> directory of the host in which the Tomcat server is running.
3. Add the following tag in server.xml file located in the <Tomcat Home>/conf directory (below the Engine tag).

<Valve className="com.adventnet.appmanager.tomcatagent.ver4.valve.AdventNetHostValve"/>

Copyright © 2014 Zoho Corp. Page 116


Applications Manager User Guide
Applications Manager User Guide Application Servers

[Click the link to view an example server.xml]


4. Restart the Tomcat Server.
5. Apache: In Apache mod_jk.conf file of Apache Server , add the following entry
● JkMount /adventnet/* ajp13, Where ajp13 is the worker name .It has be the name given in worker.properties file.
6. Restart Apache server

To create a Tomcat Server Monitor


1. Click on New Monitor link.
2. Select Tomcat Server.
3. Enter the IP Address or hostname of the host. [Note: Also refer to Configurations based on Tomcat Deployments section]
4. Enter the SubNetMask of the network.
5. Enter the port number in which the monitor is running. [Default port number is 8080]
6. Choose SSL option , if SSL is enabled in Tomcat server.
7. Enter the polling interval time in minutes.
8. If you are adding a new monitor from an Admin Server, select a Managed Server.
9. Provide the monitor-specific authentication information, such as user name and password.

Note: Tomcat 3.x and 4.x needs no user name and password. In case of Tomcat 5.x and above, an application named Manager must be running in it for Applications
Manager to monitor the Tomcat server. By default, this application will be running in the server.If you have customized the manager application (Eg., qamanager), then
you can use the option "Tomcat Manager Application URI" in the client, for Applications Manager to monitor the Tomcat server. The user role to access the server must
be manager (versions 5.x & 6.x) / manager-gui (version 7.x).

To add a role as "manager" (versions 5.x & 6.x) / "manager-gui" (version 7.x) for any of the users such as tomcat, role1, or both, you need make changes intomcat-
users.xml file located in the <TOMCAT-HOME>/conf directory.

Example:

Default configurations in tomcat-users.xml in Tomcat Server.

<tomcat-users>
<role rolename="tomcat" />
<role rolename="role1" />
<user username="tomcat" password="tomcat" roles="tomcat" />
<user username="role1" password="tomcat" roles="role1" />
<user username="both" password="tomcat" roles="tomcat,role1" />
</tomcat-users>

After adding the roles for the "tomcat" user, the modified entries will be as follows:

<tomcat-users>
<role rolename="tomcat" />
<role rolename="role1" />
<role rolename="manager" />
<user username="tomcat" password="tomcat" roles="tomcat,manager" />
<user username="role1" password="tomcat" roles="role1" />
<user username="both" password="tomcat" roles="tomcat,role1" />
</tomcat-users>

On making the configuration, restart the Tomcat Server.

Now, when adding a new Tomcat (5.x and above) monitor, specify the username/password as tomcat/tomcat when discovering the Tomcat Server.

[Click the link to view an example tomcat-users.xml for versions 5.x / 6.x and tomcat-users.xml for versions 7.x]

9. Choose the Monitor Group from the combo box with which you want to associate Tomcat Server Monitor (optional). You
can choose multiple groups to associate your monitor.
10. Click Add Monitor(s). This discovers Tomcat server from the network and starts monitoring them.

Copyright © 2014 Zoho Corp. Page 117


Applications Manager User Guide
Applications Manager User Guide Application Servers

Troubleshoot: Having trouble in monitoring Tomcat server? Refer to the online Troubleshooting section.

Note : Steps to configure Tomcat Monitor for JBoss 3.2.5


1. Append the following in the web.xml present in <JBOSS_SERVER_HOME>deployjbossweb-tomcat50.sarROOT.warWEB-INF folder
" <servlet-mapping>
<servlet-name>Status Servlet</servlet-name>
<url-pattern>/manager/status</url-pattern>
</servlet-mapping>

<servlet-mapping>
<servlet-name>Status Servlet</servlet-name>
<url-pattern>/manager/</url-pattern>
</servlet-mapping>

<servlet-mapping>
<servlet-name>Status Servlet</servlet-name>
<url-pattern>/manager/status/</url-pattern>
</servlet-mapping> "

2. Restart the JBoss server.

3. Configure a tomcat monitor by clicking New Monitor --> Select Tomcat Server in the combo box.

4. Select the version as 5.x and create the monitor. This will create a monitor for the Tomcat webserver running in JBoss3.2.5.

Configurations based on Tomcat Server Deployment

Monitoring of Tomcat Server depends on its deployment. This section explains the possible deployment scenarios of Tomcat.
Your configuration of host name and the port depends on these scenarios.

1. Standalone Tomcat Server

This is a general scenario wherein you have a Tomcat server which has the HTTP (apache) within its deployment. In this
case, when configuring a tomcat monitor, specify the host name of the Tomcat server and the port of the HTTP.

2. One Tomcat Server (with HTTP) and one external instance of Apache

There is one Tomcat server with HTTP (apache) instance running in it and another external Apache running outside.

Copyright © 2014 Zoho Corp. Page 118


Applications Manager User Guide
Applications Manager User Guide Application Servers

Example: Tomcat server name: Tomcat A; HTTP (in Tomcat server) port: 8080; External Apache server port: 80

In this case, while configuring for a Tomcat monitor, specify the host name as 'Tomcat A' and specify the port of the
HTTP that runs with the Tomcat and not the external Apache, i.e., specify the port as 8080 and not 80.

3. One Tomcat Server (without HTTP) and one external instance of Apache

There is one Tomcat server without HTTP in it and another external Apache running.

Example: Tomcat server name: Tomcat A; HTTP (in Tomcat server) port: Not available; External Apache server
port: 80

In this case, while configuring for a Tomcat monitor, specify the host name as 'Tomcat A' and specify the port of the
external Apache, i.e., 80.

4. Multiple Tomcat Server (with HTTP instances in each of these servers) and one external instance of Apache

There are multiple Tomcat servers, say 3, with HTTP instances in each of them and another external Apache running.

Example: Tomcat Server names: Tomcat A, Tomcat B, Tomcat C; HTTP (in Tomcat servers)
port: 8070, 8080, 8090 respectively; External Apache server port: 80

Copyright © 2014 Zoho Corp. Page 119


Applications Manager User Guide
Applications Manager User Guide Application Servers

In this case, you need to create tomcat server monitor individually for Tomcat A, Tomcat B, and Tomcat C and
specify their ports as 8070, 8080, and 8090 respectively.

5. Multiple Tomcat Server (without HTTP instances in these servers) and one external instance of Apache

There are multiple Tomcat servers, say 3, without HTTP instances in them and another external Apache running.

Example: Tomcat Server names: Tomcat A, Tomcat B, Tomcat C; HTTP (in Tomcat servers) port: Not available;
External Apache server port: 80

You can monitor only one of the instances in this case. Please contact appmanager-support@manageengine.com if
you would like to have it added.

Monitored Parameters

Tomcat Servers are monitored based on the parameters or the attributes listed below. These attributes provide information about
the functioning of the Monitors of Tomcat server. You can also configure thresholds to the numerical attributes monitored by the
server based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

● Overview
● Memory
● Thread

Copyright © 2014 Zoho Corp. Page 120


Applications Manager User Guide
Applications Manager User Guide Application Servers

● JDBC
● Web
● Web Applications
● Servlets

Overview

Parameters Description

Availability Shows the current status of the server - available or not available.

Response Time The time taken for the tomcat server to respond while monitoring in milliseconds

Average Processing Time The average processing time taken to process a request in milliseconds

Requests Per Minute The average number of requests received by the server in one minute

Average Bytes Per Minute The average bytes send per minute

Successful Requests The number of requests served successfully

Errors The number of error request received

Requests Failed percentage Percentage of requests failed.

Class Loaded The number of classes currently loaded in the java virtual machine.

Class Unloaded The number of classes unloaded since the java virtual machine has started

Total Class Loaded The total number of classes loaded since the java virtual machine has started execution.

Daemon Threads The number of live daemon threads

Live Threads Current number of live threads

Total Threads Started The total number of threads started since the java virtual machine started.

Memory

Parameters Description

Name The memory pool name

Type Memory pool type. i.e, (Heap memory , Non-Heap Memory)

Used Memory in MB Used memory in MB

Free Memory in MB Free memory in MB

Committed Memory in MB Committed memory in MB

Maximum Memory in MB Maximum memory allocated in MB

Used memory in % Percentage of memory used

Free memory in % Percentage of memory free

Name Garbage collector name

Number of collections per Minute Number of garbage collections occurred per minute

Copyright © 2014 Zoho Corp. Page 121


Applications Manager User Guide
Applications Manager User Guide Application Servers

Collection Time per Minute Collection time in milliseconds.

Thread

Parameters Description

Connector Name The thread pool connector name

Busy Threads Number of threads currently busy

Current Threads Number of threads currently created

Maximum Threads The maximum number of active threads can present in this pool

Percentage Used Percentage of threads used

Percentage Free Percentage of threads free

JDBC

Parameters Description

JNDI Name The JNDI name of the datasource

Context The web application context name

Active Connections Number of active connections to the data source

Idle Connections Number of idle connections to the data source

Active Connections in % Percentage of active connections (not applicable if maximum active connection is unlimited i.e. configured as -1)

Idle Connections in % Percentage of idle connections (not applicable if maximum idle connection is unlimited i.e. configured as -1)

Web

Parameters Description

Connector Name Connector name of the global request processor

Request Count Number of requests served by this global request processor

Error Count Number of error request received

Processing Time Time taken by this global request processor to process the requests in milliseconds

Bytes Send Per Second Average bytes send per second

Bytes Received Per Second Average bytes received per second

Successful Request (%) Percentage of successful requests

Failed Request (%) Percentage of failed requests

Copyright © 2014 Zoho Corp. Page 122


Applications Manager User Guide
Applications Manager User Guide Application Servers

Web Applications

Parameters Description

Context Web application's context name

Status Status of the web application such as STARTED, STOPPED

Processing Time (ms) The processing time taken to process the requests in milliseconds

Successful Requests Number of successful request served for this web application

Failed Requests Number of error request for this web application

Average Response Time (ms) Average response of this web application in milliseconds

Average Request Per Minute Average requests for this web application per minute

Average Bytes Per Second Average bytes send per second

No.of Open Sessions Number of sessions currently open / active

No.of Expired Sessions Number of sessions expired

No.of Rejected Sessions Number of sessions rejected

Servlets

Parameters Description

URL The name of the servlet

Context Web application's context name

Processing Time (ms) The processing time in milliseconds

Successful Requests Number of successful request

Failed Requests Number of error request

Average Response Time (ms) Average response time in milliseconds

Average Requests Per Minute Average requests served per minute

Copyright © 2014 Zoho Corp. Page 123


Applications Manager User Guide
Applications Manager User Guide Application Servers

SilverStream Servers

To create a SilverStream Server Monitor


1. Click on New Monitor link.
2. Select SilverStream.
3. Give the Display name.
4. Enter the Hostname of the host where SilverStream Server runs.
5. Enter the Port number.
6. Set the Polling interval.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Choose the Monitor Group from the combo box with which, you want to associate SilverStream Server Monitor (optional).
You can choose multiple groups to associate your monitor.
9. Click Add Monitor(s). This discovers SilverStream Server from the network and starts monitoring them.

Monitored Parameters

SilverStream servers are monitored based on the attributes such as memory, thread, etc. The monitoring details of SilverStream
server are represented graphically that helps to understand the parameters with ease. You can also configure thresholds to the
attributes monitored by the server based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Parameter Description

Monitor Information

Name The name of the server

Copyright © 2014 Zoho Corp. Page 124


Applications Manager User Guide
Applications Manager User Guide Application Servers

Health The health of the server

Availability The availability status of the server

Last Polled at The time at which last poll happened

Next Poll at The time at which next poll has been scheduled

Memory Details

Free Memory Available Memory in MB for the JVM

Total Memory Total Memory used by JVM

GC Count No. of time Garbage Collection happened

Request Details

Minimum Response Time The least time taken to process a request

Average Response Time Average time taken to process a request

Maximum Response Time The maximum time taken to process a request

Thread Details

Free Threads No. of free threads

Idle Threads No. of threads that are waiting for a task

Total Threads Total number of threads available

Load Details

Requests No.of requests processed by the server

Current Load Load on the SilverStream Server

Bytes No. of bytes transferred by the server

Session Details

Idle Sessions No.of sessions in idle state

Copyright © 2014 Zoho Corp. Page 125


Applications Manager User Guide
Applications Manager User Guide Application Servers

Total Sessions Total number of sessions

License Details

Used Licenses Total number of licenses used

Total Licenses Total number of licenses available

Copyright © 2014 Zoho Corp. Page 126


Applications Manager User Guide
Applications Manager User Guide Application Servers

VMware vFabric TC Server Monitoring

The supported versions of VMware vFabric tc Server are 2.6 to 2.9

To create VMware vFabric tc Server Monitor


1. Click on New Monitor link.
2. Select VMware vFabric tc Server.
3. Provide the Display name of the monitor.
4. Enter the Host Name in which the vFabric tc Server is running.
5. Enter the Port number in which the JMX Agent is running (6969 by default). The port in which JMX agent is running; is
defined in the 'catalina.properties' file.
6. Enter the User Name and Password of the vFabric tc Server.
7. Specify the JNDIPath. For example, JNDIPath for default installations of vFabric tc Server is /jmxrmi.
8. Specify the Polling Interval in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group from the combo box with which you want to associate vFabric tc Server Monitor (optional). You
can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers the vFabric tc Server from the network and starts monitoring it.

Note:To enable JMX in the tc Server, you have to define a JMX port in the file 'catalina.properties' and then give an entry in
a server.xml

[Click the link to view an example server.xml file and also a snippet of catalina.properties which shows how to set values for the
variables used in the server.xml file].

Applications Manager monitors the VMware vFabric tc Server and the Spring applications deployed on the server to detect any
performance problems. This monitoring is carried out by tracking critical components of the vFabric tc Server such as memory,
thread, throughput, garbage collector,etc.

Monitored Parameters

The Availability tab shows the availability history of the vFabric tc Server for the past 24 hours or 30 days. The Performance tab

Copyright © 2014 Zoho Corp. Page 127


Applications Manager User Guide
Applications Manager User Guide Application Servers

shows some key performance indicators of the vFabric tc Server such as CPU utilization, throughput and garbage collection rate.
This tab also shows the health status and events for the past 24 hours or 30 days.

The List view lists all the vFabric tc Servers monitored by Applications Manager along with their overall availability and health
status. It enables you to perform bulk admin configurations. Click on the individual monitors listed to view detailed performance
metrics.

To view detailed performance metrics of a vFabric tc Server, click on the monitor name listed in the Availability or List View tabs.
The performance metrics have been categorized into 6 different tabs:

● Overview
● Web Applications
● Throughput
● Cache
● Transaction
● Threads
● Configuration Details

Overview

This tab provides a high-level overview of the health and performance of the vFabric tc Server along with information pertaining to
the throughput, thread and garbage collection.

Parameters Description

Memory Details

Memory Used The amount of memory used by the JVM

Memory available The amount of physical memory available.

Used Heap The percentage of heap memory space used.

Total Memory Total amount of physical memory available to the operating system.

Copyright © 2014 Zoho Corp. Page 128


Applications Manager User Guide
Applications Manager User Guide Application Servers

CPU Usage

CPU Usage The CPU utilization of the VM.

Throughput

Bytes Received Per


The average bytes received per second.
Second

Bytes Sent Per Second The average bytes sent per second.

Error Count The number of error request received.

Processing Time The processing time taken to process the requests in milliseconds.

Request Count The number of requests served by this global request processor.

Thread Details

Thread Count Total number of threads created and also started since the Java virtual machine started.

Threads in Running
Total number of threads executing in the Java virtual machine in running state.
State

Threads in Waiting State Total number of threads in the Java virtual machine in waiting state.

Blocked Threads A thread that is blocked waiting for a monitor lock is in this state.

Timed Waiting Threads A thread that is waiting for another thread to perform an action, for up to a specified waiting time is in this state.

Deadlock Threads Number of threads that are in deadlock waiting to acquire object monitors.

Heap Memory

Eden Space The pool from which memory is initially allocated for most objects.

Tenured Gen The pool containing objects that have existed for some time in the survivor space.

Survivor Space The pool containing objects that have survived GC of eden space.

Non Heap Memory

Perm Gen, Perm Gen


Holds all the reflective data of the virtual machine itself, such as class and method objects. With JVMs that use class data sharing, this
[shared-rw], Perm Gen
generation is divided into read-only and read-write areas.
[shared-ro]

Code Cache Memory used for compilation and storage of native code.

Garbage Collector

GC Rate The rate of garbage collection.

Average GC Time (ms) Time taken to perform garbage collection.

You can use the Custom Fields option in the 'Monitor Information' section to configure additional fields for the monitor.

Copyright © 2014 Zoho Corp. Page 129


Applications Manager User Guide
Applications Manager User Guide Application Servers

Note
• Support given for JDK 1.8:
When monitoring with JDK 1.8
MetaSpace, Applications
Manager monitors and displays
new memory space called
MetaSpace and Compressed
Class Space instead of the
former Permanent
Generation (Non-Heap).

Web Applications

This tab provides the details of the various applications running in the vFabric tc Server.

Parameters Description

Context The various applications running.

Active Sessions The number of sessions currently in active state.

Session Creation Rate The number of sessions created per second.

Average Response Time The average response time taken for a particular application.

You can also disable, enable or delete a particular application by using the Actions option and also compare performance reports of
different applications using theCompare Reports option.

Throughput

This tab displays information pertaining to the number of requests received and sent per second in the server.

Copyright © 2014 Zoho Corp. Page 130


Applications Manager User Guide
Applications Manager User Guide Application Servers

Parameter Description

Global Request Processor

Name The name of the instances.

Bytes Received Per Second The number of requests received per second in the server.

Bytes Sent Per Second The number of requests sent per second from the server.

Error Count The number of requests, not processed.

Processing Time ms The time taken for a request to be processed in milliseconds.

Request Count The total count of requests.

Cache

This tab contains metrics related to cache memory

Parameters Description

Cache The applications running in the server.

Access Count The number of times the application is accessed.

Hits Count The number of times the application is accessed from the cache.

Cache Hit Ratio % The ratio of Hits Count to Access Count.

Transactions

This tab shows information pertaining to the database.

Parameters Description

Transaction Manager- Commits The commit rate transactions per second and failed commits transactions.

Transaction Manager- Resumes The resume rate transactions per second and failed resumes transactions.

Copyright © 2014 Zoho Corp. Page 131


Applications Manager User Guide
Applications Manager User Guide Application Servers

Transaction Manager- Rollbacks The rollback rate transactions per second and failed rollbacks transactions.

Transaction Manager- Suspends The suspend rate transactions per second and failed suspends transactions.

Threads

Parameters Description

Thread Details

Total Threads The total number of threads started since the java virtual machine started.

Busy Threads The number of threads currently busy.

Executor Details

Active Threads The number of Active Threads in the JVM.

Max Threads The maximum number of Threads in the JVM.

Pool Size The number of objects in the pool (entity and stateless).

Requests Queue Size The number of requests in the Request Queue.

Configuration Details

Parameters Description

Name The Java virtual machine implementation name.

Version The Java virtual machine Version.

JVM Vendor The Java virtual machine implementation vendor.

Classpath The Java class path that is used by the system class loader to search for class files.

Library Classpath The Java library path.

Boot Classpath The boot class path that is used by the bootstrap class loader to search for class files.

OS Name The operating system name.

Total Memory (MB) The amount of memory used by this VM.

Maximum Metaspace The maximum Native memory space for the representation of class metadata is called Metaspace. MetaSpace use native memory  to store
(MB) meta-data and that grows automatically.

Copyright © 2014 Zoho Corp. Page 132


Applications Manager User Guide
Applications Manager User Guide Application Servers

WebLogic Servers

Supported Versions

The following versions of the WebLogic Servers can be monitored by the Applications Manager:
1. WebLogic 6.1
2. WebLogic 7.x
3. WebLogic 8.x
4. WebLogic 9.x
5. WebLogic 10.x (WebLogic 11g)
6. WebLogic 12c

Know the Prerequisites that are required to monitor WebLogic.

To create a WebLogic Server Monitor


1. Click on New Monitor link.
2. Select WebLogic Server.
3. Enter a Display Name for the monitor.
4. Enter the IP Address/ hostname of the host.
5. Select the version of your Weblogic Server from drop-down menu.
6. From the box, select whether SSL is enabled or not.
7. Enter the port number in which WebLogic is running.
8. You can enter your own credential details or select preconfigured credentials from details in Credentials Manager. If you
wish to enter your own credentials, specify WebLogic version, username and password details for this monitor.
9. Enter the polling interval time in minutes.
10. If you are adding a new monitor from an Admin Server, select a Managed Server.
11. Provide the monitor-specific authentication information, such as user name and password.
12. Choose the Monitor Group from the combo box with which you want to associate WebLogic Server Monitor (optional). You
can choose multiple groups to associate your monitor.
13. Click Add Monitor(s). This discovers WebLogic server from the network and starts monitoring them.

Note:

The ports that need to be opened when the Weblogic Monitor is behind the firewall: Two-way communication between
WebLogic listening port (default : 7001) and Applications Manager web server port (default : 9090).

Copyright © 2014 Zoho Corp. Page 133


Applications Manager User Guide
Applications Manager User Guide Application Servers

WebLogic Server needs some additional configuration and conditions to be followed for monitoring.

● To monitor WebLogic 6.1 Follow the steps given below: 1) Provide only Admin user name.
2) Copy Weblogic.jar from folder <Weblogic Home>/weblogic61/server/lib in Remote WebLogic server version 6. Copy to
<AppManager Home >workingclassesweblogicversion6 folder in the machine where Applications Manager is running.
● To monitor WebLogic 7.x

You should set the weblogic.disableMBeanAuthorization and weblogic.management.anonymousAdminLookupEnabled variables


to true for enabling data collection.

Follow the steps given below:

1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin directory and add the following arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click here for Sample startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect
3) Copy Weblogic.jar from folder <Weblogic Home>/weblogic70/server/lib in Remote WebLogic server version 7.
Copy to <AppManager Home>workingclassesweblogicversion7 folder in the machine where Applications Manager is
running.

● To monitor WebLogic 8.x

You should set


the weblogic.disableMBeanAuthorization and weblogic.management.anonymousAdminLookupEnabled variables to
true for enabling data collection.

Follow the steps given below:

1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin directory and add the following arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click here for Sample startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect

Copyright © 2014 Zoho Corp. Page 134


Applications Manager User Guide
Applications Manager User Guide Application Servers

3) Copy Weblogic.jar from folder <Weblogic Home>/weblogic81/server/lib in Remote WebLogic server version 8
Copy to <AppManager Home>workingclassesweblogicversion8 folder in the machine where Applications Manager is
running.

● To monitor WebLogic 9.x

Copy Weblogic.jar from folder <Weblogic Home>/weblogic92/server/lib in Remote WebLogic server version 9 . Copy
to <AppManager Home>workingclassesweblogicversion9 folder in the machine where Applications Manager is
running.

● To monitor WebLogic 10.x , 11g , 12C

Copy Weblogic.jar, wlclient.jar, wljmsclient.jar, wlthint3client.jar from folder /wlserver/server/lib in Remote WebLogic
server. Copy to workingclassesweblogicversion10 folder in machine where Applications Manager is running.

If customer is monitoring all three versions of weblogic (10.x, 11g, 12C), then get the jars from latest version
of WebLogic(Version 12c).

Troubleshoot: Having trouble in monitoring WebLogic server? Refer to the online Troubleshooting section.

Monitored Parameters

WebLogic servers are monitored based on a few parameters or the attributes. These attributes provide information about the
functioning of the Monitors of WebLogic server and you can also receive alarms based on the thresholds configured on the
numerical attributes of the server.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Click on the monitor name to see all the server details listed:

● JVM
● JDBC

Copyright © 2014 Zoho Corp. Page 135


Applications Manager User Guide
Applications Manager User Guide Application Servers

● Thread pool
● Web Applications
● Java Message Service
● SAF
● Custom Attributes

Parameters Description

JVM

Type Type of memory

Heap Used Amount of heap used by the weblogic server

Heap Free Amount of heap currently available

Committed Amount of heap that is committed for running weblogic server

Maximum Maximum amount of heap available for weblogic server

Used Percentage Amount of heap used in percentage

Free Percentage Amount of heap available in percentage

JDBC

Name Name of the database connection pools that enables caching of database connection in the monitor easier through pools.

Threads waiting for connection Mentions the number of threads waiting for the connection.

JDBC Active Connections Mentions the number of active connections made to the monitor.

Total Connections Specifies the number of database connection pool.

Pool State Specifies the state of the pool Running/Suspended

There can be some problems in connections that are checked out from the connection pool but are not returned back to the
JDBC Connection Leak Count
pool and they are specified using the parameter.

JDBC Active Connection in % Amount of active connections in %

Thread Pool

Idle Threads Count Specifies the threads that are idle or not used.

Total Threads Refers to the total count of threads assigned in this thread queue.

Pending Request Total Count Specifies the number of requests that are pending in the queue.

Threads In Use Specifies the threads that are currently in use.

Web Applications

Name Name of the Web Application.

Session Opened Total Refers to the total number of sessions that were opened since deployment of an Application.

Number of Active Sessions Specifies the number of sessions that are currently active in the Application.

Maximum Number of Sessions Refers to the highest number of sessions that were open for an Application.

Number of Servlets Refers to the total number of servlets of a web application

Java Message Service

Name The name of JMS server.

Current The current number of messages stored on this JMS server.

Copyright © 2014 Zoho Corp. Page 136


Applications Manager User Guide
Applications Manager User Guide Application Servers

Pending The current number of messages pending (unacknowledged or uncommitted) stored on this JMS server.

Received/Min The number of messages received on this destination since the last reset per minute.

SAF Details (Conversations & Remote End Points)

Name Name of SAF Agent in Weblogic.

Conversations Current Count The current number of conversations.

Conversations Total Count The total number of conversations since the last reset.

Conversation/Minute The total number of conversations per minute since the last reset.

Name Name of SAF Agent in Weblogic.

Current The current number of remote endpoints to which this SAF agent has been storing and forwarding messages.

Total The number of remote endpoints to which this SAF agent has been storing and forwarding messages per minute.

Remote End Points Per Minute The rate at which this SAF agent has been storing and forwarding messages per minute.

Custom Attributes

You can also view the custom attributes of the WebLogic Server in the same page. Click Add Attributes to add custom WebLogic attributes. For information on adding
Custom Monitors, refer to Custom Monitors topic.

Copyright © 2014 Zoho Corp. Page 137


Applications Manager User Guide
Applications Manager User Guide Application Servers

WebSphere Server Monitoring

Create a New Monitor

The supported versions of WebSphere Servers are 5.x, 6.x, 7.x and 8.x

Prerequisites for Websphere Monitoring: For Applications Manager to collect data from WebSphere Application Server,
configurations are required at the Performance Monitoring Infrastructure (PMI) specification level. Refer Prerequisites
Section for configuration details.

To create a WebSphere Server Monitor


1. Click on New Monitor link.
2. Select WebSphere Server.
3. Select the Deployment Mode as Base or Network Deployment.
4. For Base Mode, Enter the Host name/IP Address of the host in which websphere application server is running.
For Network Deployment, enter the Host name/IP Address of the websphere application server in which the perf servlet is
installed. This will automatically discover all the WebSphere servers in Network Deployment.
5. Enter the SubNetMask of the network.
6. Enter the HTTP Transport Port (9080 by default).
7. Enter the polling interval time in minutes.
8. If you are adding a new monitor from an Admin Server, select a Managed Server.
9. Select the version of the WebSphere to be monitored - 5.x, 6.x, 7.x and 8.x.
10. Enter the port number of the SOAP Connector (8880 by default).
11. If you want to monitor WebSphere through SSL mode, select the SSL is enabled checkbox.
12. Enter the User Name and Password, if Global Security is enabled.
13. In Network Deployment Mode, Enter the Network Deployer's Host and SOAP Port (Default : 8879).
14. Choose the Monitor Group from the combo box with which you want to associate WebSphere Server Monitor (optional).
You can choose multiple groups to associate your monitor.
15. Click Add Monitor(s). This discovers WebSphere server from the network and starts monitoring them.

Note: Applications Manager has been tested for WebSphere versions of English, German, Japanese and Chinese languages.

Monitored Parameters

The Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and
events for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual

Copyright © 2014 Zoho Corp. Page 138


Applications Manager User Guide
Applications Manager User Guide Application Servers

monitors listed, to view the following information

WebSphere servers are monitored based on the attributes listed under the following tabs:

● Monitor Information
● Overview
● Web
● EJB
● JDBC
● JMS - Queues, Topics
● Thread

The monitoring details of the server are represented graphically that helps to understand the parameters with ease. You can also
configure thresholds to the attributes monitored by the server based on these details.

Monitor Details

Parameters Description

The deployment mode of the WebSphere server. You can choose either Base or Network Deployment.If you select:
• Base Mode, enter the Host Name/IP Address of the host in which the WebSphere application server is running.
Deployment Mode
• Network Deployment, enter the Host name/IP Address of the WebSphere Application server in which the perf servlet is
installed. This will automatically discover all the WebSphere servers in Network Deployment.

WebSphere Version Denotes the version of the WebSphere server monitor.

Port Refers to HTTP Transport port.

Subnet Mask The subNetMask of the WebSphere server.

If you have multiple system IP addresses configured with a single DNS name, select the ‘Do not resolve DNS name’ option
Do not resolve DNS name
under‘Advanced’ section.

Network Deployer Host, Network If you have chosen the ‘Network Deployment’ mode, specify the Network Deployer Host and Network Deployer SOAP Port
Deployer SOAP Port values. The default SOAP port is 8879.

SSL is enabled If you want to monitor WebSphere through SSL mode, select the ‘SSL is enabled’ checkbox.

If you want to monitor selected app servers running in the WebSphere server, select the ‘Advanced Options’ checkbox and
App Servers to Monitor specify the app servers in the ‘App Servers to Monitor’ field. If you want to monitor all the app servers in the WebSphere
server, leave this field empty.

Overview

Copyright © 2014 Zoho Corp. Page 139


Applications Manager User Guide
Applications Manager User Guide Application Servers

Parameters Description

State Refers to different states of the Websphere server such as running and down.

HTTP Port Refers to HTTP Transport port.

Transaction Details Specifies Global Commit Duration, Committed Transactions, Transactions Rolled Back and Transactions Optimized.

Server Response Time Specifies Minimum, Maximum, Average and Current Response Time.

Availability Specifies the status of the WebSphere server - available or not available.

JVM Memory Usage Specifies the total memory in JVM run time.

CPU Utilization Specifies the average system CPU utilization taken over the time interval since the last reading.

Free Memory Specifies the amount of real free memory available on the system.

Average CPU Utilization Specifies the average percent CPU Usage that is busy after the server is started

Session Details of Web Applications

Parameters Description

Invalidated Sessions Specifies the total number of sessions that were invalidated.

Session Creation Rate/Min The rate per minute at which session objects were created by the server.

The total number of requests received for sessions that were last accessed from other Web applications. This value can
Affinity Breaks/Min
indicate failover processing or a corrupt plug-in configuration.

Live Sessions The number of local sessions that are currently cached in memory

Total Requests/Min The total number of requests that a web application processed

Error Count/Min Total number of errors in a servlets or JavaServer Page (JSP).

Concurrent Requests The number of requests that are concurrently processed.

EJB Details

Copyright © 2014 Zoho Corp. Page 140


Applications Manager User Guide
Applications Manager User Guide Application Servers

Parameters Description

Mentions the names of the different EJB present in the WebSphere server with JAR and EAR name. Move the mouse pointer
Name
over the EJB name to view the JAR and EAR name.

Type Denotes the different types of the bean such as entity, stateless session, stateful session, and message driven.

Concurrent Lives Specifies the number of concurrent live beans.

Total Method Calls Specifies the total number of method calls.

Average Method Response Time Specifies the average time required to respond to the method calls.

Pool Size Specifies the number of objects in the pool (entity and stateless).

Specifies the average time in milliseconds that the total bean is activated for that particular Bean container, including the time
Activation Time
at the database, if any.

Specifies the average time in milliseconds that the total bean is passivated for that particular Bean container, including the
Passivation Time
time at the database, if any.

Current JDBC Connection Pool Details

Parameters Description

Name The name of the current JDBC Connection pool.

Pool Type The type of the connection pool.

Create Count The total number of connections created.

Pool Size The size of the connection pool.

Concurrent Waiters The number of threads that are currently waiting for a connection.

Faults The total number of faults in the connection pool such as timeouts.

Average Wait Time The average waiting time, in milliseconds, until a connection is granted.

Copyright © 2014 Zoho Corp. Page 141


Applications Manager User Guide
Applications Manager User Guide Application Servers

Percent Maxed The average percent of the time that all connections are in use.

JMS Queues

Parameters Description

Queue Depth The number of messages available for a queue's consumption

The number of messages locked or uncommitted. This means messages that have been added or removed but the transaction
Uncommitted Transactions
has not yet been committed.

Produced Count/Sec The total number of messages produced per second to this queue.

Consumed Count/Sec The total number of messages consumed per second from this queue

Number of Producers The number of currently attached local producers.

Number of Consumers The number of currently attached local consumers.

Message Wait Time(sec) Maximum time spent by messages on this queue at consumption in seconds.

Oldest Message Age(sec) The longest time any message has spent on this queue in seconds.

Jms Topics

Parameters Description

Durable Subscriptions The number of subscriptions that can be used to preserve messages published on a topic while the subscriber is not active.

Non-durable Subscriptions The number of non-durable subscriptions.

Incomplete Publications The number of publications not yet received by all current subscribers.

Oldest Publication Age The longest time any publication has spent on this topic space.

Number of Publishers The number of local publishers to topics in this topic space.

Number of Subscriptions The number of local subscriptions to topics in this topic space.

Number of Publications The total number of publications to this topic space.

Thread Pool Details

Parameters Description

Name Mentions the name of the thread pool.

Thread Creates Specifies the total number of threads created.

Copyright © 2014 Zoho Corp. Page 142


Applications Manager User Guide
Applications Manager User Guide Application Servers

Thread Destroys Specifies the total number of threads destroyed.

Active Threads Specifies the number of concurrently active threads.

Pool Size Specifies the average number of threads in pool.

Percent Used The average percentage of the pool in use.

Free Pool Size The number of free connections in the pool.

Percent Maxed Specifies the average percent of the time that all threads are in use.

Note

In Network Deployment mode, Network Deployer will be listed in the WebSphere Monitors list. Clicking on it, will give
server information and the custom attributes. Further, the individual WebSpheres within the Network Deployment would also
be listed. Clicking on those servers would bring up each of those server's details.

Copyright © 2014 Zoho Corp. Page 143


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Cloud Applications

Cloud computing services help organizations to improve the flexibility and scalability of IT services delivered to their end users.
Hence it is vital to monitor your client’s cloud infrastructure seamlessly. Applications Manager's Cloud monitoring tool addresses
this monitoring need.

Applications Manager's monitoring capabilities enables you to ensure that your public cloud computing services perform their best
at all times and that cloud resources are being effectively utilized.

The following server types supported by Applications Manager under the Cloud Applications category:

● Amazon Monitors
● Windows Azure Cloud Service (Classic) Monitor
● OpenStack

Many IT organizations are moving a portion of their IT infrastructure to the cloud in order to improve flexibility and scalability of IT
services delivered to end users. Public cloud services such as those provided by Amazon Web Services (AWS) allows companies to
rent virtual computers on which to run their own applications and services. It is important to continuously monitor these cloud
hosted applications in order to ensure they perform at expected levels at all times, and also to ensure cloud resources are being
effectively utilized.

Applications Manager enables high performance business process management by detecting and diagnosing problems of cloud
applications faster. The following cloud services are supported:

● Amazon
● EC2 Instance
● RDS Instance
● S3 Bucket
● Windows Azure Cloud Service
● OpenStack

Copyright © 2014 Zoho Corp. Page 144


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Amazon Monitors

Prerequisites for monitoring Amazon CloudWatch: You can use the Amazon CloudWatch Monitoring scripts for Microsoft
Windows Server to monitor memory and disk performance counters on Amazon EC2 Windows instances. Refer Prerequisites
Section.

To create a new Amazon monitor, follow the steps given below:


1. Click on New Monitor link.
2. Select Amazon under Cloud Apps category.
3. Specify the Display Name of the Amazon server
4. Enter the Access Key Id of the AWS for accessing the AWS through the API. The access key has 20 alpha-numeric
characters.
5. Enter the Secret Access Key of the AWS. The secret key should be 40 alpha-numeric characters long.
6. Specify the Polling Interval in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Choose the Monitor Group with which you want to associate the Amazon monitor to, from the combo box (optional). You can
choose multiple groups to associate your monitor.
9. Click Add Monitor(s). This discovers the Amazon server from the network and starts monitoring it.

Note: Before creating a new Amazon monitor, you have to configure proxy settings under 'Admin' tab.

Applications Manager automatically discovers all the EC2 and RDS instances, and S3 buckets under your Amazon account. You can
then enable monitoring for those instances and buckets as per your requirement.

Monitored Parameters

Amazon accounts are monitored based on the parameters or the attributes listed below. These attributes provide detailed
information about the functioning of the Amazon account. You can also configure thresholds to the numerical attributes based on
these details and get notified when the thresholds are violated.

The Availability tab shows the availability history of the Amazon account for the past 24 hours or 30 days. The Performance tab

Copyright © 2014 Zoho Corp. Page 145


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

shows some key performance indicators of the Amazon account such as Total EC2 Instances running and Total RDS Instances along
with heat charts for these attributes. This tab also shows the health status and events for the past 24 hours or 30 days.

The List view displays all the Amazon instances along with an overall idea of their availability and health status. The list view also
enables you to perform bulk admin configurations. Click on the individual applications listed to view detailed performance metrics.

Click on the monitor listed in the Availability tab to view detailed performance metrics of the Amazon instance. These metrics are
categorized into 2 different tabs for easy understanding. Here is an explanation of the metrics shown in these tabs:

1) Instances

This tab provides a high-level overview of your Amazon account as well as information about the EC2 instances present in this
account.

Parameter Description

Monitor Information

Name The name of the Amazon account.

Type Denotes the type you are monitoring.

Health Denotes the health (Clear, Warning, Critical) status of the Amazon account.

Total EC2 Instances Running The number of EC2 instances running in the account

Total EBS Volumes in use The number of EBS storage volumes currently in use

Total RDS Instances The total number of RDS instances present in the account

Last Polled at Specifies the time at which the last poll was performed

Next Poll at Specifies the time at which the next poll is scheduled

Shows the overall availability status of the account for the day. You can also view 7/30 reports and the current availability
Today's Availability
status of the account

EC2 Instances

Copyright © 2014 Zoho Corp. Page 146


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Instance ID The unique identifier of the EC2 instance

Region Name The region where this EC2 instance is running

State The current state of the instance. The values include running, stopped, shutdown and terminated

Platform The OS on which the instance is runnng

Monitoring Denotes whether CloudWatch monitoring is enabled for this instance.

Public DNS Name The DNS name associated with the instance

You can perform the following admin actions on the EC2 instances:

Delete: Delete the EC2 instance from the account.


Assign Platform: Assign platforms such as Windows, Mac OS, etc. to instances
Enable CloudWatch: Option to enable CloudWatch monitoring for the instance.

Disable CloudWatch: Disable CloudWatch monitoring for the instance.

Start Instances: Option to start the EC2 instance from Applications Manager.
Stop Instances: Option to stop EC2 instances from Applications Manager

Reboot Instances: Option to reboot the EC2 instances from within Applications Manager.

2) RDS Instances

This tab provides details about the RDS Instances present in the Amazon account.

Parameter Description

Instance ID The unique identifier of the instance.

Region Name The region in which the RDS instance is running

State The current state of this instance. The possible values for this field are available, creating, failed, rebooting, etc.

DB Engine Name The name of the database engine associated with this instance

Allocated Storage The storage space allocated to this instance in Giga Bytes

3) S3 Buckets

Copyright © 2014 Zoho Corp. Page 147


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

This tab provides details about the S3 buckets present in the Amazon account.

Parameter Description

Bucket Name The unique name of the S3 bucket.

Bucket Size The size of the S3 bucket in mega bytes.

The geographical region where Amazon has stored this bucket. Regions currently supported by Amazon are US-Standard, US-
Bucket Location
West (Northern California), EU (Ireland) and APAC-Singapore.

Creation Time The time when the bucket was created.

Virtual Folders The number of folders present in this S3 bucket.

Number of Objects The number of objects stored in this S3 bucket.

You can perform the following admin actions on the S3 buckets from within Applications Manager.

Disable: Disable the monitoring of S3 bucket.

Enable: Enable the monitoring of S3 bucket.

Delete: Delete the S3 bucket from Applications Manager.Use this option when S3 bucket is deleted from your Amazon account.

You can also view comparison reports based on attributes such as bucket size, virtual folders and number of objects.

Amazon CloudWatch

Amazon CloudWatch is a monitoring service for AWS cloud resources and the applications you run on AWS. In Applications
Manager, you can use the Amazon CloudWatch Monitoring scripts for Microsoft Windows Server to monitor memory and disk
performance counters on Amazon EC2 Windows instances. Refer Prerequisites Section to know how to use the scripts. These scripts
can be run in Amazon EC2 Windows instances that have Windows PowerShell installed.

Copyright © 2014 Zoho Corp. Page 148


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Disk Partition Metrics Memory Info Stats

Volume Utilization Memory Utilization

Volume Available Memory Available

Volume Used Memory Used

Copyright © 2014 Zoho Corp. Page 149


Applications Manager User Guide
Applications Manager User Guide Amazon

Amazon EC2 Instance Monitoring

Monitored Parameters

The Amazon EC2 instances are monitored based on the parameters or the attributes listed below. These attributes provide
information about the functioning of the EC2 instances. You can also configure thresholds to the numerical attributes based on
these details and get notified when the thresholds are violated.

The Availability tab shows the Availability history of the EC2 instances for the past 24 hours or 30 days. The Performance tab shows
some key performance indicators of an EC2 instance such as CPU Utilization, Volume Idle Time, Network In and Network Out along
with the heat charts for these attributes. This tab also shows the health status and events for the past 24 hours or 30 days.

The List view displays all the EC2 instances present in the Amazon account along with an overall idea of their availability and health
status. The list view also enables you to perform bulk admin configurations. Click on the individual instance listed to view detailed
performance metrics.

Click on the monitor listed in the Availability tab to view detailed performance metrics of the EC2 instance. These metrics are
categorized into 3 different tabs for easy understanding. Below is an explanation of the metrics shown in these tabs:

1) Overview

This tab provides a high-level overview of the EC2 instance as well as its performance indicators.

Parameter Description

Monitor Information

Name The name of the EC2 instance

Copyright © 2014 Zoho Corp. Page 150


Applications Manager User Guide
Applications Manager User Guide Amazon

Type Denotes the type you are monitoring.

Health Denotes the health (Clear, Warning, Critical) status of the EC2 instance.

Region Name Name of the region where the instance is running

Instance Type Indicates the type of the EC2 instance

State The current state of the instance. Valid values include running, stopped, shutdown and terminated

Public IP Address The IP address of the instance.

Platform Indicates the platform of the instance (eg: Windows)

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Shows the overall availability status of the instance for the day. You can also view 7/30 reports and the current availability
Today's Availability
status of the instance.

CPU Utilization The CPU utilization of the instance

Network Traffic

Network IN Incoming traffic in bytes per minute

Network Out Outgoing traffic in bytes per minute

Disk I/O

Disk Read Ops The average number of disk read operations per second.

Disk Write Ops The average number of disk write operations per second.

2) Attached Volumes

This tab provides metrics about the EBS volumes attached to the EC2 instance.

Parameter Description

Configuration

The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone and the instance
Volume ID
must be running.

Size The size of the volume in Giga Bytes.

Copyright © 2014 Zoho Corp. Page 151


Applications Manager User Guide
Applications Manager User Guide Amazon

Snapshot ID Snapshot from which the volume was created.

Created Time Time stamp when volume creation was initiated.

Attached Time Time stamp when the attachment was initiated.

Delete on Termination Specifies whether the Amazon EBS volume is deleted on instance termination.

Health Denotes the health of the volume (clear, warning, critical)

Latency

Idle Time The time period when no read or write operations were waiting to be completed in percentage(%)

Write Latency The average of the total number of seconds spent by all Write operations that completed in the period

Read Latency The average of the total number of seconds spent by all Read operations that completed in the period

Volume Traffic

Read Bandwidth The sum of total number of Read operations in the period in bytes per second

Write Bandwidth The sum of total number of write operations in the period in bytes per second

Volume IO

Read Throughput The sum of read operations in the period in seconds

Write Throughput The sum of write operations in the period in seconds

Queue Length The average number of read and write operation requests waiting to be completed over the period.

3) Configuration

This tab provides the configuration details of the EC2 instance.

Parameter Description

Instance ID The unique key that identifies the EC2 instance.

Instance Type Indicates the type of the instance.

Instance Launch Time The time at which the instance was launched

State The current state of the instance. The values include running, stopped, shutdown and terminated

Image ID Image ID of the AMI used to launch the instance.

AMILaunch Index The AMI launch index, which can be used to find this instance within the launch group.

Public DNS Name The public DNS name assigned to the instance. This DNS name is contactable from outside the Amazon EC2 network.

Private DNS Name The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network.

Public IP Address The IP address of the instance.

Copyright © 2014 Zoho Corp. Page 152


Applications Manager User Guide
Applications Manager User Guide Amazon

Private IP Address The private IP address assigned to the instance.

KeyPair Name The name of the key pair, if this instance was launched with an associated key pair.

Platform Indicates the platform of the instance (eg: Windows)

Availability Zone The instance's availability zone.

Architecture The architecture of the image.

RamDisk Id RAM disk associated with this instance.

Kernel Id Kernel associated with this instance.

RootDevice Type The root device type used by the AMI. The AMI can use an Amazon EBS or instance store root device.

RootDevice Name The name of the root device used by the AMI.

Monitoring Indicates whether monitoring is enabled for the instance.

Copyright © 2014 Zoho Corp. Page 153


Applications Manager User Guide
Applications Manager User Guide Amazon

Amazon RDS Instance Monitoring

Monitored Parameters

Amazon RDS Instances are monitored based on the parameters or the attributes listed below. These attributes provide information
about the functioning of the RDS instance. You can also configure thresholds to the numerical attributes based on these details and
get notified when the thresholds are violated.

The Availability tab shows the Availability history of the RDS instances for the past 24 hours or 30 days. The Performance tab shows
some key performance indicators of an EC2 instance such as CPU Utilization, Free Storage Space, Database Connections and Write
Throughput along with the heat charts for these attributes. This tab also shows the health status and events for the past 24 hours
or 30 days.

The List view displays all the RDS instances present in the Amazon account along with an overall idea of their availability and health
status. The list view also enables you to perform bulk admin configurations. Click on the individual instance listed to view detailed
performance metrics.

Click on the monitor listed in the Availability tab to view detailed performance metrics of the RDS instance. These metrics are
categorized into 2 different tabs for easy understanding. Below is an explanation of the metrics shown in these tabs:

1) Overview

This tab provides a high-level overview of the RDS Instance as well as its resource utilization.

Copyright © 2014 Zoho Corp. Page 154


Applications Manager User Guide
Applications Manager User Guide Amazon

Parameter Description

Monitor Information

Name The name of the RDS instance.

Type Denotes the type you are monitoring.

Health Denotes the health (Clear, Warning, Critical) status of the RDS instance.

Region Name The region in which the RDS instance is running.

Instance Type Indicates the type of instance

Created Time The time when the instance was created.

State The current state of the instance. The values include running, stopped, shutdown and terminated

DB Engine Name The name of the database engine associated with this instance

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Shows the overall availability status of the instance for the day. You can also view 7/30 reports and the current availability
Today's Availability
status of the instance.

CPU Utilization

CPU Utilization The percentage of CPU Utilization

Free Storage Space The amount of available storage space.

Database Connections The number of database connections in use.

Network Traffic

Read Throughput The average number of bytes read from the disk per second.

Write Throughput The average number of bytes written to the disk per second.

Network Latency

Read Latency The average amount of time taken per disk read operation.

Write Latency The average amount of time taken per disk write operation.

Disk I/O

Read Ops The average number of disk Read operations per second.

Write Ops The average number of disk write operations per second.

2) Configuration

Copyright © 2014 Zoho Corp. Page 155


Applications Manager User Guide
Applications Manager User Guide Amazon

This tab provides the configuration details of the RDS instance.

Parameter Description

Instance ID The unique key that identifies the RDS instance

Instance Type Indicates the type of instance

Created Time The time when the instance was created.

The current status of the instance. Valid values include available, backing-up, creating, deleted, deleting, failed, modifying,
State
rebooting and resetting-master-credentials

DB Engine Name The name of the database engine used for this instance.

MasterUser Name The master username for the instance.

DB Name Name of the initial database created when the instance was created.

Allocated Storage The storage space initially allocated to this instance, specified in GBs

Endpoint Address The DNS Address of the DB instance

Endpoint Port Port used to connect to the DB instance

Multi(A-Z)Deployment Indicates if this is a Multi-AZ DB Instance.

Availability Zone The instance's availability zone

PreferredBackup Window The daily period during which automated backups are created.

LatestRestorableTime The latest time to which a database can be restored using point-in-time restore.

BackupRetentionPeriod The number of days that automated backups are retained before deletion.

PreferredMaintenanceWindow The period during which patching and instance modifications will be performed.

Copyright © 2014 Zoho Corp. Page 156


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Microsoft Azure Monitoring

● Microsoft Azure - An Overview


● Monitoring Microsoft Azure - What we do
● Creating a new Azure Monitor
● Monitored Parameters

Microsoft Azure - An Overview

Microsoft Azure, formerly known as Windows Azure, is Microsoft's public cloud computing platform. It provides a range of cloud
services, including those for compute, analytics, storage and networking. Users can pick and choose from these services to develop
and scale new applications, or run existing applications, in the public cloud.

Monitoring Microsoft Azure - What we do

Applications Manager's Microsoft Azure monitor enables users to discover Virtual machines under an Azure subscription and
monitor them. You can also monitor the health and performance of your Azure Storage account for better managing and utilizing
our Azure hosted storage resources.

Applications Manager connects with Azure Virtual Machines through Azure-sdk-for-java to determine the health status and other
performance counters. With Microsoft Azure monitoring, you can:

● Discover Azure Virtual machines under an Azure subscription.


● Find the number of VMs that are provisioned and running.
● View the status and configuration information of all the discovered resources.
● Collect and monitor performance metrics(CPU, Memory, Disk, Network, Thread&Process count, .NetCLR metrics).
● Collect and monitor Disk Utilization, Disk IO statistics, Network interface details by enabling Guest OS configuration.

Creating a new Microsoft Azure Monitor

To create a new Azure monitor, follow the steps given below:

● Click on the New Monitor link in the Applications Manager web client.
● Select 'Microsoft Azure' under Cloud Apps category

Copyright © 2014 Zoho Corp. Page 157


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

● Specify the Display Name of Microsoft Azure monitor


● Enter the Subscription ID for your Microsoft Azure subscription.
● Choose the Discovery mode
● Following are the 2 discovery modes available,

Discovery using Azure Organizational Account (Powershell):

Prerequisite: Refer Prerequisites section.

Provide the User email & Password fields in New monitor page with the Username & Password of the created
Organizational account

Discovery using AD Application & Service Principal:

Prerequisite: Refer Prerequisites section.

Provide the Client ID, Tenant ID & Application key that were obtained in the above mentioned prerequisite step in the
New monitor page.

● Specify the polling interval in minutes and timeout in seconds

Note: Azure resources deployed using 'Azure Resource Manager(ARM)' model will be monitored by Applications Manager. Azure
Resources deployed using Classic model are not supported.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Microsoft Azure under the Cloud Apps Table.
Displayed is the Microsoft Azure bulk configuration view distributed into three tabs:

● Availability tab gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Microsoft Azure monitor provides a brief detail of the Azure virtual machines under the given subscription. Click on the monitor
name to see all the server details listed under the following tabs:

● Monitor Information
● Overview
● Virtual Machines
● Storage Accounts

Monitor Information

Copyright © 2014 Zoho Corp. Page 158


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Parameter Description

Name Name of the Microsoft Azure monitor

Subscription ID Subscription ID of the Azure subscription

Azure services The services that are monitored under this subscription

Discovery mode The discovery mode chosen while creating the monitor

User Email The organizational account used to access Azure resources

Client ID Client ID of the Active Directory Application

Tenant ID Tenant ID of the Active Directory

Timeout Timeout Duration(seconds)

Total Azure Virtual Machines Provisioned Count of virtual machines under this subscription

Total Azure Virtual Machines Running Count of virtual machines in running state

Associated groups The monitor groups to which this monitor is associated

Last polled at Specifies the time at which the last poll was performed

Next poll at Specifies the time at which the next poll is schedule

Overview

Parameter Description

Total Azure Virtual Machines Provisioned Count of virtual machines under this subscription

Total Azure Virtual Machines Running Count of virtual machines in running state

Virtual Machines

Parameter Description

Virtual Machine Name Name of the Virtual machine

Status Virtual machine's state

Resource group name The Resource Group which has this Virtual Machine

OS Type The Operating System of the Virtual Machine

Location The Location where the Virtual Machine is located

Copyright © 2014 Zoho Corp. Page 159


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Parameter Description

Public IP Address IP address of the Virtual Machine

Storage Accounts

Parameter Description

Azure Standard Storage Accounts

Storage Account Name The Azure Storage Account Name.

Provisioning state of Storage Account

Possible values :
• Invalid

• Creating

Provisioning State • Deleting

• Succeeded

• Failed

• Cancelled

Resource Group Resource Group where the Storage Account is allocated in.

Location Region where the storage account is provisioned

Status of Storage Account.

Primary Status Possible Values:


• Available
• Unavailable

Copyright © 2014 Zoho Corp. Page 160


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Azure Virtual Machines

The Azure Virtual machines are monitored based on the parameters or the attributes listed below. These attributes provide
information about the functioning of Azure Virtual machines. You can also configure thresholds to the numerical attributes based on
these details and get notified when the thresholds are violated.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Azure Virtual Machines under the Cloud
Apps Table. Displayed is the Azure Virtual Machine bulk configuration view distributed into three tabs:

● Availability tab gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following 9 tabs:

● Monitor Information
● Overview
● CPU
● Memory
● Disk
● Network
● Threads & Processes
● .NET CLR
● Configuration

Monitor Information

Parameter Description

Name Display name of the Virtual machine

Copyright © 2014 Zoho Corp. Page 161


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Subscription ID of the Azure subscription which contains this


Subscription ID
VM

Virtual Machine name Name of the Virtual machine

Virtual Machine Resource ID Resource ID of the Virtual machine

Timeout Timeout Duration(seconds)

Enable Guest OS monitoring Guest OS monitoring option given in Edit monitor page

Username VM's username

Timeout Timeout Duration(seconds)

Associated groups The monitor groups to which this monitor is associated

Last polled at Specifies the time at which the last poll was performed

Next poll at Specifies the time at which the next poll is scheduled

Overview

Parameter Description

CPU UTILIZATION

CPU Utilization Task Manager's CPU usage counter

MEMORY METRICS

Physical Memory Utilization Percentage of RAM used

Swap Memory Utilization

Copyright © 2014 Zoho Corp. Page 162


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Free Physical Memory Amount of free RAM

CPU

Parameter Description

PROCESSOR METRICS

% Interrupt Time Percentage of Time the processor handles Interrupts

Percentage of time the processor was running in privileged


% Priviledged Time
mode

% User Time Percentage of time the processor was running in user mode

Processor Frequency

Memory

Parameter Description

Committed Bytes Amount of commited Virtual Memory

Available Bytes Amount of available Physical Memory

% Committed Bytes In Use Ratio of Committed Bytes to the Commit Limit

Pool Paged Bytes Size in bytes of the paged pool

Size in bytes of physical memory that cannot be written to


Pool Nonpaged Bytes
disk eventhough it is not in use

Copyright © 2014 Zoho Corp. Page 163


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Cache Faults/sec Number of Cache faults per second

Page Faults/sec Number of Page Faults per second

Transition Faults/sec Number of soft page faults per second

Disk

Parameter Description

DISK UTILIZATION

Disk Disk Partition

Disk Usage Disk Free space & Used space

Total Size(MB) Total disk size

Used(%) Used disk space as percentage

Used MB Used disk space

Free(%) Free disk space as percentage

Free MB Free disk space

DISK IO STATISTICS

Disk Disk partition

The number of read/write operations on the disk that occur


Transfers/Sec
each second

The percentage of elapsed time that the disk drive was busy
Writes/sec
servicing write requests

Copyright © 2014 Zoho Corp. Page 164


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

The percentage of elapsed time that the disk drive was busy
Reads/Sec
servicing read requests

% Busy Time The percentage of time the disk was busy

The average number of both read and write requests that


Average queue length
were queued for the disk during the sample interval

Disk Read Bytes/sec Bytes read from the disc per second

Disk Write Bytes/sec Bytes written on the disc per second

DISK SPACING

Disk Name Name of the hard disk

VHD URI Virtual hard disk URI that identifies this disk

Disk Size Total size of the disk

Network

Parameter Description

NETWORK INTERFACE

Network Interface The name of the network interface

Speed(Mbps) The estimate of the current bandwidth in Mbps

The rate at which packets are received on the interface, in


Input traffic(Kbps)
kilo bytes per second.

Input Utilization(%) Input traffic percentage

Copyright © 2014 Zoho Corp. Page 165


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

The rate at which packets are sent on the interface, in kilo


Output traffic(Kbps)
bytes per second.

Output Utilization(%) Output traffic percentage

Inbound Errors Number of packets that could not be received

Outbound Errors Number of packets that could not be sent

TCPV4 CONNECTIONS

Connections establised Number of established TCP connections

Connection failures Number of Failed TCP connections

Connections reset Number of resetted TCP connections

TCPV4 SEGMENTS

Segments sent/sec Number of TCP segments sent per second

Segments received/sec Number of TCP segments received per second

Segments retransmitted/sec Number of TCP segments retransmitted per second

Threads & Processes

Parameter Description

THREAD STATS

System thread count The total number of threads

Context switches/sec The total number of context switches per sec

Copyright © 2014 Zoho Corp. Page 166


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

PROCESS STATS

Process count The total number of processes

The percentage of total time the processor was busy


% Processor time
servicing the processes

Total page faults/sec The total number of pages faulted per second

HANDLES

Handle count The total number of handles

.NET CLR

Parameter Description

.NET CLR THREADS

Logical threads Count of both running and stopped Threads

Count of threads created and owned by the common


Physical threads language runtime to act as underlying threads for managed
thread objects

.NET CLR STATS

JIT compilation time(%) Percentage of elapsed time spent in JIT compilation

The total number of threads that are currently waiting to


Current Queue length
acquire a managed lock in the application

Total number of times arguments and return values have


Marshalling count been marshaled from managed to unmanaged code, and vice
versa, since the application started

Copyright © 2014 Zoho Corp. Page 167


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Rate at which threads in the runtime attempt to acquire a


Contention Rate/sec
managed lock unsuccessfully

Remote Calls/sec Number of remote procedure calls invoked per second

Exceptions/sec Number of exceptions thrown per second

.NET CLR MEMORY STATS

The percentage of elapsed time that was spent performing a


Time in GC(%)
garbage collection

The number of bytes per second allocated on the garbage


Allocated Bytes/sec
collection heap

Gen 0 heap size The maximum bytes that can be allocated in generation 0

Gen 1 heap size Current number of bytes in generation 1

Gen 2 heap size Current number of bytes in generation 2

Large Object Heap size Current size, in bytes, of the Large Object Heap

Current memory allocated in bytes on the garbage collection


Bytes in all Heaps
heaps

Configuration

Parameter Description

SYSTEM INFORMATION

Resource Name Virtual machine name

Copyright © 2014 Zoho Corp. Page 168


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Resource ID Virtual machine resource ID

Status State of the VM

Resource Group Name The resource group which has this VM

VM Size Size of the VM

Location Location at which the VM is set up

Public IP Address Public IP of the VM

Private IP Address Private IP of the VM

OS INFORMATION

OS Type VM's Operating system

VM Image VM server configuration

NETWORK INTERFACE

Network Interface Name The name of the network interface

Network Interface ID The ID of the network interface

MAC Address MAC address of the network

Network security group ID Network security group of the network interface

Copyright © 2014 Zoho Corp. Page 169


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Microsoft Azure Storage Monitoring

● Microsoft Azure Storage - An Overview


● Creating a new Azure Storage Monitor
● Monitored Parameters

Microsoft Azure Storage- An Overview

Azure Storage is a group of highly scalable cloud-based storage services available for applications running in Azure cloud. Azure
Storage provides facilities for storing files (File storage), files and media (Blob storage), messages (Queue storage) and non-
relational schema-less data (Table storage).

Creating a new Microsoft Azure Monitor

Prerequisites:
Follow these steps to enable metrics in the Azure portal:

● Navigate to your storage account.


● Select Diagnostics on the Menu blade
● Ensure that Status is set to On.
● Select all the metrics provided.
● Specify a retention policy to indicate how long to retain metrics and log data.
● Select Save.

To create a new Azure Storage monitor, follow the steps given below:

● Click on the New Monitor link in the Applications Manager web client.
● Select 'Microsoft Azure' under Cloud Apps category.
● Specify the Display Name of Microsoft Azure monitor.
● Enter the Subscription ID for your Microsoft Azure subscription.
● Click the Azure Services textbox and choose Storage Accounts from the drop-down menu.
● Choose the Discovery mode:

Copyright © 2014 Zoho Corp. Page 170


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Discovery using Azure Organizational Account (Powershell):

Prerequisite: Refer Prerequisites section.

Provide the User email & Password fields in New monitor page with the Username & Password of the created
Organizational account

Discovery using AD Application & Service Principal:

Prerequisite: Refer Prerequisites section.

Provide the Client ID, Tenant ID & Application key that were obtained in the above mentioned prerequisite step in the
New monitor page.

● Specify the polling interval in minutes and timeout in seconds

Note:

● Azure Storage Account Monitoring does not support ZRS Storage Accounts as they do not have metrics or logging capability
enabled at this time.
● Azure Premium Accounts are not supported for monitoring. Only Azure Standard Accounts with the exception of ZRS
accounts are monitored for performance.
● Blobs capacity metrics data is stored in Azure Diagnostics once per day.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Microsoft Azure Storage under the Cloud
Apps Table. Displayed is the Microsoft Azure Storage bulk configuration view distributed into three tabs:

● Availability tab gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Microsoft Azure monitor provides a brief detail of the Azure virtual machines under the given subscription. Click on the monitor
name to see all the server details listed under the following tabs:

● Overview
● Blobs
● Tables
● Files
● Queues

Overview

Copyright © 2014 Zoho Corp. Page 171


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Storage Services Availability

The percentage of availability for the Blob storage service. Availability is calculated by taking the TotalBillableRequest value and
Blob Availability dividing it by the number of applicable requests, including those that produced unexpected errors. All unexpected errors result in
reduced availability for the storage service or the specified API operation.

The percentage of availability for the Table storage service.Availability is calculated by taking the TotalBillableRequests value and
Table Availability dividing it by the number of applicable requests, including those that produced unexpected errors. All unexpected errors result in
reduced availability for the storage service or the specified API operation.

The percentage of availability for the Queue storage service . Availability is calculated by taking the TotalBillableRequests value
Queue Availability and dividing it by the number of applicable requests, including those that produced unexpected errors. All unexpected errors result in
reduced availability for the storage service or the specified API operation.

The percentage of availability for the File storage service .Availability is calculated by taking the TotalBillableRequests value and
File Availability dividing it by the number of applicable requests, including those that produced unexpected errors. All unexpected errors result in
reduced availability for the storage service or the specified API operation.

Configuration

Storage Account Name The Azure Storage Account Name

Status of Storage Account.

Primary Status Possible Values:


• Available
• Unavailable

Status of the Replica of Storage Account.

Possible Values:
Secondary Status • Available
• Unavailable

This attribute is available only if the Replication Type is Standard_RAGRS or Standard_GRS.

Resource Group Resource Group where the Storage Account is allocated in.

Location Region where the storage account is provisioned

Provisioning state of Storage Account

Possible values :
• Invalid
Provisioning State • Creating
• Deleting
• Succeeded
• Failed
• Cancelled

The replication type used by the Storage account:

Possible values:
• Standard_LRS
Replication Type
• Standard_GRS
• Standard_RAGRS
• Standard_ZRS
• Premium_LRS

Blobs

Copyright © 2014 Zoho Corp. Page 172


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Capacity

Blobs User Data Size The amount of storage used by the storage account’s Blob service, in MB

Container Count The number of blob containers in the storage account’s Blob service.

Blob Object Count The number of blob containers in the storage account’s Blob service.

Blobs Capacity Data Collected Time The time at which blobs capacity metrics data was stored in Azure Diagnostics.

Throughput

The amount of ingress data, in MB. This number includes ingress from an external client into Azure Storage as well as ingress within
Blobs Total Ingress
Azure.

The amount of egress data, in MB. This number includes egress from an external client into Azure Storage as well as egress within
Blobs Total Egress
Azure. As a result, this number does not reflect billable egress.

The number of requests made to Blobs storage service or the specified API operation. This number includes successful and failed
Blobs Total Requests
requests, as well as requests which produced errors.

Blobs Total Billable Requests The number of billable requests to Blobs

Blobs Data Collected Time The time at which blobs performance metrics data was stored in Azure Diagnostics.

Latency

The average end-to-end latency of successful requests made to Blobs or the specified API operation, in milliseconds. This value includes
Blobs Average End-To-End Latency the required processing time within Azure Storage to read the request, send the response, and receive acknowledgment of the
response.

The average latency used by Azure Storage to process a successful request, in milliseconds. This value does not include the network
Blobs Average Server Latency
latency specified in AverageE2ELatency.

Requests Failed- Throttling Errors

Blobs Throttling Errors The number of authenticated requests to Blob storage service or the specified API operation that returned a ThrottlingError.

Blobs Anonymous Throttling Errors The number of anonymous requests to Blob storage service or the specified API operation that returned an AnonymousThrottlingError.

Blobs SAS Throttling Errors The number of SAS requests to Blob storage service or the specified API operation that returned a SASThrottlingError.

Blobs Throttling Error Percentage The percentage of requests that failed with a throttling error.

Requests Failed – Timeout Errors

Blobs Client Timeout Errors The number of authenticated requests to Blob storage service or the specified API operation that returned a ClientTimeoutError.

The number of anonymous requests to Blob storage service or the specified API operation that returned an
Blobs Anonymous Client Timeout Errors
AnonymousClientTimeoutError.

Blobs SAS Client Timeout Errors The number of SAS requests to Blob storage service or the specified API operation that returned an SASClientTimeoutError.

Copyright © 2014 Zoho Corp. Page 173


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Blobs Server Timeout Errors The number of authenticated requests to Blob storage service or the specified API operation that returned a ServerTimeoutError.

The number of anonymous requests to Blob storage service or the specified API operation that returned an
Blobs Anonymous Server Timeout Errors
AnonymousServerTimeoutError.

Blobs SAS Server Timeout Errors The number of SAS requests to Blob storage service or the specified API operation that returned an SASServerTimeoutError.

Blobs Percent Timeout Errors The percentage of requests that failed with a timeout error. This number includes both client and server timeouts.

Requests Failed – Other Client Errors

Blobs Client Other Errors The number of authenticated requests to a storage service or the specified API operation that returned a ClientOtherError.

Blobs SAS Client Other Errors The number of SAS requests to a storage service or the specified API operation that returned an SASClientOtherError.

Blobs Anonymous Client Other Errors The number of anonymous requests to a storage service or the specified API operation that returned an AnonymousClientOtherError.

Blobs Client Other Error Percentage The percentage of requests that failed with a ClientOtherError.

Requests Failed – Other Server Errors

Blobs Server Other Errors The number of authenticated requests to Blob storage service or the specified API operation that returned a ServerOtherError.

The number of anonymous requests to Blob storage service or the specified API operation that returned an
Blobs Anonymous Server Other Errors
AnonymousServerOtherError.

Blobs SAS Server Other Errors The number of SAS requests to Blob storage service or the specified API operation that returned an SASServerOtherError.

Blobs Server Other Error Percentage The percentage of requests that failed with a ServerOtherError.

Requests Failed – Authorization Errors

Blobs Authorization Errors The number of authenticated requests to Blob storage service or the specified API operation that returned an AuthorizationError.

The number of anonymous requests to Blob storage service or the specified API operation that returned an
Blobs Anonymous Authorization Errors
AnonymousAuthorizationError.

Blobs SAS Authorization Errors The number of SAS requests to Blob storage service or the specified API operation that returned an SASAuthorizationError.

Blobs Authorization Errors Percentage The percentage of requests that failed with an AuthorizationError.

Requests Failed – Network Errors

Blobs Network Errors The number of authenticated requests to Blob storage service or the specified API operation that returned a NetworkError.

Blobs Anonymous Network Errors The number of anonymous requests to Blob storage service or the specified API operation that returned an AnonymousNetworkError .

Blobs SAS Network Errors The number of SAS requests to Blob storage service or the specified API operation that returned a SASNetworkError.

Blobs Network Errors Percentage The percentage of requests that failed with a NetworkError.

Copyright © 2014 Zoho Corp. Page 174


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Successful Requests

Successful Requests to Blobs The number of successful requests made to a storage service or the specified API operation.

Blobs Anonymous Successful Requests The number of successful anonymous requests made to a storage service or the specified API operation.

Blobs SAS Successful Requests The number of successful Shared Access Signature (SAS) requests made to a storage service or the specified API operation.

The percentage of successful requests.


Blobs Successful Requests Percentage Note: that if there are no requests made against storage, the value of the PercentSuccess metric will be zero. If you are monitoring
PercentSuccess, you will also want to ensure that the value of the TotalRequests metric is greater than zero.

Tables

Parameter Description

Throughput

The amount of ingress data, in MB. This number includes ingress from an external client into Azure Storage as well as ingress within
Tables Total Ingress
Azure.

The amount of egress data, in MB. This number includes egress from an external client into Azure Storage as well as egress within
Tables Total Egress
Azure. As a result, this number does not reflect billable egress.

The number of requests made to Table storage service or the specified API operation. This number includes successful and failed
Tables Total Requests
requests, as well as requests which produced errors.

Tables Total Billable Requests The number of billable requests to Tables

Tables Data Collected Time The time at which tables performance metrics data was stored in Azure Diagnostics.

Latency

The average end-to-end latency of successful requests made to Tables or the specified API operation, in milliseconds. This value
Tables Average End-To-End Latency includes the required processing time within Azure Storage to read the request, send the response, and receive acknowledgment of the
response.

The average latency used by Azure Storage to process a successful request, in milliseconds. This value does not include the network
Tables Average Server Latency
latency specified in AverageE2ELatency.

Requests Failed- Throttling Errors

Tables Throttling Errors The number of authenticated requests to Table storage service or the specified API operation that returned a ThrottlingError.

Tables Anonymous Throttling Errors The number of anonymous requests to Table storage service or the specified API operation that returned an AnonymousThrottlingError.

Tables SAS Throttling Errors The number of SAS requests to Table storage service or the specified API operation that returned a SASThrottlingError.

Tables Throttling Error Percentage The percentage of requests that failed with a throttling error.

Copyright © 2014 Zoho Corp. Page 175


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Requests Failed – Timeout Errors

Tables Client Timeout Errors The number of authenticated requests to Table storage service or the specified API operation that returned a ClientTimeoutError.

The number of anonymous requests to Table storage service or the specified API operation that returned an
Tables Anonymous Client Timeout Errors
AnonymousClientTimeoutError.

Tables SAS Client Timeout Errors The number of SAS requests to Table storage service or the specified API operation that returned an SASClientTimeoutError.

Tables Server Timeout Errors The number of authenticated requests to Table storage service or the specified API operation that returned a ServerTimeoutError.

The number of anonymous requests to Table storage service or the specified API operation that returned an
Tables Anonymous Server Timeout Errors
AnonymousServerTimeoutError.

Tables SAS Server Timeout Errors The number of SAS requests to Table storage service or the specified API operation that returned an SASServerTimeoutError.

Tables Percent Timeout Errors The percentage of requests that failed with a timeout error. This number includes both client and server timeouts.

Requests Failed – Other Client Errors

Tables Client Other Errors The number of authenticated requests to Table storage service or the specified API operation that returned a ClientOtherError.

Tables SAS Client Other Errors The number of SAS requests to Table storage service or the specified API operation that returned an SASClientOtherError.

The number of anonymous requests to Table storage service or the specified API operation that returned an
Tables Anonymous Client Other Errors
AnonymousClientOtherError.

Tables Client Other Error Percentage The percentage of requests that failed with a ClientOtherError.

Requests Failed – Other Server Errors

Tables Server Other Errors The number of authenticated requests to Table storage service or the specified API operation that returned a ServerOtherError.

The number of anonymous requests to Table storage service or the specified API operation that returned an
Tables Anonymous Server Other Errors
AnonymousServerOtherError.

Tables SAS Server Other Errors The number of SAS requests to Table storage service or the specified API operation that returned an SASServerOtherError.

Tables Server Other Error Percentage The percentage of requests that failed with a ServerOtherError.

Requests Failed – Authorization Errors

Tables Authorization Errors The number of authenticated requests to Table storage service or the specified API operation that returned an AuthorizationError.

The number of anonymous requests to Table storage service or the specified API operation that returned an
Tables Anonymous Authorization Errors
AnonymousAuthorizationError.

Tables SAS Authorization Errors The number of SAS requests to Table storage service or the specified API operation that returned an SASAuthorizationError.

Tables Authorization Errors Percentage The percentage of requests that failed with an AuthorizationError.

Requests Failed – Network Errors

Copyright © 2014 Zoho Corp. Page 176


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Tables Network Errors The number of authenticated requests to Table storage service or the specified API operation that returned a NetworkError.

Tables Anonymous Network Errors The number of anonymous requests to Table storage service or the specified API operation that returned an AnonymousNetworkError .

Tables SAS Network Errors The number of SAS requests to Table storage service or the specified API operation that returned a SASNetworkError.

Tables Network Errors Percentage The percentage of requests that failed with a NetworkError.

Successful Requests

Tables Requests to Blobs The number of successful requests made to Table storage service or the specified API operation.

Tables Anonymous Successful Requests The number of successful anonymous requests made to Table storage service or the specified API operation.

Tables SAS Successful Requests The number of successful Shared Access Signature (SAS) requests made to Table storage service or the specified API operation.

The percentage of successful requests.


Tables Successful Requests Percentage Note that if there are no requests made against storage, the value of the PercentSuccess metric will be zero. If you are monitoring
PercentSuccess, you will also want to ensure that the value of the TotalRequests metric is greater than zero.

Files

Parameter Description

Throughput

The amount of ingress data, in MB. This number includes ingress from an external client into Azure Storage as well as ingress within
Files Total Ingress
Azure.

The amount of egress data, in MB. This number includes egress from an external client into Azure Storage as well as egress within
Files Total Egress
Azure. As a result, this number does not reflect billable egress.

The number of requests made to File storage service or the specified API operation. This number includes successful and failed
Files Total Requests
requests, as well as requests which produced errors.

Files Total Billable Requests The number of billable requests to Files

Files Data Collected Time The time at which files performance metrics data was stored in Azure Diagnostics.

Latency

The average end-to-end latency of successful requests made to File Storage Service or the specified API operation, in milliseconds. This
Files Average End-To-End Latency value includes the required processing time within Azure Storage to read the request, send the response, and receive acknowledgment
of the response.

The average latency used by Azure Storage to process a successful request, in milliseconds. This value does not include the network
Files Average Server Latency
latency specified in AverageE2ELatency.

Requests Failed- Throttling Errors

Copyright © 2014 Zoho Corp. Page 177


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Files Throttling Errors The number of authenticated requests to File storage service or the specified API operation that returned a ThrottlingError.

Files Anonymous Throttling Errors The number of anonymous requests to File storage service or the specified API operation that returned an AnonymousThrottlingError.

Files SAS Throttling Errors The number of SAS requests to File storage service or the specified API operation that returned a SASThrottlingError.

Files Throttling Error Percentage The percentage of requests that failed with a throttling error.

Requests Failed – Timeout Errors

Files Client Timeout Errors The number of authenticated requests to File storage service or the specified API operation that returned a ClientTimeoutError.

The number of anonymous requests to File storage service or the specified API operation that returned an
Files Anonymous Client Timeout Errors
AnonymousClientTimeoutError.

Files SAS Client Timeout Errors The number of SAS requests to File storage service or the specified API operation that returned an SASClientTimeoutError.

Files Server Timeout Errors The number of authenticated requests to File storage service or the specified API operation that returned a ServerTimeoutError.

The number of anonymous requests to File storage service or the specified API operation that returned an
Files Anonymous Server Timeout Errors
AnonymousServerTimeoutError.

Files SAS Server Timeout Errors The number of SAS requests to File storage service or the specified API operation that returned an SASServerTimeoutError.

Files Percent Timeout Errors The percentage of requests that failed with a timeout error. This number includes both client and server timeouts.

Requests Failed – Other Client Errors

Files Client Other Errors The number of authenticated requests to File storage service or the specified API operation that returned a ClientOtherError.

Files SAS Client Other Errors The number of SAS requests to File storage service or the specified API operation that returned an SASClientOtherError.

Files Anonymous Client Other Errors The number of anonymous requests to File storage service or the specified API operation that returned an AnonymousClientOtherError.

Files Client Other Error Percentage The percentage of requests that failed with a ClientOtherError.

Requests Failed – Other Server Errors

Files Server Other Errors The number of authenticated requests to File storage service or the specified API operation that returned a ServerOtherError.

Files Anonymous Server Other Errors The number of anonymous requests to File storage service or the specified API operation that returned an AnonymousServerOtherError.

Files SAS Server Other Errors The number of SAS requests to File storage service or the specified API operation that returned an SASServerOtherError.

Files Server Other Error Percentage The percentage of requests that failed with a ServerOtherError.

Requests Failed – Authorization Errors

Files Authorization Errors The number of authenticated requests to File storage service or the specified API operation that returned an AuthorizationError.

Copyright © 2014 Zoho Corp. Page 178


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

The number of anonymous requests to File storage service or the specified API operation that returned an
Files Anonymous Authorization Errors
AnonymousAuthorizationError.

Files SAS Authorization Errors The number of SAS requests to File storage service or the specified API operation that returned an SASAuthorizationError.

Files Authorization Errors Percentage The percentage of requests that failed with an AuthorizationError.

Requests Failed – Network Errors

Files Network Errors The number of authenticated requests to File storage service or the specified API operation that returned a NetworkError.

Files Anonymous Network Errors The number of anonymous requests to File storage service or the specified API operation that returned an AnonymousNetworkError .

Files SAS Network Errors The number of SAS requests to File storage service or the specified API operation that returned a SASNetworkError.

Files Network Errors Percentage The percentage of requests that failed with a NetworkError.

Successful Requests

Files Requests to Blobs The number of successful requests made to File storage service or the specified API operation.

Files Anonymous Successful Requests The number of successful anonymous requests made to File storage service or the specified API operation.

Files SAS Successful Requests The number of successful Shared Access Signature (SAS) requests made to File storage service or the specified API operation.

The percentage of successful requests.


Files Successful Requests Percentage Note that if there are no requests made against storage, the value of the PercentSuccess metric will be zero. If you are monitoring
PercentSuccess, you will also want to ensure that the value of the TotalRequests metric is greater than zero.

Queues

Parameter Description

Throughput

The amount of ingress data, in MB. This number includes ingress from an external client into Azure Storage as well as ingress within
Queues Total Ingress
Azure.

The amount of egress data, in MB. This number includes egress from an external client into Azure Storage as well as egress within
Queues Total Egress
Azure. As a result, this number does not reflect billable egress.

The number of requests made to Queue storage service or the specified API operation. This number includes successful and failed
Queues Total Requests
requests, as well as requests which produced errors.

Queues Total Billable Requests The number of billable requests to Queues

Queues Data Collected Time The time at which queues performance metrics data was stored in Azure Diagnostics.

Latency

Copyright © 2014 Zoho Corp. Page 179


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

The average end-to-end latency of successful requests made to Queue or the specified API operation, in milliseconds. This value
Queues Average End-To-End Latency includes the required processing time within Azure Storage to read the request, send the response, and receive acknowledgment of the
response.

The average latency used by Azure Storage to process a successful request, in milliseconds. This value does not include the network
Queues Average Server Latency
latency specified in AverageE2ELatency.

Requests Failed- Throttling Errors

Queues Throttling Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a ThrottlingError.

Queues Anonymous Throttling Errors The number of anonymous requests to Queue storage service or the specified API operation that returned an AnonymousThrottlingError.

Queues SAS Throttling Errors The number of SAS requests to Queue storage service or the specified API operation that returned a SASThrottlingError.

Queues Throttling Error Percentage The percentage of requests that failed with a throttling error.

Requests Failed – Timeout Errors

Queues Client Timeout Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a ClientTimeoutError.

The number of anonymous requests to Queue storage service or the specified API operation that returned an
Queues Anonymous Client Timeout Errors
AnonymousClientTimeoutError.

Queues SAS Client Timeout Errors The number of SAS requests to Queue storage service or the specified API operation that returned an SASClientTimeoutError.

Queues Server Timeout Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a ServerTimeoutError.

The number of anonymous requests to Queue storage service or the specified API operation that returned an
Queues Anonymous Server Timeout Errors
AnonymousServerTimeoutError.

Queues SAS Server Timeout Errors The number of SAS requests to Queue storage service or the specified API operation that returned an SASServerTimeoutError.

Queues Percent Timeout Errors The percentage of requests that failed with a timeout error. This number includes both client and server timeouts.

Requests Failed – Other Client Errors

Queues Client Other Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a ClientOtherError.

Queues SAS Client Other Errors The number of SAS requests to Queue storage service or the specified API operation that returned an SASClientOtherError.

The number of anonymous requests to Queue storage service or the specified API operation that returned an
Queues Anonymous Client Other Errors
AnonymousClientOtherError.

Queues Client Other Error Percentage The percentage of requests that failed with a ClientOtherError.

Requests Failed – Other Server Errors

Queues Server Other Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a ServerOtherError.

The number of anonymous requests to Queue storage service or the specified API operation that returned an
Queues Anonymous Server Other Errors
AnonymousServerOtherError.

Copyright © 2014 Zoho Corp. Page 180


Applications Manager User Guide
Applications Manager User Guide Microsoft Azure

Parameter Description

Queues SAS Server Other Errors The number of SAS requests to Queue storage service or the specified API operation that returned an SASServerOtherError.

Queues Server Other Error Percentage The percentage of requests that failed with a ServerOtherError.

Requests Failed – Authorization Errors

Queues Authorization Errors The number of authenticated requests to Queue storage service or the specified API operation that returned an AuthorizationError.

The number of anonymous requests to Queue storage service or the specified API operation that returned an
Queues Anonymous Authorization Errors
AnonymousAuthorizationError.

Queues SAS Authorization Errors The number of SAS requests to Queue storage service or the specified API operation that returned an SASAuthorizationError.

Queues Authorization Errors Percentage The percentage of requests that failed with an AuthorizationError.

Requests Failed – Network Errors

Queues Network Errors The number of authenticated requests to Queue storage service or the specified API operation that returned a NetworkError.

Queues Anonymous Network Errors The number of anonymous requests to Queue storage service or the specified API operation that returned an AnonymousNetworkError .

Queues SAS Network Errors The number of SAS requests to Queue storage service or the specified API operation that returned a SASNetworkError.

Queues Network Errors Percentage The percentage of requests that failed with a NetworkError.

Successful Requests

Queues Requests to Blobs The number of successful requests made to Queue storage service or the specified API operation.

Queues Anonymous Successful Requests The number of successful anonymous requests made to Queue storage service or the specified API operation.

Queues SAS Successful Requests The number of successful Shared Access Signature (SAS) requests made to Queue storage service or the specified API operation.

The percentage of successful requests.


Queues Successful Requests Percentage Note that if there are no requests made against storage, the value of the PercentSuccess metric will be zero. If you are monitoring
PercentSuccess, you will also want to ensure that the value of the TotalRequests metric is greater than zero.

Copyright © 2014 Zoho Corp. Page 181


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Windows Azure Cloud Service Monitoring (Classic)

Applications Manager's Windows Azure monitor enables users to collect diagnostic data for the applications deployed in Windows
Azure platform. Windows Azure is monitored using REST API to discover the list of deployed applications and get the performance
counters based on the Role instances of the service.

With Windows Azure monitoring capabilities in ManageEngine Applications Manager, you can:

● Discover Windows Azure applications and all its roles instances.


● Collect and monitor performance information based on role instances.
● Collect and monitor Windows Azure Event Logs, Trace Logs and Diagnostic Infrastructure Logs

Adding a Windows Azure application will include all the Hosted Services, deployments and its roles instance based on the Storage
account. The hosted services and deployments will be created as a group.

● Creating a Windows Azure Monitor.


● Monitored Parameters

Creating a Windows Azure Monitor in Applications Manager :

Prerequisites: To add Windows Azure in Applications Manager, you must first export your Windows Azure Managed Certificates
file (eg., testcertificate.pfx) and the password of the pfx file. To export your Windows Azure Managed Certificates file , invoke the
batch script exportCertificateToAppManager.bat in the <Applications Manager Home>bin directory.

To create a new Windows Azure monitor, follow the steps given below:
1. Click on the New Monitor link in the Applications Manager web client.
2. Enter the Subscription ID for your Windows Azure account. (Note: Subscription ID can be obtained by signing into
windows.azure.com using your windows live id. Then click Hosted Service and navigate to Storage & CDN, then to Storage
Accounts)
3. Enter the Account Name and Account key of your Windows Azure Storage account.
4. Check the checkbox if your service is https-enabled.
5. Specify a Timeout interval in seconds
6. Specify the Polling Interval in minutes
7. If you are adding a new monitor from an Admin Server, select a Managed Server.

Copyright © 2014 Zoho Corp. Page 182


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Note: Before creating a new Windows Azure monitor, you have to configure proxy settings under 'Admin' tab.

Creating and deploying Management Certificates in Azure

● Login to the machine where you have installed Windows Azure SDK and IIS 7.
● To load the IIS 7 Management console, go to the Control Panel, select Administrative Tools and then IIS Manager.
● In the IIS section of the center pane, double-click Server Certificates.
● Click Create Self-Signed Certificate in the Actions panel.
● Enter a name for the file.
● Close the IIS Manager and open the Certificate Manager.
● Under Trusted Root Certification Authorities, open Certificates.
● Right-click your certificate, choose All Tasks and Export. The Certificate Export Wizard appears. Click Next.

You can export the certificate with or without a private key. First, export the certificate without a private key to be uploaded to
Windows Azure Portal. Then export the certificate again with a private key to be used in Service Management API.

Exporting the certificate without a private key:

● When the Certificate Export Wizard appears, Click Next.


● On the Export Private Key page, click No.
● Select the CER file format and click Next.
● Enter a name and click Next.
● Click Finish to start the export process.

Exporting the certificate with a private key:

● When the Certificate Export Wizard appears, Click Next.


● On the Export Private Key page, click Yes, export the private key.
● Keep the default value, then click Next.
● Specify a password for protecting your private key and click Next.
● Specify a name for the PFX file and click Next.
● Click Finish to start the export process.

The .cer file can be uploaded in the Windows Azure portal and the .pfx file which has the private key can be used in Applications
Manager.

Copyright © 2014 Zoho Corp. Page 183


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Monitored Parameters

Windows Azure platforms are monitored based on the parameters or the attributes listed below. You can also configure thresholds
to the numerical attributes based on these details and get notified when the thresholds are violated.

The Availability tab shows the availability history for Azure Role instances for the past 24 hours or 30 days. The Performance tab
shows some key performance indicators such as CPU, Memory Utilization, Exceptions thrown and Health History along with heat
charts for these attributes. This tab also shows the health status and events for the past 24 hours or 30 days.

The List view displays all the Azure role instances along with an overall idea of their availability and health status. The list view also
enables you to perform bulk admin configurations. You can click on the individual role instances to view detailed performance
metrics.

Click on the monitor listed in the Availability tab to view detailed performance metrics of the Azure role instances. These metrics
are categorized into 4 different tabs for easy understanding:

● Overview
● Event Logs
● Trace Logs
● Diagnostic Infrastructure Logs

Overview :

This tab provides a high-level overview of your Azure account as well as information about the Role instances present in this
account.

Parameter Description

Monitor Information

Name The name of the Windows Azure account.

Copyright © 2014 Zoho Corp. Page 184


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Type Denotes the type you are monitoring.

Health Denotes the health (Clear, Warning, Critical) status of the Windows Azure account.

Associated Groups Denotes the monitor groups associated with the Windows Windows Azure monitor.

Last Polled at Specifies the time at which the last poll was performed

Next Poll at Specifies the time at which the next poll will be performed

CPU Utilization Usage of CPU resources or the amount of work handled by CPU

Memory Available

Memory Utilization Memory Usage

Time Spend in Garbage Collection

Exceptions Thrown Number of exceptions thrown per second

• Number of times Application Restarted


• Request Execution Time
• Number of Requests Disconnected
• Number of times Worker Process Restarted
• Total Number of Requests
ASP .NET System Performance Counters • Number of Requests executed per second
• Current Requests
• Recent Request Waited Time
• Number of Queued Request waiting for service
• Number of Requests Rejected

• Number of TCP Connections failed


• Number of TCP Connections Established
TCP Connections
• Number of TCP Connections Reset

TCP Segment Connections TCP segments sent per sec

• Total number of Bytes received per second for all interfaces


Network Traffic • Total number of Bytes sent per second for all interfaces

• Total number of bytes send and received per sec for VM Bus Network Adapter
• Total number of bytes received per second for VM Bus Network Adapter
Network Traffic VM Bus Adapter
• Total number of bytes sent per second for VM Bus Network Adapter

Monitoring Logs in Applications Manager :

Event Logs, Trace logs and Diagnostic infrastructure logs of the Windows Azure Role Instances can be monitored by defining
rules. On clicking Windows Azure Log rule configuration, you can create rules for Diagnostic Infrastructure and Trace logs.

When the Azure Role Instance starts it data collection, all the logs associated to the role instance will be matched the rule. On
matching the rule, an event will be generated and the log entry will be persisted in the database. The log information will be

Copyright © 2014 Zoho Corp. Page 185


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

available in the GUI of the Azure role instance

Event Logs:

On clicking Event Log Rules configuration tab, you can create rules on various category such as Application, System, Application,
Security, DNS Server, File replication service and Directory service.

You can view Windows Azure Event Log Details like:

Parameter Description

Rule Name Specify the name of the rule.

Provider Guid Globally unique identifier of the provider

Provider Name Provider name of the event.

Event ID The identifier of the event.

Level This field provides the severity of the event.

Process ID The process ID of the event.

Thread ID The thread ID of the event.

Channel You can get notified by the events from channels like Applications, Security, System, etc.

Generated Time The time at which the event is generated.

Trace logs:

In the trace logs tab, you can view Windows Azure Event Log Details like:

Copyright © 2014 Zoho Corp. Page 186


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

Parameter Description

Rule Name Specify the name of the rule.

Event ID The identifier of the events

Level This field provides the severity of the log event.

Process ID The process ID of the log.

Thread ID The thread ID of the log.

Generated Time The time at which the event is generated.

Diagnostic infrastructure logs:

In the Diagnostic infrastructure logs tab, you can view Windows Azure Diagnostic Infrastructure Log Details like :

Parameter Description

Rule Name Specify the name of the rule.

Error Code Specify the error code of the log.

Level This field provides the severity of the log event.

Process ID The process ID of the log.

Thread ID The thread ID of the log.

Function Specify the function of the log event.

Line Specify the line containing the function.

MD Result Specify the MDetect result of the log.

Event Generated Time The time at which the event is generated.

Copyright © 2014 Zoho Corp. Page 187


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

OpenStack Monitoring

Prerequisites for monitoring OpenStack:

To create a new OpenStack monitor, follow the steps given below:


1. Click on New Monitor link.
2. Select OpenStack under Cloud Apps category.
3. Specify the Display Name of the OpenStack server
4. Enter the Base Authentication URL of the OpenStack for accessing the OpenStack. The sample URL is:
http://openstack:5000/
5. Enter the Tenant Name. Tenant Name is the project name of the OpenStack
6. Choose the Credential Details either use below credentials or select from credential list
7. Enter the Username and Password of the OpenStack.
8. Select Need Proxy, if you require to give proxy server details
9. Specify the Polling Interval in minutes.
10. Choose the Monitor Group with which you want to associate the Amazon monitor to, from the combo box (optional). You
can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers the OpenStack server from the network and starts monitoring it.

Note: If you require proxy server, you have to configure proxy settings under 'Admin' tab.

Applications Manager automatically discovers all the OpenStack instances under your OpenStack account. You can then enable
monitoring for those instances and images as per your requirement.

Monitored Parameters

Click on the monitor listed in the Availability tab to view detailed performance metrics of the OpenStack instance. These metrics are
categorized into 2 different tabs for easy understanding. Here is an explanation of the metrics shown in these tabs:

1) Instances

Copyright © 2014 Zoho Corp. Page 188


Applications Manager User Guide
Applications Manager User Guide Cloud Apps

This tab provides a high-level overview of your OpenStack account as well as information about the OpenStack instances present in
this account.

Parameter Description

Instances

Name The name of the instance

Status Current status of the instance

Image A virtual machine image is a single file which contains a virtual disk that has a bootable operating system installed on it

Images

Name Name of the image

Status Current status of the image

Visibility

Visibility is orthogonal of ownership

Disk Format The disk format of a virtual machine image is the format of the underlying disk image

Size The size of the image data, in bytes

Copyright © 2014 Zoho Corp. Page 189


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Custom Monitors

The following custom monitors are available in Applications Manager.

● JMX / SNMP Dashboard


● File / Directory Monitor
● Windows Performance Counters
● Script Monitors
● Database Query Monitor

JMX / SNMP Dashboard

These custom monitors provide a real-time, correlated view of the entire application stack improving J2EE/J2SE application
performance by monitoring its data sources such as JMX MBean source and SNMP Agents.

JMX / SNMP Dashboard is a logical grouping that consist of data sources such as JMX MBean and SNMP OID. It can have both the JMX
and SNMP attributes.Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the
Health Status and events for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Building JMX
/ SNMP Dashboard involves

● Creating JMX / SNMP Dashboard and adding it to a specific Monitor Group


● Adding Attributes

The advantage of creating the dashboard is to monitor various data source at a common place.

Creating a JMX / SNMP Dashboard

For example, you have a Java application with built-in manageability using JMX and any application that has an SNMP interface,
then they are managed by building JMX / SNMP Dash Board.

To create a JMX / SNMP Dash Board, follow the given steps:


1. Select New Monitor. Choose JMX / SNMP Dashboard.

Copyright © 2014 Zoho Corp. Page 190


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

2. Provide any name for the custom monitor and a description.


3. Click Add JMX / SNMP Dashboard to create the custom monitor. This opens a screen that allows you to add attributes for
custom monitors.

The next step is to build the custom monitor to enable monitoring your data sources. Refer to the Custom Monitors section of
Monitor Information, for more details on the same.

You need to discover JMX MBeans and SNMP Agent data source to add attributes. The following are the JMX MBean resources whose
MBean attributes are monitored by Applications Manager using Custom Monitor.

Troubleshoot: Having trouble in monitoring custom applications? Refer the online Troubleshooting section.

Adding Attributes

Once you add a JMX / SNMP Dashboard, the Add Attributes option is available. Click that to add custom attributes to your Custom
Monitor. The following are the data source for which custom monitors are built by Applications Manager. Click on the topics to view
the steps required to add the respective data sources or attributes to the Custom Monitor.

● Adding JMX MBean Attributes.


● Adding SNMP OID Attributes.

Copyright © 2014 Zoho Corp. Page 191


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Adding JMX MBeans Attributes

The following are the JMX MBean resources whose MBean attributes are monitored by Applications Manager using Custom Monitor:

● JMX [MX4J / JDK 1.5]


● WebLogic Server
● JBoss Server

To add the attributes, follow these steps:


1. In the Add Attributes screen, select the JMX MBean resource from the combo box and click Add. You can also discover a
resource using Add Monitorprovided alongside the combo box and add them to the list of resources.
2. Select the domains and click Show MBeans to list all the MBeans of those domains. You can also specify some filter criteria
to match the MBean names. Alternatively, you can add the MBean atrributes directly, by choosing the Add the MBean
attributes directly option. You can enter the MBean ObjectName, Attribute Name and Attribute Type (String / Numeric) and
then add that attribute to be monitored. For Numeric attributes, you can edit and set whether you want to view the values as
Counters or Non Counters. From the next poll onwards, the latest type would be displayed.
3. On clicking Show MBeans button, you get the list of all the MBeans. Select the MBean (all attributes) or only the required
attribute(s) by enabling the check box provided alongside. In case of tabular MBeans, select the attribute (all columns) or only
the required columns.
4. Click Add Attributes. All the selected attributes will be listed with their details. Note: You have an option to enable / disable
reports for scalar numerical attributes, which is indicated through the above images in the Reports column. Refer
to Viewing Reports for more details on report generation.
5. Click the Back to Details Page button to view the newly created Custom Monitor. This screen lists all the attributes added.
6. If you want to add or delete attributes, click Add or Delete Custom Attributes.

Note: If the JMX data source is WebLogic Server 6.1 or WebLogic 6.1 sp1, you have to specify the full object name in the filter criteria to get the MBean attributes. This is
because of the implementation bug in WebLogic 6.1.

However, versions WebLogic 6.1 SP2 and above do not have this problem.

Copyright © 2014 Zoho Corp. Page 192


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Note: Steps to Create JMX Notification Listener (JMX [MX4J / JDK 1.5])
• In the JMX [MX4J / JDK 1.5] Monitor page, click on the 'Create new JMX Notification Listener' link.

• The first step is to choose the Domain of the JMX Agent. After selecting the Domain, Click on 'Show MBeans' to view the MBeans that belong to the selected Domain.

• The second step is to choose the Mbeans from the list that is shown.

• The third step will be to create the new JMX Notification Listener. Enter the Name and select the status of the Listener as enabled or disabled. Set the severity of the
Alarm that will be generated once a JMX notification is received, as Critical/Warning/Clear. Associated actions that need to be executed when the notification is received
can be chosen from the list of actions configured.

• Clicking on 'Save' will have a JMX Notification Listener configured, which would generate alarms of the configured severity and execute actions.

Copyright © 2014 Zoho Corp. Page 193


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Adding SNMP OID Attributes

Once the Custom Monitor is created, you have to add the required SNMP attributes added to it. Follow these steps:
1. Click on Add attributes link.
2. It opens up Customize screen - Select a SNMP monitor from the combo box for adding the attributes. Click add.
3. Mib Browser opens up - select the MIB that contains the attribute to be added to the Custom Monitor.
4. Select the attributes that you want to monitor. Click Add to add the selected attributes.

Note:
• The MIB, whose attributes are required to be added to the Custom Monitor, must be present in the <Applications Manager
Home>/working/mibs directory of Applications Manager. To add the MIBs to the directory, use Add Mib Form.

• The MIB must be implemented in the SNMP Agent being monitored.

Copyright © 2014 Zoho Corp. Page 194


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

File / Directory Monitor

To create a file/directory monitor, follow the steps given below:

● From the New Monitor tab, select File / Directory Monitor.


● Provide a Display Name for the monitor.
● Select whether it is a File or Directory monitor.
● Specify whether the File / Directory to be monitored is in the Local or Remote Server.
● If it is in the Local server, give the absolute path to the file / directory. If it is in a Remote server, select the Host Name
(remote server) from the combo box or you can create a new host (by giving a new host name / IP address, username and
password of the host) and the file / directory's absolute path. This new host thus added can be deleted by clicking on the
Delete Host link. Host names already present and configured for server monitoring cannot be deleted in this manner. Also
select the Mode Of Monitoring (WMI for Windows, Telnet/SSH for Linux), the port and Command Prompt if required.
● If the path that you have selected is in a Remote server,you can either enter the credential details like user name,
password, the command prompt or select credentials from a Credential Manager list. Enter the respective port.
● For a File monitor, select the Do Content Check box if you wish to run a content check. Enter the string for which you want to
check content matching in Check Content text box. Once any/ all of these contents match, the monitor status becomes
up/down. You can perform content check for regular expressions by checking the Regular Expressions checkbox. (Regex
Guide)

Note: Applications Manager cannot perform multiple regex checks. Checks can be done only for non-regex matches by
separating strings with a comma.

If the Monitor Status is selected as 'Down', the following conditions can be used to make the status Up. If the Monitor status is
selected as 'Up', the following conditions can be used to make the status Down.

Conditions:

There are two conditions to configure monitor status:

Example:

For a file monitor, if the Monitor status is marked 'Down if any/ all content(s) matched' and the content in the Check Content
box is 'error, down, problem', then the monitor status will become down if any of these content match. In order to make the
monitor status up, one of the following conditions has to be selected.

If, the option 'If the above content(s) is/ are not matched' is selected, then the monitor status will become up if the above
content is not matched.

Copyright © 2014 Zoho Corp. Page 195


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

If, the option 'If any/ all content(s) matched' is selected, then the content has to be specified for which the monitor will become
up. Example, 'success, up, fine'. Once any/ all of these content(s) are matched, the monitor will become up. (If this option is
chosen and none of the contents match, the monitor will continue to remain down.)

● If the above content(s) is/ are not matched: When this option is chosen, the monitor status will become up/ down if none
of the contents in the above Check Content box match.
● If any/ all of the contents to make monitor status up/ down are matched: Enter the string for which you want to check
content matching in the text box given. If any/ all of these contents match, the monitor status will become up/ down. If none of
the contents match, the monitor status will continue to remain in the existing state.
● Choose between the File Parsing Options to perform content check to Only appended content or the Whole File. Also,
you can set the monitor status to UP/DOWN if ANY/ALL of the contents/Regular Expressions are matched. For a Directory
monitor, select the Show SubDirectory Count checkbox to display the subdirectory count of a directory.
● For both File and Directory monitor, you can select the Do file/directory age check check box if you wish to display the
Monitor Status to UP/DOWN if the FILE/DIRECTORY is MODIFIED/NOT MODIFIED within a certain time.
● Enter the Polling interval time period in minutes and the Timeout in seconds.
● If you are adding a new monitor from an Admin Server, select a Managed Server.
● Choose the Monitor Group from the combo box to which you want to associate the Monitor (optional). You can choose
multiple groups to associate your monitor.
● Click Add Monitor(s). This discovers the file / directory from the network and starts monitoring them.

Applications Manager uses this File / Directory Monitor to monitor the changes in the selected files and directories. Availability tab,
gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events for the past 24
hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed, to view the
following information.

File Monitor Checks

File size the size of the file

File Size changed the % change in file size

Content string that needs to be monitored

Last Modified Time the time at which the file was last modified

Directory Monitor Checks

Directory Size the size of the directory

Change in Directory Size the % change in directory size

Total No.of
the subdirectory count of a directory
Subdirectories

Copyright © 2014 Zoho Corp. Page 196


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Total No. of Files the total count of files in the directory

Last Modified Time time of last modification.

Important Note:
• File Name / Directory Name should be specified with Absolute Path. (eg) C:Desktoptest.txt (or) /home/test/test.txt.

• Pattern matching for file names is supported in both windows and Linux servers. If we get the multiple files for the pattern
matching, monitoring is carried out for the last modified file.

• In case of Multiple Checks for Content in File Monitoring specify them as comma separated. (eg) NullPointerException,File
System Monitor,testString

• Support for configuring files which will be created on a daily basis.Say for example you can configure filename as
localhost.$YYYY-$MM-$DD.log.

• Ensure that the file you are monitoring has Read Permission.

• Content Matching in File Monitoring is supported in both Windows and Linux Servers.

• Displaying the subdirectory count of a directory is configurable

Copyright © 2014 Zoho Corp. Page 197


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Database Query Monitor

Database Query Monitor is used to monitor a single query or a set of queries for any given database. This SQL based query monitor
allows user to monitor the status of that particular query.

To add Database Query Monitor, follow the given steps:


1. Click New Monitor. Choose Database Query Monitor.
2. Enter the Display Name of the Monitor.
3. Enter the Host Name of the Monitor on which the database is running.
4. Enter the Port number.
5. Select the DB type for which the query is being executed.
6. Enter the Username and Password of the database server.
7. Enter the Database name.
8. Select whether you would prefer Query Output by choosing the Yes or No radio button.
9. Enter the Query. Please note that the number of queries is limited to five queries. Also, note that the delimiter for a query
is new line.
10. Enter the Polling Interval. By default, it is 5 minutes.
11. If you are adding a new monitor from an Admin Server, select a Managed Server.
12. Choose the Monitor Group from the combo box with which you want to associate Database Query monitor.

Database Query Monitor is used to monitor a single or a specific set of queries for any given database.

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Using a single query or a given set of queries, you can monitor the status of any given database using Applications Manager
Database Query monitor. Queries are the best way to find out whether your database is up and running 24x7. In business
enterprises such as an online store, there are a number of applications and databases used for e-commerce. Any interruption in
such an environment could mean only one thing: loss of revenue.

The execution of such a query or a set of queries can be automated by setting the polling interval. By fixing the polling interval,
user can automate this process and the results are obtained at the end of the polling. The result includes execution time (time
taken by the query to provide results) and also displays any error that may occur during regular polling intervals. These errors help
identify any issue that may occur with the database.

Copyright © 2014 Zoho Corp. Page 198


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Let us consider an example. Many enterprise environment run critical applications which need to be up and running 24x7. Let us
assume, the status of such applications are maintained in a "APPLICATION_STATUS" table. Using Database Query monitor, the user
shall be able to send a select set of queries to that database to find out if they are operational or not.

|-----------------------------------------------------------|

| APPLICATIONS_STATUS |

|-----------------------------------------------------------|

| APPLICATIONS_NAME | Status |

|-----------------------------------------------------------|

| PURCHASE | OK |

| CRM | CRITICAL |

| PAYROLL | OK |

| LEADS | OK |

|-----------------------------------------------------------|

SELECT * APPLICATIONS_STATUS

By executing the above command using Database Query monitor, the user will then obtain the list of applications that are running
along with its status. The user can then identify the applications whose status is 'Critical' and then carry out necessary action by
configuring Alarms in Applications Manager. This action could be in the form of creating a ticket, or executing a script to rectify the
problem.

Copyright © 2014 Zoho Corp. Page 199


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Database Query monitor can also be used to identify any bottle necks in the networks which are linked to several databases and
help remove them by identifying the correct database which has the issue. This bottle neck issue can arise because there is a
problem with the one of applications or with the databases. Using Database Query monitor, user can then execute a given set of
queries and analyze the result which provides a clear indication of the error that has caused such an occurance. The result includes
the execution time (time taken by the query to generate the result). If the execution time is above a certain pre-assigned threshold,
then the issue is with the database or if the result is below the pre-assigned threshold, then the issue is elswhere.

The Database Query monitor currently supports queries of the following databases:
• DB2
• Informix
• Ingres
• MS SQL
• MySQL
• Oracle
• Oracle RAC
• Postgres
• Sybase

Applications Manager also provides the ability to compare various column value in the output by attributes types. Option to Enable
or Disable Reports is provided.

Note: Please note that the number of queries is limited to five queries. Total number of rows shown in the output is limited
to 50 rows.

Copyright © 2014 Zoho Corp. Page 200


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Script Monitors

● Script Monitor - An Overview


● Creating a new Script Monitor
● Sample Input
● Sample Output
● Monitored Parameters
● Examples -
● Sample Scalar Usecase
● Sample Table Usecase
● Other -
● Overriding Availability and Response Time of the Script
● Monitoring SNMP OIDs
● Rest API for getting the remote hostname for Script monitor
● Custom Monitor Types

Script Monitor - An Overview

Custom script monitoring can be a tedious task if the output of the scripts that are run, are to be monitored manually. Applications
Manager provides with script monitoring functionality to ease the process by automatically monitoring the output of in-house
custom scripts (Windows/Linux) and by creating alarms as per the configuration. Script monitor allows you to monitor the script that
is present in the local system or in the remote system, transfers the output to an Output File, parses the output and executes the
actions configured.

Applications Manager provides Script Monitoring functionality to automatically monitor the output of ad-hoc Windows/Linux/Solaris
scripts that are used in-house.

● During creation of a new script monitor, you must give the location of the custom script (local /
remote), attributes (numeric/string) to be monitored, the Output File in which the output is going to be redirected and
the polling interval.
● Based on the polling interval, Applications Manager executes the script.
● The script will transfer its output to the Output File configured. The output of the script should be in a Key=Value format
where '=' can be any delimiter.
● Applications Manager parses the Output File and executes the actions configured. It enables you to alert an Administrator or
automatically take corrective actions by way executing other OS scripts.

Copyright © 2014 Zoho Corp. Page 201


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

● Reports for the attributes configured would be shown as graphs. Option to enable or disable reports is given.

Creating a new Script Monitor

To add a Script Monitor, follow the given steps:


1. Click New Monitor. Choose Script Monitor.
2. Enter the Display Name of the Monitor.
3. Specify if the script to be monitored is present in the Local Server or in a Remote Server.
4. If it is Local Server, Give the absolute path of the Script to be Monitored and also the absolute path of the directory from
which the script should be executed. The execution directory should in the same hierarchy of the 'script to be monitored'
directory structure.
5. Select the script location as command or script / batch file.
6. Specify the absolute path of the script / command to be monitored.
7. Specify the absolute path of the execution directory from which the script should be executed.. The execution directory
should in the same hierarchy of the script to be monitored directory structure.
8. Check the Output Settings checkbox, to configure output settings
● Check the Get output from file checkbox and specify the path of the file. If the checkbox is not checked, Applications
Manager takes the output from the output stream.
● Enter the String and Numeric attributes (one attribute per line).
● Enter the value of Delimiter used in the output file. By default, it is "=". If you don't specify a delimiter, then 'space' would
be considered as a delimiter.
9. If you want to monitor a tabular Output file, enter the details of the tables - Name, String and Numeric column
attributes, delimiter and also specify which attribute is the Unique Column.
● Inorder to identify a tabular output file, execute the following commands before and after the actual script.
echo <--table <table-name> starts-->
[Script Commands]
echo <--table <table-name> ends-->
This would enable Applications Manager to identify the Output File's table.
● Even if you're using a command instead of a script as input, then the output of the command should be in the above format.
It is also mandatory to have the headers and footer in the command output as the first line in the file.
10. Specify the Arguments. For e.g., hostname 80 http
11. Set the Polling Interval. By default, it is 5 minutes
12. Specify the Timeout value in seconds. The value can be the maximum time taken by the script to execute.
13. In Linux, Specify the mode in which script should be executed. By default, it is "sh".
14. If the script is in a remote server, select the Host Name from the list
15. If the remote server is a new host, then enter the server's Host Name / IP Address. Choose the mode of monitoring
- Telnet or SSH.

Copyright © 2014 Zoho Corp. Page 202


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

16. Enter the User Name and Password of the server.


17. Enter the Port number - Default Telnet port no: 23, SSH: 22
18. Specify the command prompt value, which is the last character in your command prompt. Default value is $ and possible
values are >, #, etc.
19. Upon adding the script monitor, you can view the details of the newly added Script Monitor

Note

You must add "-encoding ascii" for output files created via powershell.

Tips

1. If you choose the Script Location as command:


● Command Length must not exceed 255 characters.
● Linux commands must not contain backslash ()
● Here is an example.
2. If you choose the Command type of script:
● Here is an example.
3. If you choose the Script Location as script:
● Any Script in a Local Windows server will be executed as, cmd /C [ScriptName] [Arguments] Example: cmd /C
D:testScript.bat hostname username password.
4. To execute a VBS, Powershell or any script that is not a batch file:
● The script should write the output to command prompt or file.
● You can also execute files by embedding them inside a Batch script and using the Batch script for monitoring. Here are
some examples.
5. You can use them directly by selecting "Command", without using another batch file:
C:windowssystem32cscript.exe D:testFile.vbs hostname username > outputfile.txt
6. Arguments can be used in the script.

Note: Remote Windows script monitoring is Not Supported.

Local & Remote Non-Windows Script Monitoring:

● Provide proper "Shell Type" for executing the scripts. By default "sh" is used.
● You can execute script directly as "Command":

Copyright © 2014 Zoho Corp. Page 203


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

sh ./test.sh

Note: The user must have permission to execute the script and read/write permission for Output file.

Examples

Command: netstat -an | grep "CLOSE_WAIT" | wc -l | awk '{print "CLOSE_WAIT=" $1}'

Examples

To Execute VBS files:


• To execute testFile.vbs, embed it inside a batch script testScript.bat
• Contents of testScript.bat file:

c:windowssystem32cscript.exe D:testFile.vbs > outputFile.txt


• Add testScript.bat for monitoring and use outputFile.txt to get Output.

Copyright © 2014 Zoho Corp. Page 204


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Examples

To Execute a Powershell file:


• To execute test.ps1, embed it inside a batch script testScript.bat
• Content of test.bat:

PowerShell.exe -NoProfile -ExecutionPolicy Bypass -Command


• Add test.bat file for monitoring and use outputFile.txt to get Output.

Note:
• PowerShell script must be executed with -NoProfile -ExecutionPolicy Bypass
• Need to add "-encoding ascii" for output files created via powershell.

Sample Input

Copyright © 2014 Zoho Corp. Page 205


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

To monitor a script interfacestatus.bat that creates a user defined table called InterfaceStats and user defined parameters
like DiskStatus, DiskErrors and No. ofProcess, in the output file interfacestatusoutput.txt

Copyright © 2014 Zoho Corp. Page 206


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

● In the Script Monitor creation form, give the absolute path of the script : c:interfacestatus.bat
● Under Output settings, give the absolute path of Output file: c:interfacestatusoutput.txt
● Give DiskStatus as the string attribute, No.ofProcess and DiskErrors are the numeric attributes with Delimiter "="
● If you want to monitor statistics in a table format , select Tables in output file.
● Here, we have the table InterfaceStats with the stats Name, IP, Status, In, Out where Name, IP, Status are string attributes;
In & Out are numeric attributes. TheDelimiter is the separater between the two column names -> space. If tab is the
delimiter, then give t . Usually tab will be the delimiter for sql queries results.
● Note: The starting tag of the table, InterfaceStats is "<--table InterfaceStats starts-->" and the end tag is "<--table
InterfaceStats ends-->". Also, the first line of the table should contain the attribute names. The attribute names or the column
names should also be separated by the same delimiter used to separate the data rows and that is specified as the column
delimiter. In this case, they are Name, IP, Status, In and out. The remaining lines between the start and end tag should
comprise of the actual data. Make sure that the delimiter for the table is unique and you should specify that as the column
delimiter.
● Unique Column is the attribute that doesn't repeat itself in the rows and identify the row by that value. Here it is IP.

Sample Output

DiskStatus=Up
No.ofProcess=1
DiskErrors=0

<--table InterfaceStats starts-->


Name IP In Out
eth0 192.168.1.1 123451 234567
eth1 192.168.1.2 345633 453267
<--table InterfaceStats ends-->

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Script Monitor under the Custom Monitors Table.
Displayed is the Script Monitor bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.

Copyright © 2014 Zoho Corp. Page 207


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

● List view enables you to perform bulk admin configurations.

Overriding Availability and Response Time of the Script

This option would be useful, if you want to override the response time measured for custom scripts using a defined value in the
output file. Applications Manager looks for few reserved keywords in the output file, if it matches then it will replace the
corresponding attribute.

For eg., if the script output looks like this,

script_availability=1 (Allowed values are 0 or 1. "0" refers to success. "1" refers to failure.)
script_message=Server is not running.
script_responsetime=10

Then, while parsing the output file, script_availability value will be taken and based on that the availability is calculated.The same is
the case for response time.

Examples:

Sample Scalar Usecase

Let's assume you want to monitor a script < filesystem.sh> present under /home/test-solaris/ in test-solaris machine. The
output from this script is dumped to output.txtfile present under the same directory. The format of output.txt is as shown
below :

SystemTemperature=37
TimeSinceLastReboot=30
TopPaginApp=sendmail
IOReads=1050

Setting up Script Monitor:

● Login to the Applications Manager Web Client.


● Click New Monitor. From the combo box, choose Script Monitor.
● For the Display Name give some name. For e.g FileSystem
● Choose whether the script to be monitored is present in the Local Server or in a Remote Server. If the script is in a Remote
Server, then make sure you put the script in the Remote Server.
● If it is Local Server/ Remote Server, give the absolute path of the Script to Monitor (/home/test-solaris/filesystem.sh) and also

Copyright © 2014 Zoho Corp. Page 208


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

the absolute path of the directory from which the script should be executed(/home/test-solaris/).
● Under Output Settings, give the Output file name (/home/test-solaris/output.txt) with absolute path. This is the file where the
output from the script is dumped.
● Enter the Name of the Non Numeric and Numeric attributes.

In the Numeric area, add

SystemTemperature
TimeSinceLastReboot
IOReads

In the String Attributes Text area, add :

TopPaginApp

● Enter the value of Delimiter (=) used in the output file. By default, it is "=". If you don't specify a delimiter, then 'space' would
be considered as a delimiter.
● Specify the additional Arguments (if required to pass to the script). For e.g., hostname 80 http
● Set the Polling Interval. By default, it is 5 minutes
● Specify the Timeout value in seconds. The value can be the maximum time taken by the script to execute.
● In Linux, Specify the mode in which script should be executed. By default, it is "sh".
● If the script is in a Remote Server, select the Host Name from the list
● If the remote server is a new host choose New Host, then enter the server's Host Name / IP Address (test-solaris). Choose
the mode of monitoring - Telnet orSSH.(Telnet)
● Enter the User Name(test) and Password(test) of the server.
● Enter the Port number - Default Telnet port no: 23, SSH: 22
● Specify the command prompt value, which is the last character in your command prompt. Default value is $ and possible
values are >, #, etc.
● Once all the values are entered select Add Monitor(s).

The success message should be displayed. Click Monitor Details > Script Monitor and go to the create script, to view the
details.

Note: AppManager uses either ANSI or UTF-8 encoding. Hence it is advised that you use the same format while writing
output to the file.

Sample Table Usecase

Let's assume you want to monitor a script <prustat.sh> present under /home/test-solaris/ in test-solaris machine. The
output from this script is dumped to output.txt file present under the same directory. The format of output.txt is as shown

Copyright © 2014 Zoho Corp. Page 209


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

below

<--table prustat starts-->


PID CPU Mem Disk Net COMM
7176 0.88 0.70 0.00 0.00 dtrace
7141 0.00 0.43 0.00 0.00 sshd
7144 0.11 0.24 0.00 0.00 sshd
3 0.34 0.00 0.00 0.00 fsflush
7153 0.03 0.19 0.00 0.00 bash
99 0.00 0.22 0.00 0.00 nscd
7146 0.00 0.19 0.00 0.00 bash
52 0.00 0.17 0.00 0.00 vxconfigd
7175 0.07 0.09 0.00 0.00 sh
98 0.00 0.16 0.00 0.00 kcfd
<--table prustat ends-->

Note: the table headers <--table prustat starts-->. This is mandatory and should follow the same format as mentioned.
Here "prustat" should be replaced by the Table Name explained below

Setting up Script Monitor

● Follow the same instructions as mentioned for Scalar till point 6


● Select Tables in output file check box
● For the Table Name provide some name(prustat). Note that this same should be present in the table header(<--table prustat
starts-->) in the output file.
● For the Numeric Attributes area provide the column names in the script output that are numeric: CPU, Mem, Disk, Net
● For the String Attributes provide the column names in the script output that are non numeric: PID, COMM
● For the Unique Column provide the column names that can identify a row data. This can be a single value or multiple value:
PID, COMM
● For the Column Delimiter provide the column separator. The default value is a space.
● In case you have scripts that output multiple tables then you can select More and configure the values.
● Once all the values are entered select Add Monitor(s).

You can use script monitor to monitor the SNMP OIDs

Please look at the steps below for creating a script monitor,

● Create a script file ( say script.sh ) under the /opt/ManageEngine/AppManager11/ directory


● Edit that file and type in the following content into that file,
snmpwalk -v 1 -c public app-w2k1 CPQHLTH-MIB::cpqHeFltTolPowerSupplyRedundant.0.1| awk '{ y = $1; x = $4 ; gsub(/[a-zA-
Z()]/, "", x)}
{print y " = " x}'>> output.txt
snmpwalk -v 1 -c public app-w2k1 CPQHLTH-MIB::cpqHeFltTolPowerSupplyRedundant.0.2 | awk '{ y = $1; x = $4 ; gsub(/[a-zA-

Copyright © 2014 Zoho Corp. Page 210


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Z()]/, "", x)}


{print y " = " x}' >> output.txt
● Click on "New Monitor" in applications manager and choose script monitor. Then create a new monitor using the following
parameters,
Script to Monitor </opt/ManageEngine/AppManager11/script.sh> Directory from which the script should be executed
</opt/ManageEngine/AppManager11/>
Under Output Settings,Output File </opt/ManageEngine/AppManager11/output.txt> Numeric Attributes <CPQHLTH-
MIB::cpqHeFltTolPowerSupplyRedundant.0.1>
<CPQHLTH-MIB::cpqHeFltTolPowerSupplyRedundant.0.2>
● Use the default parameters for configuring the remaining attributes.

REST API to get the HostName

This API gives host name for the given Script Monitor.

Sample Request:

http://[Host]:[Port]/AppManager/json/GetRemoteHost?apikey=[APIKEY]&resourceid=[RESOURCEID]

Request Parameters

The parameters involved in executing this API request are:

Field Description

The key generated using the Generate API Key option in the 'Admin'
apikey
tab.

resourceid The resource id of the monitor that needs to be polled.

Example:

http://app-windows:9090/AppManager/json/GetRemoteHost?apikey=095cb3835ff015b01a3b3a6c4ab2c38a&reso
urceid=10000293

Sample Output:

{"response":{"result":[{"hostname":"app-w7-64-
8"}],"uri":"/AppManager/json/GetRemoteHost"},"response-code":"4000"}

Copyright © 2014 Zoho Corp. Page 211


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Custom Monitor Types

Custom Monitor Types in Applications Manager allow you to associate a monitor type to the inhouse scripts, for monitoring your
own applications. You can define your own monitor types apart from the monitor types that are available by default. Know more.

Copyright © 2014 Zoho Corp. Page 212


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

Windows Performance Counters

To create windows performance counters in Applications Manager, follow the steps given below:
1. Select New Monitor. Choose Windows Performance Counters.
2. Provide Name for Windows Performance Counter.
3. Enter the Description for the counter.
4. Enter the Polling Interval for the counter.
5. If you are adding a new monitor from an Admin Server, select a Managed Server.
6. Select the Host Name from the combo box or you can create a new host (by giving the new host name / IP address,
username and password of the host)

Note:

Windows Performance Counters is currently supported for Windows Vista, Windows 7, Windows 8, Windows Server 2000,
2003, 2008 and 2012.

Applications Manager uses WMI (Windows Management Instrumentation) for monitoring Windows Performance

Counters. WMI gives preinstalled performance counter classes; each class describes an object in performance libraries.

For eg., the object that appears in the Perfmon System Monitor named NetworkInterface is represented in WMI by
the Win32_PerfRawData_Tcpip_NetworkInterface class for raw data
Win32_PerfFormattedData_Tcpip_NetworkInterface class for pre-calculated, or "cooked" data.

Currently Applications Manager supports monitoring the counters of classes derived from Win32_PerfFormattedData

Some of the WMI Performance classes for Performance Objects that are present in Perfmon are
Processor -Win32_PerfFormattedData_PerfOS_Processor
Browser -Win32_PerfFormattedData_PerfNet_Browser
PagingFile -Win32_PerfFormattedData_PerfOS_PagingFile
Memory -Win32_PerfFormattedData_PerfOS_Memory
Server -Win32_PerfFormattedData_PerfNet_Server

Some classes can only have one instance of it, they are called "Singleton Classes".

After creating Windows Performance Counters, You will see the WMI Monitor details page showing availability and other
details.Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and
events for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual

Copyright © 2014 Zoho Corp. Page 213


Applications Manager User Guide
Applications Manager User Guide Custom Monitors

monitors listed, to view the following information. The windows performance counter values can be added and monitored as
attribues. The overall ability to configure thresholds on attributes and taking corrective actions are supported out-of-the-box.

Adding Attributes

● Click on Add Attributes link.


● This will take you to the list of WMI Performance Classes. You can choose the classes whose attributes you want to monitor.
● Click on Show Attributes; the list of WMI classes selected along with their attributes and instances are displayed. Select
the attributes and instances. The attributes would then be added for monitoring.
● You can configure thresholds and alarms for the attributes. At a class level, you can configure alarms for Health, which inturn
depends on the attributes it comprises of.

Note: Windows Performance Counters is currently supported for Windows Vista, Windows 7, Windows 8, Windows Server
2000, 2003, 2008 and 2012..

Copyright © 2014 Zoho Corp. Page 214


Applications Manager User Guide
Applications Manager User Guide Database Servers

Database Servers

Applications Manager provides Database Server monitoring that monitors system resources. It also provides proactive measures by
notifying database and system administrators about potential problems that could compromise database performance. This
database server monitoring has the ability to connect to the database source, process any query received in the database, monitor
various system table column values, collect data, etc. and also notify through alarms, if the database system properties are beyond
a given threshold.

The different database servers supported are:

● MySQL Database Servers


● Oracle Database Servers
● MS SQL Database Servers
● IBM DB2 Database Servers
● IBM Informix Database
● SAP HANA Database Servers
● Sybase Database Servers
● PostgreSQL Database Servers
● Database Query Monitor
● Apache HBase Database Servers
● NoSQL Database Servers
● Cassandra Database Servers
● CouchBase Database Servers
● MongoDB Database Servers
● Redis Database Servers
● Memcached Database Servers
● Oracle NoSQL Database Servers

Please browse through the different database servers that provide server information and their parameters being monitored. For all
databases, data collection happens by establishing a JDBC connection and executing queries to collect the data.

Copyright © 2014 Zoho Corp. Page 215


Applications Manager User Guide
Applications Manager User Guide Database Servers

MySQL Database / MariaDB Monitoring

Note: In the MySQL database (that you are trying to monitor), ensure that the user name assigned to Applications Manager has the
permission to access the MySQL database from the host where Applications Manager is running. Else, give a relevant user who has
the privileges to do the same.

Minimum User Privileges : The user should have privileges to execute SELECT, SHOW DATABASES, REPLICATION commands in
the MySQL server. Also, Applications Manager machine should be allowed to access the MySQL database server.

For enabling the privileges, execute the below commands in the remote MySQL Server

INSERT INTO user (Host,User) VALUES('<host>','<user>');


GRANT SELECT,SHOW DATABASES,REPLICATION CLIENT ON *.* TO '<user>'@'<host>';
FLUSH PRIVILEGES;

(Host -> Applications Manager machine) /

To create a MySQL database server Monitor, follow the given steps:


1. Click on New Monitor link.
2. Select MySQL DB Server.
3. Enter the IP Address or hostname of the host.
4. Enter the SubNetMask of the network.
5. Enter the port number in which MySQL is running.
6. Enter the polling interval time in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Provide the user name and password of user who has permission to access the MySQL database.
9. Specify the database name. Please note that the Database name must be valid. Also, the database name is associated with
the user name. Hence, provide the database name corresponding to the user name given in the above field.
10. Choose the Monitor Group from the combo box with which you want to associate MySQL database server Monitor (optional).
You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers MySQL database server from the network and starts monitoring them.

Troubleshoot: Having trouble in monitoring MySQL database server? Refer to the online Troubleshooting section.

Supported Versions

● MySQL 3.23.x
● MySQL 4.x, 4.1.x
● MySQL 5.x, 5.1.x, 5.5.x, 5.6.x, 5.7.x

Copyright © 2014 Zoho Corp. Page 216


Applications Manager User Guide
Applications Manager User Guide Database Servers

● All Versions of MariaDB

Monitored Parameters

The Availability tab gives the Availability history for the past 24 hours or 30 days. The Performance tab gives the health status and
events for the past 24 hours or 30 days. The List view enables you to perform bulk admin configurations.

To view detailed performance metrics of a MySQL server, click the corresponding monitor listed in the Availability tab. These
metrics are categorized into two different tabs for better understanding.

Overview

This tab provides information into the overall performance of the MySQL server.

Parameter Description

Monitor Information

Name Denotes the name of MySQL server monitor.

Health Denotes the health (Clear, Warning, Critical) of the MySQL server.

Type Denotes the type you are monitoring.

MySQL Version Specifies the version of the database server.

Port Specifies the port number at which the database server is running.

Base Directory Specifies the directory in which the database server is installed.

Data Directory Specifies the directory in the hard disk of the system where the data for the database server is stored.

Host Name Specifies the host at which the database server is running.

Copyright © 2014 Zoho Corp. Page 217


Applications Manager User Guide
Applications Manager User Guide Database Servers

Host OS Specifies the OS of the host where the database server is running.

Last Alarm Specifies the last alarm that was generated for the database server.

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Availability Shows the current status of the server - available or not available.

Connection Time

Connection Time Specifies the time taken to connect to the database

Connection Time Out Specifies the maximum time taken by the application to connect to MySQL Server

Request Statistics

Request Rate Number of request received in one second.

Bytes Received Rate Number of bytes received in one second.

Bytes Sent Rate Number of bytes sent in one second.

Connection Statistics

Open Connections The number of connections opened at present in the MySql Server.

Aborted Connections Number of tries to connect to the MySQL server that failed.

Aborted Clients Number of clients aborted by MySQL server.

Thread Details

Threads Used Number of threads processing the request.

Threads in Cache Number of threads currently placed in the thread cache.

Thread Cache Size Specifies the cache size in the MySQL server.

Database Details

Database Name Name of the database instance.

Database Size Size of the various databases in the MySQL server.

Table Lock Statistics

Copyright © 2014 Zoho Corp. Page 218


Applications Manager User Guide
Applications Manager User Guide Database Servers

Immediate Locks Number of times a table lock for the table is acquired immediately.

Locks Wait Number of times a table lock could not be acquired after waiting.

Key Efficiency

Key Hitrate Percentage of key read requests that resulted in actual key reads from the key buffer.

Key Buffer Used Amount of allocated key buffer in use.

Key Buffer Size Size of the buffer used for index blocks. Also known as the key cache.

Query Statistics

Queries Inserted/Min No. of Insert Queries executed per minute

Queries Deleted/Min No. of Delete Queries executed per minute

Queries Updated/Min No. of Update Queries executed per minute

Queries Selected/Min No. of Select Queries executed per minute

Query Cache Hitrate (This performance data is not available for MySQL versions 3.23.x)

Query Cache Hitrate Ratio of queries that were cached and queries that were not cached.

Query Cache Size Amount of memory allocated for caching query results.

Query Cache Limit Maximum amount of memory for storing cache results.

Replication Details

Replication Status The status of Slave process in MySQL Server

Slave IO Running Status of the Slave IO Process in MySQL Server. Possible values are Yes/No

Slave SQL Running Status of the Slate SQL Process in MySQL Server.Possible values are Yes/N.

Last Error The last error occured when Slave is synching the data from master.

Master Host The hostname or IP number of the master replication server.

Master Port The TCP/IP port number that the master is listening on

Master User The username of the account that the slave thread uses for authentication when it connects to the master

Time Behind Master This indicates of how “late” the slave is behind the Master

Copyright © 2014 Zoho Corp. Page 219


Applications Manager User Guide
Applications Manager User Guide Database Servers

Configuration

This tab provides information about the system variables maintained by the MySQL server. These system variables indicate how the
server is configured.

You can also view realtime and historical data of any of the attributes present in the 'Configuration Information' section in the
Configuration tab. Click on any attribute under the Configuration tab. This will open up a new window named 'History Data' that
provides more information about these attributes.

There are two tabs in the History Data window - History Report and Global View.

History Report: This tab provides historical reports of the attribute selected based on the time period chosen. You can also use
the Select Attribute drop-down box and view reports for other attributes.

Global View: This tab displays the current values of the attribute selected, across multiple monitors. To view information about
other attributes present in the monitor, use the Select Attribute drop-down box and change the attribute.

If you want to view data of multiple attributes, click the Customize Columns link present at the top left corner of the window. This
will take you to the Edit Global Viewscreen. In this screen, you can change the monitor type using the Filter by Monitor Type drop-
down box, select the metrics to be displayed, and show monitors on a monitor basis or a monitor group basis. After you select your
options, click the Show Report button to view those information in the Global View tab.

The View Process List option present on the right side under the Show Status section gives you information on the current
threads that are running in the MySQL server.

Copyright © 2014 Zoho Corp. Page 220


Applications Manager User Guide
Applications Manager User Guide Database Servers

Oracle DB Servers

Follow the given steps to create a Oracle database server monitor:

Note: For you to create a new Oracle database monitor, you should have admin privileges. Minimum User Privileges -> user with
CONNECT and SELECT_CATALOG_ROLE roles
1. Click on New Monitor link.
2. Select Oracle DB Server.
3. Enter the IP Address or hostname of the host.
4. Enter the SubNetMask of the network.
5. Enter the port number in which the Oracle is running.
6. Enter the polling interval ime in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Provide the user name of the admin user ('system' is the default username) and its corresponding password.
9. Provide a valid System Identifier / Host Connection String.
10. Choose the Monitor Group from the combo box with which you want to associate Oracle database server Monitor (optional).
You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers Oracle database server from the network and starts monitoring them.

Supported Versions

Applications Manager supports monitoring of Oracle database servers of versions 8.x, 9i, 10g, 10.1.3, 11g, RAC (Real Application
Clusters) and 12c.

Monitored Parameters

Applications Manager provides out-of-the-box performance metrics and helps you visualize the health and availability of an Oracle
Database server farm. Database administrators can login to the web client and visualize the status and Oracle performance
metrics.

Copyright © 2014 Zoho Corp. Page 221


Applications Manager User Guide
Applications Manager User Guide Database Servers

Go to the Monitors Category View by clicking the Monitors tab. Click on Oracle Server under the Database Servers Table.
Displayed is the Oracle servers bulk configuration view in three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Note: To create a new Oracle database monitor, you should have admin privileges. Minimum User Privileges -> user with CONNECT and SELECT_CATALOG_ROLE roles

Click on the monitor name to see all the server details listed under the following tabs:

● Overview
● Table Space
● Session
● Rollback & Corrupted blocks*
● SGA
● Query
● Lock Statistics
● Jobs & Backup*
● PGA
● Process
● ASM*
● RPO

Note:

The server details marked with an * symbol is supported in Oracle database servers version 10g and above.

Overview

Monitor Information

Parameters Description

Copyright © 2014 Zoho Corp. Page 222


Applications Manager User Guide
Applications Manager User Guide Database Servers

Name Name of the Oracle server monitor

Oracle Version Refers to the Version of the Oracle Database.

Oracle Start Time Refers to the time when Oracle server was started.

Availability Refers to the status of the database server - available or not available.

Today's Availability

Parameters Description

Current Status Availability history graph with uptime

Connection Time

Parameters Description

Connection Time Refers to the time taken to connect to the database.

User Activity

Parameters Description

Number of Users Graph for the number of users executing an SQL Statement. vs time

Table spaces with least free bytes

Parameters Description

Name The name of the table space.

Free Bytes (MB) The free space available in bytes.


% of Free Bytes The percentage of free space available in bytes.

Database Details

Copyright © 2014 Zoho Corp. Page 223


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

Database Created Time Creation time of the database.

Open Mode Indicates the Open mode of the Instance which can be either Read Write or Read.

If the transactions are written on the Log, the Log mode will be ARCHIVELOG, or else, the Log
Log Mode
mode will be NOARCHIVELOG.

Current role of the database:



DB Role ⚬ LOGICAL STANDBY
⚬ PHYSICAL STANDBY
⚬ PRIMARY

Type of control file:


• STANDBY - Indicates that the database is in standby mode
• CLONE - Indicates a clone database
Control File type
• BACKUP | CREATED - Indicates the database is being recovered using a backup or created
control file
• CURRENT - database is available for general use

Indicates whether switchover is allowed:


• NOT ALLOWED - Either this is a standby database and the primary database has not been
switched first or this is a primary database and there are no standby databases.
• SESSIONS ACTIVE - Indicates that there are active SQL sessions attached to the primary or
standby database that need to be disconnected before the switchover operation is
permitted. Query the V$SESSION view to identify the specific processes that need to be
terminated.
• SWITCHOVER PENDING - This is a standby database and the primary database switchover
request has been received but not processed.
• SWITCHOVER LATENT - The switchover was in pending mode, but did not complete and
went back to the primary database.
• TO PRIMARY - This is a standby database and is allowed to switch over to a primary
database.
• TO STANDBY - This is a primary database and is allowed to switch over to a standby
Switch over status
database.
• RECOVERY NEEDED - This is a standby database that has not received the switchover
request.
• PREPARING SWITCHOVER - Either this is a primary database that is accepting redo data
from a logical standby database in preparation for switch over to the logical standby
database role, or it is a logical standby database sending redo data to a primary database
and other standby databases in preparation for switch over to the primary database role. In
the latter case, a completed dictionary has already been sent to the primary database and
other standby databases.
• PREPARING DICTIONARY - This is a logical standby database that is sending redo data to a
primary database and other standby databases in the configuration in preparation for switch
over to the primary database role.
• TO LOGICAL STANDBY - This is a primary database that has received a complete dictionary
from a logical standby database.

Copyright © 2014 Zoho Corp. Page 224


Applications Manager User Guide
Applications Manager User Guide Database Servers

Protection mode currently in effect for the database:


• MAXIMUM PROTECTION - Database is running in maximized protection mode
• MAXIMUM AVAILABILITY - Database is running in maximized availability mode
Protection Mode • RESYNCHRONIZATION - Database is running in resynchronization mode
• MAXIMUM PERFORMANCE - Database is running in maximized protection mode
• UNPROTECTED - Database is unprotected (this normally occurs when the primary database
is mounted and not open)

Indicates whether the next database open allows or requires the resetlogs option
• NOT ALLOWED
Open reset logs
• ALLOWED
• REQUIRED

Protects data from being changed:


• ALL - Indicates all users other than SYS are prevented from making changes to any data in
the database.
Guard Status
• STANDBY - Indicates all users other than SYS are prevented from making changes to any
database object being maintained by logical standby.
• NONE - Indicates normal security for all data in the database.

Force logging Indicates whether the database is under force logging mode (YES) or not (NO).

Database Status

Parameters Description

Database Size Size of the database in Megabytes.

This is the average number of executions that happen during the execution of every SQL
Average Executions
Statement.

Reads Refers to the number of reads from the database.

Writes Refers to the number of writes to the database.

Block Size This refers to the lowest possible storage area for an Instance in bytes.

Hit Ratio

Parameters Description

Buffer Creation time of the database.

Data Dictionary The ratio of the data gets to the data misses in the row cache is Data Dictionary Hit Ratio.

Copyright © 2014 Zoho Corp. Page 225


Applications Manager User Guide
Applications Manager User Guide Database Servers

The Library cache stores all shared SQL and PL/SQL blocks, along with their parse trees. In
OLTP environments where a large numbers of users are entering and exchanging data, there
Library is a great chance for overlapping the parse and execute needs of those different queries.
Such an overlap in the library is called a cache hit and the ratio determined to the misses
and hits is called Library Cache Hit Ratio.

SGA Details

Parameters Description

Buffer Cache Size The total size of the Buffer Cache given in bytes.

Shared Pool Size The size of the shared pool given in bytes.

Redolog Buffer Size The size of the buffers for the Redo Logs in bytes.

Library Cache Size The size of the Library Cache given in bytes.

Data Dictionary Cache Size The cache size of the data dictionary or row cache in bytes.

SQL Area Size The size of the SQL Area for usage of SQL/PL statements (bytes).

Fixed Area Size The size of the SGA, which is fixed throughout the instance.

Oracle DB Links

Parameters Description

DB link name Name of the database link

Owner Owner of the database link


User Name of the user when logging in
Oracle Net connect string Host Name
Creation time Creation time of the database link

Invalid Objects

Parameters Description

Owner Owner of the invalid dba object.

Copyright © 2014 Zoho Corp. Page 226


Applications Manager User Guide
Applications Manager User Guide Database Servers

Object Name Name of the invalid object.


Status Status of the invalid object.

Table Space

Table Space Details

Parameters Description

Name Refers to the name of the Table space.

Allocated Bytes Refers to the size of the Table space in bytes.

Allocated Blocks Refers to the number of allocated blocks in Table space.

Data Files Refers to the number of data files in Table space.

Table Space Status

Parameters Description

Name Refers to the name of the Table space.

Status Tablespace status: ONLINE, OFFLINE, or INVALID (tablespace has been dropped)

Free Bytes Refers to the available free space in bytes.

Free Blocks Refers to the number of free blocks in Table space.

Reads Refers to the number of reads from the Table space.

Writes Refers to the number of writes on the Table space.

Read Time Time taken for a single read from the Table space.

Copyright © 2014 Zoho Corp. Page 227


Applications Manager User Guide
Applications Manager User Guide Database Servers

Write Time Time taken for a single write on the Table space.

Performance of Data Files

Parameters Description

Data File Name Name and location of the data file.

Table Space Name Name of the Table space.

If a data file is a part of the system table space, its status is SYSTEM (unless it requires
Status recovery). If a data file in a non-SYSTEM table space is online, its status is ONLINE. If a data
file in non-SYSTEM table space is offline, its status can be either OFFLINE OR RECOVER.

Created Bytes Size of the Data file in bytes.

Reads Refers to the number of reads from the Data file.

Writes Refers to the number of writes to the Data file.

Average Read Time Refers to the average read time.

Average Write Time Refers to the average write time.

Objects Approaching MAX Extents

Parameters Description

Owner Owner name of the table space.

Table space name Name of the table space.


Segment Name Name of the segment approaching maximum extents
Segment Type The type of segment approaching maximum extents
Extents Number of extents allocated to the segment
Max Extents Maximum allowed extents that can be filled in a segment
Next Extent (MB) Next extent size in MB

Copyright © 2014 Zoho Corp. Page 228


Applications Manager User Guide
Applications Manager User Guide Database Servers

Note:

Data collection is scheduled to take place once a day; the user can use the 'Optimize datacollection' option to change the
schedule.

Session

Session Details

Parameters Description

ID Session Identifier for the connected session.

Status Current status: ONLINE, OFFLINE, or INVALID (tablespace has been dropped).

Machine Name of the operating system user.

User Name Name of the Oracle process user.

Elapsed Time Time elapsed in seconds after which the user has logged into the oracle server.

CPU Used CPU centiseconds (divide by 100 to get real CPU seconds) used by this session.

Memory Sorts Number of memory sorts performed.

Table Scans Number of table scans performed.

Physical Reads Physical reads for the session.

Logical Reads Sum of consistent gets and db block gets.

Commits Number of commits made by user in a second.

Cursor Number of cursor currently in use.

Copyright © 2014 Zoho Corp. Page 229


Applications Manager User Guide
Applications Manager User Guide Database Servers

Percentage of session logical reads taking place from the buffer (1-physical reads/session
Buffer Cache Hit Ratio
logical reads*100).

Session Waits

Parameters Description

ID Session Identifier for the connected session.

User Name Name of the Oracle process user.

Event Resource or event for which the session is waiting

Wait state:
0 - WAITING (the session is currently waiting)
State -2 - WAITED UNKNOWN TIME (duration of last wait is unknown)
-1 - WAITED SHORT TIME (last wait <1/100th of a second)
>0 - WAITED KNOWN TIME (WAIT_TIME = duration of last wait)

A nonzero value is the session's last wait time. A zero value means the session is currently
Wait Time
waiting.

If WAIT_TIME = 0, then SECONDS_IN_WAIT is the seconds spent in the current wait condition. If
Seconds in Wait WAIT_TIME 0, then SECONDS_IN_WAIT is the seconds since the start of the last wait, and
SECONDS_IN_WAIT - WAIT_TIME / 100 is the active seconds since the last wait ended.

User Expiry

Parameters Description

Username User name.

Expiry Date Date user account expires.


Days to Expiry The number of days to account expiration.
Account Status Status of the user account.
User Profile Profile name of user.

Copyright © 2014 Zoho Corp. Page 230


Applications Manager User Guide
Applications Manager User Guide Database Servers

Rollback & Corrupted blocks

Rollback Segment

Parameters Description

Segment Name Name of the rollback segment.

Table Space Name Name of the tablespace containing the rollback segment.

ONLINE if the segment is online, or PENDING OFFLINE if the segment is going offline but some
Status active (distributed) transactions are using the rollback segment. When the transaction(s)
complete, the segment goes OFFLINE.

Current Size Current size in bytes of the rollback segment.

Initial Extent Initial extent size in bytes.

Next Extent Secondary extent size in bytes.

Min. Extent Minimum number of extents.

Max. Extent Maximum number of extents.

Hit Ratio Ratio of gets to waits. This should be >= 99%.

HWMSize High Water Mark of rollback segment size.

Shrinks Number of times rollback segment shrank, eliminating one or more additional extents each time.

Wraps Number of times rollback segment wraps from one extent to another.

Extend Number of times rollback segment was extended to have a new extent.

Blocks Corrupted

Parameters Description

Copyright © 2014 Zoho Corp. Page 231


Applications Manager User Guide
Applications Manager User Guide Database Servers

File Number Datafile number

Block Number First block of the corrupted range


Number of corrupted blocks Number of contiguous blocks in the corrupted range

Type of block corruption in the datafile:


• ALL ZERO - Block header on disk contained only zeros. The block
may be valid if it was never filled and if it is in an Oracle7 file. The
buffer will be reformatted to the Oracle8 standard for an empty
block.
• FRACTURED - Block header looks reasonable, but the front and back
of the block are different versions.
Type of block corruption • CHECKSUM - optional check value shows that the block is not
self-consistent. It is impossible to determine exactly why the check
value fails, but it probably fails because sectors in the middle of the
block are from different versions.
• CORRUPT - Block is wrongly identified or is not a data block (for
example, the data block address is missing)
• LOGICAL - Specifies the range is for logically corrupt blocks.
CORRUPTION_CHANGE# will have a nonzero value.

Note:

Data collection is scheduled to take place once every 12 hours; the user can use the 'Optimize datacollection' option to change
the schedule.

Fast Recovery Area

Parameters Description

FRA Name Current location of the FRA.

The maximum amount of disk space (in bytes) that the database can use for the flash recovery
FRA Space Limit (MB)
area.
The amount of disk space (in bytes) used by flash recovery area files created in current and all
FRA Space Used (MB)
previous flash recovery areas.
The percentage of disk space used by flash recovery area files created in current and all previous
Used Percentage
flash recovery areas.

SGA

SGA Performance

Copyright © 2014 Zoho Corp. Page 232


Applications Manager User Guide
Applications Manager User Guide Database Servers

Graph displaying value (in %) of Buffer Hit Ratio, Data Dictionary Hit Ratio and Library Hit Ratio vs time

Parameters Description

When a scan of the buffer cache shows that there are no free buffers, Database Block Writer
determines which blocks to be eliminated based on a least recently used algorithm or LRU.
Buffer Hit Ratio Having a block required by a user process in the buffer cache already is called a buffer cache hit
or is determined as a ratio. Hits are good because they reduce the amount of disk I/O required
for the user process.

The purpose of the row or dictionary cache is to store rows of information from the data
dictionary in memory for faster access. The row cache is designed to hold the actual rows of data
from objects in data dictionary. While this data is held in the row cache, the users of the
Data Dictionary Hit Ratio
database may access that information more quickly than if Oracle had to read the data into
memory from disk. The ratio of the data gets to the data misses in the row cache is Data
Dictionary Hit Ratio.

The Library cache stores all shared SQL and PL/SQL blocks, along with their parse trees. In OLTP
environments where a large numbers of users are entering and exchanging data, there is a great
Library Hit Ratio chance for overlapping the parse and execute needs of those different queries. Such an overlap
in the library is called a cache hit and the ratio determined to the misses and hits is called
Library Cache Hit Ratio.

SGA Details

Parameters Description

Buffer Cache Size The total size of the Buffer Cache given in bytes.

Shared Pool Size The size of the shared pool given in bytes.

Redolog Buffer Size The size of the buffers for the Redo Logs in bytes.

Library Cache Size The size of the Library Cache given in bytes.

Data Dictionary Cache Size The cache size of the data dictionary or row cache in bytes.

SQL Area Size The size of the SQL Area for usage of SQL/PL statements (bytes).

Fixed Area Size The size of the SGA, which is fixed throughout the instance.

SGA Status

Copyright © 2014 Zoho Corp. Page 233


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

When a scan of the buffer cache shows that there are no free buffers, Database Block Writer
determines which blocks to be eliminated based on a least recently used algorithm or LRU.
Buffer Hit Ratio Having a block required by a user process in the buffer cache already is called a buffer cache hit
or is determined as a ratio. Hits are good because they reduce the amount of disk I/O required
for the user process.

The purpose of the row or dictionary cache is to store rows of information from the data
dictionary in memory for faster access. The row cache is designed to hold the actual rows of data
from objects in data dictionary. While this data is held in the row cache, the users of the
Data Dictionary Hit Ratio
database may access that information more quickly than if Oracle had to read the data into
memory from disk. The ratio of the data gets to the data misses in the row cache is Data
Dictionary Hit Ratio.

The Library cache stores all shared SQL and PL/SQL blocks, along with their parse trees. In OLTP
environments where a large numbers of users are entering and exchanging data, there is a great
Library Hit Ratio chance for overlapping the parse and execute needs of those different queries. Such an overlap
in the library is called a cache hit and the ratio determined to the misses and hits is called
Library Cache Hit Ratio.

Free Memory Refers to the size of the free memory in bytes.

Query

Query attributes are not monitored by default. Applications Manager allows you to enable/disable data collection of query metrics.
Once enabled ,you can also customize the polling interval of these metrics. To monitor query metrics:

● Go to Admin tab.
● Click Performance Polling under Discovery and Data Collection.
● Under Performance Data Collection, Click on the Optimize Data Collection tab.
● Select Oracle from the Monitor Type drop-down menu.
● Select Top 10 Queries by Buffer Gets from the Metric Name drop-down menu.
● Select how you wish to configure the queries:
● By Monitor Type - This will be the default polling status, for any new monitor added. All the monitors of this type, will
have the default polling status, until any exclusive customization is done for the monitor. You can choose between three
different polling settings: Never collect data, Collect data in every polling and Collect data at customized time
interval. Changing the polling status of 'Monitor Type', will also change any configuration done for its 'Monitors'.
● By Monitors - Use this option to change the polling status of any particular monitor(s).

Copyright © 2014 Zoho Corp. Page 234


Applications Manager User Guide
Applications Manager User Guide Database Servers

Buffer Gets

Parameters Description

Buffer Gets Number of buffer gets for the child cursor

Number of executions that took place on the object since it was brought into the library
Executions
cache

Buffer Gets per Executions The ratio of buffer gets to execution in the current polling interval

Query First thousand characters of the SQL text for the current cursor

Disk Reads

Parameters Description

Disk Reads Number of disk reads for this child cursor

Number of executions that took place on this object since it was brought into the library
Executions
cache

Disk Reads per Executions The ratio of disk reads to execution in the current polling interval

Query First thousand characters of the SQL text for the current cursor

Lock Statistics

Lock statistics are not monitored by default. Applications Manager allows you to enable/disable data collection of Lock statistics.
Once enabled ,you can also customize the polling interval of these metrics. To monitor Lock statistics:

● Go to Admin tab.
● Click Performance Polling under Discovery and Data Collection.
● Under Performance Data Collection, Click on the Optimize Data Collection tab.
● Select Oracle from the Monitor Type drop-down menu.
● Select Lock and Wait Statistics from the Metric Name drop-down menu.

Copyright © 2014 Zoho Corp. Page 235


Applications Manager User Guide
Applications Manager User Guide Database Servers

● Select how you wish to configure the Lock and Wait Statistics:
● By Monitor Type - This will be the default polling status, for any new monitor added. All the monitors of this type, will
have the default polling status, until any exclusive customization is done for the monitor. You can choose between three
different polling settings: Never collect data, Collect data in every polling and Collect data at customized time
interval. Changing the polling status of 'Monitor Type', will also change any configuration done for its 'Monitors'.
● By Monitors - Use this option to change the polling status of any particular monitor(s).

Sessions holding a lock

Parameters Description

Id Session identifier of Session holding a lock

Session serial number. Used to uniquely identify a session's objects. Guarantees that session-
Serial level commands are applied to the correct session objects if the session ends and another
session begins with the same session ID.

Machine Operating system machine name.

PROGRAM Operating system program name.

Lock Wait Address of lock waiting for; null if none.

Sessions waiting for a lock

Parameters Description

Waiting Session ID ID of Session waiting for lock.

Holding Session ID ID of Session holding lock.

Lock Type The lock type.

Mode Held The mode held.

Mode Requested The mode requested.


Lock ID1, ID2 The Lock IDs.

Lock Statistics

Parameters Description

Copyright © 2014 Zoho Corp. Page 236


Applications Manager User Guide
Applications Manager User Guide Database Servers

Name of the locked object.


Object Name

Session Id Session Id of locked object.

Serial Session serial number. Used to uniquely identify a session's objects.

Lock Mode Mode of lock.

OS Process ID Operating system process identifier.


If the session STATUS is currently ACTIVE, then the value represents the elapsed time in
Last call Minute seconds since the session has become active. If the session STATUS is currently INACTIVE, then
the value represents the elapsed time in seconds since the session has become inactive.
Time of logon Time of logon.

Jobs & Backup

Schedule jobs details

Parameters Description

Job name Name of the job.

Current state of the job (DISABLED, RETRY SCHEDULED, SCHEDULED, RUNNING, COMPLETED,
Current state
BROKEN, FAILED, REMOTE, SUCCEEDED, CHAIN_STALLED).

Last run status Status of the job run.


Last run date Last date on which the job started running.
Last run duration Amount of time the job took to complete during the last run (in seconds)
Next run date Next date on which the job is scheduled to run.
Run count Number of times the job has run.
Failed count Number of times the job has failed to run.
Retry count Number of times the job has retried, if it is retrying.
Elasped time Elapsed time since the job was started (in seconds).

Backup jobs details

Parameters Description

Copyright © 2014 Zoho Corp. Page 237


Applications Manager User Guide
Applications Manager User Guide Database Servers

Session Key Session identifier.

Input Type Type of input files backed up in this session.


Last backup time Last backup start time.
Status Back up status with the value FAILED.
Time Taken Time Taken to complete last back-up (in seconds).
Backup size in MB Backup size in megabytes.

Note:

By Default, data collection is performed only for backup jobs whose status is 'FAILED' . To capture all the backup jobs, go to
Admin tab -> Discovery & Data Collection -> Performance Polling -> Database Servers -> and uncheck the Monitor
only failed Backup Jobs checkbox.

Data collection is scheduled to take place once every 12 hours; the user can use the 'Optimize datacollection' option to change
the schedule.

PGA

TOP 10 Process using PGA

Graphical representation of the PGA used by processes.

PGA Stats Per Process (TOP 10)

Parameters Description

Process Id Oracle process identifier.

Program Name Program in progress.

PGA used (MB) Amount of PGA memory consumed in megabytes.

PGA Allocated (MB) Maximum PGA memory allocated at one time since instance startup.

Max PGA Used (MB) PGA memory currently used by the process.

Copyright © 2014 Zoho Corp. Page 238


Applications Manager User Guide
Applications Manager User Guide Database Servers

Freeable PGA (MB) Allocated PGA memory which can be freed.

PGA Stats

Parameters Description

Total PGA used (MB) Indicates how much PGA memory is currently consumed.

Total PGA allocated (MB) Current amount of PGA memory allocated by the instance.

Maximum PGA allocated (MB) Maximum amount of PGA memory consumed .

Number of bytes of PGA memory in all processes that could be freed back to the operating
Total freeable PGA (MB)
system.

PGA freed back to OS (MB) Number of bytes of PGA memory freed back to the operating system.

Cache hit percentage Percentage of PGA memory component, cumulative since instance startup
Resource being used by processes
Percentage resources currently being used by processes.
(%)

Resouce limit for processes

Parameters Description

Resource being used by processes Resources (locks or processes) currently being used.

Free Resource Percentage of unused resources.

Process

Session Details

Parameters Description

Copyright © 2014 Zoho Corp. Page 239


Applications Manager User Guide
Applications Manager User Guide Database Servers

Process Id Oracle process identifier.

PGA used (MB) Indicates how much PGA memory is currently consumed.

PGA Stats Per Process(TOP 10)

Parameters Description

Process Id Oracle process identifier.

Program Name The program in progress.


PGA used(MB) Indicates how much PGA memory is currently consumed.
PGA Allocated(MB) Current amount of PGA memory allocated by the instance.
Max PGA Used(MB) Maximum amount of PGA memory consumed .
Number of bytes of PGA memory in all processes that could be freed back to the operating
Freeable PGA(MB)
system.

ASM

Disk Group Details

Parameters Description

Disk Group Number Cluster-wide number assigned to the disk group.

Name Name of the disk group.


State of the disk group relative to the instance (Connected, Broken, Unknown, Dismounted,
State
Mounted).
Type Redundancy type for the disk group (EXTERN, NORMAL, HIGH).
Total Memory (GB) Total capacity of the disk group (in megabytes).
Free Memory (GB) Unused capacity of the disk group (in megabytes).

RPO

RPO statistics are not monitored by default. Applications Manager allows you to enable/disable data collection of RPO statistics.
Once enabled, you can also customize the polling interval of these metrics. To monitor RPO statistics:

Copyright © 2014 Zoho Corp. Page 240


Applications Manager User Guide
Applications Manager User Guide Database Servers

● Go to Admin tab.
● Click Performance Polling under Discovery and Data Collection.
● Under Performance Data Collection, Click on the Optimize Data Collection tab.
● Select Oracle from the Monitor Type drop-down menu.
● Select Log Apply Gap details in Primary Server/Log Apply Lag details in Standby Server from the Metric Name
drop-down menu.
● Select how you wish to configure the Log Apply Gap details:
● By Monitor Type - This will be the default polling status, for any new monitor added. All the monitors of this type, will
have the default polling status, until any exclusive customization is done for the monitor. You can choose between three
different polling settings: Never collect data, Collect data in every polling and Collect data at customized time
interval. Changing the polling status of 'Monitor Type', will also change any configuration done for its 'Monitors'.
● By Monitors - Use this option to change the polling status of any particular monitor(s).

Log Apply Gap Details (only from primary)

Parameters Description

Last log sequence created in


Shows the last log sequence that was applied to the primary database
primary server

Last log sequence synched in


Shows the last log sequence that was applied to the secondary database
secondary server
Amount of time that the application of archive data on the standby database lags behind the
Log apply gap primary database. This data will be collected only once a day. The user can change it using
'Optimize Data Collection' option.

Log Apply Lag Details (only from standby)

Parameters Description

Amount of redo data generated by the primary database is not available or applicable on the
Transport Lag
standby database at the time of computation.

Amount of time that the application of redo data on the standby database lags behind the
Log Apply Lag
primary database.
Estimated time before log apply services will finish applying the redo data available on the
Apply Finish Time
standby database.

Archive Log Destination Details are not monitored by default. Applications Manager allows you to enable/disable data collection of
archive log destination metrics. Once enabled ,you can also customize the polling interval of these metrics. To monitor metrics:

● Go to Admin tab.
● Click Performance Polling under Discovery and Data Collection.

Copyright © 2014 Zoho Corp. Page 241


Applications Manager User Guide
Applications Manager User Guide Database Servers

● Under Performance Data Collection, Click on the Optimize Data Collection tab.
● Select Oracle from the Monitor Type drop-down menu.
● Select Archive Log Destination Monitoring from the Metric Name drop-down menu.
● Select how you wish to configure the queries:
● By Monitor Type - This will be the default polling status, for any new monitor added. All the monitors of this type, will
have the default polling status, until any exclusive customization is done for the monitor. You can choose between three
different polling settings: Never collect data, Collect data in every polling and Collect data at customized time
interval. Changing the polling status of 'Monitor Type', will also change any configuration done for its 'Monitors'.
● By Monitors - Use this option to change the polling status of any particular monitor(s).

Archive Log Destination Details (only from primary)

Parameters Description

Dest Id Identifies the log archive destination parameter

Name Archived log file name.


Status Status of the archived log.
Type of archival destination database:
• LOCAL - Local to primary database

• PHYSICAL - Physical standby


Type
• CROSS-INSTANCE - An instance of the primary

• LOGICAL - Logical standby

Destination Original destination from which the archive log was generated.
Indicates whether the database is protected:
• MAXIMUM PROTECTION

• MAXIMUM AVAILABILITY

• RESYNCHRONIZATION
Protection Mode
• MAXIMUM PERFORMANCE

• UNPROTECTED

Specifies network transmission mode:


• SYNCHRONOUS

• PARALLELSYNC
Transmit mode
• ASYNCHRONOUS

Copyright © 2014 Zoho Corp. Page 242


Applications Manager User Guide
Applications Manager User Guide Database Servers

Current mode of media recovery at the archival destination database:


• IDLE - Managed recovery is not active

• MANUAL - Manual media recovery active

• MANAGED - Managed recovery is active


Recovery mode
• MANAGED REAL TIME APPLY - Log apply services recover redo data from standby redo
logs at the same time the logs are being written to, as opposed to recovering redo from
archived redo logs when a log switch occurs

Archive Log Destination Stats (only from primary)

Parameters Description

Dest Id Log archive destination parameter identifier

Log sequence Identifies the sequence number of the last archived redo log to be archived
Number of seconds the log writer process will wait for status from the network server of a
Net timeout
network operation issued by the log writer process
Fail Sequence Sequence number of the archived redo log being archived when the last error occurred
Identifies the log sequence number of the most recent archived redo log received at the
Archived Sequence
destination
Identifies the log sequence number of the most recent applied redo log received at the
Applied Sequence
destination
Identifies the delay interval (in minutes) before the archived redo log is automatically
Delay (Mins)
applied to a standby database
Error Displays the error text

Copyright © 2014 Zoho Corp. Page 243


Applications Manager User Guide
Applications Manager User Guide Database Servers

MS SQL DB Servers Monitoring

Supported Versions - Applications Manager supports monitoring of MS SQL 2000, 2005, 2008, 2008 R2, 2012, 2014 and 2016
versions.

To create a MS SQL database server Monitor, follow the given steps:


1. Click on New Monitor link.
2. Select MS SQL DB Server.
3. Enter the IP Address or Hostname of the host.
4. Enter the SubNetMask of the network.
5. Enter the Port number in which the MS SQL is running.
6. Enter the polling interval time in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Provide the User Name and Password of user who has permission to access the MS SQL database. The user name specified
for collecting the data from MS SQL Server should have either System Administrator role or the user should be the DB owner
for master database. Alternatively, you can provide the Windows Authentication details (give the User Name like
domainnameusername) also.
9. If you want to connect using a Named Instance, check the Connect using Named Instance checkbox and specify the
InstanceName.
10. Choose the Monitor Group from the combo box with which you want to associate MS SQL database server Monitor
(optional). You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers MS SQL database server from the network and starts monitoring them.

Note:
Minimum User Privileges: User should be permitted to access MASTER database & MSDB database.
Roles: public + db_datareader should be selected for both MASTER and MSDB databases.

For MS SQL 2005, 2008 and 2012 user roles:


Database Accessed: Master
Permit in Database Role: db_datareader & Requires VIEW SERVER STATE permission on the server.

To grant VIEW SERVER STATE, you can use any of the following methods :

1) Execute the following query

GRANT VIEW SERVER STATE TO username;

2) In SQL management studio for user choose Properties -> Securables -> Click Add ( under securables ) -> choose "All objects of the Types..." -> choose Servers -> choose Grant for
"View server state" permission.

To monitor SQL jobs

The user should be a member of sysadmin or members of one of these fixed database roles roles:
• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

Copyright © 2014 Zoho Corp. Page 244


Applications Manager User Guide
Applications Manager User Guide Database Servers

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on MS SQL under the Databases Table. Displayed is the
MS SQL bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Monitor Information

Parameters Description

Name Specifies the name of MS SQL server monitor.

Health Specifies the health (Clear, Warning, Critical) of the MS SQL server.

Type Specifies the type you are monitoring.

Version Specifies the version of the database server.

Port Specifies the port number at which the database server is running.

ODBC Driver Version Specifies the ODBC driver version used.

Host Name Specifies the host at which the database server is running.

Host OS Specifies the OS of the host where the database server is running.

Last Alarm Specifies the last alarm that was generated for the database server.

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Availability Shows the current status of the server - available or not available.

Copyright © 2014 Zoho Corp. Page 245


Applications Manager User Guide
Applications Manager User Guide Database Servers

Memory Usage

Parameters Description

Total Memory Total amount of dynamic memory the server is currently consuming.

SQL Cache Memory Total amount of dynamic memory the server is using for the dynamic SQL cache.

Lock Memory Total amount of dynamic memory the server is using for locks.

Optimizer Memory Total amount of dynamic memory the server is using for query optimization.

Connection Memory Total amount of dynamic memory the server is using for maintaining connections.

Granted WorkSpace Memory Total amount of memory granted to executing processes. This memory is used for hash, sort and create index operations.

Memory Grants Pending Current number of processes waiting for a workspace memory grant.

Memory Grants Success Current number of processes that have successfully acquired a workspace memory grant.

Buffer Manager Statistics

Parameters Description

Buffer Hit Ratio Percentage of pages that were found in the buffer pool without having to incur a read from disk.

Page LookUps/Min Number of requests to find a page in the buffer pool.

Page Reads/Min Number of physical database page reads issued.

Page Writes/Min Number of physical database page writes issued.

Total Pages Number of pages in the buffer pool (includes database, free, and stolen).

Database Pages Number of pages in the buffer pool with database content.

Free Pages Total number of pages on all free lists.

Page Life Expectancy The number of seconds a page will stay in the buffer pool without references.

Copyright © 2014 Zoho Corp. Page 246


Applications Manager User Guide
Applications Manager User Guide Database Servers

Connection Statistics

Parameters Description

Connection Time Time taken to get connected to the MS SQL database server.

Active Connections Number of users connected to the system.

Logins/Min Total number of logins started per minute.

Logouts/Min Total number of logouts started per minute.

Cache Details

Parameters Description

Cache Hit Ratio Ratio between cache hits and lookups

Cache Used/Min Times each type of cache object has been used

Cache Count Number of cache objects in the cache

Cache Pages Number of 8k pages used by cache objects

Lock Details

Parameters Description

Lock Requests/Min Number of new locks and lock conversions requested from the lock manager.

Lock Waits/Min Total wait time for locks in the last minute.

Lock Timeouts/Min Number of lock requests that timed out. This includes internal requests for NOWAIT locks.

Copyright © 2014 Zoho Corp. Page 247


Applications Manager User Guide
Applications Manager User Guide Database Servers

Deadlocks/Min Number of lock requests that resulted in a deadlock.

Average Lock Wait Time The average amount of wait time for each lock request that resulted in a wait.

SQL Statistics

Parameters Description

Batch Requests/Min Number of SQL batch requests received by server.

SQL Compilations/Min Number of SQL compilations.

SQL Recompilations/Min Number of SQL re-compiles.

AutoParams/Min Number of auto-parameterization attempts.

Failed AutoParams/Min Number of failed auto-parameterizations.

Latch Details

Parameters Description

Latch Waits/Min Number of latch requests that could not be granted immediately and had to wait before being granted.

Average Latch Wait Time Average latch wait time for latch requests that had to wait.

Access Method Details

Parameters Description

Full Scans/Min Number of unrestricted full scans. These can either be base table or full index scans.

Range Scans/Min Number of qualified range scans through indexes.

Probe Scans/Min Number of probe scans. A probe scan is used to directly look up rows in an index or base table.

Database Details

Copyright © 2014 Zoho Corp. Page 248


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

DataFile Details Gives the DataFile size.

Log File Size Gives the Size of the Log File, used size of the Log File.

Transaction Details Gives the number of transaction per minute, replication transaction per minute, and the active transactions.

Log Flush Details Gives the number of Log Flush/minute, Log Flush waits/minute, and the Log Flush wait time.

In addition, Applications Manager displays more in-depth performance metrics such as System Tables, Table Relationship, User
Tables etc., of the selected database details page..

Parameters Description

• System Table Name - Name of the System Table.

• Total Rows - Total number of rows present in that table.


System Tables
• Total Space Used in MB - Size of the table (MB).

• Parent Table – Table which contains the primary / parent column for
the foreign key.

• Parent Column – The primary column for which a foreign exists.


Table Relationship
• Foreign Table – Table name of foreign key column.

• Foreign Column – The foreign key column name.

• System Table Name - Name of the User Table.

• Total Rows - Total number of rows present in that table.


User Tables
• Total Space Used in MB - Size of the table (MB).

• View Name - Name of the View.

• Schema Name - Schema Name to which this view is associated.

• IsIndexed - Shows if there is an index for the view ( 1 = Index Present,


0 = No Index ).
View Details
• IsIndexable - Shows whether an index can be created ( 1 = Index can
be created, 0 = No Index can be created ).

• Create Date - Date on which the view was created.

• Modify Date - Date on which the view was last modified.

Copyright © 2014 Zoho Corp. Page 249


Applications Manager User Guide
Applications Manager User Guide Database Servers

• Table Name - Name of the Table.

• Index Name - Name of Index present in the table.

• Maximum Size Row - Maximum size for a row in that table (in bytes).

• Max Noleafindex Row - Maximum size of a nonleaf index row (in


bytes).
Index Details
• File Group Name - Name of the filegroup (Primary or User-defined).

• Column Name - Name of the column for which index is present.

• Type - Data type of the Column.

• Clustered Index - Shows if the index is a Clustered Index or not (Yes or


No). A clustered index determines the physical order of data in a table.

• Object Name – Name of the table in which the index is present.

Indexes that have not • Index Name – Name of the index which is not used.
been used
• Type – Type of the Index.

• Table Name - Name of the table in which the index is present

• Index Name - Name of Index present in the table

• Fragmentation Percent - Percentage of Logical fragmentation present


Fragmentation Details
in the Index. This is the percentage of out-of-order pages in the leaf pages
of an index. The Percentage of Fragmentation should be as close to zero
as possible for maximum performance. However, values from 0% through
10% may be acceptable

• Object Name – Name of the table in which the index is present.

• Schema Name – Schema Name to which this table is associated.

• Index Name – Name of the index which is not used.

• Type – Type of the Index.


Indexes that have been
• User Seeks - The number of seeks in this index by user queries.
used
• User Scans - The number of scans in this index by user queries.

• User Lookups - The number of bookmark lookups in this index by user


queries.

• User Updates - The number of updates in this index by user queries.

Copyright © 2014 Zoho Corp. Page 250


Applications Manager User Guide
Applications Manager User Guide Database Servers

Scheduled Jobs

Parameters Description

Job Status Gives the Status of the job

Run date & time Gives the date & time for which the jobs are scheduled to run.

Job Time Gives the time taken by the job.

Retries Attempted Gives the number of times the scheduled jobs attempted to run.

SQL Performance

Applications Manager presents a host of performance metrics for the SQL Server. They are:

● Top Queries by CPU (displayed by default)


● Top Queries by I/O (Input/Output)
● Top Queries by CLR
● Top Slow Running Queries
● Top Queries by most frequently executed
● Top Queries by most frequently blocked
● Top Queries by Lowest Plan Reuse
● Cost of Missing Indexes
● Top Components by Memory Usage
● Top Waits by Waiting Tasks
● Top Waits by Waiting Tasks

Top Queries by CPU

Parameters Description

Avg. CPU Time Average CPU Time taken to execute the query.

Copyright © 2014 Zoho Corp. Page 251


Applications Manager User Guide
Applications Manager User Guide Database Servers

Total CPU Time The cumulative total amount of CPU time that has been spent running this query since the plan was compiled.

Query The SQL Query Text.

DB Name The database against which this query has been executed.

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Top Slow Running Queries

Displays information of Top 10 costly queries as measured by the Average Execution Time.

Parameters Description

Avg. Execution Time Average time taken for complete execution of this query.

Maximum Execution Time Maximum elapsed time for any complete execution of this query.

Minimum Execution Time Minimum elapsed time for any complete execution of this query.

The number of times that the query has been executed since the plan was
No of Executions
last compiled.

Query The SQL query text.

Last Execution Time The last time at which the query started executing.

Top Queries by Lowest Plan Reuse

Displays information of Top 10 queries whose query plan are not cached by the SQL Server. Query plan will be cached by SQL
Server for faster query execution.

Copyright © 2014 Zoho Corp. Page 252


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

Plan Usage Number of times this cache object has been used since its inception.

Cache Object Type Type of object in the cache. (Possible Values : Compiled Plan / Compiled Plan Stub / Parse Tree / Extended Proc / CLR Compiled Func / CLR Compiled Proc).

Query The SQL Query Text.

DB Name The Database against which this query has been executed (will be empty for ad hoc and prepared batches).

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Top Queries by I/O

Displays information of the Top 10 costly queries as measured by Average I/O operation (logical read and logical write operations).

Parameters Description

Average number of logical reads and logical writes performed by executions of


Avg. Logical I/O
this query.

The cumulative total number of logical reads and logical writes performed by
Total I/O
executions of this query since the plan was compiled.

Query The SQL query text.

The Database against which this query has been executed (will be empty for
DB Name
ad hoc and prepared batches).

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Copyright © 2014 Zoho Corp. Page 253


Applications Manager User Guide
Applications Manager User Guide Database Servers

Top Queries by Most Frequently Executed

Parameters Description

The number of times that the query has been executed since the plan was last
Execution Count
compiled.

Query The SQL query text.

The Database against which this query has been executed (will be empty for
DB Name
ad hoc and prepared batches).

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Cost of Missing Indexes

Displays information of the Top 10 missing indexes in the SQL Server. These indexes will have varying levels of impact on query
performance. From this table, you can find out the most costly missing indexes across all the databases on the server and thus help
finding out which missing indexes are likely to have the most significant impact on performance.

Parameters Description

Overall cost of the queries executing without having the recommended indexes. It
simply is a unit, the SQL Server Query Optimizer does its calculations with and is not
associated with any type of known measurement unit like seconds or CPU time.
Bigger the total cost number, more the resources could be saved after creating the
Total Cost
recommended index. You need to check the query execution plan before creating the
index for these particular columns and you need not check any other details. Also
note that every index has a negative impact on the inserts/updates/deletes on that
table and this impact can not be measured.

Copyright © 2014 Zoho Corp. Page 254


Applications Manager User Guide
Applications Manager User Guide Database Servers

Displays the average percentage of benefit that the user queries could experience if
this missing index group was implemented. This value means that the query cost
Avg. User Impact
would on average drop by this percentage if this missing index group was
implemented.

Displays the name of table (along with Database Name and Schema Name) in which
Table Name
the index is missing.

Displays the column names for which Index is missing. These column names are used
Equality Usage
in equality predicates of the form: table.column = constant_value

Displays the column names for which Index is missing. These column names are used
Inequality Usage in inequality predicates ( any comparison operator other than "=" ) of the form:
table.column > constant_value.

Displays the column names for which Index is missing. These column names are
Include Columns
Comma-separated list of columns needed as covering columns for the query.

Top Queries by CLR

Displays information of the Top 10 queries having high CLR time (Common Language Runtime inside Microsoft .NET Framework).

Parameters Description

Average Time consumed inside Microsoft .NET Framework Common Language


Average CLR
Runtime (CLR) for executions of this query.

The cumulative Total Time consumed inside Microsoft .NET Framework


Total CLR Common Language Runtime (CLR) objects by executions of this query since
the plan was compiled.

DB Name The Database against which this query has been executed.

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Copyright © 2014 Zoho Corp. Page 255


Applications Manager User Guide
Applications Manager User Guide Database Servers

Top Queries by most frequently blocked

Parameters Description

Average Time Blocked The average amount of time the query was blocked.

Total Time Blocked The cumulative total amount of time for which the query was blocked.

Query The SQL query text.

DB Name The Database against which this query has been executed.

Last Execution Time The last time at which the query started executing.

Average Execution Time Average time taken to execute an individual query.

Top Components by Memory Usage

Displays information about the various Memory clerks. Memory clerks allocates resource / memory to SQL memory object during
times of need.

Parameters Description

Component Type Displays the type of memory clerk.

Displays the Total amount of single page memory allocated in kilobytes


Single Pages(KB) (KB) directly from the buffer pool. Its is the memory consumed by this
component from the Buffer pool.

Copyright © 2014 Zoho Corp. Page 256


Applications Manager User Guide
Applications Manager User Guide Database Servers

Displays the total amount of multipage memory allocated in (KB) from


Multi Pages(KB)
outside the buffer pool.

Displays the total amount of virtual memory reserved directly by the


Virtual Memory Reserved(KB)
component that uses this clerk.

Displays the total amount of virtual memory that is committed by the


Virtual Memory
memory clerk. This should be always less than the amount of reserved
Committed(KB)
memory.

Displays total amount of memory that is allocated by the memory clerk


AWE Memory Allocated(KB)
by using Address Windowing Extensions (AWE).

Displays the total amount of shared memory that is reserved by a


Shared Memory
memory clerk memory reserved for use by shared memory and file
Allocated(KB)
mapping.

Shared Memory Displays the total amount of shared memory that is committed by the
Committed(KB) memory clerk.

Top Waits by Waiting Tasks

Parameters Description

Wait Type Indicates name of the wait type.

Waiting Tasks Displays the number of waits on that particular wait type.

Wait Time Total time in milliseconds for that particular type of wait.

Average Wait Time Average time in milliseconds for that particular type of wait.

Displays the difference between the time the waiting thread was signaled and when
Signal Time
it started running.

Copyright © 2014 Zoho Corp. Page 257


Applications Manager User Guide
Applications Manager User Guide Database Servers

Backup/Restore Details

Backup Details

Displays the performance metric about various SQL backup set present in the SQL Server.

Parameters Description

DB Name Displays the name of the database involved in the backup operation.

Start Displays the date and time of the back up operation started.

End Displays the date and time of the back up operation ended.

Expiration Displays the date and time the back up operation is supposed to expire.

If the value is 1, then it means that the damage to database was detected while
Damaged this back up was being created. However the back up operation continued despite
the errors.

Size Displays the size of the back up set (in bytes).

Physical Name Displays the physical name of the back up device.

Backup Age (Hours) Displays the number of hours passed since the back up operation was completed.

Restore Details

Displays the performance metrics about various Restore operation in the SQL Server.

Copyright © 2014 Zoho Corp. Page 258


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

Displays the name of the destination database for which the restore operation operate
DB Name
upon.

Restore by Displays the name of the user who performed the restore operation on the database.

Displays the type of restore operation performed which could be either Database / File /
Restore Type
Filegroup / Log / Verifyonly / Differential / Revert.

Started Displays the date and time of the restore operation.

Restore From Displays the physical name of the backup file created.

Restore To Displays the name of the file where the backup was restored to.

Replication Details

Log Shipping Status

Parameters Description

Database Name Displays the name of the database.

Agent Type Displays the type of agent - Backup, Copy or Restore.

Displays the status of the database log shipping - Starting, Running, Success,
Status
Error, Warning.

Time Elapsed (in min) Displays the total time taken to run the log shipping operation.

Log Time Displays the time and date last log shipping operation.

Error Log Time Displays the time of the last error log shipping operation ran.

Copyright © 2014 Zoho Corp. Page 259


Applications Manager User Guide
Applications Manager User Guide Database Servers

Displays the error messages received while running the log shipping operation if
Error Message
any.

Replications Monitor Details

Publications

This table displays status information for all publications available in the corresponding SQL monitor.

Parameters Description

Status The status of each publication.

Publication Name of the publication

Type Type of the publication

No. of Subscriptions Number of subscriptions associated with the corresponding publication.

Synchronizing The number of distribution agents running for the publication.

Current Average Performance Current average performance of the replication based on the latency.

Current Worst Performance Current worst performance of the replication based on the latency.

Subscriptions

Applications Manager provides information about subscriptions available in the corresponding monitor.

Parameters Description

Copyright © 2014 Zoho Corp. Page 260


Applications Manager User Guide
Applications Manager User Guide Database Servers

Running status Status of each subscription.

Subscription Name of the subscription

Publication Name of the publication running the corresponding subscription.

Performance Performance of the subscription.

Latency Latency value

Shows expiring status of the subscription which can be one of the following
• Expired
Expiration Status
• Expiring soon
• Critical

Replication Agents

Replication Agents tab displays information about each replication agent running in the corresponding monitor.

Parameters Description

Agent Name Name of the agent involved in the replication

Agent Type Type of the agent

Current Status Current status of the agent

[Database].[Publication] Name of the publisher

Last Start Time Last start time of the agent

Duration (HH:mm:ss) Duration of the agent session.

Delivary Rate (cmds/sec) Ratio of delivered commands to the duration of the agent.

The current amount of time, in milliseconds, elapsed from when transactions


Latency
are applied at the Publisher to when they are delivered to the distributor.

Copyright © 2014 Zoho Corp. Page 261


Applications Manager User Guide
Applications Manager User Guide Database Servers

#Trans The number of transactions delivered to the distributor.

#Cmds The number of commands delivered to the distributor.

The average number of commands per transaction delivered to the distributor


Avg #Cmds
for the session.

Replication Agent History Table

Displays the performance metrics of various agents history running in SQL server. You will be able to view replication agent's
history when you click on the corresponding agent from Agent Details table. This will show the step by step agent execution history
for that corresponding agent in a pop-up window.

Parameters Description

Current status Current status of the agent

Last start time Last start time of the agent

Duration (HH:mm:ss) Duration of the agent session.

Last Action Displays the last action message of the agent.

SQL Session Details

Parameters Description

PID Displays the SQL server session ID running in SQL Server.

Copyright © 2014 Zoho Corp. Page 262


Applications Manager User Guide
Applications Manager User Guide Database Servers

Displays the status of the process in SQL Server. The possible values are:
• Dormant : SQL Server session that hasn't done any work in more than an
hour.
• Running : SQL Server session running one or more batches. A session can
run multiple batches when Multiple Active Result Sets (MARS) is enabled.
• Background : SQL Server session running a background task, such as
deadlock detection.
• Rollback : SQL Server session which has a transaction rollback in process.
Status • Pending : SQL Server session waiting for a worker thread to become
available.
• Runnable : The task in SQL Server session which is in the runnable queue
of a scheduler while waiting to get a time quantum.
• Spinloop : The task in SQL Server session waiting for a spinlock (Spinlock
is a lock where the thread waits in a loop, repeatedly checking until the lock
becomes available) to become free.
• Suspended : SQL Server session is waiting for an event, such as I/O, to
complete.

User Name The login name used for executing the process.

Host The host machine name from where the session has been established from.

Program The application in SQL Server which has established the session.

The number of pages in the procedure cache that are currently allocated to
Memory Usage
this process.

CPU Time (ms) The cumulative CPU time for the process running in the SQL Server.

The cumulative Disk reads and writes for the process running in the SQL
I/O
Server.

Displays the ID of the session that is blocking the request.


• If this column is 0, then the request is not blocked, or the session
information of the blocking session is not available (or cannot be identified).
• If value is -2, then the blocking resource is owned by an orphaned
Blocked distributed transaction.
• If value is-3, then the blocking resource is owned by a deferred recovery
transaction.
• If value is -4, then the Session ID of the blocking latch owner could not be
determined due to internal latch state transitions.

DB Name Displays the name of the database currently being used by the process.

Command Name Displays the command that is being currently executed.

Query Displays the query for the selected database session.

Copyright © 2014 Zoho Corp. Page 263


Applications Manager User Guide
Applications Manager User Guide Database Servers

Kill Allows you to kill the session of the selected database.

The time, in milliseconds, in which this task is waiting for a resource. When
Wait Time (ms)
the task is not waiting, the wait time is 0.

Last Wait Type The name of the last wait type.

Wait Resource The name of the resource that is needed.

SQL Host Details

Parameters Description

Host Connected to the


Displays the hosts name connected to the SQL server.
SQL

No. of Connections Displays the number of connections each host has to the SQL server.

Memory Usage Displays the total memory usage by each host connected to the SQL server.

Displays the total CPU time (in milliseconds) of each host connected to the
CPU Time (ms)
SQL server.

The cumulative Disk reads and writes for the process running in the SQL
I/O
Server.

SQL Session Lock Details

Parameters Description

PID The SQL Server sessions ID.

Copyright © 2014 Zoho Corp. Page 264


Applications Manager User Guide
Applications Manager User Guide Database Servers

The status of the process in SQL Server. The possible values are:
• Dormant : SQL Server session that hasn't done any work in more than an
hour.
• Running : SQL Server session running one or more batches. A session can
run multiple batches when Multiple Active Result Sets (MARS) is enabled.
• Background : SQL Server session running a background task, such as
deadlock detection.
• Rollback : SQL Server session which has a transaction rollback in process.
Status • Pending : SQL Server session waiting for a worker thread to become
available.
• Runnable : The task in SQL Server session which is in the runnable queue
of a scheduler while waiting to get a time quantum.
• Spinloop : The task in SQL Server session waiting for a spinlock (Spinlock
is a lock where the thread waits in a loop, repeatedly checking until the lock
becomes available) to become free.
• Suspended : SQL Server session is waiting for an event, such as I/O, to
complete.

Lock Type The type of Lock.

User Name The SQL login name used for executing the process in SQL Server.

DB Name The database currently being used by the process in SQL Server.

Object ID The Object ID associated the resource.

Host The host machine on which the SQL Server is running.

Program The application in SQL Server which has established the session.

Command Name The command that is being currently executed.

CPU Time (ms) The cumulative CPU time for the process running in the SQL Server.

The cumulative Disk reads and writes for the process running in the SQL
I/O
Server.

The number of pages in the procedure cache that are currently allocated to
Memory Usage
this process.

The time, in milliseconds, in which this task is waiting for a resource. When
Wait Time (ms)
the task is not waiting, the wait time is 0.

Last Wait Type The name of the last wait type.

Copyright © 2014 Zoho Corp. Page 265


Applications Manager User Guide
Applications Manager User Guide Database Servers

Wait Resource The name of the resource that is needed.

SQL Session Blocked Lock Details

Parameters Description

Holding ID The Blocked sessions ID.

The status of the process in SQL Server. The possible values are:
• Dormant : SQL Server session that hasn't done any work in more than an
hour.
• Running : SQL Server session running one or more batches. A session can
run multiple batches when Multiple Active Result Sets (MARS) is enabled.
• Background : SQL Server session running a background task, such as
deadlock detection.
• Rollback : SQL Server session which has a transaction rollback in process.
Status • Pending : SQL Server session waiting for a worker thread to become
available.
• Runnable : The task in SQL Server session which is in the runnable queue
of a scheduler while waiting to get a time quantum.
• Spinloop : The task in SQL Server session waiting for a spinlock (Spinlock
is a lock where the thread waits in a loop, repeatedly checking until the lock
becomes available) to become free.
• Suspended : SQL Server session is waiting for an event, such as I/O, to
complete.

Lock Type The type of Lock.

Hold User The user the Lock.

Wait User The blocked user waiting for the Lock.

DB Name The Name of the database being used by the process.

Object ID The Object ID associated with the resource.

Hold Host The host machine holding the Lock.

Wait Host The Blocked Host waiting the Lock.

Host Command The Command being executed by the process holding the Lock.

Copyright © 2014 Zoho Corp. Page 266


Applications Manager User Guide
Applications Manager User Guide Database Servers

Wait Command The Command to be executed by the process waiting for the Lock.

The number of pages in the procedure cache that are currently allocated to
Memory Usage
this process.

The time, in milliseconds, in which this task is waiting for a resource. When
Wait Time (ms)
the task is not waiting, the wait time is 0.

Last Wait Type The name of the last or wait type.

Wait Resource The name of the resource that is needed.

Copyright © 2014 Zoho Corp. Page 267


Applications Manager User Guide
Applications Manager User Guide Database Servers

IBM DB2 DB Servers

To create a IBM DB2 database server Monitor, follow the given steps:

Note: IBM DB2 Version 8, 9 and 10 monitoring is supported. A DB2 user with SYSMON instance level authority is required for
monitoring DB2 server.
1. Click on New Monitor link.
2. Select DB2 DB Server.
3. Enter the IP Address or hostname of the host.
4. Enter the SubNetMask of the network.
5. Enter the port number in which DB2 is running.
6. Enter the polling interval time in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Provide the user name and password of user who has permission to access the DB2 database. The user name specified for
collecting the data from DB2 Server should have either System Administrator role or the user should be the DB owner for
master database.
9. Specify the Database Name.
10. Choose the Monitor Group from the combo box with which you want to associate DB2 database server Monitor (optional).
You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers DB2 database server from the network and starts monitoring them.

Supported Versions

Applications Manager supports monitoring of IBM DB2 8.x, 9 versions.

Monitored Parameters

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Copyright © 2014 Zoho Corp. Page 268


Applications Manager User Guide
Applications Manager User Guide Database Servers

Monitor Information

Parameters Description

Name Specifies the name of IBM DB2 server monitor.

Health Specifies the health (Clear, Warning, Critical) of the IBM DB2 server.

Type Specifies the type you are monitoring.

Version Specifies the version of the database server.

Port Specifies the port number at which the database server is running.

Instance Name The name of the instance in which the database is present

Server Status The current status of the database server itself

Started Time The date and time that the database manager was started using the db2start comma

Host Name Specifies the host at which the database server is running.

Host OS Specifies the OS of the host where the database server is running.

Last Alarm Specifies the last alarm that was generated for the database server.

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Availability Shows the current status of the server - available or not available.

Connection Statistics

Parameters Description

Connection Time Time taken to get connected to the IBM DB2 database server

Total Connections The total number of local and remote connections that currently present in the database manager

Local Connections The number of connections initiated from remote clients to the current instance of the database manager

Remote Connections The number of local applications that are currently connected to the database within the database manager

Copyright © 2014 Zoho Corp. Page 269


Applications Manager User Guide
Applications Manager User Guide Database Servers

Agents Statistics

Parameters Description

Active Agents The number of agents in the agent pool that are currently active and assigned to an application

Idle Agents The number of agents in the agent pool that are currently unassigned to any application

Number of Agents The number of agents registered in the current database manager instance

Agents Waiting The number of agents waiting for a token so they can execute a transaction in the database manager

Database Information

Parameters Description

Database Name The real name of the database for which information is collected

Health Specifies the health (Clear, Warning, Critical) of the database.

Database Alias The alias of the database provided when calling the snapshot function

Database Path The full path of the location where the database is stored on the monitored system

Database Status The current status of the database

Connected Time The date and time when the activate database was issued

Deadlock Rate The total number of deadlocks that have occurred in the given polling interval

Percentage of Log Utilization The total amount of active log space used in bytes in the database

Percentage of Sorts Overflowed The percentage of sorts that have over flowed

Transaction Statistics

Parameters Description

Successful Queries The total number of successful SQL statements executed at the database in the given polling interval

Failed Queries The number of SQL statements that were attempted, but failed at the database in the given polling interval

Copyright © 2014 Zoho Corp. Page 270


Applications Manager User Guide
Applications Manager User Guide Database Servers

This represents the total number of sql commits, internal commits, sql roll backs and internal roll backs done by the database
Units of Work
manager in the given polling interval

Cache Performance

Parameters Description

The hit ratio is a percentage indicating how well the package cache is helping to avoid reloading packages and sections for static
Package Cache Hit Ratio
SQL from the system catalogs as well as helping to avoid recompiling dynamic SQL statements.

Catalog Cache Hit Ratio The hit ratio is a percentage indicating how well the catalog cache is helping to avoid actual accesses to the catalog on disk

Buffer Statistics

Parameters Description

The buffer pool hit ratio indicates the percentage of time that the database manager loaded the required page from buffer pool in
Buffer Pool Hit Ratio
order to service a page request

The Index Page hit ratio indicates the percentage of time that the database manager accessed the index pages present in the buffer
Index Page Hit Ratio
pools.

The Data Page hit ratio indicates the percentage of time that the database manager accessed the data pages present in the buffer
Data Page Hit Ratio
pools.

Direct Reads The number of read operations that do not use the buffer pool

Direct Writes The number of write operations that do not use the buffer pool

TableSpace Status

Parameters Description

Name Refers to the name of the Table space.

Allocated Bytes calculated from (tablespace_total_pages)*(tablespace_page_size) and converted to MB

Copyright © 2014 Zoho Corp. Page 271


Applications Manager User Guide
Applications Manager User Guide Database Servers

Free Bytes calculated from (tablespace_free_pages)*(tablespace_page_size) and converted to MB

% of Free Bytes calculated from (tablespace_free_pages) /(tablespace_total_pages)*100

Copyright © 2014 Zoho Corp. Page 272


Applications Manager User Guide
Applications Manager User Guide Database Servers

IBM Informix Database Monitoring

Supported versions of Informix Server: Informix 10.x & above.

Prerequisite: Click to know about the user previleges and other necessary prerequisites to monitor IBM Informix database.

To create an Informix Server Monitor


1. Click on New Monitor link.
2. Select Informix under Database Servers.
3. Specify the Display Name of the Informix monitor
4. Enter the HostName or IP Address of the host where Informix server is installed.
5. Enter the port number for eg., 1526.
6. Enter the Database Server name i.e the name of the Informix database server to which you want to connect.
7. You can enter your own credential details or select preconfigured credentials from Credentials Manager. If you wish to enter
your own credentials, specify Informix username and password details for this monitor.
8. Set the Polling Interval.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group from the combo box with which you want to associate Informix Server Monitor (optional). You can
choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers Informix server from the network and starts monitoring them.

IBM Informix is one of the industry's most widely used database servers with a comprehensive set of high availability options, high
levels of performance, data replication capabilities, scalability and minimal administrative overhead for both simple and complex IT
infrastructures. Applications Manager performs effective monitoring, which is very critical in Informix administration, to collect
system and database performance stats, session details and to identify problems at an early stage for proactive troubleshooting
and performance tuning.

IBM Informix - Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Informix under the Database Servers Table.
Displayed is the Informix Database bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.

Copyright © 2014 Zoho Corp. Page 273


Applications Manager User Guide
Applications Manager User Guide Database Servers

● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Overview
● Database
● Sessions

Overview

Parameter Description

Response time The time taken to establish a JDBC connection with the Informix Server.

Database Space Details

Dbspace Name The unique name of the Database Space.

Allocated (MB) The total physical disk size allocated for the Database Space in MB.

Free (MB) The free physical disk size for the Database Space in MB.

Used % The percentage of physical disk utilization by the Database Space.

Disk Reads/sec The number of Disk Reads happening in the Database Space per second.

Disk Writes/sec The number of Disk Writes happening in the Database Space per second.

Database

Parameter Description

Name The name of the Database

Dbspace Name The Database Space which stores data for this database.

Owner The User ID of the creator of the database.

Created On The time at which the Database was created.

Is Logging
The current logging modes of a database:
• Unbuffered logging. Values are 1=Yes, 0=No
Is Buff Log
• Buffered logging. Values are 1=Yes, 0=No
• ANSI mode database. Values are 1=Yes, 0=No
Is ANSI
• NLS support. Values are 1=Yes, 0= No1
• Values are: I if case-insensitive for NCHAR and NVARCHAR columns, 0 if not
Is NLSIs Case Insens

Copyright © 2014 Zoho Corp. Page 274


Applications Manager User Guide
Applications Manager User Guide Database Servers

Sessions

Parameter Description

Session Id A unique identifier number assigned to the session.

User Name The User name of the Informix user account.

Host Name The host from which the user is connecting to the Informix database

Login Time The time at which the user connected to the database server.

Copyright © 2014 Zoho Corp. Page 275


Applications Manager User Guide
Applications Manager User Guide Database Servers

SAP HANA Monitoring

To create an SAP HANA DB Server Monitor:


1. Click on New Monitor link.
2. Select SAP HANA under Database Servers.
3. Specify the Display Name of the SAP HANA monitor
4. Enter Host Name of HANA server.
5. If Using SAP HANA Cloud Platform,
● Select SAP HANA Cloud Platform.
● Enter Cloud Account Name, UserName and Password.
6. Enter Port as IndexServer port, default port is 30015.
7. You can enter your own credential details or select pre-configured credentials from Credentials Manager. If you wish to enter
your own credentials, specify SAP HANA username and password details for this monitor.
8. Enter Database Username and Database Password.
9. Enter Instance Name.
10. Set the Polling Interval.
11. If you are adding a new monitor from an Admin Server, select a Managed Server.
12. Choose the Monitor Group from the combo box with which you want to associate SAP HANA Server Monitor (optional). You
can choose multiple groups to associate your monitor.
13. Click Add Monitor(s). This discovers Informix server from the network and starts monitoring them.

Prerequisites:
1. Need to copy ngdbc.jar into the location /working/classes. ngdbc.jar can be copied from installed SAP HANA Client folder.
Click here to download SAP HANA Client
2. If HANA is running ondemand, in addition to the above SAP Cloud Platform SDK is needed, this is not needed for HANA On
premise. Click here to download SAP Cloud Platform SDK. The downloaded zip should be extracted under
APM_HOME/working/hanacloud folder. After extracting need to verify whether APM_HOME/working/hanacloud/tools folder is
available.
3. Need to restart APM after performing the above steps.
4. To effectively monitor SAP HANA, the SAP HANA DB User must have the below privileges,
● System privilege CATALOG READ.
● Object privilege SELECT on the schema _SYS_STATISTICS.
5. To grant these privileges to the user, execute the below statements in SAP HANA SQL console.(Replace USER_NAME with
actual HANA DB Username)
● GRANT MONITORING to USER_NAME
● CALL GRANT_ACTIVATED_ROLE ('sap.hana.admin.roles:Monitoring','USER_NAME')

Copyright © 2014 Zoho Corp. Page 276


Applications Manager User Guide
Applications Manager User Guide Database Servers

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on SAP HANA under the Database Servers Table.
Displayed is the SAP HANA bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Overview
● Alerts
● Caches
● Jobs
● Expensive Statements
● Transactions
● Workload
● Backup
● Replication
● Schema
● Disk
● Services

Overview

Parameter Description

Memory and CPU

Memory Utilization Percentage of Memory Utilized by HANA System as a whole


CPU Utilization Percentage of CPU Utilized by HANA System as a whole
CPU Available No. of CPU Available
CPU Used Used no. of CPU.
Total Physical Memory Total Physical Memory of HANA System
Used Physical Memory Memory Used by HANA System
Total Swap Memory Total Swap Memory allocated for HANA System

Connection Statistics

Active Connections Total No. of Active Connections

Copyright © 2014 Zoho Corp. Page 277


Applications Manager User Guide
Applications Manager User Guide Database Servers

Inactive Connections Total No.of Inactive connections

Memory Details of Host

Total Physical Memory Total Memory for each host in the HANA system.
Free Physical Memory Free Memory Available in individual host
Used Physical Memory Used Memory in individual host (HANA+other appllications)
Swap Memory Swap Memory of individual host
Used Swap Memory Swap Memory used.
Peak Memory Peak Memory used in each host

Memory Used By HANA

Allocation Limit Memory allocated for HANA in each host


HANA used memory Memory Used only by HANA in each host (Total resident)
The amount of memory used for column tables. (A major part of the SAP HANA
Memory Used by Column Tables
Used Memory is taken up by the data tables).
The total amount of memory used for row tables. (A major part of the SAP HANA
Memory Used by Row tables
Used Memory is taken up by the data tables).
Code & Stack Memory Memory used by HANA Code and Stack
The amount of physical memory actually in operational use by a process. (When
DataBase Resident a part of the virtually allocated memory actually needs to be used, it is loaded or
mapped to the real, physical memory of the host, and becomes "resident".)

System Information

Version The version of the SAP HANA database that is installed on the system.
System Type A SAP HANA system can be configured as a single-host or multiple-host system.
All Services Started Indicates if all services are started and the system is operational and accessible.
Platform The operating system of the SAP HANA system.
Instance ID The instance ID of the SAP HANA database.

Services

Parameter Description

Service name The name of the service.


CPU used The percentage of CPU used by the service.
Memory Used The memory used by each service.
Requests per sec The number of requests that are processed by the host computer.
The time (in milliseconds) that is taken by the service to respond to requests
Response Time
from the clients.
Active Requests count The number of active requests that are being processed by the service.
The number of requests that are waiting in a queue to be processed by a service
Pending requests count
in the SAP HANA database server.
Active Threads count The total number of active threads for the service.
The number of files that are currently opened through a service in the SAP HANA
Open File Count
database server.
The status of the service. The status can be no, yes, unknown, starting,
Service status
and stopping.

Disk

Copyright © 2014 Zoho Corp. Page 278


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameter Description

The type of disk usage on the host computer. The usage types are log,
Disk usage Type
data, trace, data_backup, and log_backup.
Total Disk Space The total Space allocated for each Disk
Disk Used Disk Used
Disk Free percentage The free space percentage of the disk.
Disk Path The path to the disk, disk location.
Disk Volume size The total disk space in GB.

Disk Volume

Service Name The name of the service.


Volume ID The unique volume identifier.
The type of file in the volume directories. Possible values are - DATA, LOG,
File Type
TRACE.
File Name The name of the file,
Total Volume Size The total data volume sizes of the SAP HANA servers.
Used Volume Size The total data volume sizes used.
Free Size The free memory size of the module.

Volume IO Statistics

Service Name The name of the service.


Volume ID The unique volume identifier.
Volume Path The Filesystem path.
Disk Type The Filesystem type.
Blocked Write Quotes The count of blocked write requests.
Total Reads Total number of file reads on the disk for all file types.
Total Failed Reads The number of failed reads from the disk.
Total Read Size The size of read data.
Total Appends Total number of file appends on the disk for all file types.
Total Writes Total number of file writes on the disk for all file types.
Total Failed Writes The number of of failed writes
Total Write Size The total size of written data.
Total I/O Time
Speed The I/O performance measured in MB per Second.

Schema

Parameter Description

No.of Column Tables The number of Column Tables in this partition.


Size of Column Tables Allocated memory size for fixed-size and variable-size column table paritions.
No. of Row Tables The number of Row Tables in this partition.
Size of row tables Allocated memory size for fixed-size and variable-size row table paritions.

Copyright © 2014 Zoho Corp. Page 279


Applications Manager User Guide
Applications Manager User Guide Database Servers

Replication

Parameter Description

Host Host name


Service Name Name of the Service
Site Name Logical site name
Secondary Host The secondary host name.
Secondary Site Name The secondary logical site name.
Replication Status Replication Status

Backup

Parameter Description

Backup Size The size of the backup.


Source Type name Type of persistence to be backed up: 'volume', 'topology'.
Service Type Name Type of database service: 'indexserver', 'nameserver', 'statisticsserver'.
Classification of backup catalog entries: 'complete data backup', 'data
Entry type Name
snapshot', 'log backup', 'log missing'
Start time Time stamp when backup started
Total Time TimeTaken for Backup
Result of corresponding action: 'successful', 'failed', 'running', 'cancel pending',
Backup status
'canceled'

Backup Configuration

Max Recovery File Age The maximum recovery file age in seconds.
Log Replay Step Size The Log replay step size in bytes.
Max Recovery Backint Channels The max number of parallel backint channels per request during recovery.
Backint Executable Link The link name of the backint executable.
Backint Executable The filename of the backint executable.
Backint Data Backup Path The data backup directory for backint.
File Data Backup Path The default directory for file-based data backups.
File Log Backup Path The current directory for file-based log backups.

Latest Backup Details

Latest Backup ID The unique ID of a data backup or a log backup respectively.


Latest Backup Start Time The start time of the backup operation.
Latest Backup End Time The end time of the backup operation.
The classification of backup catalog entries. The following types are supported:
Latest Backup Entry Type
'complete data backup', 'log backup', 'log missing'.
Latest Backup Destination Type The type of backup location. Possible values are - 'file' or 'backint'.
Latest Backup Size Specifies the size of the backup.

Workload

Copyright © 2014 Zoho Corp. Page 280


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameter Description

Current Execution Rate/min The current statement execution count per minute.
Current Compilation Rate/min The current statement preparation count per minute.
Current Transaction Rate/min The current transaction count per minute.
Current Commit Rate/min The total number of commits per minute.
Current Rollback Rate/min The total number of rollbacks per minute.
Current Memory Usage
The total size of used memory per minute.
Rate/min

Transactions

The Blocked Transaction data set provides information about the transactions that are waiting to acquire transaction locks held by
another transaction, network, or disk.

Parameter Description

Blocked Transaction Id The connection ID of the blocked transaction.


The connection ID associated with the write transaction that is holding the
Lock Owner Transaction Id
lock.
Blocked Time The time from when the transaction is blocked.
Waiting Schema Name The name of the schema on which the lock is placed.
Waiting Object Name The type of the object on which the lock is placed.
The type of lock that is held by the blocking transaction. The lock type can be
Lock Type
record, object, and metadata.
The access level of transactions to the locked record, table, and database. The
Lock Mode
lock mode can be shared, exclusive, and intentional exclusive.
Blocked Statement The statement that is blocking the transaction.

Expensive Statements

The Expensive Statement data set provides information about the statements for which execution time
was greater than the configured threshold.

Parameter Description

Statement Duration The time that is required for executing the statement.
Records The number of records in the database table.
Memory Size The memory required for computing the statement.
DB User The user name that is used to connect to the database.
Operation Type of operation: e.g. prepare, execute, fetch, close.
Statement The SQL statement that runs for duration longer than the defined threshold.
Error Code The error code associated with the query.

Copyright © 2014 Zoho Corp. Page 281


Applications Manager User Guide
Applications Manager User Guide Database Servers

Error Message The error message associated with the error code.

Jobs

Parameter Description

Connection Id The connection that triggered the operation.


Schema name Schema of the object.
Object name Name of the object.
Job Name The type of the operation.
Start Time The time when the operation was started.
The current status of the operation. One of the following values is possible:
Current Job Progress inactive, active, precommitted, aborting, partial_aborting, and
active_prepare_commit.

Caches

Parameter Description

Cache id The unique identifier for the cache.


Total Size Maximum available memory for each cache instance
Used Size Memory Used by Cache instance
Hits Count Number of cache hits for the cache instance.
Misses Count Number of cache misses for the cache instance.

Alerts

Parameter Description

Alert ID The ID of the current alert.


The severity of the alert occurrence. The severity might be different for each
Alert rating alert. The following values are possible: 1 (information message), 2 (warning
level 1), 3 (warning level 2), 4 (warning level 3), 5 (error message).
Alert TimeStamp The time according to the local server time when the alert was occurred.
Description The information about the alert.

Copyright © 2014 Zoho Corp. Page 282


Applications Manager User Guide
Applications Manager User Guide Database Servers

Sybase Database Server Monitoring

Supported Versions: Applications Manager supports monitoring of Sybase ASE 12.5.3 and above.

To create a Sybase database server Monitor, follow the given steps:


1. Click on New Monitor link.
2. Select Sybase.
3. Enter the IP Address or Host Name of the host.
4. Enter the SubNetMask of the network.
5. Enter the port number in which sybase is running.
6. Enter the polling interval time in minutes.
7. If you are adding a new monitor from an Admin Server, select a Managed Server.
8. Provide the user name and password of user who has permission to access the Sybase database. The user name specified
for collecting the data from Sybase should have either System Administrator role or the user should be the DB owner for
master database.
9. Specify the Database Name.
10. Choose the Monitor Group from the combo box with which you want to associate Sybase database server Monitor (optional).
You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers Sybase database server from the network and starts monitoring them.

Monitored Parameters

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed,
to view the following information.

Monitor Information

Parameters Description

Name Specifies the name of Sybase server monitor.

Copyright © 2014 Zoho Corp. Page 283


Applications Manager User Guide
Applications Manager User Guide Database Servers

Health Specifies the health (Clear, Warning, Critical) of the Sybase server.

Type Specifies the type you are monitoring.

Version Specifies the version of the database server.

Port Specifies the port number at which the database server is running.

Server Status The current status of the database server itself

Started Time The date and time that the database manager was started

Host Name Specifies the host at which the database server is running.

Host OS Specifies the OS of the host where the database server is running.

Last Alarm Specifies the last alarm that was generated for the database server.

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll is scheduled.

Availability Shows the current status of the server - available or not available.

Memory Usage

Parameters Description

Total Memory Total memory used by ASE server in kb

Used Memory Used memory available in ASE

Free Memory Free memory available in ASE

Used Memory % Percentage of memory used by ASE server

Copyright © 2014 Zoho Corp. Page 284


Applications Manager User Guide
Applications Manager User Guide Database Servers

Connection Statistics

Parameters Description

Connection Time Time taken to get connected to the Sybase database ASE server

Active Remote Connections The number of active remote connections after the ASE server has restarted

Max Remote Connections The number of max remote connections available in the ASE server

Active User Connections The number of active user connections after the ASE server has restarted

Max User Connections The number of max user connections available in the ASE server

Database Details

Parameters Description

Database Name Name of the database instances

Total Size Allocated space for the database in MB

Used Size Used space of database in MB

Used Size % Percentage of Used Size

Creator User who created the database

Health Health of the database

Current Process

Copyright © 2014 Zoho Corp. Page 285


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameters Description

Process Name The name of the process currently connected to ASE server

Host/IPAddress The Host Name / IP address of the process connected to ASE

User Name The name in which the process is connected to ASE

DB Name The name of the Database to which process is connected to ASE

Command The command executed by process connected to ASE (command shown here limits to 255 chrs)

Status The current status of the process

Physical_IO The Physical_IO of the process

MemUsage The memory used by the process

Time_Blocked secs The time blocked by the process is shown in secs

Current Transactions

Parameters Description

Type The type of the transaction

Coordinator The coordinator of the transaction

State The state of the current transaction like it is started or in process or ended

Connection The type of connection

DB Name The database name in which the transaction is executed

Process Name The process which is executing the transaction

Transaction Name The name of the transaction

Copyright © 2014 Zoho Corp. Page 286


Applications Manager User Guide
Applications Manager User Guide Database Servers

Starttime The time at which the transaction started

Copyright © 2014 Zoho Corp. Page 287


Applications Manager User Guide
Applications Manager User Guide Database Servers

PostgreSQL DB Servers

To create a PostgreSQL database server monitor, follow the steps given below:
1. Click on New Monitor link.
2. Select PostgreSQL.
3. Enter the Display Name of the database server.
4. Enter the IP Address or Host Name of the host.
5. Enter the port number in which PostgreSQL is running.
6. Provide the user name and password of user who has permission to access the PostgreSQL database.
7. Specify the DBName.
8. Enter the polling interval time in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group with which you want to associate the PostgreSQL database server to, from the combo box
(optional). You can choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers PostgreSQL database server from the network and starts monitoring them.

Supported Versions: 8.1 and above

The Availability tab displays the availability history of the PostgreSQL database servers in your network for the past 24 hours or 30
days. The Performance tab displays the Health Status and events for the past 24 hours or 30 days. The List view displays all the
PostgreSQL servers that you monitor along with their current availability and health status. You can also perform bulk admin
configurations from this view. Click on the individual monitors listed to view the following information:

Monitor Information

Parameter Description

Name Denotes the name of PostgreSQL database server monitor.

Type Denotes the type you are monitoring.

Health Denotes the health (Clear, Warning, Critical) status of the PostgreSQL server.

Last Polled at Specifies the time at which the last poll was performed.

Copyright © 2014 Zoho Corp. Page 288


Applications Manager User Guide
Applications Manager User Guide Database Servers

Next Poll at Specifies the time at which the next poll is scheduled.

Availability Shows the current status of the server - available or not available.

Connection Statistics

Parameter Description

Active Connections Number of currently active connections to the database

Total Users The total number of users active at the time of data collection

Lock Statistics

Parameter Description

Locks Held Number of locks held by the indicated session

Locks Wait Number of locks waiting in the database

Buffer Statistics

Parameter Description

Buffer Hits/min Total buffer hits (i.e., block read requests avoided by finding the block already in buffer cache) per minute

Copyright © 2014 Zoho Corp. Page 289


Applications Manager User Guide
Applications Manager User Guide Database Servers

Block Reads/Min Total disk blocks read per minute

Cache Hit Ratio The current ratio of buffer cache hits to total requests

Disk Usage Details

Parameter Description

Disk Usage Size of the on-disk representation of all tables in the database in MB

Index usage Size of the on-disk representation of all indexes in the database in MB

Index Scan Details

Parameter Description

Index scans/min Total number of index scans initiated per minute

Index Reads/min Total number of index entries returned by index scans per minute

Index Fetches/min Total number of live table rows fetched by simple index scans per minute

Query Statistics

Parameter Description

Row inserts/min Total numbers of rows returned by each type of scan per minute

Copyright © 2014 Zoho Corp. Page 290


Applications Manager User Guide
Applications Manager User Guide Database Servers

Row Updates/min Total of row insertions and updates per minute

Row Deletes/min Total number of rows deleted per minute

Transaction Details

Parameter Description

Total Commits Total transactions committed

Total Rollbacks Total transactions rolled back

Commits/Min Total transactions committed per minute

Rollbacks/Min Total transactions rolled back per minute

Table Level Scan Details

Parameter Description

Sequential Scans/min Total number of sequential scans per minute

Table Index Scans/min Total number of index scans per minute

Sequential Scan Rows Read/min Total number of rows returned by sequential scans per minute

Table Index Scan Rows Read/min Total numbers of rows returned by index scans per minute

Primary Database Object Statistics

Copyright © 2014 Zoho Corp. Page 291


Applications Manager User Guide
Applications Manager User Guide Database Servers

Parameter Description

Total Tables Total number of tables in the database server

Total Triggers Total number of triggers in the database server

Total Procedures Total number of procedures in the database server

Size of the Largest Table Size of the largest table in the database server

Largest Table(s) Largest table in the database server

Copyright © 2014 Zoho Corp. Page 292


Applications Manager User Guide
Applications Manager User Guide Database Servers

Apache HBase Monitoring

● Apache HBase - An Overview


● Monitoring Apache HBase - What we do
● Adding a new Apache HBase monitor / Using AddMonitor API
● Monitored Parameters

Apache HBase - An Overview

Apache HBase is a distributed, scalable, data store. Being open-sourced and non-relational, HBase is the database for you when you
need random, real-time read/write access to your Big Data. Apache HBase provides Google's Bigtable-like capabilities on top of
Hadoop and HDFS.

Top

Monitoring Apache HBase - What we do.

Applications Manager aims to help Apache HBase administrators monitor the cluster in terms of region distribution. Let’s take a
look at what you need to see to monitor Apache HBase, the performance metrics to gather and how you can ensure that your
HBase database is up and operating as expected with Applications Manager:

● Track HBase cluster metrics - Monitor HBase clusters to make sure your HBase cluster is up and running and is
continuously operating as expected. Track the average load, requests, and the number of dead, live and overall number of
region servers.
● Memory and JVM usage - Track memory usage details such as available memory, free and total swap space size, the
committed virtual memory size, etc. Keep track of JVM metrics to correlate server performance.
● Guage Region servers performance - Get metrics about the block cache, the cache hit and miss counts and the hit ratio.
Look at compaction metrics and and the total size of storage files that have been compacted.
● Fix performance problems faster - Get instant notifications when there are performance issues with the components of
Apache HBase components. Become aware of performance bottlenecks and take quick remedial actions before your end users
experience issues.

Top

Copyright © 2014 Zoho Corp. Page 293


Applications Manager User Guide
Applications Manager User Guide Database Servers

Apache HBase - Adding a new monitor

Supported versions: HBase version 1.x

Prerequisites for monitoring Apache HBase:

JMX MBeans are used to collect HBase metrics. To enable JMX, open HBase/conf/HBase-env.sh and uncomment/add the below JVM
arguments.

export HBase_JMX_BASE="-Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.authenticate=false"

export HBase_MASTER_OPTS="$HBase_MASTER_OPTS $HBase_JMX_BASE -


Dcom.sun.management.jmxremote.port=10101"

export HBase_REGIONSERVER_OPTS="$HBase_REGIONSERVER_OPTS $HBase_JMX_BASE -


Dcom.sun.management.jmxremote.port=10102"

Steps to create a new monitor

● To create an Apache HBase Monitor, follow the steps given below:


● Click on New Monitor link. Choose Apache HBase.
● Enter Display Name of the monitor.
● Enter the IP Address or hostname of the host in which HBase is running.
● Enter the JMX Port in the JMX Port field. For default installations of HBase, the JMX port number is 10101 for Master and
10102 for RegionServer.
● Enter the credential details like user name, password and JNDIPath or select credentials from a Credential Manager
list. If no authentication is required, then leave the fields blank.
● Enter the polling interval time in minutes.
● Click Test Credentials button, if you want to test the access to Apache HBase Server.
● Choose the Monitor Group from the combo box with which you want to associate Apache HBase Monitor (optional). You can
choose multiple groups to associate your monitor.
● Click Add Monitor(s). This discovers Apache HBase from the network and starts monitoring.

Top

Copyright © 2014 Zoho Corp. Page 294


Applications Manager User Guide
Applications Manager User Guide Database Servers

Use the AddMonitor API to add an Apache HBase monitor:

Syntax:

http://[hostname]:[port]/AppManager/xml/AddMonitor?apikey=[apikey]&type=HBase&displayname=[Displayname]&
HostName=[HostName]&Port=[Port]&UserName=[UserName]&Password=[Password]&JNDIPath=/jmxrm

Request Parameters:

The parameters involved in the API request are described below.

Field Description
apikey API key to create the HBase monitor.
type The type of the database you want to add. Value should be HBase
displayname Display name of the HBase monitor.
hostname The name of the host in which HBase is running.
port The port number where HBase is running.
username The name of the user who has permission to access the HBase database.
password The password of the user who has permission to access the HBase database.
JNDIPath JNDI path to be used.

Sample Request:

http://Prod-server7:9010/AppManager/xml/AddMonitor?apikey=0b719d6a4a564c8be86fbc60d3f0b996&type=HBase&
displayname=HBase&HostName=APP-W8-AIO-
5&Port=5000&UserName=admin&Password=Abc@123&JNDIPath=/jmxrmi

Top

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on HBase under the Database Table. Displayed is the
HBase bulk configuration view distributed into three tabs:

Copyright © 2014 Zoho Corp. Page 295


Applications Manager User Guide
Applications Manager User Guide Database Servers

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Overview
● IPC
● Master
❍ Region Server Details
● RegionServer
❍ Region Details
❍ Region Server Details
● HLog
● Configuration

Overview

Parameter Description

HBase MASTER OVERVIEW

Average Load The average number of regions served by each region server.
Dead Region Servers Count The number of dead region servers.
Region Servers Count The number of online region servers.
Cluster Requests / Min The total number of requests from all region servers to a cluster per minute.

HBase JVM METRICS

Total Heap Memory Calculates the total heap memory in MB.


Used Heap Memory Calculates the heap memory used in MB.
Committed Heap Memory Calculates the heap memory committed in MB.
Total Garbage Collections Total JVM garbage collection.

MEMORY DETAILS

Free Physical Memory Size The amount of free physical memory in Megabytes.
Free Swap Space Size Total amount of free swap space in Megabytes.
Total Physical Memory Size Total amount of physical memory in Megabytes.
Total Swap Space Size Total amount of swap space in Megabytes.
The amount of virtual memory that is guaranteed to be available to the running process in
Committed Virtual Memory Size
Megabytes.

THREAD DETAILS

The number of threads that are waiting for another thread to perform an action for up to a
Timed Waiting Threads Count
specified waiting time.

Copyright © 2014 Zoho Corp. Page 296


Applications Manager User Guide
Applications Manager User Guide Database Servers

Waiting Threads Count The number of threads waiting for another thread to perform a particular action.
Blocked Threads Count The number of threads that are blocked waiting for a monitor lock.
Runnable Threads Count The number of threads that are being executed in the JVM

Top

IPC

Parameter Description

IPC DETAILS

Number of Open Connections The number of open connections at the RPC layer.
Total Call Time The total call time, including both queued and processing time.
Number of Active RPC Handlers The number of RPC handlers actively servicing requests.
Number of Calls In Replication The number of currently enqueued operations received from replication.

DATA TRANSFERRED

Sent Data The number of bytes of sent data in the call queues.
Received Data The number of bytes of recieved data in the call queues.

EXCEPTIONS

Out of Order Scanner Exception


Unknown Scanner Exception
Region Too Busy Exception The region server is too busy exception.

Top

Master - RegionServer

Parameter Description

REGIONS IN TRANSITION

Copyright © 2014 Zoho Corp. Page 297


Applications Manager User Guide
Applications Manager User Guide Database Servers

Regions in Transition Counts the number of regions in transition.


Counts the number of regions in transition that exceed the threshold as defined by the
Regions in Transition over Threshold
property rit.metrics.threshold.time.

REGION SERVERS

Name The name of the region server.


Start Time The HBase master start time.

Top

Region Server - Region Details

Parameter Description

STORE FILES

Store File Count The number of store files in the RegionServer.


Store File Size The total size of the store files (data files) in the RegionServer.

MEMSTORE

Memstore Size The total Memstore memory size of the RegionServer.

COMPACTION DETAILS

Compactions Completed Count Total number of compactions completed since startup by the nodes.
Num Bytes Compacted Count The number of bytes compacted across all this entity's hregions.
Num Files Compacted Count The number of files compacted across all this entity's hregions.

HLog COUNT

Delete Count The total number of Delete requests in the RegionServer.


Increment Count The total number of Increment requests in the RegionServer.
Append Count The total number of Append requests in the RegionServer.
Mutate Count The total number of Mutate requests in the RegionServer.

OPERATIONAL LATENCY - SCAN NEXT

Scan Next Num Operations The numer of Scan Next operations across all this entity's hregions.
Scan Next Min The minimum latency for Scan operation in the RegionServer.
Scan Next Max The maximum latency for Scan operation in the RegionServer.
Scan Next Mean The mean latency for Scan operation in the RegionServer.
Scan Next Median The median latency for Scan operation in the RegionServer.

OPERATIONAL LATENCY - GET

Get Num Operations The total number of Get requests per second in the RegionServer.
Get Min The minimum latency for Get operation in the RegionServer.

Copyright © 2014 Zoho Corp. Page 298


Applications Manager User Guide
Applications Manager User Guide Database Servers

Get Max The maximum latency for Get operation in the RegionServer.
Get Mean The mean latency for Get operation in the RegionServer.
Get Median The median latency for Get operation in the RegionServer.

Top

Region Server Details

Parameter Description

CACHE DETAILS

Block Cache Count The number of Store Files cached in the block cache.
Block Cache Eviction Count The total number of blocks that have been evicted from the block cache.
Block Cache Free Size The number of bytes that are free in the block cache.
Block Cache Express Hit Percent The block cache hit percent for requests where caching was turned on.
Block Cache Hit Count The total number of block cache hits for requests, regardless of caching setting.
Block Cache Count Hit Percent The block cache hit percent for all requests regardless of the caching setting.
Block Cache Miss Count The total number of block cache misses for requests, regardless of caching setting.
Block Cache Size The number of bytes used by cached blocks.

SLOW OPERATIONS COUNT

Slow Append Count The number of appends that took more than 1000 ms to complete.
Slow Get Count The number of gets that took more than 1000 ms to complete.
Slow Put Count The number of puts that took more than 1000 ms to complete.
Slow Increment Count The number of increments that took more than 1000 ms to complete.
Slow Delete Count The number of deletes that took more than 1000 ms to complete.

Top

HLog

Parameter Description

HLog FILES SPLIT TIME

HLog Split Time Mean The average time to split the total size of a write-ahead log file.

Copyright © 2014 Zoho Corp. Page 299


Applications Manager User Guide
Applications Manager User Guide Database Servers

HLog Split Time Min The minimum time to split the total size of a write-ahead log file.
HLog Split Time Max The maximum time to split the write-ahead log file after a restart.
HLog Split Time Num Operations The time to split write-ahead log files.

HLog FILE SPLIT SIZE

HLog Split Size Mean The average time to split the total size of an HLog file.
HLog Split Size Min The minimum time to split the total size of an HLog file.
HLog Split Size Max The maximum time to split the total size of an HLog file.
HLog Split Size Num Operations The size of write-ahead log files that were split.

Top

Configuration

Parameter Description

CONFIGURATION

VM Name The Java virtual machine implementation name.


Boot Class Path The boot class path that is used by the bootstrap class loader to search for class files.
VM Vendor The Java virtual machine implementation vendor.
Spec Version The version of the JMX specification implemented by this product.

Top

Copyright © 2014 Zoho Corp. Page 300


Applications Manager User Guide
Applications Manager User Guide Database Servers

NoSQL Database Servers

NoSQL databases defined as a non-relational, distributed database, are gaining recognition as an alternative mode to the relational
database management system among the organizations.

Inspite of the fact that NoSQL databases have a number of significant advantages, they share almost an equal set of setbacks.
However when used appropriately, NoSQL databases can offer real benefits. How will you ensure a smooth and unruffled operation
of these boundless unstructured data?

Applications Manager provides NoSQL database monitoring, helping you to keep track of how the database is used and alerts you
on any threshold breaches ensuring the performance of the database to the highest standards.

The Applications Manager functionality includes the ability to collect metrics like Bytes received / sent per minute helping to
monitor the network traffic, Transaction details, response time, number of open connections, items cached, etc., from the NoSQL
database and present them using our dashboard in a simple and impactful manner.

The different NoSQL database servers supported are:

● CassandraDB Server
● CouchBase Server
● MongoDB Server
● Redis Server
● Memcached Database Server
● Oracle NoSQL

Browse through the different database servers that provide server information and their parameters being monitored.

Copyright © 2014 Zoho Corp. Page 301


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

CouchBase Monitoring

To create a CouchBase server monitor, follow the steps given below:


1. Click on New Monitor link.
2. Select CouchBase from Database Servers.
3. Specify the Display Name of the Mongo monitor
4. Enter the HostName or IP Address of the host where CouchBase process runs.
5. Enter the Port where the server is running.By default, it will be 8091.
6. Specify the Polling Interval in minutes.
7. Choose the Monitor Group with which you want to associate the CouchBase server to, from the combo box (optional). You can
choose multiple groups to associate your monitor.
8. Click Add Monitor(s). This discovers the CouchBase server from the network and starts monitoring it.

CouchBase Server is an open-source, distributed NoSQL document-oriented database and key-value store that is optimized for
interactive applications. CouchBase is designed to provide easy-to-scale key-value or document access with low latency and high
sustained throughput.

Applications Manager helps to actively monitor all aspects of a CouchBase server like health, availability, response time etc., and
helps take informed decisions in case of downtimes.

CouchBase - Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on CouchBase under the Database table. Displayed is
the CouchBase bulk configuration view distributed into three tabs:

● Availability tab, gives the availability history for the past 24 hours or 30 days.
● Performance tab gives the health status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Copyright © 2014 Zoho Corp. Page 302


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Click on the monitor name to see all the database details listed under the following tabs:

● Monitor Information
● Performance Overview
● Server Nodes
● Data Buckets

Monitor Information:

This tab contains all general information regarding the monitor like Monitor name, port, hostname, username, associated groups
etc.

Performance Overview

Cluster Details

Parameters Description

Total Memory (MB) Total memory available for the cluster.

Used Memory (MB) RAM usage of the cluster.

Free Memory (MB) Free memory available.

Cluster Disk Utilization (GB) Total disk usage of the cluster.

Total Cluster Storage (GB) Total disk space available for the cluster.

Other Data (GB) Disk used by other data other than Couchbase.

Usable Free Space (GB) Maximum free space available for Couchbase server.

Copyright © 2014 Zoho Corp. Page 303


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Server Nodes

Parameters Description

Server Node Name Server IP address where the Couchbase is running.

RAM Usage RAM usage of the server.

Swap Usage Swap usage of the server

CPU Usage CPU usage of the server.

Data Usage Data usage of this node.

Disk Usage Disk usage of this node.

Node Memory Utilization Memory Utilization of the alloted memory.

Active Items Active data is the data written in this node.

Replica Items Replica item is the copy of item from another node.

Node Disk Usage Individual node disk consumed by Couchbase.

Background Data Fetches Data not in cache and pulled from the disk.

Data Buckets

Parameters Description

Bucket Name Bucket name is the given name for the bucket.

Bucket Type Bucket type can be either memcached or Couchbase.

Nodes Number of nodes available in the Couchbase server.

Item Count Item count indicates the number of objects stored in the bucket.

Ops/Sec Ops/sec shows the number of operations per second for this data bucket.

Disk Fetches/Sec Disk fetches/sec shows the number of operations required to fetch the items from disk.

Used RAM Quota (MB) Memory used from the given quota.

RAM Quota (MB) Memory allocated for this bucket.

Quota Memory Utilization (%) Memory utilization from the available quota.

Data Usage (MB) Data used by this bucket.

Disk Usage (MB) Disk used by this bucket.

Current Connections The number of connections per host.

Cache miss ratio Ratio of the objects fetched from disk as opposed to memory. Value should be as for be as close to
0 performance.

Resident item ratio Ratio of items that are kept in memory versus stored on disk.

Total disk drain rate Number of items actually written to disk from the disk queue.

Copyright © 2014 Zoho Corp. Page 304


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Memory Headroom This value indicates when you need to allocate more memory to a bucket.

Copyright © 2014 Zoho Corp. Page 305


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

MongoDB

To create a Mongo database server monitor, follow the steps given below:
1. Click on New Monitor link.
2. Select Mongo.
3. Specify the Display Name of the Mongo monitor.
4. Enter the HostName or IP Address of the host where MongoDB/mongo process runs.
5. Enter the Port where the server is running.By default, it will be 27017.
6. To discover only this node and not all nodes in the ReplicaSet / Sharding disable the option Discover all nodes in the
ReplicaSet / Sharding. By default, it is enabled.
7. Check the Is Authentication Required field, to give the credentials to be used to connect to the MongoDB server. Now enter
the UserName and Password of the credential.
8. Specify the Polling Interval in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group with which you want to associate the MongoDB server to, from the combo box (optional). You can
choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers the MongoDB server from the network and starts monitoring it.

Monitored Parameters

MongoDB is monitored based on the parameters or the attributes listed below. These attributes provide information about the
functioning of the monitors of MongoDB. You can also configure thresholds to the numerical attributes monitored by the server
based on these details.

The Availability tab shows the Availability history of the MongoDB for the past 24 hours or 30 days. The Performance tab shows the
Health Status and events for the past 24 hours or 30 days. The List view enables you to perform bulk admin configurations. Click on
the individual monitors listed to view the following information:

Copyright © 2014 Zoho Corp. Page 306


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Monitor Information

Displays the basic information like the name of the server, host name, port where it is running and the associated groups.

Monitor Snapshot

This tab displays the availability and performance history for the past 6 hours. The businessview will help you have an integrated
high-level view of the links between the different nodes in the replica set or sharding server. However, this view will not be
available for single servers that are not part of any replica set or sharding server.

Server Stats

Parameters Description

Performance Status Specifies the used and free memory of the server in percentage.

Memory Utilization Specifies the used, free and total memory of the server in mega bytes.

Number of used and available connections in the database server. This will help to asses the current load and capacity requirements
Current Connections
of the server.

Specifies the amount of network traffic sent and received by the database, in bytes per second. This value will help you ensure that
Network Traffic
network traffic sent to and by the mongod process is consistent.

The total number of various database operations (insert, get, query, update, command) per second since the mongod instance last
Database Operations Counter
started. This data helps to analyze and track the load on the database.

Assert Errors The number of asserts (regular, warning, message, user, rollover) per second raised since the server process started.

Lock Statistics The time, in seconds, since the database last started.

Lock Current Queue Details Number of operations that are currently queued and waiting for the read-lock/ write-lock.

Lock Active Client Details Number of active client connections to the database, performing read/ write operations.

Background Flushes Number of times the database has flushed all writes to disk per second.

Background Flushes Statistics Total number of seconds that the mongod processes have spent writing data to disk.

Number of transactions written to the journal during the last journal group commit interval. A Journal is a sequential, binary
Journaling Commits transaction used to bring the database into a consistent state in the event of a hard shutdown. MongoDB performs group commits
when journaling, i.e., a series of operations are committed at once over many milliseconds. This is done to achieve high performance.

Journaling Data Number of data in megabytes (MB) written to journal during the last journal group commit interval.

Journaling Statistics Number of seconds spent for each phase of journaling in the last journal group commit interval.

Note: All the metrics above in Server Stats will be displayed for a mongod device. Whereas for a mongos device, only the first six
metrics will be displayed.

Copyright © 2014 Zoho Corp. Page 307


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Cursors

Parameters Description

The maximum number of open cursors a session can have at once. You can use this parameter to prevent a session from opening an
Number of open cursors
excessive number of cursors.

Number of timed-out cursors The number of timed out cursors since the last server restart.

Index Counters

Parameters Description

Index Accessed The number of indexes accessed by a MongoDB statement.

Index served from Memory Indexes that reside in memory and when queried, will be served from memory as long as the whole set fits in the memory.

Index served from Disk Indexes that don't fit in the memory and must be served from disk.

The ratio of hits to misses. The misses is the total number of times that an operation tried to access an index that was not in memory
Miss Ratio per collection. The hits is the total number of times that indexes have been accessed and the mongod was able to return the index
from memory per collection.

Page Faults

Parameters Description

The total number of page faults that occured when MongoDB reads from or writes data to parts of its data files that are not currently
Total Page Faults
located in physical memory or when physical memory is exhausted .

MongoDB on Windows counts both hard and soft page faults. The MongoDB page fault counter may increase dramatically in moments
Page Faults Counter
of poor performance and may correlate with limited physical memory environments.

Database Statistics

Parameters Description

Database Name The name of the database whose statistics are being monitored.

Collections The number of the Collections, i.e a group of MongoDB documents, in the database.

Copyright © 2014 Zoho Corp. Page 308


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Objects All the json data and performance objects in a collection.

Avgerage Object Size The average size of all the KEY:VALUE objects contained within the shard.

Data Size The size of data stored in a collection in MB.

Indexes The total number of indexes in the database.

Index Size The total size of all indexes on the database in KB.

File Size The size of the files that hold the database contents in MB.

Replica Stats

Parameters Description

Status information for MongoDB’s replica set configuration. Only when the current host has replication enabled these values will be
Replication Details
displayed.

Total number of various database replication operations (insert, update, delete, getmore, command) per second since
Replication Operations Counter
the mongod instance last started. These values will help to analyze the load on the replica.

Sharding Operations Counter - Total number of various database sharding and notsharding operations (insert, update, delete, getmore, command) per second since
Sharded/ NotSharded the mongos instance last started.

Note: The tab Replica Stats display only replication details for a mongod device and sharding details for a mongos device.

Copyright © 2014 Zoho Corp. Page 309


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Redis

To create a Redis database server monitor, follow the steps given below:
1. Click on New Monitor link.
2. Select Redis.
3. Specify the Display Name of the Redis monitor
4. Enter the HostName or IP Address of the host where Redis server runs.
5. Enter the Port where the server is running.By default, it will be 6379. Or else you can also check it in the redis.conf file.
6. To discover only this node and not all nodes in the cluster disable the option Discover all nodes in the cluster. By
default, it is enabled.
7. Check the Is Authentication Required field, to give the credentials to be used to connect to the Redis server. Now enter the
Password of the credential.
8. Specify the Polling Interval in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Choose the Monitor Group with which you want to associate the Redis server to, from the combo box (optional). You can
choose multiple groups to associate your monitor.
11. Click Add Monitor(s). This discovers the Redis server from the network and starts monitoring it.

If you have added Monitors and not associated them with a Monitor Group, you can do this manually anytime. For information on
associating a Monitor with a Monitor Group, refer to Associating Monitor with Monitor Groups topic.

Supported Versions: Redis 2.4 and above

Monitored Parameters

Redis database server is monitored based on the parameters or the attributes listed below. These attributes provide information
about the functioning of Redis database. You can also configure thresholds for the attributes monitored by the server based on
these details.

The Availability tab shows the Availability history of the Redis database for the past 24 hours or 30 days. The Performance tab
shows the Health Status and events for the past 24 hours or 30 days. The List view enables you to perform bulk admin
configurations. Click on the individual monitors listed to view the following information:

Copyright © 2014 Zoho Corp. Page 310


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Monitor Information

This tab displays the basic information like the name of the server, host name and the port where the server is running. Additional
parameters like ProcessID, RunID, uptime and associated groups are also displayed.

Performance

Parameters Description

Availability and Performance


Displays the availability and performance history for the last six hours.
History

CPU Usage Specifies the usage of CPU in percentage.

Children CPU Usage The CPU consumed by the background processes (like SORT, SUNION, BGSAVE, BGREWRITEAOF).

Memory Utilization Specifies the used, free and total memory of the server in mega bytes.

The ratio between the number of bytes that Redis allocated as seen by the operating system and the total number of bytes allocated
Memory Fragmentation Ratio
by Redis using its allocator.

Connected/ Blocked Clients Number of client connections and number of clients pending on a blocking call.

Rejected Connections Number of connections rejected because of maxclients limit.

Connections Stats Number of connections accepted by the server per second.

Operations Stats Number of commands processed per second.

Keyspace Stats Specifies the number of successful and failed lookup of keys in the main dictionary.

Keyspace Hit Percentage Percentage of the number of successful and failed lookup of keys in the main dictionary.

Expired/ Evicted Key Stats Displays the total number of key expiration events and the number of evicted keys due to max memory limits.

Publish Subscribe Stats The global number of pub/sub channels with cleint subscriptions.

Persistence

Parameters Description

Displays the details about RDB and AOF persistence states like the status of the last RDB save operation, status of the AOF rewrite
Persistence Stats
operation, etc.

Copyright © 2014 Zoho Corp. Page 311


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Database Stats Displays the details about the database, like the db name, total number of keys and number of expired keys.

Replication

Parameters Description

Displays if the replication role is master or slave. In case of slave, master node details like master host, master port and status of the
Replication Details
link, etc., are displayed.

Slave Connections Specifies the number of slaves connected. This graph will be populated in case of master node alone.

Copyright © 2014 Zoho Corp. Page 312


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Memcached Servers

To create a Memcached database server monitor, follow the steps given below:
1. Click on New Monitor link.
2. Select Memcached under Cloud Computing/Virtualization category.
3. Specify the Display Name of the memcached server
4. Enter the HostName or IP Address of the host where Memcached server runs.
5. Enter the Port where the server is running.
6. If you want to enable Transaction test, select 'Yes' radio button, otherwse select 'No' button.
7. Set the Polling Interval.
8. If you are adding a new monitor from an Admin Server, select a Managed Server.
9. Choose the Monitor Group with which you want to associate the Memcached server to, from the combo box (optional). You
can choose multiple groups to associate your monitor.
10. Click Add Monitor(s). This discovers the Memcached server from the network and starts monitoring it.

Supported Versions: Memcached v1.2 and above.

Monitored Parameters

Memcached Servers are monitored based on the parameters or the attributes listed below. These attributes provide information
about the functioning of the monitors of Memcached server. You can also configure thresholds to the numerical attributes
monitored by the server based on these details.

The Availability tab shows the Availability history of the Memcached server for the past 24 hours or 30 days. The Performance tab
shows the Health Status and events for the past 24 hours or 30 days. The List view enables you to perform bulk admin
configurations. Click on the individual monitors listed to view the following information:

Parameters Description

Copyright © 2014 Zoho Corp. Page 313


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Monitor Details

Availability Shows the current status of the Memcached server - available or not available

Performance Status

Used Memory Specifies the used memory of the server in percentage

Free Memory Specifies the free memory of the server in percentage

Hit Ratio Refers to the hit ratio in percentage

Memory Utilization

Used Memory Specifies the used memory of the server in mega bytes

Free Memory Specifies the free memory of the server in mega bytes

Total Memory Specifies the total memory of the server in mega bytes

CPU Utilization

User CPU* Specifies the accumulated user time for a process in seconds

System CPU* Specifies the accumulated system time for a process in seconds

Cached Hits and Misses

Hits/min Number of keys that have been requested and found present per minute

Misses/min Number of items that have been requested and not found per minute

GET and SET Requests

Gets/min Number of retrieval requests per minute

Sets/min Number of storage requests per minute

Cached Items

Items cached Current number of items stored by server

Evictions Number of valid items removed from cache to free memory for new items

Copyright © 2014 Zoho Corp. Page 314


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Network Traffic

Bytes Received Number of bytes read by this server from network per min

Bytes Sent Number of bytes sent by this server to network per min

Current Connections

Connections Number of open connections

Response Time

Response Time The time taken by Applications Manager to execute the STATS command on the memcached server

Version Version of Memcached server

Transaction

SET-Time The time taken by Applications Manager to set the content on the memcached server

GET-Time The time taken by Applications Manager to fetch the content from the memcached server

DELETE-Time The time taken by Applications Manager to delete the content from the memcached server

Total Transaction Time The total time taken to connect to memcached server, set content, fetch content and delete content from the server

* - not supported in Memcached installed in Windows

Copyright © 2014 Zoho Corp. Page 315


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Oracle NoSQL Database Server Monitoring

Applications Manager provides out-of-the-box performance metrics and helps you visualize the health and availability of an Oracle
NoSQL server farm. Database administrators can login to the web client and visualize the status and Oracle NoSQL performance
metrics.

Follow the given steps to create a Oracle NoSQL server monitor:


1. Click on New Monitor link.
2. Select Oracle NoSQL.
3. Enter the Display Name of the monitor
4. Enter the IP Address or hostname of the host.
5. Enter the JMX Port in which the JMX is running.
6. Enter the Additional JMX Port in which the JMX is already running in any of the other machine of the same cluster.

7. Choose the Credential Details either use below credentials or select from credential list
8. Enter the Username and Password of the Oracle NoSQL.
9. Enter JNDI Path ex. /jmxrmi
10. Enter the polling interval time in minutes.
11. Choose the Monitor Group from the combo box with which you want to associate Oracle database server Monitor
(optional). You can choose multiple groups to associate your monitor.
12. Click Add Monitor(s). This discovers Oracle database server from the network and starts monitoring them.

Note:

Ensure that you enable JMX for Oracle NoSQL monitoring. To create a new Oracle NoSQL monitor, you should have admin
privileges.

Setting up JMX for Oracle NoSQL monitoring

Oracle NoSQL Database allows Java Management Extensions (JMX) or Simple Network Management Protocol (SNMP) agents to be
optionally available for monitoring, in addition to the native monitoring provided by the Admin CLI and the Admin Console. These
agents provide interfaces on each storage node that allow management clients to poll them for information about the status,
performance metrics, and operational parameters of the storage node and its managed services, including replication nodes and
admin instances. Both these management agents can also be configured to push notifications about changes in the status of any of
the services, and for violations of preset performance limits. The JMX interface can be enabled in either the Community Edition or

Copyright © 2014 Zoho Corp. Page 316


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

the Enterprise Edition. To use SNMP, however, you must have the Enterprise Edition. The JMX service exposes MBeans for the three
types of components. These MBeans are the java interfaces StorageNodeMBean, RepNodeMBean, and AdminMBean in the package
oracle.kv.impl.mgmt.jmx. For more information about the status reported for each component, see the javadoc for these interfaces.

The same information that is reported via JMX can also be reported through SNMP. In this case, the information is organized
according to the Management Information Base (MIB) named OracleNosqlMIB, which is included with the Enterprise Edition, in the
file lib/nosql.mib.

Simple Network Management Protocol (SNMP) and Java Management Extensions (JMX)

Both the SNMP and JMX agents in NoSQL Database are read-only interfaces and allow you to poll the storage nodes for information
about the storage node and about any replication nodes or admins that are hosted on the storage node. The available information
includes service status (such as, RUNNING, STOPPED etc.), operational parameters, and performance metrics. SNMP and JMX
traps/notifications are also delivered for particular events. Notifications are sent for every service status state change; and for
violations of performance limits.

Enabling Monitoring

Monitoring can be enabled on a per-storage node basis in two different ways:

In the Bootfile

Copyright © 2014 Zoho Corp. Page 317


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

You can specify that you want to enable JMX or SNMP in the storage node's boot configuration file. Usually, these files are created
by using the makebootconfig utility, which has the following options to control these features:

● [-mgmt {snmp|jmx|none} -pollport <snmp poll port>]

● -traphost <snmp trap/notification hostname>]

● -trapport <snmp trap/notification port>]

Note

When you specify -mgmt snmp, you must also specify -pollport. The SNMP agent listens for connections from
SNMP management clients on this port. You may also optionally specify -traphost and -trapport to indicate the
destination address for notifications. This would be the hostname and port number of an SNMP management
service that is configured to receive notifications at that address.

Note

When you specify -mgmt jmx, you do not have to specify -pollport. A storage node's JMX agent uses the RMI
registry at the same port number as is used for all other RMI services managed by the storage node. (This port
number is specified as the -port argument to makebootconfig.)

By Changing Storage Node Parameters

You can still enable JMX or SNMP after a store is deployed, by changing the storage node parameters "mgmtClass", "mgmtPollPort",

Copyright © 2014 Zoho Corp. Page 318


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

"mgmtTrapHost", and "mgmtTrapPort". Similar to configuring via makebootconfig, the "mgmtPollPort", "mgmtClass",
"mgmtTrapHost", and "mgmtTrapPort" are used only for SNMP; and the parameter "mgmtPollPort" must be set when enabling
SNMP.

The value of the "mgmtClass" parameter may be one of the following class names:

● To enable JMX:
oracle.kv.impl.mgmt.jmx.JmxAgent
● To enable SNMP:
oracle.kv.impl.mgmt.snmp.SnmpAgent
● To enable neither JMX nor SNMP:
oracle.kv.impl.mgmt.NoOpAgent

For example, you could issue the following command in the Admin CLI to enable SNMP on a storage node:

plan change-parameters -service sn1 -wait -params


mgmtClass=oracle.kv.impl.mgmt.snmp.SnmpAgent
mgmtPollPort=5002 mgmtTrapHost=192.168.26.42
mgmtTrapPort=32767

Note

Only a single implementation of the management agent may be enabled at a particular time. If you enable
SNMP on a storage node where JMX is already enabled; the JMX agent shuts down, and the SNMP agent takes its
place.

Displaying the NoSQL DB MBeans

To view the NoSQL Database JMX Mbeans in a monitoring tool such as JConsole, connect using the hostname and registry port for
each Storage Node that you would like to view. This is the port that is named by the "-port" argument to the java -jar kvstore.jar
makebootconfig command. It is also used in the deploy-sn plan during configuration. The documentation examples use 5000 as the
registry port.
For example, you would specify localhost:5000 to the JConsole Remote Process connection box in the New Connection tab.

Monitored Parameters

Note:
• To create a new Oracle NoSQL monitor, you should have admin privileges.
• Jconsole can also be used to access the Mbeans

Copyright © 2014 Zoho Corp. Page 319


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Oracle NoSQL Monitoring Metrics

Copyright © 2014 Zoho Corp. Page 320


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Admin Attributes

Attribute Name Description

Admin ID Number of an Admin instance.

HttpPort The port number used by the Admin Console web application.

LogFileCount Number of log files that are kept.

LogFileLimit The maximum size of log files.

Master Whether this Admin is the master among Admin instances.

PollPeriodMillis The polling period for collecting metrics.

ServiceStatus The reported service status of the Admin.


Storage Attributes

Attribute Name Description

Capacity The number of Replication Nodes that can be hosted on this Storage Node.

AdminHttpPort The http port used by the Admin Console web application.

HostName The name of the network interface used for communication between Replication Nodes

HAPortRange The range of port numbers available for assigning to Replication Nodes that are hosted
on this Storage Node.

HostingAdmin True if this Storage Node hosts an Admin instance

MemoryMB The amount of memory known to be available on this Storage Node, in megabytes.

MountPoints A list of file system mount points on which Replication Nodes can be deployed

NumCPUs The number of CPUs known to be available on this Storage Node.

RegistryPort The port number of the Storage Node's RMI registry.

RootDirPath The pathname of the store's root directory

SnId the StorageNodeId number of this Storage Node.

StoreName The configured name of the store to which this Storage Node belongs.

Replicated Node Table Attribute

Attribute Name Description

CacheSize The size of the BDB-JE cache, in MBytes.

CollectEnvStats If true, then the underlying BDB-JE subsystem will dump statistics into a local .stat file.

CommitLag Average commit lag(in milliseconds) for a given replication node's update operations
during a given time interval.

RepNodeId The RepNodeId, in its String form

CommitLagThreshold Average commit lag (in milliseconds) for a given replication node during a given time
interval exceeds the value returned by this method, a notification event will be sent to
any parties that have registered interest.

CumulativeEnd The timestamp at the end of a cumulative measurement period.

CumulativeLatAvg The average latency for single operations since service startup.

CumulativeLatMax The highest latency measured for single operations since service startup.

CumulativeStart The timestamp at the beginning of a cumulative measurement period

CumulativeThroughput Single operations per second since service startup.

CumulativeTotalOps The total number of single operations since service startup.

HeapMB The size of the Java heap for this Replication Node, in MB.

IntervalLatAvg Average Latency of Operations in the given Interval

Copyright © 2014 Zoho Corp. Page 321


Applications Manager User Guide
Applications Manager User Guide NoSQL Database Servers

Copyright © 2014 Zoho Corp. Page 322


Applications Manager User Guide
Applications Manager User Guide ERP

Oracle E-Business Suite Monitoring

Oracle E-Business Suite (Oracle EBS) monitor allows you to monitor the availability and performance of Oracle EBS from a
centralized web console. Data of Oracle E-Business Suite are collected using DMS stands for Dynamic Monitoring Service (a web
application which get data from the fusion middleware components). Data that is created and updated by DMS-enabled applications
and components is accessible through the DMS Spy Servlet. Only users having administrator rights can access this servlet.

Create an Oracle EBS monitor

Oracle EBS Versions Supported: R11i, R12.0 and R12.2.0


Prerequisites for monitoring Oracle EBS: Applications Manager uses the Dynamic Monitoring Service (DMS) provided by
Oracle Application Server to monitor the same. For this reason, the DMS Servlet has to be made accessible to the system where the
Applications Manager is running. Refer Prerequisites Section.
Follow the steps given below to create a new Oracle EBS monitor in Applications Manager:
1. Click on New Monitor. Click on Oracle EBS.
2. Enter Display Name.
3. Provide Host Name & Port.
4. Select the EBS Server Version - R11i, R12.0 or R12.2.0
5. If you select Version R12.2.0, a username and password details are mandatory. You can enter your own credential details or
select preconfigured credentials details in Credentials Manager. If you wish to enter your own credentials, specify
username and password details for this monitor.
6. SSL Enabled checkbox- If SSL authentication is enabled on the server connection channel then select this option.
7. Enter the polling interval time in minutes.
8. If you are adding a new monitor from an Admin Server, select a Managed Server.
9. Choose the Monitor Group from the combo box to which you want to associate the Monitor (optional). You can choose
multiple groups to associate your monitor.
10. Click Add Monitor(s). Upon adding the Oracle EBS monitor, you can view the details of the newly added Oracle monitor.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Oracle EBS under the ERP Table. Displayed is the
Oracle EBS bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● For Oracle E-Business Suite R11i:


● Performance Overview
● For Oracle E-Business Suite R12.0:

Copyright © 2014 Zoho Corp. Page 323


Applications Manager User Guide
Applications Manager User Guide ERP

● Performance Overview
● Process Information
● Applications
● For Oracle E-Business Suite R12.2.0:
● Performance Overview
● Process Information
● Clusters
● Servers
● Applications
● Forms
● Oracle Process Manager and Notification Server
● Web Cache

For Oracle E-Business Suite R11.0:

Performance Overview

Parameter Description

Name The name of Oracle EBS monitor.

Health The health (Clear, Warning, Critical) of the server

Type The type you are monitoring.

Last Polled at The time at which the last poll was performed.

Next Poll at The time at which the next poll is scheduled.

Availability The current status of the server - available or not available.

Connection Statistics

Connections per Minute Number of times an HTTP connection was established.

Active Connections Number of connections that are active.

Requests Statistics

Active Requests Number of requests that are active

Completed Requests per min Number of HTTP request completed per minute

Response Time

Average Response Time Average Response time of the request

Minimum Response Time Minimum Response time for the request

Maximum Response Time Maximum Response time for the request

Process Stats

Process Name Name of the process like BDMSProcess

Heap Size Heap memory size of the process

Copyright © 2014 Zoho Corp. Page 324


Applications Manager User Guide
Applications Manager User Guide ERP

For Oracle E-Business Suite R12.0:

Performance Overview

Parameter Description

Active Requests Number of child servers currently in the request processing phase.

Completed Requests per min Number of HTTP request completed per minute

Average Response Time Average time required to service an HTTP request

Min Response Time Minimum time required to service an HTTP request

Max Response Time Maximum time required to service an HTTP request

Active Connections Number of connections currently open

Connections per Minute Number of times an HTTP connection was established.

Virtual Host Processes

Virtual Host Name Specifies Virtual host name.

Active Requests Total time spent processing requests for this virtual host.

Completed Requests Per Minute Number of requests processed completely per minute.

Average Response Time Average time spent processing requests for this virtual host.

Applications

Parameter Description

Applications Requests

Applications The echo of the value specified as the path for OC4J Mount directive in mod_oc4j.conf.

Specifies the number of requests per minute, both session and non-session together, that mod_oc4j successfully routed to
Success Requests per Minute
an OC4J instance.

Error Requests per Minute The number of requests per minute, both session and non-session, that mod_oc4j failed to route to an OC4J.

Sessions Success Requests per Minute Specifies the number of session requests per minute that mod_oc4j successfully routed to an OC4J instance.

Sessions Error Requests per Minute The number of session requests per minute that mod_oc4j failed to route to an OC4J.

Non-Sessions Success Requests per


Specifies the number of non-session requests per minute that mod_oc4j successfully routed to an OC4J instance.
Minute

Non-Sessions Error Requests per Minute The number of non-session requests per minute that mod_oc4j failed to route to an OC4J.

Process Information

Parameter Description

Process Details

Process ID The process ID for the process.

Process Name The process name.

Heap Size The heap size of the process in MB.

Copyright © 2014 Zoho Corp. Page 325


Applications Manager User Guide
Applications Manager User Guide ERP

For Oracle E-Business Suite R12.2.0:

Performance Overview

Parameter Description

Server Name The name of the Server.

Process Name of the process. For eg, opmn:/EBS_web_VIS_OHS.

Min Response Time (ms) Minimum time required to service an HTTP request.

Max Response Time (ms) Maximum time required to service an HTTP request.

Average Response Time (ms) Average time required to service an HTTP request.

Active Requests Child servers currently in the request processing phase.

Completed Requests per minute Number of HTTP request completed per minute.

Active Connections Number of connections currently open

Connections per Minute Number of times an HTTP connection was established.

Virtual Hosts Process Stats

Virtual Host Name Host name of the virtual host.

Server Name The name of the Server.

Active Requests Number of requests currently being processed by this host.

Average Response Time Average time spent processing requests for this virtual host

Completed Requests Per Minute Number of requests processed completely per minute

Process Information

Parameter Description

Process Details

Process Name of the process. For eg, opmn:/EBS_web_VIS_OHS.

Host Name The name of the host where the process is running.

Server name The name of the Server.

Heap Size The heap size of the process.

Clusters

Parameter Description

Cluster Statistics

Cluster Name Specifies Cluster Name

Number of managed servers in running state. Servers in the following states are taken as running servers:
• RUNNING
• STARTING
• ADMIN
Running Servers
• STANDBY
• RESUMING
• SUSPENDING
• FORCE_SUSPENDING

Number of managed servers in shutdown state. Servers in the following states are taken as Shutdown servers:
Shutdown Servers • SHUTTING_DOWN
• SHUTDOWN

Failed Servers Number of managed servers in failed state

Server Status

Copyright © 2014 Zoho Corp. Page 326


Applications Manager User Guide
Applications Manager User Guide ERP

Server Name Specifies Server Name

Specifies state of the server. Possible States are:


• Starting - During the STARTING state, a WebLogic Server instance transitions from SHUTDOWN to STANDBY, as a result of a Start, Start in
Admin, or Start in Standby command.
• Resuming - The WebLogic Server performs the operations required to move itself from the STANDBY or ADMIN state to the RUNNING state.
• Running -The WebLogic Server is fully functional, offers its services to clients, and can operate as a full member of a cluster.
• Admin - In the ADMIN state, WebLogic Server is up and running, but available only for administration operations, allowing you to perform
server and application-level administration tasks.
• StandBy - The WebLogic Server instance transitions from SHUTDOWN to STANDBY. A server instance in STANDBY does not process any
request—its regular Listen Port is closed.
Server State • Suspending - The WebLogic Server performs the operations required to place itself in the ADMIN state, suspending a subset of WebLogic Server
subsystems and services, and completing a predefined portion of the application work currently in process
• Force_Suspending - The WebLogic Server performs the operations required to place itself in the ADMIN state, suspending a subset of WebLogic
Server subsystems and services in an ordered fashion. During the FORCE_SUSPENDING state, WebLogic Server does not complete in-flight work;
application work in progress is abandoned.
• Shutdown - The WebLogic Server instance is configured but inactive. The WebLogic Server completes the suspension of subsystems and
services and does not accept application or administration requests.
• Shutting_Down - The WebLogic Server is in the process of shutting down.
• Failed - A running server instance can fail as a result of out-of-memory exceptions or stuck application threads, or if one or more critical
services become dysfunctional.

Cluster Name Name of the cluster

Servers

Parameter Description

Threads in JVM

Server Name The name of the Server.

Active Threads The number of active threads.

Daemon Threads The number of daemon threads.

Deadlock Threads The number of threads which are deadlock.

Self-Tuning Thread Pool

Server Name The name of the Server.

Hogged Threads The number of threads that are being held by a request right now.

Idle Threads The number of idle threads in the pool.

Pending Requests The number of pending user requests in the priority queue.

StandBy Threads The number of threads in the standby pool.

Active Threads The total number of threads in the pool.

Server Login Rate

Server Name Specifies the server where metrics come

Success Logins Percentage of successful logins

Failed Logins Percentage of failed logins

Blocked Logins Percentage of blocked logins

Forms Resource Usage

Server Name The name of the Server.

Instance Name The name of the FMW instance home.

CPU Usage The Percentage of CPU space used.

Memory Usage Percentage of Total Memory Used.

Copyright © 2014 Zoho Corp. Page 327


Applications Manager User Guide
Applications Manager User Guide ERP

Private Memory Usage The total private memory used by the run-time process in MB.

Resource Usage of Forms JVM

Server Name Specifies server name from where metrics come

CPU Usage by JVM Percentage of CPU used by form's JVM processes

Memory Usage by JVM Memory used by form's JVM processes in MB.

Applications

Parameter Description

Applications Status

Server Name The name of the Server.

Applications The name of the cluster application

Cluster Name The name of the cluster in which the application is deployed

Status The current status of the application

Forms

Parameter Description

Form Application Details

Server Name The name of the Server.

Form Applications The name of the Forms Application.

Instance Name The name of the FMW instance home.

Process The process where metrics come.

Number of Sessions The total number of sessions in the application.

Status The status of the application.

Oracle Process Manager and Notification Server

Parameter Description

OPMN Components Resource Usage

Server Name The name of the Server.

Component Name The name of the component in server.

Memory Usage The percentage of memory space used by component.

CPU Usage The percentage of CPU used by the component.

Web Cache

Parameter Description

Webcache Performance

Server Name The name of the Server.

Process Name The processes where metrics are monitored.

Copyright © 2014 Zoho Corp. Page 328


Applications Manager User Guide
Applications Manager User Guide ERP

Average Latency The average amount of time for client requests forwarded by Oracle Web Cache to be resolved.

Processed Requests Per Minute The number of client requests forwarded by Oracle Web Cache processed by origin server

Failed Requests Per Minute The number of client requests forwarded by Oracle Web Cache that resulted in an error.

WebCache Requests Filter

Site Name The name of the website

Server Name The processes where metrics are monitored.

Instance Name The name of the instance

Cache Size The size of the objects currently stored in the cache

Hit Rate The percentage of requests resolved by cache content

Denied Request Per Minute The number of requests denied by request filters.

Served Request Per Minute The number of requests that Oracle Web Cache has served.

Copyright © 2014 Zoho Corp. Page 329


Applications Manager User Guide
Applications Manager User Guide ERP

SAP CCMS Monitors


Creating SAP CCMS Monitor
Prerequisites for monitoring SAP CCMS Monitors: SAP JavaConnector (JCo) should be present in Applications Manager's classpath.
More

Follow the steps given below to add a SAP CCMS monitor in Applications Manager:
1. Click on New Monitor. Click on SAP CCMS monitor.
2. Enter Display Name.
3. Provide Host Name / IP Address.
4. Check the Connect using Router String checkbox to enter the SAP Router String through which SAP Server is connected.
5. Enter the SAP Logon client.
6. Enter the SAP System number.
7. Enter the SAP Logon language like EN for English.
8. Enter the polling interval time in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Enter the User Name & Password for SAP server.
11. Select CCMS Monitor Sets by clicking on Click Here link. It then displays a list of CCMS monitor sets present in SAP server.
Select a CCMS monitor set from the list which you would like to monitor.
12. Choose the Monitor Group from the combo box to which you want to associate the Monitor (optional). You can choose
multiple groups to associate your monitor.
13. Click Add Monitor(s). Upon adding the SAP CCMS monitor, you can view the details of the newly added SAP CCMS monitor.

Kindly refer SAP CCMS Parameters to know more about the attributes monitored. Please note that while creating a SAP monitor, you
need a SAP user profile with the following authorization objects: S_RFC, S_XMI_LOG and S_XMI_PROD which are minimum
prerequisities for adding a SAP monitor.
Applications Manager allows you to monitor the availability and connection time of SAP CCMS monitors from a centralized web
console. The availability tab, gives the availability history for the past 24 hours or 30 days. The connection time refers to the time
taken by Applications Manager to connect to SAP server. You can also add performance / status / log attributes in the same page by
clicking on link 'Add Attributes' or by clicking on 'Add Custom Attributes' under Quick Links section.

Monitored Parameters

The following parameters are monitored for SAP CCMS.

Parameter Description

Monitor Information

Health Specifies the health of the monitor based on its dependencies

Type Type of the Monitor

Host Name Specifies the host in which SAP is running

Host OS The Operating System of the host

Last Polled at The time at which last polling happened

Next Polled at The time at which the next polling is scheduled

Availability The current status of the SAP CCMS Monitor - whether it is up or down.

Copyright © 2014 Zoho Corp. Page 330


Applications Manager User Guide
Applications Manager User Guide ERP

Adding SAP CCMS Attributes

To add a SAP CCMS monitor set's attributes, follow the steps given below:

1. Click on Add Attributes or Add Custom Attributes link in SAP CCMS monitor page.

2. In the Add Attributes screen, you will find the entire set of CCMS monitoring tree elements (MTE) listed below. Click on MTE which
you would like to monitor, and this will expand the entire set of attributes available inside the monitor set.

3. Similarly, you can also select various MTE and its attributes inside available CCMS monitors.

4. If there are no attributes present inside MTE, an error message appears: "There are no Performance / Status / Log Attributes
present in this Node"

5. Click on Add Attributes button to complete the process.

6. If you would like to delete exisiting attributes, click on Add Custom Attributes link. In SAP Custom Attributes screen, Applications
Manager will list the exisiting attributes that are being monitored and provides you the option to delete attributes. You can also
enable / disable reports for the attributes in the same screen.

Copyright © 2014 Zoho Corp. Page 331


Applications Manager User Guide
Applications Manager User Guide ERP

SAP Server Monitoring

Creating a SAP Server Monitor

Prerequisites for monitoring SAP Server : SAP JavaConnector ( JCo) should be present in Applications Manager's classpath. More
Follow the steps given below to create a SAP server monitor in Applications Manager:
1. Click on New Monitor. Click on SAP Server.
2. Provide Host Name / IP Address.
3. Enter the SubNetMask of the network.
4. Check the Connect using Router String checkbox to enter the SAP Router String through which SAP Server is connected
(optional).
5. Enter the SAP Logon client.
6. Enter the SAP System number.
7. Enter the SAP Logon language like EN for English.
8. Enter the polling interval time in minutes.
9. If you are adding a new monitor from an Admin Server, select a Managed Server.
10. Enter the User Name & Password for SAP.
11. Choose the Monitor Group from the combo box to which you want to associate the Monitor (optional). You can choose
multiple groups to associate your monitor.
12. Click Add Monitor(s). Upon adding the SAP monitor, you can view the details of the newly added SAP monitor.

Kindly refer SAP Parameters to know more about the attributes monitored. Please note that while creating a SAP monitor, you need
a SAP user profile with the following authorization objects: S_RFC, S_XMI_LOG and S_XMI_PROD which are minimum prerequisities
for adding a SAP monitor.

SAP monitor allows you to monitor the availability and performance of SAP environment from a centralized web console. SAP
monitor takes advantage of the SAP CCMS (Computer Center Management System) architecture to give insightful information about
the SAP system along with fault management and reporting capabilities.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events
for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations.

● Monitor Information
● Background
● Buffer
● Dialog
● Enqueue
● OS
● Spool
● Background Jobs
● RFC

Copyright © 2014 Zoho Corp. Page 332


Applications Manager User Guide
Applications Manager User Guide ERP

Monitored Parameters

The following parameters are monitored for SAP:

Parameter Description

Monitor Information

Health Specifies the health of the monitor based on its dependencies

Type Type of the Monitor

Host Name Specifies the host in which SAP is running

Host OS The Operating System of the host

Last Polled at The time at which last polling happened

Next Polled at The time at which the next polling is scheduled

Availability The current status of the SAP Monitor- whether it is up or down.

Background Processing

Background Utilization Percentage of the background processing capacity currently utilized.

Number of jobs that are ready to be executed, have start authorization, and have no target server specified for which there are no
System Wide Queue Length
free background work processes, averaged over all application servers with background work processes.

System Wide Free Processes Number of free background work processes

Number of released jobs that are explicitly to be executed on this application server, but for which there are no free background
Server Specific Queue Length
work processes

Background work processes


Number of background work processes on an application server
count

Number of errors in background work processes since the monitoring segment was created (that is, since the application server was
Error count
started)

Error frequency Number of errors in background work processes per minute

Terminated on error count Number of background work processes terminated after an error

Buffer

Percentage of the database queries that were met from the buffer (hit rate) and did not have to be passed on to the database for
Hit Ratio
different buffer types like Program, Repository, Table & GUI

Directory Used Percentage usage of the directory (number of entries) for different buffer types like Program, Repository, Table & GUI

Space Used Percentage usage of the buffer storage for different buffer types like Program, Repository, Table & GUI

Swap Swaps due to a full buffer per minute for different buffer types like Program, Repository, Table & GUI

Dialog

Frontend Response Time Average time that a user waits at the front end for the processing of his or her request

Database Request Time Average time for processing logical database requests

Load And Generation Time Average load and generation time of CUA objects

Response Time Average response time of the dialog service

Time used in the network during the first data transfer from the front end to the application server and during the last data transfer
Network Time
from the application server to the front end.

Users Logged In Number of users logged on

Queue Time Average time in the dispatcher wait queue

Enqueue

Enqueue Requests Number of lock requests

Enqueue Request Rejects Number of rejected lock requests

Enqueue Requests Errors Number of errors that occurred during lock requests

Dequeue Requests Number of release requests

Copyright © 2014 Zoho Corp. Page 333


Applications Manager User Guide
Applications Manager User Guide ERP

Dequeue Requests Errors Number of errors that occurred when releasing locks

Dequeue All Requests Number of releases of all locks of an LUW

CleanUp Requests Number of releases of all locks of an application server

Backup Requests Number of update calls for which locks were forwarded to the update.

Reporting Requests Number of operations for reading the lock table.

Owner Names Actual Utilization Current number of lock owners in the lock table

Granule Arguments Actual


Current number of different lock arguments in the lock table
Utilization

Granule Entries Actual Utilization Current number of elementary locks in the lock table

Update Queue Actual Current number of open update requests with locks

Recent Lock Time (per minute) Time spent in the critical path of the lock table for lock operations (in seconds per minute)

Recent Lock Wait Time (per


Wait time of parallel processes before entering the critical path of the lock table (in seconds per minute)
minute)

Recent Server Time (per minute) Total time spent in the enqueue server (in seconds per minute)

Enqueue Frequency Enqueue operations (logical data locks) per minutes that are coming from another instance to the central instance

Operating System

CPU Utilization Average usage of the CPU in a host system

Disk Utilization Average usage of the disk in a host system

Extended Memory Utilization of the extended memory as a percentage.

Private Memory Utilization of the private memory as a percentage.

Roll Area Usage Usage of the roll area as a percentage

Average number of page-ins per second; a page-in occurs if a process must access a data page that is not available in the main
Page In
memory

Average number of page-outs per second (page-out occurs if a page is stored out of the main memory to make room for the pages
Page Out
required by other processes)

Syslog Frequency Number of messages per minute that appeared in the system log of an application server.

Spool system Details

Spool Utilization Utilization of the spool work processes as a percentage

Spool Work Processes Count Number of spool work processes

Spool Work Processes Errors Number of errors in spool work processes

Spool Work Processes


Number of spool work processes that terminated after errors
Terminated

Dispatcher Queue Utilization Used area of the dispatcher queue as a percentage

Request Queue Utilization Used area of the spool request queue as a percentage

Service Queue Priv Used area of the spool request queue for processing in chronological order as a percentage

Service Queue Pages Number of pages in the spool request queue

Device Cache Used Used area of the entire device cache as a percentage

Device Cache Fixed Used area of the fixed device cache as a percentage

Host Spool List Used Used area of the host spool request list as a percentage

Shows all the alerts under System Errors tree node of SAP CCMS monitor [RZ 20].
Alerts When you set an alert to completed status, it is deleted from the active alerts that are shown in the Alert Monitor and the Alert
Browser.

Background Jobs

Job Name The name of the background job monitored.

The current status of the background job.


Possible Statuses are:
• No Released Job Exists,
Current Status
• Scheduled,
• Released,
• Active.

Copyright © 2014 Zoho Corp. Page 334


Applications Manager User Guide
Applications Manager User Guide ERP

The status of the background job during last execution.


Possible Statuses are:
Last Run Status • Finished,
• Terminated,
• - (No Status If it is executed for first time)

Last Run Date & Time The date & time of the last executed background job.

Runtime (Sec) The runtime in seconds (difference between starttime and endtime) of the last executed background job.

Delay(Sec) The delay in seconds (difference between scheduled starttime and starttime) of the last executed background job.

Age Time since last execution of the background job in minutes.

Note:
Click the icon to view the logs of a terminated background job and it's history.

SAP RFC Monitoring

Remote Function Call (RFC) is the standard SAP interface for communication between SAP systems. The RFC calls a function to be
executed in a remote system. Applications Manager monitors metrics pertaining to Queued RFCs (qRFC) and Transactional RFC
(tRFC) like:

● QOUT Scheduler (SMQS) - The QOUT Scheduler processes qRFC outbound queues and controls the sending of qRFC calls.
This information can be used to monitor the QOUT Scheduler.
● QIN Scheduler (SMQR) - The QIN Scheduler processes qRFC inbound queues and controls the processing of inbound qRFC
calls.This information can be used to monitor the QIN Scheduler.
● QOUT Data (SMQ1) - QOUT Data can be used to monitor the Individual qRFC Outbound queues.
● QIN Data (SMQ2) - QOUT Data can be used to monitor individual qRFC inbound queues.
● Transactional RFC (SM58) - Every transactional RFC that is executed in a monitored SAP Server is listed here.

Parameter Description

QOUT Scheduler (SMQS)

Client The Logon Client.

The status of the Scheduler at the moment when SMQS is executed. Possible states are: SYSFAIL, CPICERR, INACTIVE,
State
WAITING, WAITCONN, STARTING, ACTIVE.

Time The time of last update.

Group The group to which this scheduler belongs.

Host The host in which this scheduler is running.

QIN Scheduler (SMQR)

Client The Logon Client.

The status of the Scheduler. Possible states are: SYSFAIL, CPICERR, INACTIVE, RESOURCE LACK, WAITING, BATCH ,
State
ACTIVE,STARTING.

Time The time of last update.

Group The group to which this scheduler belongs.

Host The host in which this scheduler is running.

QOUT Data (SMQ1)

Client The Logon Client.

Queue Name The name of the queue.

Destination The target destination of the queue.

Copyright © 2014 Zoho Corp. Page 335


Applications Manager User Guide
Applications Manager User Guide ERP

The current state of the queue. Possible states are: SYSFAIL, CPICERR, STOP, SYSLOAD, VBERROR, READY, RUNNING,
State NOSEND, NOSENDS, WAITING, WAITSTOP, WAITUPDA, RETRY, ARETRY, ANORETRY, MODIFY, EXECUTED, AFINISH,
FINISH.

Message The message while executing the queue.

Time The time of last update.

QIN Data (SMQ2)

Client The logon Client.

Queue Name The name of the queue.

The current state of the queue. Possible States are:SYSFAIL, CPICERR, STOP, READY, RUNNING, WAITING, WAITSTOP,
State
RETRY, ARETRY, ANORETRY, MODIFY, EXECUTED, NOEXEC, AFINISH, FINISH, SAVED.

Message The message while executing the queue.

Time The time of last update.

Transactional RFC (SM58)

Transactional ID The identifier of the Transaction.

Functional Name The name of the function that executed for transaction.

Destination The target destination where this function is executed.

Caller The user who called this transaction.

The state of the transaction. Possible States are : CPICERR, SYSFAIL, CONFAIL, RECORDED, VBERROR, SYSLOAD,
State
RETRY, ARETRY, ANORETRY, EXECUTED, MAILED, READ, VBRECORD, SENDED, DEBUG, VXRECORD

Message The message while executing the transaction.

Time The time of last update.

Tcode The Tcode from where this transaction is called.

Note:
Data Retention: For Transactional RFC, only 2 hours of RAW data will be retained. After two hours the collected RAW data available in Applications Manager database will
be deleted. This is because of the HUGE volume of transaction data available in SAP system. Applications Manager database will not scale the huge volume of transaction
data.
Data Archiving: Data archiving of transaction data will not happen due to the following reasons.
• The RAW data is deleted after two hours.
• Archiving huge volume of transaction data is not a scalable option.
The alert history will be available but no reporting is possible for Transactional RFC.

Copyright © 2014 Zoho Corp. Page 336


Applications Manager User Guide
Applications Manager User Guide ERP

Siebel Server Monitoring

Applications Manager lets you monitor the status of Siebel server components that are essential to keeping the application up and
running. You can monitor as far down as the process level CPU and memory utilization of a Siebel task. Auto-discover your entire
Siebel Enterprise; get out-of-the-box performance graphs showing Application Object Manager and Enterprise Application
Integration Stats of processes within your enterprise.

Adding a new Siebel Monitor

Follow the steps given below to create a new Siebel Enterprise Server monitor in Applications Manager:
1. Copy the "AppManager_Home/working/resource/APMSiebelCommands.txt" file and paste it under "Siebel
Installation directory/bin".
2. Click on New Monitor in Applications Manager.
3. Click on Siebel Enterprise Server under ERP.
4. Enter Display Name.
5. Provide the Host Name or IP Address of the server where Siebel is installed .
6. Select the Operating System of the server where Siebel is installed from the drop-down menu. Adding windows installed
siebel from linux installed Applications Manager is not supported.
7. Enter your UserName and Password to the server where Siebel is running.
8. Enter the Siebel Gateway Server and Enterprise Server names.
9. Enter the Siebel administrator name (administrator or equivalent user) and Password.
10. Enter the path to the Siebel Installation Directory.
11. Enter the polling interval time in minutes.
12. If you are adding a new monitor from an Admin Server, select a Managed Server.
13. Choose the Monitor Group from the combo box to which you want to associate the Monitor (optional). You can choose
multiple groups to associate your monitor.
14. Click Add Monitor(s). Upon adding the Siebel Server monitor, you can view the details of the newly added Siebel Server
monitor.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Siebel server under the ERP Table. Displayed is the
Siebel Server bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Monitor Information
● Performance

Copyright © 2014 Zoho Corp. Page 337


Applications Manager User Guide
Applications Manager User Guide ERP

● Components
● AOM Statistics
● DB Statistics
● InfraStructure
● EAI Statistics
● Task
● Active Sessions

Monitor Information

Monitor Information
Parameters Description

Name Name of the Siebel server monitor

Last Polled at Specifies the time at which the last poll was performed.

Next Poll at Specifies the time at which the next poll will be performed.

Associated Groups Denotes the monitor groups associated with the Siebel server monitor.

Performance

Parameters Description

Availability history for last 6 hours Name of the Siebel server monitor

Performance history for last 6 hours Specifies the time at which the last poll was performed.

CPU Utilization Displays the current CPU utilization of the server.

Memory Utilization Displays the current memory utilization of the server.

Statistic Name Siebel application statistic name.

Statistic Value Siebel application statistic value.

Description Description of the statistic.

Transactions from PIM in Progress Number of inprocess transactions from PIM

Global Data Cursor Cache Misses Number of global data cursor cache misses

Tests Successful Number of tests that were successful

Global Data Cursor Cache Objects Number of objects currently in the global data cursor cache

Transactions form Siebel in Progress Number of inprocess transactions from Siebel

Maximum OOB Component Time Maximum OOB Component Time

Global Data Cursor Cache CPU Total CPU time spent on creating global data cursor objects in cache (in seconds)

Failed Transactions from Siebel Number of failed transactions from Siebel

Global Data Cursor Cache Memory Total memory spent on creating global data cursor objects in cache (in bytes)

Global Data Cursor Cache Hits Number of global data cursor cache hits

Events Processed Total number of events processed

Data Cursor Cache Objects Number of objects currently in the data cursor cache

Failed Transactions from PIM Number of failed transactions from the PIM

Events Processed Rate Rate of Processing the events

Copyright © 2014 Zoho Corp. Page 338


Applications Manager User Guide
Applications Manager User Guide ERP

Data Cursor Cache Memory Total memory spent on creating data cursor objects in cache (in bytes)

Number of Component Crashes The number of times a process of the component has crashed.

Data Cursor Cache Misses Number of SQL data cursor cache misses

Number of Component Restarts The number of times a process of the component has restarted.

Number of Errors Total number of level 0 and 1 errors.

This statistics represents the cumulative number of records assigned by this component since the server was
Number of object rows assigned
started

PSP Cache Hit Total Total PSP Cache Hit Number

PSP Cache Miss Total Total PSP Cache Miss Number

SQL Object Cache Memory Total memory spent on creating SQL object objects in cache (in bytes)

Data Cursor Cache CPU Total CPU time spent on creating data cursor objects in cache (in seconds)

Completed Transactions from Siebel Number of completed transactions from Siebel

Completed Transactions from PIM Number of completed transactions from the PIM Server

Average OOB Queue Size Average OOB Queue Size

SearchEvents Processed Rate Rate of Processing the records during indexing

Average OOB Component Time Average OOB Component Time

SearchEvents Processed Total number of records processed during indexing

Tests Failed Number of tests that failed

Tests Attempted Number of tests that were started

Data Cursor Cache Hits Number of SQL data cursor cache hits

Components

Parameters Description

Component Specifies the name of the Siebel component.

Component Group Specifies the name assigned to the Siebel component group.

RunState Specifies the value returned for the state of the component. An example value of RunState is offline

ActiveMTSProcess The number of running multi-threaded shell (MTS) processes.

RunningTasks The current number of running tasks for the component.

AOM Statistics

Application Object Manager Statistics


Parameters Description

The time required to perform all the activities required to establish an interactive session (such as
Average Connect Time
authentication, initialization, and allocating the necessary resources) with Object Manager.

The average (mean) time required to respond to an end-user action. If application performance is
Average Response Time
deteriorating, the metric value increases.

Statistic Name Siebel application statistic name.

Statistic Value Siebel application statistic value.

Description Description of the statistic.

Average Request Size The average size of request messages (in bytes)

Average Reply Size The average size of reply messages (in bytes)

Average Requests Per Session The average number of requests per Object Manager session

Copyright © 2014 Zoho Corp. Page 339


Applications Manager User Guide
Applications Manager User Guide ERP

Total Think Time The total end-user think time (in seconds)

Average Think Time The average end-user think time between requests (in seconds)

Object Manager Errors The number of errors encountered during Object Manager session

Reply Messages The number of reply messages sent by the server

Request Messages The number of request message received by the server

Total Database Response Time The total Database Response/Processing Time (milliseconds)

Total Reply Size The total size (in bytes) of reply messages

Total Request Size The total size (in bytes) of request messages

Total Response Time The total Object Manager response time (msec)

Database Statistics

Parameters Description

The average (mean) amount of time the database requires to process the SQL statement after the statement is
Average Execution Time
parsed.

The average (mean) amount of time the database requires to fetch records by an SQL statement after the
Average Fetch Time
statement is parsed.

Statistic Name Siebel application statistic name.

Statistic Value Siebel application statistic value.

Description Description of the statistic.

SQL Cursor Cache Misses The number of SQL cursor cache misses

SQL Cursor Total Cpu The total CPU time spent on creating SQL cursor objects in cache (in seconds)

SQL Parse Time The total elapsed time for SQL parse operations (in seconds)

Number of SQL Fetches The total number of SQL fetch operations

SQL Object Cache Objects The number of objects currently in the SQL object cache

Number of SQL Executes The total number of SQL execute operations

SQL Object Cache Misses The number of SQL object cache misses

SQL Cursor Cache Hits The number of SQL cursor cache hits

Number of SQL Parses The total number of SQL parse operations

SQL Object Cache Hits The number of SQL object cache hits

SQL Object Cache CPU The total CPU time spent on creating SQL object objects in cache (in seconds)

SQL Fetch Time The total elapsed time for SQL fetch operations (in seconds)

Avg SQL Parse Time The average time for SQL parse operations (in seconds)

SQL Execute Time The total elapsed time for SQL execute operations (in seconds)

InfraStructure

Parameters Description

Statistic Name Siebel application statistic name.

Statistic Value Siebel application statistic value.

Description Description of the statistic.

Tasks Exceeding Configured Capacity The number of tasks stated that exceeded configured capacity

Copyright © 2014 Zoho Corp. Page 340


Applications Manager User Guide
Applications Manager User Guide ERP

CPU Time The total CPU time for component tasks (in seconds)

Num of DLRbk Retries The number of Retries due to Deadlock Rollbacks

Num of Exhausted Retries The number of Times All Retries are Exhausted

Elapsed Time The total running time elapsed for component tasks (in seconds)

Number of Sleeps The total number of sleeps for component tasks

FDR Avg time between aging Avg Seconds per buffer wrap

Sleep Time The total amount of sleep time for component tasks (in seconds)

FDR Buffer Life in seconds Seconds since buffer was created

Num of DBConn Retries The number of retries due to DB Connection Loss

Minimum Peak Memory Usage Peak Mem used by task. Rolls up differently than MaxPeakMemory

Maximum Peak Memory Usage The Peak Memory used by task. Rolls up differently from MinPeakMemory

Total Tasks The total number of tasks completed for server components

FDR Buffer Wraps The number of buffer wraps

EAI Statistics

Parameters Description

Statistic Name Siebel application statistic name.

Statistic Value Siebel application statistic value.

Description Description of the statistic.

EAI Receiver Total Messages Processed The total number of messages processed by the Enterprise Application Integration receiver.

Siebel Adapter Total Query Calls The total cumulative size of output property sets (in KB) for all queries

Siebel Adapter Total Sync/Upsert Calls The total number of non-query (synchronize, upsert, update or insert) calls made to Siebel Adapter

Total XML Converter Size of Input Buffer The total cumulative size of input buffer (in KB)

Siebel Adapter Total Query Size The total cumulative size of output property sets (in KB) for all queries

The total cumulative size of input property sets (in KB) for all non-query calls (synchronize, upsert, update or
Siebel Adapter Total Sync Size
insert)

Total XML Parser Calls The total number of XML parser calls

Total XML Converter Size of Output Buffer The total cumulative size of output buffer (in KB)

Total XML Generator Calls The total number of XML generator calls

Tasks

Parameters Description

Tasks Running The current number of concurrent task instances running in the Siebel component.

Tasks Paused The tasks that have been temporarily placed in a suspended state.

Tasks Completed The tasks that have run to completion.

Tasks Exited with Errors The tasks that encountered an error during its processing and exited.

Tasks Killed The tasks that were not able to shut down cleanly, and were forced to shut down.

Error Tasks

Component Name of the Siebel component.

TaskID The operating system identification number assigned to the task.

Run State Current run state for the Siebel task (Running, Paused, Stopping,

Copyright © 2014 Zoho Corp. Page 341


Applications Manager User Guide
Applications Manager User Guide ERP

A task may be in one of four states


• Running
Task Status • Paused
• Stopping
• Completed

Task Label The task label.

Start Time The time when this task started.

End Time The time when this task ended.

Active Sessions

Parameters Description

Component
Specifies the name of the Siebel component.

TaskID Siebel task ID for the application OM that handles the user session

Run State The running state of the users' sessions for the selected Siebel Server.

Hung State The state of the users' sessions for the selected Siebel Server not responding.

DB Session ID A unique session number created for the user

OM Login Object Manager login ID of the user.

Task Status Current status of the task i.e running or paused.

Copyright © 2014 Zoho Corp. Page 342


Applications Manager User Guide
Applications Manager User Guide ERP

Microsoft Dynamics CRM Monitoring

Supported versions of Microsoft Dynamics CRM: CRM 2011 and 2013


Prerequisites for monitoring Microsoft Dynamics CRM: Click to know about the user previleges and other necessary
prerequisites to monitor Microsoft Dynamics CRM.
Applications Manager connect with Microsoft Dynamics CRM Application and used to determine the Performance of various services
and components of CRM. Follow the steps given below to create a new Dynamics CRM Application monitor:
1. Click on New Monitor link.
2. Select Microsoft Dynamics CRM under ERP category.
3. Specify the Display Name of the CRM Application.
4. Enter the CRM Host Name or IP Address of the host where the CRM Application runs.
5. Select the Version number from the drop-down menu.
6. If you choose the Use Below Credentials option, then enter the credentials - UserName and Password of the Host
Machine.UserName - To monitor a Microsoft Dynamics CRM application, use Administrator user account which has the
permission to execute WMI queries on 'root/CIMV2' namespace of the CRM Server.Password - Password of the above user
who has the permissions to execute WMI Queries.If you choose the Select from credential list option, then select the
respective credential from preconfigured credential list.
7. Select Enable Event Log Monitoring if you wish to monitor event logs.
8. Specify the Polling Interval in minutes.
9. Choose the Monitor Group with which you want to associate the Dynamics CRM monitor to, from the combo box (optional).
You can choose multiple groups to associate your monitor.
10. Click Add Monitor(s). This discovers the Dynamics CRM Application from the network and starts monitoring it.

Dynamics CRM is Microsoft's fully integrated customer relationship management system that helps organizations attract and
develop new profitable relationships with customers while managing ongoing relationships from a single operating platform.
Microsoft Dynamics CRM offers both on-premise and cloud-based options, tight integration with Microsoft Office and Outlook, and
all-out customization flexibility.

As a system administrator you need to be able to to respond quickly to critical events and prevent service outages. Applications
Manager helps you track the set of counters that generate data about how various components perform as they run in the Microsoft
Dynamics CRM environment. You can monitor the WMI Performance counters, Services, Transactions and Eventlogs for CRM
Applications. You can get deeper insight into the performance of CRM's Authentication, Outlook Sync, e-mail Router, Discovery,
Locator, Platform Services, Sandbox counters and Async Services.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Microsoft Dynamics CRM under the ERP Table.
Displayed is the Microsoft Dynamics CRM bulk configuration view distributed into three tabs:

● Availability tab, gives the Availability history for the past 24 hours or 30 days.
● Performance tab gives the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Copyright © 2014 Zoho Corp. Page 343


Applications Manager User Guide
Applications Manager User Guide ERP

Click on the monitor name to see all the server details listed under the following tabs:

● Overview
● Server
● Requests
● Sandbox
● Async Services
● Events

OVERVIEW
Parameter Description

Authentication Failures in Last Minute

Claims Authentication Failures In The The total number of failed authentication requests processed per minute using claims. This counter
Last Minute measures the whole deployment including all organizations.

The number of unsuccessful authentication requests per minute that are processed by using Active
Config DB Windows Authentication
Directory authentication credentials. This counter measures the entire Microsoft Dynamics CRM
Failures In The Last Minute
deployment including all organizations.

The number of unsuccessful authentication requests per minute that are processed by using Microsoft
CRM Post Authentication Failures In
Dynamics CRM authentication credentials. This counter measures the entire deployment including all
The Last Minute
organizations.

The number of failed authentication requests per minute that are processed by using Microsoft account
Passport Authentication Failures In
authentication credentials. This counter measures the entire Microsoft Dynamics CRM deployment
The Last Minute
including all organizations. This counter is CRM Online - specific.

The number of unsuccessful authentication requests per minute. There are several possible causes for
authentication failure. For example, the user may have been authenticated successfully by Active
Windows Authentication Failures In
Directory but Microsoft Dynamics CRM authentication failed to communicate with the Kerberos servers,
The Last Minute
or a token expired, or the user's credentials are incorrect. This counter measures the entire Microsoft
Dynamics CRM deployment including all organizations.

Outlook Sync Requests

Current MAPI Sync Requests The number of MAPI sync requests currently executing.

Current Offline Sync Requests The number of offline sync requests currently executing.

Current Outlook Sync Requests The number of Microsoft Office Outlook sync requests currently executing.

The total number of Address Book Provider (ABP) synchronization requests made from CRM for Outlook
Total ABP Sync Requests to a Microsoft Dynamics CRM server; a high count indicates a high client load on the Asynchronous
Processing Service.

The total number of offline synchronization requests made from CRM for Outlook to a Microsoft Dynamics
Total Offline Sync Requests
CRM server; a high count indicates a high client load on the Asynchronous Processing Service.

The total number of ABP Sync Requests and the Offline Sync Requests; a high count indicates a high
Total Outlook Sync Requests
client load on the Asynchronous Processing Service.

The number of successful offline synchronization requests made from CRM for Outlook to a Microsoft
Total Succeeded Offline Sync
Dynamics CRM server; a count that is much lower than the total number of offline synchronization
Requests
requests may indicate a problem with clients that try to synchronize with the server.

The number of failed offline synchronization requests made from CRM for Outlook to a Microsoft
Dynamics CRM server. This is calculated from 'Total Offline Sync Requests' and 'Total Succeeded Offline
Sync Requests' .
Total Failed Offline Sync Requests
A count greater than 'Total Succeeded Offline Sync Requests' or a count close to 'Total Offline Sync
Requests' may indicate a problem with clients that try to synchronize with the server.

Services

The name of the service. Note that the display name and the service name (which is stored in the
Name
registry) are not always the same.

Copyright © 2014 Zoho Corp. Page 344


Applications Manager User Guide
Applications Manager User Guide ERP

The Start mode of the service. The different start modes are:
• Boot - The device driver is started by the operating system loader (valid only for driver services).
• System - The device driver started by the operating system initialization process. This value is valid
only for driver services.
Start Mode • Auto - The service to be started automatically by the service control manager during system startup.
Auto services are started even if a user does not log on.
• Manual - The service to be started by the Service Control Manager when a process calls the
StartService method. These services do not start unless a user logs on and starts them.
• Disabled - The service that cannot be started until its StartMode is changed to either Auto or Manual.

The current state of the base service. The values are: Stopped, Start Pending, Stop Pending, Running,
State
Continue Pending, Pause Pending, Paused, Unknown.

SERVER
Parameter Description

Server

Number of Organizations The number of organizations that are currently active.

The total number of failed web service requests to Microsoft Dynamics CRM InProc calls that
Failed Internal Organization
are made by applications that use the methods described in the Microsoft Dynamics CRM
Service Requests
SDK.

Failed Organization Service The total number of metadata requests received by the Microsoft Dynamics CRM
Metadata Requests Organization Web Service that failed because of a time-out or other SOAP failure.

Failed Organization Service The total number of requests to the Microsoft Dynamics CRM Organization Web Service that
Requests failed because of a time-out or other SOAP failure.

The number of requests to render Microsoft SQL Server Reporting Services reports that failed
Failed Report Render Requests
because of a time-out or error.

The total number of error reports generated by the web client and CRM for Outlook. This
counter is reset weekly to zero. This counter is an indicator of high script error frequency. If a
Script Error Reports large number of error reports are received in a short time, the operations team should
investigate to determine which pages are producing errors. We recommend that you set a
monitoring alert to notify you if there are more than 500 error reports in a 10-minute period.

REQUESTS
Parameter Description

Discovery Service

The number of requests to the Microsoft Dynamics CRM Discovery service that are unsuccessful for any reason. For example, a
Failed Discovery Service Requests request may fail because the requesting party is not recognized as a user in the organization. A high count may indicate that the
system is possibly under a denial-of-service (DoS) attack, or there is some problem with the Discovery service configuration.

Successful Discovery Service Requests The number of requests to the Microsoft Dynamics CRM Discovery service that completed successfully.

The total number of requests (successful and unsuccessful) received by the Microsoft Dynamics CRM Discovery service. This counter
Total Discovery Service Requests
can be used to track traffic patterns for Discovery service capacity planning.

Locator Service

The number of LocatorService cache flush requests that were unsuccessful for any reason. For example, a request may fail because it
was for an invalid cache entry, or the cache may not flush because of an incorrect cache state. A high count may indicate a problem
Failed Cache Flush Requests
with the LocatorService cache, or a problem with the connection to CONFIG_DB. For information about the cause, review the event log
for errors.

Total Cache Flush Requests The total number of successful LocatorService cache flush requests that have been received.

Router Service Request

Copyright © 2014 Zoho Corp. Page 345


Applications Manager User Guide
Applications Manager User Guide ERP

AppFabric Request Timeout The number of time-outs seen making requests to Windows Azure.

Router Request Faulted The number of requests made on the faulted channel to the router.

Router Request Received (Throughput) The number of requests received by the router.

Router Request Timeout The number of time-outs seen making requests to the router.

Platform

The average time that is required to process Microsoft Dynamics CRM data import requests. Import requests are resource-intensive
SQL Server operations. If the average time is too high and the number of concurrent imports is high, some organizations may have to
Average Time Of Import Request
be moved to a different deployment. Also, you may want to consider processing import jobs during a maintenance window to reduce
the performance effect on users.

The number of import requests that have been submitted by organizations in the deployment in the past hour. This counter is useful
Number Of Import Requests Per Hour
to indicate how many import requests are being processed concurrently.

The number of requests that have been submitted by organizations in the deployment in the past hour. This counter is useful to
Number Of Publish Requests Per Hour
indicate how many publish requests are being processed concurrently.

SANDBOX
Parameter Description

Sandbox Host

Worker Processes Crashed Percentage The percentage of Sandbox Worker processes that have crashed.

Worker Processes Terminated Percentage The percentage of Sandbox Worker processes that have been terminated due to excessive resource usage or no response.

Active Assemblies The number of plug-in assemblies currently in use.

Active Organizations The number of organizations that currently have a Sandbox Worker process active.

Active Plugins The number of plug-ins currently in use.

Handles The total handle count used by all Sandbox Worker processes.

CPU Usage Percentage The total CPU percentage used by all Sandbox Worker processes.

Assembly Cache Hits Percentage The assembly cache hit rate percentage.

Assembly Cache Usage Percentage The percentage of the total assembly cache disk space that is in use.

Execute Failures Percentage The incoming execution failure rate percentage in the Sandbox Host.

SDK Failures Percentage The outgoing Request failure rate percentage in the Sandbox Host.

Assembly Cache Disk Space (KB) The total disk space used by all plug-in assemblies in the assembly cache, in KB.

Memory Usage (MB) The total memory used by all Sandbox Worker processes, in MBytes.

Sandbox Client

Execute Failures Percentage The outgoing execution failure rate percentage in the Sandbox Client.

SDK Failures Percentage The incoming SDK Request failure rate percentage in the Sandbox Client.

ASYNC SERVICES
Parameter Description

Async Services

The total number of organizations in the Microsoft Dynamics CRM deployment that are actively being polled by the Microsoft CRM
Active Organizations
Asynchronous Processing Service.

Total Organizations The number of organizations being monitored for the entire Microsoft Dynamics CRM deployment.

Capacity Per Organization The number of asynchronous operations to be removed from the processing queue that are currently allocated to an organization.

Items In Memory (high) The maximum number of asynchronous operations to hold in memory for processing.

Items In Memory (low) The threshold of asynchronous operations to trigger loading of additional operations.

Threads In Use The number of threads currently employed in the processing of asynchronous operations for all organizations in the deployment.

Total Operations Failed The total number of asynchronous operations that failed for all organizations in the deployment.

Copyright © 2014 Zoho Corp. Page 346


Applications Manager User Guide
Applications Manager User Guide ERP

EVENTS
Event Log from the Dynamics CRM Application can be monitored by creating EventLog Rules in Applications Manager.
Parameter Description

Events

Rule Name The name of the event log rule

Log File Type The Log File Type - Application, system, security, file replication service, DNS Server or directory service.

Source The Application which created the event.

Event Id The Event ID associated with the Event Log File.

The Event Type - Error, Warning, Information or Event of Any Type. In case of Security Events, the types would vary
Type
between Success Audit and Failure Audit.

User Name The system component or User account that was running the process which caused the event.

Description A description of the event.

Generated Time The time when the event entry was submitted.

Copyright © 2014 Zoho Corp. Page 347


Applications Manager User Guide
Applications Manager User Guide ERP

Microsoft Dynamics AX Monitoring

● Microsoft Dynamics AX - An Overview


● Monitoring Microsoft Dynamics AX - What we do.
● Adding a new Microsoft Dynamics AX monitor / Using AddMonitor API
● Monitored Parameters

Microsoft Dynamics AX - An Overview

Microsoft Dynamics AX 2012 is an Enterprise Resource Planning (ERP) system suitable for midsize to large enterprises. It provides
your enterprise with comprehensive core functionality like financial, human resources and operations management so that your
business can thrive. Microsoft Dynamics AX offers complete functionality for inventory control, warehouse management,
transportation management, demand and supply chain planning, material requirements planning, production management, quality
assurance, product lifecycle management, asset management, and business intelligence so you can make important business
decisions.

Monitoring Microsoft Dynamics AX - What we do

To actively monitor the behavior of the Microsoft Dynamics AX application and related applications, Applications Manager
effectively collects information pertaining to the performance of each component of the system architecture, i.e.: Application Object
Server (AOS), the SQL Database Server, and their Server Stats.

Adding a new Microsoft Dynamics AX monitor

Supported versions of Microsoft Dynamics AX


Microsoft Dynamics AX 2012, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 R3

Prerequisites for monitoring Microsoft Dynamics AX :

1. To monitor a Microsoft Dynamics AX application, use an Administrator user account which has the permission to execute WMI queries on 'rootCIMV2' namespace of
the AX Server.

2. Firewall access for monitoring - Ports required for monitoring via WMI:

● Windows Management Instrumentation (WMI) (default : TCP 445)

● Remote Procedure Call (RPC) (default : TCP 135)

Copyright © 2014 Zoho Corp. Page 348


Applications Manager User Guide
Applications Manager User Guide ERP

● Target server uses random port above 1024 by default to respond back for remote communication (DCOM) (default : TCP 1025 to 1030)

Steps to create a new monitor:


To create a Dynamics AX Monitor, follow the steps given below:
● Click on New Monitor link.

● Select Microsoft Dynamics AX under ERP category.

● Specify the Display Name of the Dynamics AX Application.

● Enter the AX Host Name or IP Address of the host where the AX Server runs.

● Select the Version number from the drop-down menu.

● Select the services to be monitored from the drop down list.

● If you choose the Use Below Credentials option, then enter the credentials - UserName and Password of the Host Machine.UserName - To monitor a Microsoft
Dynamics AX application, use Administrator user account which has the permission to execute WMI queries on 'root/CIMV2' namespace of the AX Server.Password -
Password of the above user who has the permissions to execute WMI Queries.If you choose the Select from credential list option, then select the respective
credential from preconfigured credential list.
● Specify the Polling Interval in minutes.

● Choose the Monitor Group with which you want to associate the Dynamics AX monitor to, from the combo box (optional). You can choose multiple groups to
associate your monitor.
● Click Add Monitor(s). This starts monitoring the Dynamics AX Server Application from the network.

Use the AddMonitor API to add a Microsoft Dynamics AX Monitor

Syntax
http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST
NAME]&Version=[VERSION NO]&UserName=[USERNAME]&Password=[PASSWORD]&pollinterval=[INTERVAL]
Request Parameters
Field Description

apikey The key generated from the Generate API Key option in the 'Admin' tab.

type The type of the monitor you want to add. The value should be MSDynamicsAX

displayname .The Display Name of the AX Application

host The AX Host Name or IP Address of the host where the AX server runs

Version The version of the AX Application.

The UserName of the Host Machine. To monitor a Microsoft Dynamics AX application, use Administrator user account which has the
UserName
permission to excute WMI queries on 'rootCIMV2' namespace of the AX Server.

Password The password of the above user who has the permissions to execute WMI Queries.

Sample Request
http://prod-4409:9210/AppManager/xml/AddMonitor?apikey=aca1b8f2f109e319f46733675983e847&type=MSDynamicsAX&displayname=AXTest&host=user-4409&Versio
n=2012&UserName=user-4409&Password=Qwerty@123&pollinterval=5

Copyright © 2014 Zoho Corp. Page 349


Applications Manager User Guide
Applications Manager User Guide ERP

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on the Microsoft Dynamics AX monitor under the ERP
Table. Displayed is the Microsoft Dynamics AX bulk configuration view distributed into three tabs:

● Availability tab displays the Availability history for the past 24 hours or 30 days.
● Performance tab displays the Health Status and events for the past 24 hours or 30 days.
● List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

● Overview

● Application Object Server (AOS)

● AOS Data Cache

● SQL Server

● Server Statistics
Overview

Parameter Description

AOS Active Sessions

Active Sessions The number of currently active server sessions

Total Sessions The total number of active sessions since the AOS instance started

Microsoft Dynamics AX and MSSQL Services

Service Name The name of the service. Note that the display name and the service name (which is stored in the registry) are not always the same.

Availability The current state (Running or stopped) of the base service.

Top
Application Object Server (AOS)

Parameter Description

AOS Traffic

Bytes Received/Sec The number of bytes received by the AOS instance per second

Bytes Sent/Sec The number of bytes sent by the AOS instance per second

Request Statistics

Total Client Requests The number of client-to-server requests since the AOS instance starte