Get External Task Log Count

Queries for the number of historic external task logs that fulfill the given parameters. Takes the same parameters as the Get External Task Logs method.

Method

GET /history/external-task-log/count

Parameters

Query Parameters

Name Description
logId Filter by historic external task log id.
externalTaskId Filter by external task id.
topicName Filter by an external task topic.
workerId Filter by the id of the worker that the task was most recently locked by.
errorMessage Filter by external task exception message.
activityIdIn Only include historic external task logs which belong to one of the passed activity ids.
activityInstanceIdIn Only include historic external task logs which belong to one of the passed activity instance ids.
executionIdIn Only include historic external task logs which belong to one of the passed execution ids.
processInstanceId Filter by process instance id.
processDefinitionId Filter by process definition id.
processDefinitionKey Filter by process definition key.
tenantIdIn Only include historic external task log entries which belong to one of the passed and comma-separated tenant ids.
withoutTenantId Only include historic external task log entries that belong to no tenant. Value may only be true, as false is the default behavior.
priorityLowerThanOrEquals Only include logs for which the associated external task had a priority lower than or equal to the given value. Value must be a valid long value.
priorityHigherThanOrEquals Only include logs for which the associated external task had a priority higher than or equal to the given value. Value must be a valid long value.
creationLog Only include creation logs. Value may only be true, as false is the default behavior.
failureLog Only include failure logs. Value may only be true, as false is the default behavior.
successLog Only include success logs. Value may only be true, as false is the default behavior.
deletionLog Only include deletion logs. Value may only be true, as false is the default behavior.

Result

A JSON object that contains the count as the only property.

Name Type Description
count Number The number of matching historic external task logs.

Response Codes

Code Media type Description
200 application/json Request successful.
400 application/json Returned if some of the query parameters are invalid.

Example

Request

GET /history/external-task-log/count?externalTaskId=anExternalTaskId

Response

{
  "count": 1
}

On this Page: