ManageEngine® Applications Manager


List Monitor API

<< Prev

Home

Next >>

List Monitor API

 

ManageEngine Applications Manager provides List Monitor API that allows the user to list details of monitor by the following categories.

This API lists all the monitors of a given type that are configured in Applications Manager for the user corresponding to the API Key. This details displayed includes the Health and Availability of the monitor types, image type, Health outages and Critical/Warning/Clear/UP/Down count for each monitor type.

 

APIs for ListMonitor

1.  By monitor Type
             http://[ Host ]:[ Port ]/AppManager/xml/ListMonitor?apikey=[ API key ]&type=[ TYPE in AM_ManagedObject table ]

2. By particular monitor name
             http://[ Host ]:[ Port ]/AppManager/xml/ListMonitor?apikey=[ API key ]&resourceid=[ Resourceid ]

 

3.  Listing all the added monitors
             http://[ Host ]:[ Port ]/AppManager/xml/ListMonitor?apikey=[ API key ]&type=all

 

4.  API For XML Response
             
http://[ APM Host ]:[ APM Port ]/AppManager/xml/ListMonitor?apikey=[ API Key ]&type=all

 

5. For JSON Response
             
http://[ APM Host ]:[ APM Port ]/AppManager/json/ListMonitor?apikey=[ API Key ]&type=[Type]

Note:

a) For getting both Esx VirtualMachine and HyperV VirtualMachine , we can simply pass VirtualMachine as type

b) For getting all windows types, pass 'Windows' as type value

c) For all network devices (devices added to APM from OPM or OpStor) simply pass 'NWD' as value for type.

 

Request Parameters

Field Description        
API Key The key generated from "Generate API" option in the Admin tab.
Type "type=<monitor type>" is used to list all the monitors in a specified monitor type.
<monitor type>  is TYPE in AM_ManagedObject table like Linux, Windows XP, MYSQL-DB-server, Apache-server, UrlMonitor, Tomcat-server, etc.
resourceid The resourceid of the monitor
type This value specifies the monitor type, to get all monitor types we need to pass 'all' as the value for the field type.

Extra Attributes:

IMAGEPATH This monitor type's image path
LASTALARMTIME This is the time at which last alarm has been generated.

Example API that is used to get XML of monitors by monitor type:

http://app-windows:9090/AppManager/xml/ListMonitor?apikey=[Api Key]&type=Windows

Example API that is used to get XML of all monitors:

http://app-windows:9090/AppManager/xml/ListMonitor?apikey=65d0fa3e1f6c6bdcce1c3969f24c39a8&type=all

Example API that is used to get XML of a particular monitor:

http://app-windows:9090/AppManager/xml/ListMonitor?apikey=65d0fa3e1f6c6bdcce1c3969f24c39a8&resourceid=10000047

Example output:

Monitor Details:

DISPLAYNAME Monitor's Display Name
RESOURCE ID Monitor's Resource ID
TYPE Monitor type like Windows, Linux
Health Details Contains HEALTHMESSAGE that gives the Health Root Cause Message, Health Attribute ID, HEALTHSEVERITY - (5/4/1) - Clear/Warning/Crirical , STATUS - Clear/Warning/Critical
Availability Details Contains AVAILABILITYMESSAGE that gives the Availability Root Cause Message, Availability Attribute ID, AVAILABILITYSEVERITY - Up/Down (5/1), STATUS - UP/Down
Managed True - the monitor is in Managed state, False - the monitor is in Unmanaged State
RESOURCENAME Monitor's Resource Name
DESCRIPTION Description of the Resource like Network Resource
RCAPageURL URL that links to Root Cause Analysis details
DetailsPageURL URL that links to details page of the monitor
LASTALARMTIME This is the time at which last alarm has been generated.


XML Input:

http://app-windows:9090/AppManager/xml/ListMonitor?apikey=65d0fa3e1f6c6bdcce1c3969f24c39a8&type=all

 

Response:

<AppManager-response uri="/AppManager/xml/ListMonitor">

<result>

<response response-code="4000">

