The event bus facilitates the transmission of events to subscribers using a NATS-based system. When eventing is enabled, NATS pods are created to gather various events from the cluster. These events are generated by changes in the system, such as the creation and deletion of volumes and replicas.
Presently, callhome serves as the sole consumer for these events. Within the obs-callhome-stats container, the stats exporter operates by listening on the event bus for events. It collects these events and makes them available as part of callhome metrics.
List of events being collected:
Volume Events#
| Category | Action | Source | Description |
|---|
| Volume | Create | Control plane | Generated when a volume is successfully created |
| Volume | Delete | Control plane | Generated when a volume is successfully deleted |
Replica Events#
| Category | Action | Source | Description |
|---|
| Replica | Create | Data plane | Generated when a replica is successfully created |
| Replica | Delete | Data plane | Generated when a replica is successfully deleted |
| Replica | StateChange | Data plane | Created upon a change in replica state |
Pool Events#
| Category | Action | Source | Description |
|---|
| Pool | Create | Data plane | Generated when a pool is successfully created |
| Pool | Delete | Data plane | Generated when a pool is successfully deleted |
Nexus Events#
| Category | Action | Source | Description |
|---|
| Nexus | Create | Data plane | Created when a nexus is successfully created |
| Nexus | Delete | Data plane | Created when a nexus is successfully deleted |
| Nexus | StateChange | Data plane | Created upon a change in nexus state |
| Nexus | RebuildBegun | Data plane | Created when a nexus child rebuild operation begins |
| Nexus | RebuildEnd | Data plane | Created when a nexus child rebuild operation ends |
| Nexus | AddChild | Data plane | Created when a child is added to nexus |
| Nexus | RemoveChild | Data plane | Created when a child is removed from nexus |
| Nexus | OnlineChild | Data plane | Created when a nexus child becomes online |
| Nexus | SubsystemPause | Data plane | Created when an I/O subsystem is paused |
| Nexus | SubsystemResume | Data plane | Created when an I/O subsystem is resumed |
| Nexus | Init | Data plane | Created when nexus enters into init state |
| Nexus | Reconfiguring | Data plane | Created when nexus enters into reconfiguring state |
| Nexus | Shutdown | Data plane | Created when a nexus is destroyed |
Node Events#
| Category | Action | Source | Description |
|---|
| Node | StateChange | Control plane | Created upon a change in node state |
High Availability Events#
| Category | Action | Source | Description |
|---|
| HighAvailability | SwitchOver | Control plane | Created when a volume switch over operation starts, fails or completes |
Nvme Path Events#
| Category | Action | Source | Description |
|---|
| NvmePath | NvmePathSuspect | Control plane | Created when an NVMe path enters into suspect state |
| NvmePath | NvmePathFail | Control plane | Created when an NVMe path transitions into failed state |
| NvmePath | NvmePathFix | Control plane | Created when an NVMe controller reconnects to a nexus |
Host Initiator Events#
| Category | Action | Source | Description |
|---|
| HostInitiator | NvmeConnect | Data plane | Created upon a host connection to a nexus |
| HostInitiator | NvmeDisconnect | Data plane | Created upon a host disconnection to a nexus |
| HostInitiator | NvmeKeepAliveTimeout | Data plane | Created upon a host keep alive timeout (KATO) on a nexus |
IO-Engine Events#
| Category | Action | Source | Description |
|---|
| IoEngineCategory | Start | Data plane | Created when io-engine is initializes |
| IoEngineCategory | Shutdown | Data plane | Created when io-engine shutdown starts |
| IoEngineCategory | Stop | Data plane | Created when an io-engine is stopped |
| IoEngineCategory | ReactorUnfreeze | Data plane | Created when an io-engine reactor is healthy again |
| IoEngineCategory | ReactorFreeze | Data plane | Created when an io-engine reactor frozen |
Snapshot and Clone Events#
| Category | Action | Source | Description |
|---|
| Snapshot | Create | Data plane | Created when a snapshot is successfully created |
| Clone | Create | Data plane | Created when a clone is successfully created |
