|
ManageEngine® Applications Manager ListMonitorGroups API | ||
This API will fetch all the List of Monitor Groups created in the Server which includes all the sub- groups and associated monitors configured of the Monitor group. This will also list the monitor groups associated to the user. This will have information about monitor groups today's availability, monitor health outages among subgroups and associated monitors.
API for XML Response:
http://[ APM Host ]:[ APM Port ]/AppManager/xml/ListMonitorGroups?apikey=[ API Key ]&type=all
API for JSON Response:
http://[ APM Host ]:[ APM Port ]/AppManager/json/ListMonitorGroups?apikey=[ API Key ]&groupId=10000035
Request Parameters:
| Field | Description |
| type | To get all monitor groups we need to pass 'all' as the value for the field type. |
| groupId | This parameter is used to get the Monitor Group and its associated monitors based on the monitor group id for the user |
| groupName | This parameter is used to get the Monitor Group and its associated monitors based on the monitor group name for the user. |
| outageReports | This parameter is used to determine whether the user need outage reports. The value of this parameter is either true or false. The default value is true. The following details are added in the response if value is "true":
|
| severityDetails | This parameter is used to define whether the user need severity details or not. The value of this parameter is either true or false. The default value is true. The following details are added in the response if value is "true":
|
| treeview | This parameter is used for displaying the tree view structure of the given monitor group. The values are,
|
Response Details:
| Field | Description |
DetailsPageURL |
This is the url for the details page of the monitor group |
| TODAYUNAVAILPERCENT | This value represents the today's unavailability perecentage |
| AvailabilityRCAURL | This represents the Availability RCA Url. |
| Action | This represents status of the monitor group whether actions or enabled or not |
| CRITICALCOUNT | This represents the critical monitors/monitorgroups count |
| NAME \ DISPLAYNAME | This Represents the displayname of the monitor group |
| DOWNCOUNT | This represents the total number of monitors/monitor groups down in this group |
| TODAYAVAILPERCENT | This value represents the today's availability perecentage |
| TODAYSCHEDDOWNPERCENT | This value represents the today's scheduled downtime perecentage |
| Type | This value represents type i.e Monitor group or sub group |
| HEALTHSEVERITY | This represents the severity of the health for this Monitor group (1-critical, 4-warning & 5-clear) |
| HealthUnknownCount | This represents the number of monitors or subgroups for which the health is unknown. |
| AVAILABILITYSEVERITY | This represents the severity of the availability for this monitor group (1-down , 5-up) |
| AVAILABILITYMESSAGE | This is the availability message for this group |
| RESOURCEID | This is the resourceid of the monitor group. |
| CLEARCOUNT | This represents the number of monitors or subgroups for which the health is clear. |
| UPCOUNT | This represents the number of monitors or subgroups for which the availability is up. |
| HealthRCAURL | This represents the link which show the Health RCA of this group. |
| TODAYUNMANGDPERCENT | This value represents the today's unmanaged perecentage |
| HEALTHMESSAGE | This is the health message for this group |
| AvailabilityUnknownCount | This represents the number of monitors or subgroups for which the availability is unknown. |
| OUTAGES | This represents the number of monitors or subgroups for which the health is not clear. |
| WARNINGCOUNT | This represents the number of monitors or subgroups for which the health is warning. |
| HEALTHSTATUS | This represents health status of this group (CRITICAL / CLEAR / WARNING) |
| AVAILABILITYSTATUS | This represents availablility status of this group (UP/ DOWN) |
| SubMonitorGroup | DetailsPageURL --- This is the details page of the sub group TODAYUNAVAILPERCENT --- this is today's unavailability percentage for sub group AvailabilityRCAURL --- this represents the availability RCA url for sub group Action --- this states whether the actions are enabled for this subgroup or not. NAME \ DISPALYNAME --- this is the displayname of the subgroup TODAYAVAILPERCENT --- this is today's availability percentage for sub group TODAYSCHEDDOWNPERCENT --- this is today's scheduled downtime percentage for sub group HEALTHSEVERITY --- this is health severity of the sub group TYPE --- this represents whether it is subgroup/group AVAILABILITYSEVERITY --- this is availability severity of the sub group AVAILABILITYMESSAGE --- this is availability message of the sub group RESOURCEID --- this is resource id the sub group HealthRCAURL --- this is health RCA url of this sub group TODAYUNMANGDPERCENT --- this is today's unmanaged percentage of the sub group HEALTHMESSAGE --- this is health message of the sub group HEALTHSTATUS --- this is health status of the sub group AVAILABILITYSTATUS --- this is availability status of the sub group |
Case 0: When the type is all
<AppManager-response uri="/AppManager/xml/ListMonitorGroups">
Case 1: When the outageReports is false
<AppManager-response uri="/AppManager/xml/ListMonitorGroups"><result><response response-code="4000"><MonitorGroups><MonitorGroup HEALTHMESSAGE="Health of Applications Manager is critical. <br>Root Cause : <br><ol><li>Health of host-0589_Windows 7 is critical. <br>Root Cause : <br>1. aaa is down <br>2. 111 is down <br></li></ol>" Type="Monitor Group" DISPLAYNAME="Applications Manager" AVAILABILITYMESSAGE="Resource Applications Manager is up. <br>Root Cause : <br>Resource is Up" AVAILABILITYSEVERITY="5" Action="enabled" HEALTHSTATUS="critical" DESCRIPTION="The resources used by Applications Manager" HealthRCAURL="/jsp/RCA.jsp?resourceid=10000029&attributeid=18" RESOURCEID="10000029" AVAILABILITYSTATUS="up" AvailabilityRCAURL="/jsp/RCA.jsp?resourceid=10000029&attributeid=17" DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000029&method=showApplication" NAME="Applications Manager" HEALTHSEVERITY="1"/></MonitorGroups></response></result></AppManager-response>
Case 2: When the severityDetails is false
<AppManager-response uri="/AppManager/xml/ListMonitorGroups"><result><response response-code="4000"><MonitorGroups><MonitorGroup DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000029&method=showApplication" TODAYUNAVAILPERCENT="0.0" Action="enabled" CRITICALCOUNT="1" NAME="Applications Manager" TODAYAVAILPERCENT="100.0" DOWNCOUNT="0" TODAYSCHEDDOWNPERCENT="0.0" Type="Monitor Group" HealthUnknownCount="0" DESCRIPTION="The resources used by Applications Manager" RESOURCEID="10000029" UPCOUNT="4" CLEARCOUNT="3" TODAYUNMANGDPERCENT="0.0" AvailabilityUnknownCount="0" OUTAGES="1/4" DISPLAYNAME="Applications Manager" WARNINGCOUNT="0"/></MonitorGroups></response></result></AppManager-response>
<AppManager-response uri="/AppManager/xml/ListMonitorGroups"><result><response response-code="4000"><MonitorGroups><MonitorGroup RESOURCEID="10000029" DISPLAYNAME="Applications Manager" DESCRIPTION="The resources used by Applications Manager" Type="Monitor Group" DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000029&method=showApplication" Action="enabled" NAME="Applications Manager"/><MonitorGroup RESOURCEID="10000103" DISPLAYNAME="ParentGrp1" DESCRIPTION="Description....This service is critical to our business" Type="Monitor Group" DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000103&method=showApplication" Action="enabled" NAME="ParentGrp1"><SubMonitorGroup RESOURCEID="10000104" DISPLAYNAME="SubGrp1" DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000104&method=showApplication" Action="enabled" NAME="SubGrp1" IMAGEPATH="/images/icon_monitors_app.gif" TYPE="Sub Group"></SubMonitorGroup></MonitorGroups></response></result></AppManager-response> |
JSON Input http://apm-prod1:9090/AppManager/json/ListMonitorGroups?apikey=c4e547c2330e2eb92d3e7af2262da9e9&groupId=10000035 JSON Response {"response-code":"4000","response":{"uri":"/AppManager/json/ListMonitorGroups","result":[{"DetailsPageURL":"/showresource.do?method=showResourceForResourceID&resourceid=20000036&method=showApplication","TODAYUNAVAILPERCENT":"100.0","AvailabilityRCAURL":"/jsp/RCA.jsp?resourceid=20000036&attributeid=17","Action":"enabled","CRITICALCOUNT":"1","NAME":"Applications Manager","DOWNCOUNT":"1","TODAYAVAILPERCENT":"0.0","TODAYSCHEDDOWNPERCENT":"0.0","Type":"Monitor Group","HEALTHSEVERITY":"1","HealthUnknownCount":"0","AVAILABILITYSEVERITY":"1","AVAILABILITYMESSAGE":"Resource Applications Manager is down. <br>Root Cause : <br><ol><li>Resource down. <br>The resource AppManager Home Page is not available.Connection Timed Out. Increase the time out level:ResponseCode -200<br>-->><\/li><\/ol>","RESOURCEID":"20000036","CLEARCOUNT":"2","UPCOUNT":"2","HealthRCAURL":"/jsp/RCA.jsp?resourceid=20000036&attributeid=18","TODAYUNMANGDPERCENT":"0.0","HEALTHMESSAGE":"Health of Applications Manager is Critical. <br>Root Cause : <br><ol><li>Health of AppManager Home Page is critical. <br>Root Cause : <br>1. AppManager Home Page is down<br><\/li><\/ol>","AvailabilityUnknownCount":"0","OUTAGES":"1/3","DISPLAYNAME":"Applications Manager","WARNINGCOUNT":"0","HEALTHSTATUS":"critical","AVAILABILITYSTATUS":"down"}]}}
|
List Monitor API |
ListMGDetails API |