<MonitorDetailsPageURL="/showresource.do?resourceid=10000048&method=showResourceForResourceID&PRINTER_FRIENDLY=true" HEALTHATTRIBUTEID="153" ASSOCIATEDGROUPS="Applications Manager,My App2" RESOURCENAME="172.18.90.117" Managed="true" HEALTHSEVERITY="5" AVAILABILITYATTRIBUTEID="152" AVAILABILITYMESSAGE="Resource up. <br>The resource 172.18.90.117 is available." TYPESHORTNAME="Service Monitoring" TYPE="Port-Test" DESCRIPTION="Port-Test Monitoring: for 172.18.90.117" AVAILABILITYSEVERITY="5" RESOURCEID="10000048" HEALTHMESSAGE="Health of 172.18.90.117 is clear. <br>Root Cause : <br>1. Response Time 2 <= 1500 ms (threshold).<br>2. 172.18.90.117 is up<br>" DISPLAYNAME="172.18.90.117" RCAPageURL="/jsp/RCA.jsp?resourceid=10000048&attributeid=153" HEALTHSTATUS="clear" IMAGEPATH="/images/icon_monitors_servicemonitoring.gif" AVAILABILITYSTATUS="up" LASTALARMTIME="0"/><Monitor DetailsPageURL="/showresource.do?resourceid=10000047&method=showResourceForResourceID&PRINTER_FRIENDLY=true" HEALTHATTRIBUTEID="9301" ASSOCIATEDGROUPS="Applications Manager,My App2" RESOURCENAME="localhost" Managed="true" HEALTHSEVERITY="5" AVAILABILITYATTRIBUTEID="9300" AVAILABILITYMESSAGE="Resource up. <br>The resource 172.18.90.117_PGSQL is available." TYPESHORTNAME="PostgreSQL" TYPE="PostgreSQL" DESCRIPTION="PostgreSQL Monitoring: for localhost" AVAILABILITYSEVERITY="5" RESOURCEID="10000047" HEALTHMESSAGE="Health of 172.18.90.117_PGSQL is clear. <br>Root Cause : <br>1. 172.18.90.117_PGSQL is up<br>" DISPLAYNAME="172.18.90.117_PGSQL" RCAPageURL="/jsp/RCA.jsp?resourceid=10000047&attributeid=9301" HEALTHSTATUS="clear" IMAGEPATH="/images/icon_monitors_postgres.gif" AVAILABILITYSTATUS="up" LASTALARMTIME="0"/><Monitor TIMEOUT="3" DetailsPageURL="/showresource.do?resourceid=10000049&method=showResourceForResourceID&PRINTER_FRIENDLY=true" REQUESTPARAMETERS="" HEALTHATTRIBUTEID="401" ASSOCIATEDGROUPS="Applications Manager" USERNAME="" URL="http://rashmi-1335:9090" RETRY="Yes" RESOURCENAME="http://rashmi-1335:9090" Managed="true" HEALTHSEVERITY="5" AVAILABILITYATTRIBUTEID="400" AVAILABILITYMESSAGE="Resource up. <br>The resource AppManager Home Page is available.<span></span>ResponseCode - 200" TYPESHORTNAME="Url Monitor" TYPE="UrlMonitor" DESCRIPTION="URL Monitor for http://rashmi-1335:9090" AVAILABILITYSEVERITY="5" RESOURCEID="10000049" CHECKCONTENT="applications" METHOD="Get" HEALTHMESSAGE="Health of AppManager Home Page is clear. <br>Root Cause : <br>1. AppManager Home Page is up<br>2. Response Time 21 <= 1500 ms (threshold).<br>" DISPLAYNAME="AppManager Home Page" RCAPageURL="/jsp/RCA.jsp?resourceid=10000049&attributeid=401" HEALTHSTATUS="clear" ERRORCONTENT="Error" POLL="10" IMAGEPATH="/images/icon_monitors_urlmonitor.gif" AVAILABILITYSTATUS="up" LASTALARMTIME="1385008485848"/><Monitor DetailsPageURL="/showresource.do?resourceid=10000046&method=showResourceForResourceID&PRINTER_FRIENDLY=true" HEALTHATTRIBUTEID="751" ASSOCIATEDGROUPS="-" RESOURCENAME="rashmi-1335.csez.zohocorpin.com" Managed="true" HEALTHSEVERITY="-" AVAILABILITYATTRIBUTEID="750" AVAILABILITYMESSAGE="-" TYPESHORTNAME="Unknown" TYPE="Node" DESCRIPTION="Network Resource" AVAILABILITYSEVERITY="-" RESOURCEID="10000046" HEALTHMESSAGE="-" DISPLAYNAME="rashmi-1335" RCAPageURL="/jsp/RCA.jsp?resourceid=10000046&attributeid=751" HEALTHSTATUS="UnKnown" IMAGEPATH="/images/icon_monitors_unknown.gif" AVAILABILITYSTATUS="UnKnown" LASTALARMTIME="0"/><Monitor DetailsPageURL="/showresource.do?resourceid=10000050&method=showResourceForResourceID&PRINTER_FRIENDLY=true" HEALTHATTRIBUTEID="16" ASSOCIATEDGROUPS="-" RESOURCENAME="IF-rashmi-1335.csez.zohocorpin.com_Tomcat-server_9090" Managed="true" HEALTHSEVERITY="-" AVAILABILITYATTRIBUTEID="15" AVAILABILITYMESSAGE="-" TYPESHORTNAME="Tomcat" TYPE="Tomcat-server" DESCRIPTION="Network Resource" AVAILABILITYSEVERITY="-" RESOURCEID="10000050" HEALTHMESSAGE="-" DISPLAYNAME="rashmi-1335_Tomcat Server_9090" RCAPageURL="/jsp/RCA.jsp?resourceid=10000050&attributeid=16" HEALTHSTATUS="UnKnown" IMAGEPATH="/images/icon_monitors_tomcat.gif" AVAILABILITYSTATUS="UnKnown" LASTALARMTIME="0"/>

</response>

</result>

</AppManager-response>


 

<< Prev

Home

Next >>

ListDashboards API

ListMonitorGroups API