JetStream Advisories
Advisories are system events published by JetStream servers to notify about important state changes and operational events. These events are published to specific subjects that can be subscribed to for monitoring and observability.
Advisory Events
| Name | Subject | Description |
|---|---|---|
| API Audit | $JS.EVENT.ADVISORY.API | Audit trail of JetStream API operations |
| API Limit Reached | $JS.EVENT.ADVISORY.API.LIMIT_REACHED.{account} | API rate limit reached |
| Consumer Action | $JS.EVENT.ADVISORY.CONSUMER.CREATED.{stream}.{consumer}$JS.EVENT.ADVISORY.CONSUMER.DELETED.{stream}.{consumer} | Consumer lifecycle events |
| Consumer Group Pinned | $JS.EVENT.ADVISORY.CONSUMER.GROUP_PINNED.{stream}.{consumer} | Consumer group pinned to node |
| Consumer Group Unpinned | $JS.EVENT.ADVISORY.CONSUMER.GROUP_UNPINNED.{stream}.{consumer} | Consumer group unpinned from node |
| Consumer Leader Elected | $JS.EVENT.ADVISORY.CONSUMER.LEADER_ELECTED.{stream}.{consumer} | New consumer leader elected |
| Consumer Pause | $JS.EVENT.ADVISORY.CONSUMER.PAUSE.{stream}.{consumer} | Consumer paused or resumed |
| Consumer Quorum Lost | $JS.EVENT.ADVISORY.CONSUMER.QUORUM_LOST.{stream}.{consumer} | Consumer lost quorum |
| Domain Leader Elected | $JS.EVENT.ADVISORY.DOMAIN.LEADER_ELECTED.{domain} | New domain leader elected |
| Max Deliveries Exceeded | $JS.EVENT.ADVISORY.CONSUMER.MAX_DELIVERIES.{stream}.{consumer} | Message exceeded max delivery attempts |
| Message NAK | $JS.EVENT.ADVISORY.CONSUMER.MSG_NAK.{stream}.{consumer} | Message negatively acknowledged |
| Message Terminated | $JS.EVENT.ADVISORY.CONSUMER.MSG_TERMINATED.{stream}.{consumer} | Message terminated |
| Restore Complete | $JS.EVENT.ADVISORY.STREAM.RESTORE_COMPLETE.{stream} | Stream restore completed |
| Restore Started | $JS.EVENT.ADVISORY.STREAM.RESTORE_CREATE.{stream} | Stream restore initiated |
| Server Out of Space | $JS.EVENT.ADVISORY.SERVER.OUT_OF_STORAGE | Server storage exhausted |
| Server Removed | $JS.EVENT.ADVISORY.SERVER.REMOVED | Server removed from cluster |
| Snapshot Complete | $JS.EVENT.ADVISORY.STREAM.SNAPSHOT_COMPLETE.{stream} | Stream snapshot completed |
| Snapshot Started | $JS.EVENT.ADVISORY.STREAM.SNAPSHOT_CREATE.{stream} | Stream snapshot initiated |
| Stream Action | $JS.EVENT.ADVISORY.STREAM.CREATED.{stream}$JS.EVENT.ADVISORY.STREAM.DELETED.{stream}$JS.EVENT.ADVISORY.STREAM.UPDATED.{stream} | Stream lifecycle events |
| Stream Leader Elected | $JS.EVENT.ADVISORY.STREAM.LEADER_ELECTED.{stream} | New stream leader elected |
| Stream Quorum Lost | $JS.EVENT.ADVISORY.STREAM.QUORUM_LOST.{stream} | Stream lost quorum |
Subscribing to Advisories
To receive advisory events, subscribe to the appropriate subject pattern. You can use wildcards to subscribe to multiple advisory types:
$JS.EVENT.ADVISORY.>- All advisory events$JS.EVENT.ADVISORY.STREAM.>- All stream-related advisories$JS.EVENT.ADVISORY.CONSUMER.>- All consumer-related advisories