Manage AFA issues

Use the following request methods to manage issues in the AFA issues center.

Note: All of the API requests for managing issues can only be run by administrators. In a distributed architecture environment, they can only be run on the central manager / master appliance.

Retrieve unresolved issues

The get_issues request retrieves all the unresolved issues in the AFA issues center. This includes both acknowledged and active issues.

Resource Name:/ms-watchdog/v1/api/issues-center/issues

Request Method: POST

Authentication: Cookie with session ID.

Request URL Parameters:

Element

Type

Description
sizeOptional

Integer

Number of results per page.

The default value is 10.
pageOptional

Integer

Page number to return.

The default value is 0 (the first page).

Note: This element requires a definition for size. Defining this element without size will cause the return to be empty.
sortColumnOptional

String

The column / issue attribute to sort by.

One of the elements of the issueAttributes, issue, or device objects. See IssueAttributes type.

sortDirectionOptional

String

The sort direction. One of the following:

  • DESC (Default)
  • ASC

Request Body:

(Optional) A map of column names and values.

The response will only include issues which match the specified value(s) for the specified columns.

The column name can be any of the elements of the issueAttributes, issue, or device objects. See IssueAttributes type.

Response:

Element

Type

Description
content

Array

An array of issueAttributes objects. See IssueAttributes type.
Various elements that describe the paging of the issues.  

See the spring framework for more information.

Request example

https://<ASMS_Server>/ms-watchdog/v1/api/issues-center/issues?size=13&page=0&sortColumn=lastFailure&sortDirection=DESC

{"nodeType":"MASTER","issue.type":"System"}

Response example 

{ 
 "content":[ 
  { 
   "id":1,
   "status":"OPEN",
   "lastFailure":"2019-05-01T14:33:40.369",
   "lastSuccess":null,
   "count":15,
   "nodeType":"MASTER",
   "nodeName":"10.20.15.82",
   "issue":{ 
    "type":"System",
    "failureType":"Disk space",
    "description":"Low free disk space on /data",
    "remediation":"- Configure/change the backup configuration for a smaller retention size\n- Delete temporary files.",
    "kbLink":""
    },
    "device":null
   },
   { 
    "id":357,
    "status":"ACKNOWLEDGED",
    "lastFailure":"2019-04-24T08:26:45.264",
  "lastSuccess":"2019-04-21T10:18:19.033",
  "count":818,
  "nodeType":"MASTER",
  "nodeName":"10.20.15.82",
  "issue":{ 
  "type":"System",
  "failureType":"Disk space",
  "description":"Low free disk space",
  "remediation":"- Configure/change the backup configuration for a smaller retention size\n- Delete temporary files",
  "kbLink":""
   },
   "device":null
    },
    { 
    "id":133,
    "status":"ACKNOWLEDGED",
    "lastFailure":"2019-04-24T08:26:45.06",
    "lastSuccess":null,
    "count":1893,
    "nodeType":"MASTER",
    "nodeName":"10.20.15.82",
    "issue":{ 
     "type":"System",
     "failureType":"DFS",
     "description":"Synchronization error",
     "remediation":"Synchronization error on node",
     "kbLink":""
     },
     "device":null
     },
],
"pageable":"INSTANCE",
"last":true,
"totalPages":1,
"totalElements":6,
"sort":{ 
	"sorted":false,
	"unsorted":true,
	"empty":true
},
"first":true,
"numberOfElements":6,
"size":0,
"number":0,
"empty":false
}

Back to top

Acknowledge an issue

The acknowledge request marks active issues in the AFA issues center as acknowledged. Issues marked as acknowledged will appear in the list of acknowledged issues and will no longer appear in the list of active issues.

Resource Name:/ms-watchdog/v1/api/issues-center/issues/acknowledge

Request Method: POST

Authentication: Cookie with session ID.

Request Body: Any array of issue IDs. To retrieve the issue IDs, see Retrieve unresolved issues.

Response:

Element

Type

Description

newStatus

String

The new status of the issues: ACKNOWLEDGED.
updatedIssues Array

An array of issue IDs.
successful Boolean

Whether the request was successful.

Request example

#/ms-watchdog/v1/api/issues-center/issues/acknowledge

[2,4]

Response example 

{ 
	"newStatus":"ACKNOWLEDGED",
	"updatedIssues":[ 
		2,
		4
	],
	"successful":true
}

Back to top

Activate an issue

The activate request marks acknowledged issues in the AFA issues center as active. Issues marked as active will appear in the list of active issues and will no longer appear in the list of acknowledged issues.

Resource Name:/ms-watchdog/v1/api/issues-center/issues/activate

Request Method: POST

Authentication: Cookie with session ID.

Request Body: Any array of issue IDs. To retrieve the issue IDs, see Retrieve unresolved issues.

Response:

Element

Type

Description

newStatus

String

The new status of the issues: OPEN.
updatedIssues Array

An array of issue IDs.
successful Boolean

Whether the request was successful.

Request example

#/ms-watchdog/v1/api/issues-center/issues/activate

[2,4]

Response example 

{ 
	"newStatus":"OPEN",
	"updatedIssues":[ 
		2,
		4
	],
	"successful":true
}

Back to top