LXD provides an /events endpoint that is upgraded to a streaming websocket
for getting LXD events in real-time. The
method will return a websocket client that can interact with the
web socket messages.
>>> ws_client = client.events() >>> ws_client.connect() >>> ws_client.run()
A default client class is provided, which will block indefinitely, and collect all json messages in a messages attribute. An optional websocket_client parameter can be provided when more functionality is needed. The ws4py library is used to establish the connection; please see the ws4py documentation for more information.
The stream of events can be filtered to include only specific types of events, as defined in the LXD /endpoint documentation.
To receive all events of type ‘operation’ or ‘logging’, generated by the LXD server:
>>> filter = set([EventType.Operation, EventType.Logging]) >>> ws_client = client.events(event_filter=filter)
To receive only events pertaining to the lifecycle of the containers:
>>> filter = set([EventType.Lifecycle]) >>> ws_client = client.events(event_filter=filter)