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
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":
  • TODAYAVAILPERCENT
  • TODAYSCHEDDOWNPERCENT
  • TODAYUNMANGDPERCENT
  • TODAYUNAVAILPERCENT
  • OUTAGES
  • AvailabilityUnknownCount
  • UPCOUNT
  • DOWNCOUNT
  • HealthUnknownCount
  • CLEARCOUNT
  • WARNINGCOUNT
  • CRITICALCOUNT
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":
  • HEALTHSEVERITY
  • HEALTHSTATUS
  • HEALTHMESSAGE
  • HealthRCAURL
  • AVAILABILITYSEVERITY
  • AVAILABILITYSTATUS
  • AVAILABILITYMESSAGE
  • AvailabilityRCAURL
treeview This parameter is used for displaying the tree view structure of the given monitor group. The values are,
  • toplevel - Displays the all parent monitor groups of the given group.
  • bottomlevel - Displays the all child monitor groups of the given group.
  • all - Displays the all parent and child monitor groups of the given group.
If none of the above arguments passed, by default the first level sub-group will be displayed.
listOnlyParentGroups If this parameter is set to true, only the parent monitor groups will be listed.

Note: If the groupName or groupId is not specified in the input, then all the Monitor Group details will be pulled up in the response.

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">
<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>

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>

Case 3: When both the outageReports and the severityDetails are false

<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"}]}}