AddMonitor API - Application Servers


This section explains how to use the AddMonitor API to add monitors of the 'Application Servers' category. The following application servers are supported:

Microsoft .NET

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&username=[USERNAME]&password=[PASSWORD]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be '.Net'.
host The name of the host where the .Net server is running.
username The username of the .Net server.
password The password of the .Net server.

Sample Request

http://prod-server5:9090/AppManager/xml/AddMonitor?apikey=4df5040d6db873dcdaf4359b259fd494&type=.Net&displayname=AppmanagerDotNet&host=app-xp3&username=administrator&password=vembu

 

Adding a new monitor from an Admin server in the Enterprise Edition

When adding a new monitor from an admin server in the Enterprise Edition, the user can select the Managed server of his preference. Know more about the mandatory parameters to be appended.

GlassFish

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&host=[HOST]&port=[PORT]&username=[USERNAME]&password=[PASSWORD]&displayname=[DISPLAYNAME]&JNDIPath=[JNDIPATH]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be 'glassfish'.
host The name of the host where the GlassFish server is running.
port The port number where GlassFish server is running.
username The username of the GlassFish server.
password The password of the GlassFish server.
JNDIPath The JNDI path name. For example, the JNDIPATH for default installations of GlassFish is /jmxrmi.

Sample Request

http://prod-server1:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=glassfish&host=app-xp2&port=8686&username=admin&password=adminadmin&displayname=glfish&JNDIPath=/jmxrmi

JBoss Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&version=[VERSION]&authEnabled=[AUTHENABLED]&username=[USERNAME]&password=[PASSWORD]&LaunchType=[LAUNCHTYPE]&DomainController=[DOMAIN CONTROLLER]&filterEnabled=[FILTER ENABLED/DISABLED]&filterCondition=[FILTER CONDITION]&AppServers=[APP SERVERS]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be 'JBoss server'.
host The name of the host where the JBoss server is running.
port The port number where JBoss server is running.
version The version of the JBoss server. Supported versions include 3.2.x, 4.x, 4.0.1, 4.0.2, 5.x, 6.x , 7.x and Wildfly_8.x .
authEnabled Denotes whether authentication is enabled in the JBoss server. Value should be either 'on' or 'off'
username The username of the JBoss server. This should be specified only if authEnabled value is 'on'.
password The password of the JBoss server. This should be specified only if authEnabled value is 'on'
LaunchType The launch type of the JBoss server. Value should be 'Domain', if JBoss server is started as domain. This is applicable for version 7.x and above, else value can be 'Standalone' or optional.
DomainController The domain controller name of the JBoss server, i.e., master/slave. This should be specified only if LaunchType is 'Domain'.
filterEnabled Specifies whether the filter is enabled or not while discovering and adding the monitor. Possible values are either true or false.
filterCondition Specifies whether the servers are to be included / excluded while discovering and adding the monitor. Possible values are either include or exclude.
AppServers The list of servers that are to be included / excluded based on the condition given for the filterCondition parameter. It should be specified in the format "hostName1:serverName1,serverName2,serverName3....;hostName2:serverName1,serverName2,serverName3...."

Sample Request

  • http://prod-server2:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=JBoss server&displayname=AppmanagerJBoss4&host=app-xp2&port=8080&version=Wildfly_8.x&authEnabled=on&username=guest&password=guest
  • http://prod-server2:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=JBoss server&displayname=AppmanagerJBoss7_domain&host=app-win7-64-2&port=9990&version=7.x&authEnabled=on&username=domain&password=appman&LaunchType=Domain&DomainController=host0-master&filterEnabled=true&filterCondition=include&AppServers=host1:Server11,Server12;host2:Server21,Server22,Server23

Oracle Application Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&version=[VERSION]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type Denotes the category type of the monitor you want to add. If you want to add an Oracle application server monitor, specify the value as 'oracle application server'.
host The name of the host where the Oracle application server is running.
port The port number where Oracle application server is running.
version The version of the Oracle application server. Supported version is 10.1.3

Sample Request

http://prod-server5:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=oracle application server&displayname=appmanageroracle&host=app-xp5&port=7200&version=10.1.3

Resin Server

Syntax

http://[HOST]:[PORT]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=Resin&host=[HostName]&port=[JMX PORT]&UserName=[Username]&Password=[password]&displayname=Resin&JNDIPath=[JNDIPATH]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be Resin.
host The name of the host where the Resin server is running.
port The port number where Resin server is running.
username The username of the Resin server.
password The password of the Resin server.
JNDIPath The JNDI path name. For example, the JNDIPATH for default installations of Resin is /jmxrmi.

Sample Request

http://prod-server1:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=resin&host=app-xp2&port=8686&username=admin&password=adminadmin&displayname=resinmonitor&JNDIPath=/jmxrmi

SilverStream Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST] &port=[PORT]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be 'SilverStream'
host The name of the host where the SilverStream server is running.
port The port number where the SilverStream server is running.

Sample Request

http://prod-server6:8090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=SilverStream&displayname=sl&host=myesuraj&port=8080

Tomcat Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&username=[USERNAME]&password=[PASSWORD]&version=[VERSION]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. The value should be 'tomcat server'.
host The name of the host where the Tomcat server is running.
port The port number where Tomcat is running.
username The username of the Tomcat server.
password The password of the Tomcat server.
version The version of the Tomcat server. Supported version is 5 and above.
sslenabled True if the SSL is enabled.

Sample Request

http://app-xp5:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=tomcat server&displayname=appmanagertomcat&host=host&port=8080&username=admin&password=admin&version=5

