Skip to main content

Connectivity

The ConnectivityAgent in Oblix monitors network connectivity, including latency, packet loss, and bandwidth to determine if cloud model execution is viable.

Creating a Connectivity Agent​

from oblix.agents import ConnectivityAgent

# Create with default settings
connectivity_agent = ConnectivityAgent()

# Create with custom configuration
connectivity_agent = ConnectivityAgent(
name="custom_connectivity_monitor",
latency_threshold=150.0, # Maximum acceptable latency in ms (default: 200.0)
packet_loss_threshold=5.0, # Maximum acceptable packet loss percentage (default: 10.0)
bandwidth_threshold=10.0, # Minimum acceptable bandwidth in Mbps (default: 5.0)
check_interval=60 # Seconds between connectivity checks (default: 30)
)

Connectivity States​

The connectivity agent reports one of the following states:

StateDescription
OPTIMALGood connectivity suitable for cloud model use
DEGRADEDLimited connectivity that may affect performance
DISCONNECTEDNo connectivity, must use local models

Connection Targets​

Based on connectivity state, the agent recommends one of these targets:

TargetDescription
LOCALUse local models due to connectivity issues
CLOUDUse cloud models due to good connectivity
HYBRIDConsider balancing between local and cloud models

Accessing Connectivity Metrics Directly​

You can access the current connectivity metrics directly:

# Get connectivity metrics
connectivity_metrics = await client.get_connectivity_metrics()
print(f"Current latency: {connectivity_metrics['latency']}ms")
print(f"Packet loss: {connectivity_metrics['packet_loss']}%")
print(f"Bandwidth: {connectivity_metrics['bandwidth']} Mbps")