Schedule demo

Get Monitor Group Availability API


You can use this API is used to pull up availability data on a monitor group in Applications Manager. Depending on the output format that you require, you can use one of the following APIs:

getMonitorGroupAvailabilityInfo API

Sample Request:

https://[HOST]:[PORT]/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=[REST API Key]

Supported HTTP methods: GET

Allowed roles: Administrator, Operator, User

Request Parameters

The parameters involved in the API request are described below:

FieldDescription
apikey *The key generated from the Generate API Key option in the Settings tab.
IncludeSubGroupSpecify 'IncludeSubGroup=trueif you also wish to know the availability status of the sub-group within the monitor group.
CustomTimeSpecify CustomTime=true for custom time availability report. If CustomTime is true then you must provide StartTime and EndTime.
StartTimeThe start time of the report, in milliseconds.
EndTimeThe end time of the report in milliseconds.
ReportPeriod

The time period for which the report should be created. If this parameter is not provided then today's availability is shown. Possible values are:

  • 0 = Todays Availability
  • 1 = Last 7 Days Availability
  • 2 = Last 30 Days Availability
  • 3 = Yesterday Availability
  • 5 = Last 1 Year Availability
  • 6 = This week Availability
  • 7 = This month Availability
  • 8 = This year Availability
  • 9 = This quarter Availability
  • 11= Last month Availability
  • 12= Last week Availability
HAIDThe ID of the monitor group. In Applications Manager, you can find the groupID of a monitor group using the following method:
  • Click on the Group Name in the Monitor Groups table. This will open the Monitor Group details page
  • The URL of the Monitor Group details page will be in the following format:

    https://apm-prod-server:8443/showapplication.do?&method=showApplication&HAID=10000040

  • The HAID in the URL is the Group ID that you require, in this case, 10000040.

* mandatory

Sample Inputs

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee

To include sub-group:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true

For service availability calculation:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&ServiceAvailability=true

For custom time availability report:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&CustomTime=true&StartTime=1584877371000&EndTime=1585136571000

To set the Report Period:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&ReportPeriod=1

To filter with HAIDs:

https://apm-prod-server:8443/AppManager/xml/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true&HAID=10000

Sample Outputs

Description

Sample Inputs and Outputs

To include sub-group

Input:

https://apm-prod-server:8443/AppManager/xml/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true

Output:

<AppManager-response uri="/AppManager/xml/getMonitorGroupAvailabilityInfo">
<result>
<response response-code="200">
<Group_Availability>
<Availability ResourceID="10001368" DisplayName="App2-level1" Unavailable="0" Available="100"/>
<Availability ResourceID="10001369" DisplayName="App2-level2" Unavailable="0" Available="100"/>
<Availability ResourceID="10000252" DisplayName="App - 1" Unavailable="100.0" Available="0.0"/>
</Group_Availability>
</response>
</result>
</AppManager-response>

 

getMonitorGroupAvailability API

Sample Request:

https://[HOST]:[PORT]/AppManager/json/getMonitorGroupAvailability?apikey=[REST API Key]

Supported HTTP methods: GET

Allowed roles: Administrator, Operator, User

Request Parameters

The parameters involved in the API request are described below:

FieldDescription
apikey*The key generated from the Generate API Key option in the Settings tab.
IncludeSubGroupSpecify IncludeSubGroup=true if you also wish to know the availability status of the sub-group within the monitor group.
CustomTimeSpecify CustomTime=true for custom time availability report. If CustomTime is true then you must provide StartTime and EndTime
StartTimeThe start time of the report, in milliseconds.
EndTimeThe end time of the report in milliseconds.
ReportPeriod

The time period for which the report should be created. If this parameter is not provided then today's availability is shown. Possible values are:

  • 0 = Todays Availability
  • 1 = Last 7 Days Availability
  • 2 = Last 30 Days Availability
  • 3 = Yesterday Availability
  • 5 = Last 1 Year Availability
  • 6 = This week Availability
  • 7 = This month Availability
  • 8 = This year Availability
  • 9 = This quarter Availability
  • 11= Last month Availability
  • 12= Last week Availability
HAIDThe id of the monitor group. In Applications Manager, you can find the groupID of a monitor group using the following method:
  • Click on the Group Name in the Monitor Groups table. This will open the Monitor Group details page
  • The URL of the Monitor Group details page will be in the following format:

    https://apm-prod-server:8443/showapplication.do?&method=showApplication&HAID=10000040

  • The HAID in the URL is the Group ID that you require, in this case, 10000040.

* - mandatory

Sample requests:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee

To include sub-group:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true

For service availability calculation:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee&ServiceAvailability=true

For custom time availability report:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee&CustomTime=true&StartTime=1584877371000&EndTime=1585136571000

To set the Report Period:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee&ReportPeriod=1

To filter with HAIDs:

https://apm-prod-server:8443/AppManager/xml/getMonitorGroupAvailabilityInfo?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true&HAID=10000

Sample Output

Description

Sample Inputs and Outputs

To include sub-group

Input:

https://apm-prod-server:8443/AppManager/json/getMonitorGroupAvailability?apikey=aaaaaabbbbbbccccccddddddeeeeee&IncludeSubGroup=true

Output:

Today Availability Report
ResourceID,DisplayName,Uptime %,Downtime %
10001368,App2-level1,100%,0%
10001369,App2-level2,100%,0%
10000252,App - 1,0.0%,100.0%

Loved by customers all over the world

"Standout Tool With Extensive Monitoring Capabilities"

It allows us to track crucial metrics such as response times, resource utilization, error rates, and transaction performance. The real-time monitoring alerts promptly notify us of any issues or anomalies, enabling us to take immediate action.

Reviewer Role: Research and Development

carlos-rivero
"I like Applications Manager because it helps us to detect issues present in our servers and SQL databases."
Carlos Rivero

Tech Support Manager, Lexmark

Trusted by thousands of leading businesses globally