subscriptions (instance statistics)
Each client that submits a subscribe command message is tracked by AMPS, and their relevant metrics are captured in the monitoring instance database. Selecting the subscriptions resource lists the available subscribers. Selecting a subscriber will list the available statistics below:
| Metric | Description | Type |
|---|---|---|
backlog | The current number of messages leased on this subscription. Applies to subscriptions to a queue. | snapshot |
bookmark | The bookmark the client provided when the subscription was entered, if any. | fixed |
client_id | The ID of the subscribing client. | fixed |
entitlement_filter | The filter applied to this subscription by the entitlement module, if any. (Since a regular expression subscription can have multiple entitlement filters, one for each matching topic, this is blank for subscriptions that use a regular expression for the topic name.) | fixed |
filter | The filter requested on the subscription, if any. | fixed |
message_type | Message type for the subscription message. Message type for a subscription is established when the client connects to a Transport. It will be the | fixed |
options | The options string for the subscription. | fixed |
pagination_id | For subscriptions that use pagination, the identifier of the paginated set for this subscription. | fixed |
seconds_behind | For bookmark subscriptions, the age of the last message enqueued for the client. This indicates the point in the transaction log at which replay is currently happening, and does not necessarily correspond to the rate at which the client is receiving messages or the amount of time required for the client to complete replay. | snapshot |
sub_id | The subscription ID for this subscription. | fixed |
topic | Subscription topic. | fixed |
Statistics Database Tables: ISUBSCRIPTIONS_STATIC, ISUBSCRIPTIONS_DYNAMIC
Admin Path: /amps/instance/subscriptions/<id>/<metric>