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 |
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 |
<AppManager-response uri="/AppManager/xml/ListMonitorGroups"> <result> <response response-code="4000"> <MonitorGroups> <MonitorGroup DetailsPageURL="/showresource.do?method=showResourceForResourceID&resourceid=10000036&method=showApplication" TODAYUNAVAILPERCENT="0.0" AvailabilityRCAURL="/jsp/RCA.jsp?resourceid=10000036&attributeid=17" Action="enabled" CRITICALCOUNT="0" NAME="Applications Manager" DOWNCOUNT="0" TODAYAVAILPERCENT="100.0" TODAYSCHEDDOWNPERCENT="0.0" Type="Monitor Group" HEALTHSEVERITY="5" HealthUnknownCount="0" AVAILABILITYSEVERITY="5" AVAILABILITYMESSAGE="Resource Applications Manager is up. <br>Root Cause : <br>Resource is Up" RESOURCEID="10000036" CLEARCOUNT="5" UPCOUNT="5" HealthRCAURL="/jsp/RCA.jsp?resourceid=10000036&attributeid=18" TODAYUNMANGDPERCENT="0.0" HEALTHMESSAGE="Health of Applications Manager is clear. <br>Root Cause : <br>Health is Clear" AvailabilityUnknownCount="0" OUTAGES="0/5" DISPLAYNAME="Applications Manager_karthi-0031" WARNINGCOUNT="0" HEALTHSTATUS="clear" AVAILABILITYSTATUS="up" /> </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 |
List Monitor Group Details API |