Skip to main content

processors (instance statistics)

Selecting the processors resource will list all the available message processors that the AMPS instance has invoked to handle messages. Each AMPS message processor will be listed individually, or selecting the all resource will list an aggregate of the available message processors.

All AMPS message processors have the following attributes available:

MetricDescriptionType
denied_readsNumber of read requests which have been denied due to an entitlement filter.cumulative
denied_writesNumber of write requests which have been denied.cumulative
descriptionDescriptor of the processor.fixed
last_active

Number of milliseconds since a processor was last active.

For each statistics snapshot, this indicates the longest period of time between the time that the statistics were collected and the time an instance of a processor of this type marked itself as active.

This counter is expected to have variation in a healthy instance. A steady increase in this counter over a number of samples could indicate that the processor is not able to become active (for example, due to CPU saturation).

snapshot
matches_foundNumber of messages found.cumulative
matches_found_per_secRate of messages found.interval average
matches_found_bytesNumber of bytes matched.cumulative
matches_found_bytes_per_secRate of bytes matched for this processor.interval average
messages_receivedNumber of messages received.cumulative
messages_received_per_secRate of messages received.interval average
messages_received_bytesNumber of bytes received.cumulative
messages_received_bytes_per_secRate of bytes received for this processor.interval average
throttle_count

Number of times the processor had to wait to add a message to the processing pipeline due to the instance reaching capacity limits on the number of in-progress messages.

This metric can indicate resource constraints on AMPS.

cumulative

AMPS also includes information for the following processing types, presented as an entry for a message processor with the given name:

Processing TypeDescription
bookmarkMessages from transaction log replays (bookmark subscriptions).
detachedMessages related to subscriptions that hold messages before delivering them (such as conflated subscriptions, aggregated subscriptions, and subscriptions that use pagination).
externalMessages to and from regular publish/subscribe subscriptions (that is, not SOW queries, message queue subscriptions, or transaction log replays).
internalMessages internally generated by AMPS.
queueMessages to and from message queues.
replicationMessages to and from replication destinations.
sowMessages from queries of a SOW topic.

Statistics Database Tables: IPROCESSORS_STATIC, IPROCESSORS_DYNAMIC

Admin Path: /amps/instance/processors/<identifier>/<metric>