The monitorCountIssuesByPredefinedFilter Web API Method

Count the number of issues according to a particular filter or customized filter list.

The response is a list of issue elements with their general details and event-groups identifiers.

Version: 1.3

Required Permissions: Read-only

HTTP method: GET

Supported by Editions: Zend Server

Request Parameters:  

Parameter

 Type

Required

Description

filterId

String

Yes

The predefined filter's name. This parameter is case-sensitive

filters

Array

No

Add filter parameters in an ad-hoc manner. These filters will be added to the predefined filter that was passed.

This parameter is an array with a predefined set of parameters that accept strings or arrays to hold multiple values:

  • applicationIds: array, a list of application IDs to use for retrieving issue rows

  • severities: array, a list of severities (info, normal, severe)

  • statuses: array, a list of statuses (open, closed, reopened, ignored)

  • eventTypes: array, a list of eventTypes (zend-error, function-error, request-slow-exec, function-slow-exec, request-relative-slow-exec, java-exception, request-large-mem-usage, request-relative-large-mem-usage, request-relative-large-out-size, jq-job-exec-error, jq-job-logical-failure, jq-job-exec-delay, jq-daemon-high-concurrency, tracer-write-file-fail, zsm-node-added-successfully, zsm-node-enabled, zsm-node-disabled, zsm-node-removed-successfully, zsm-node-is-not-responding, zsm-configuration-mismatch, zsm-restart-failed, zdd-deploy-success, zdd-deploy-error, zdd-redeploy-success, zdd-redeploy-error, zdd-remove-success, zdd-remove-error, zdd-update-success, zdd-update-error, zdd-rollback-success, zdd-rollback-error, custom

  • freeText: string

  • from: string, a timestamp to use for retrieving rows

  • to: string, a timestamp to use for retrieving rows

  • ruleNames: array, a list of rule names that are defined in the system: Function Error, Database Error, Slow Function Execution, Slow Query Execution, Slow Request Execution, High Memory Usage, Inconsistent Output Size, PHP Error, Uncaught Java Exception, Custom Event, Zend Framework Exception, Job Execution Error, Job Logical Failure, Job Execution Delay, Failed Writing Code Tracing Data and other custom names

Expected Response Code: 200 OK. For more information see Response Format.

Response Format: Response successful message or error message

Possible Action Specific Error Codes:

HTTP Code

Error Code

Description

404

noSuchFilterId

The requested filter does not exist

Example

Usage Example

Request

GET/ZendServer/Api/monitorCountIssuesByPredefinedFilter?filterId=All+Issues

Response

<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse >
	<requestData>
		<apiKeyName><![CDATA[Admin]]></apiKeyName>
		<method>monitorGetIssuesListPredefinedFilter</method>
	</requestData>
	<responseData>
		<totalCount>2</totalCount>	
	</responseData>
</zendServerAPIResponse>