Observability

Observability helps you answer what happened to a machine, whether long-running work is still healthy, and which events your application should react to. Use lifecycle events for durable state transitions, webhooks for application notifications, and monitor streams for live metrics and process snapshots.

Choose A Signal

Need	Use
List or stream create, pause, resume, hibernate, fork, and destroy transitions	Lifecycle events
Notify your service when lifecycle events happen	Webhooks
Watch live CPU, memory, process, update, and error events	Monitor machines
Inspect timeout behavior and resource usage	Metrics and timeouts

Quick Examples

List recent lifecycle events:

from nullspace import Lifecycle

lifecycle = Lifecycle()
events = lifecycle.list_events(limit=20)
for event in events.events:
    print(event.operation, event.status, event.machine_id)
lifecycle.close()

Subscribe to live monitor metrics:

from nullspace import Monitor

monitor = Monitor()
subscription = monitor.subscribe(
    interval_ms=1_000,
    include_processes=True,
    on_metrics=lambda event: print(event.metrics),
    on_processes=lambda event: print(event.processes),
    on_error=lambda event: print(event.message),
)
subscription.stop()

Operational Guidance

Situation	Guidance
A workflow owns a specific machine	Use per-machine lifecycle and metrics helpers.
A control plane watches many machines	Use lifecycle list/stream filters and webhooks.
A process may be alive but not ready	Combine monitor data with command, process, or preview readiness checks.
You need retryable automation	Persist event IDs and resume streams with `after_event_id`.

Observability Guides

Lifecycle events

Understand state changes such as create, pause, resume, hibernate, and stop.

Webhooks

Receive event notifications in your own service.

Monitor machines

Inspect resource usage and operational state.

Shutdown Running Machines Lifecycle Events

Get started

Machines

Commands

Filesystem

Code Interpreter

Desktop

Templates

Volumes

Networking

Interactive access

Observability

Choose A Signal

Quick Examples

Operational Guidance

Observability Guides

Lifecycle events

Webhooks

Monitor machines

​Choose A Signal

​Quick Examples

​Operational Guidance

​Observability Guides

Lifecycle events

Webhooks

Monitor machines

​Related

Choose A Signal

Quick Examples

Operational Guidance

Observability Guides

Related