VMware vFabric TC Server

Syntax

http://[ APM Host ]:[ APM Port ]/AppManager/xml/AddMonitor?apikey=[ API Key ]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[ PORT ]&username=[USERNAME] &password=[PASSWORD]&JNDIPath=[JNDI Path]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type Denotes the category type of the monitor you want to add. The value should be as 'VMware vFabric tc Server'.
host The name of the host where VMware is running.
port The port number where VMware is running.
username The username of the VMware server.
password The password of the WebLogic server.
JNDIpath The JNDI path name.

Sample Request

http://app-windows:9090/AppManager/xml/AddMonitor?apikey=c4bc4e45a43d2d6bfbca6bdcaf31f436&type=VMware vFabric tc Server&displayname=vFabric&host=app-centos32-2&port=6969&username=admin&password=springsource&JNDIPath=/jmxrmi

WebLogic Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&username=[USERNAME]&password=[PASSWORD]&version=[VERSION]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type Denotes the category type of the monitor you want to add. The value should be as 'WEBLOGIC SERVER'.
host The name of the host where the WebLogic is running.
SSL enabled Option to enable SSL (applicable for version 9 and above).
port The port number where WebLogic is running.
username The username of the WebLogic server.
password The password of the WebLogic server.
version The version of the WebLogic server. Supported versions include 6.1, 7.0, 8.1, 9.x and 10.x

Sample Request

http://app-windows:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=WEBLOGIC SERVER&displayname=Appmanagerweblogic&host=app-linux1&port=7001&username=weblogic&password=weblogic&version=8.1

For SSL support over Weblogic:

Syntax:

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&username=[USERNAME]&password=[PASSWORD]&version=[VERSION]&sslenabled=[ISSSLENABLED]

Example:

http://app-windows:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=WEBLOGIC SERVER&displayname=Appmanagerweblogic&host=app-linux1&port=7001&username=weblogic&password=weblogic&version=10.x&sslenabled=true

WebSphere Server

Syntax

http://[Host]:[Port]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=[TYPE]&displayname=[DISPLAYNAME]&host=[HOST]&port=[PORT]&version=[VERSION]&mode=[MODE]&soapport=[SOAPPORT]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type Denotes the category type of the monitor you want to add. The value should be 'websphere server'.
host The name of the host where the WebSphere is running.
port The port number where WebSphere is running.
username The username of the WebSphere server.
password The password of the WebSphere server.
version The version of the WebSphere server. Supported versions include 5.x, 6.x, 7.x, 8.x, and 9.x
mode The deployment mode of the server. Value is 'BASE'
soapport The SOAP connector port.

Sample Request

Base Deployment

http://prod-server4:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=websphere server&displayname=AppmanagerwebsphereBASE&host=app-w2k8r2-64ee&port=9082&version=9.x&mode=BASE&soapport=8880

Base Deployment With Global Security Enabled

http://prod-server4:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=websphere server&displayname=AppmanagerwebsphereBASE&host=app-w2k8r2-64ee&port=9082&version=9.x&mode=BASE&soapport=8880&authEnabled=true&username=admin&password=123

Base Deployment With SSL Enabled

http://prod-server4:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=websphere server&displayname=AppmanagerwebsphereBASE&host=app-w2k8r2-64ee&port=9444&version=9.x&mode=BASE&soapport=8880&sslenabled=true

Network Deployment

http://prod-server4:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=websphere server&displayname=AppmanagerwebsphereND&host=app-w2k8r2-64ee&port=9081&version=9.x&mode=ND&soapport=8880&ndhost=app-w2k8r2-64ee&ndport=9082

Jetty Server

Syntax

http://[HOST]:[PORT]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=Jetty Server&host=[HostName]&port=[JMX PORT]&UserName=[Username]&Password=[password]&displayname=Jetty&JNDIPath=[JNDIPATH]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common Request Parameters.

Field Description
type The category type of the monitor you want to add. Value should be Jetty Server.
host The name of the host where the Jetty server is running.
port The port number where Jetty server is running.
username The username of the Jetty server.
password The password of the Jetty server.
JNDIPath The JNDI path name. For example, the JNDIPATH for default installations of Jetty is /jmxrmi.

Sample Request

http://prod-server1:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=Jetty Server&host=app-xp2&port=8686&username=admin&password=adminadmin&displayname=jettymonitor&JNDIPath=/jmxrmi

Apache Geronimo

Syntax

http://[HOST]:[PORT]/AppManager/xml/AddMonitor?apikey=[APIKEY]&type=ApacheGeronimo&HostName=[HostName]&Port=[JMX PORT]&UserName=[Username]&Password=[password]&displayname=[Display Name]&JNDIPath=[JNDIPATH]

Request Parameters

The parameters involved in the API request are described below. Also, refer to the list of common 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. Value should be 'ApacheGeronimo'.
displayname The display name of the Apache Geronimo monitor.
HostName The name of the host in which Apache Geronimo server is running.
port The port number where Apache Geronimo server is running.
Port The JMX Port of the Apache Geronimo server.
Username The Username of Apache Geronimo instance.
Password The password of Apache Geronimo instance.
JNDI Path The JNDI Path of the server.

Sample Request

http://prod-server1:9090/AppManager/xml/AddMonitor?apikey=136edbeb3ccb83c6cc71df03ef273313&type=ApacheGeronimo&host=app-xp2&port=8989&username=admin&password=adminpass&displayname=Apache Geronimo Server&JNDIPath=/jmxrmi