> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hopx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Observability

> Complete guide to monitoring HopX sandboxes - metrics, processes, and system information for observability and debugging. Monitor CPU, memory, and disk usage, list and track running processes, view system metrics, and use observability features for performance optimization and troubleshooting. Includes SDK and API examples.

Monitor and observe HopX sandboxes with comprehensive metrics, process monitoring, and system information. This hub covers all observability features for debugging and performance optimization.

## Related

* [CLI System Commands](/cli/commands/system) - System operations from CLI

## What You'll Learn

* How to monitor sandbox metrics (CPU, memory, disk)
* How to list and monitor processes
* How to track system information and health
* How to use observability for debugging
* How to optimize performance based on metrics

## Observability Overview

| Feature                                                   | SDK Method                    | API Endpoint          |
| --------------------------------------------------------- | ----------------------------- | --------------------- |
| **[Metrics](/core-concepts/observability/metrics)**       | `sandbox.get_agent_metrics()` | `GET /system/metrics` |
| **[Processes](/core-concepts/observability/processes)**   | `sandbox.list_processes()`    | `GET /processes`      |
| **[Monitoring](/core-concepts/observability/monitoring)** | Monitoring utilities          | Monitoring endpoints  |

## Core Concepts

### Metrics

Monitor CPU, memory, disk, and other system metrics.

* **[Metrics](/core-concepts/observability/metrics)** - Monitor system metrics
* **SDK**: [Python: sandbox.get\_agent\_metrics()](/sdk/python/sandbox#get_agent_metrics) | [JavaScript: sandbox.getAgentMetrics()](/sdk/javascript/sandbox#getagentmetrics)
* **API**: [GET /system/metrics](/api/vm-agent/get-system-metrics)

### Processes

List and monitor running processes in sandboxes.

* **[Processes](/core-concepts/observability/processes)** - Monitor processes
* **SDK**: [Python: sandbox.list\_processes()](/sdk/python/sandbox#list_processes) | [JavaScript: sandbox.listProcesses()](/sdk/javascript/sandbox#listprocesses)
* **API**: [GET /processes](/api/vm-agent/list-processes) | [GET /processes/system](/api/vm-agent/list-system-processes)

### Monitoring

Comprehensive monitoring strategies and best practices.

* **[Monitoring](/core-concepts/observability/monitoring)** - Monitoring strategies
* **SDK**: Monitoring utilities | **API**: Monitoring endpoints

## SDK Reference

### Python SDK

Complete reference for Python observability operations.

* **[Sandbox.get\_agent\_metrics()](/sdk/python/sandbox#get_agent_metrics)** - Get system metrics
* **[Sandbox.list\_processes()](/sdk/python/sandbox#list_processes)** - List processes
* **[Sandbox.get\_metrics\_snapshot()](/sdk/python/sandbox#get_metrics_snapshot)** - Get metrics snapshot

### JavaScript SDK

Complete reference for JavaScript/TypeScript observability operations.

* **[Sandbox.getAgentMetrics()](/sdk/javascript/sandbox#getagentmetrics)** - Get system metrics
* **[Sandbox.listProcesses()](/sdk/javascript/sandbox#listprocesses)** - List processes
* **[Sandbox.getMetricsSnapshot()](/sdk/javascript/sandbox#getmetricssnapshot)** - Get metrics snapshot

## API Reference

### VM Agent API

REST API endpoints for observability.

* **[VM Agent API Overview](/api/vm-agent/overview)** - API overview
* **[Get System Metrics](/api/vm-agent/get-system-metrics)** - `GET /system/metrics` - Get metrics
* **[List Processes](/api/vm-agent/list-processes)** - `GET /processes` - List background processes
* **[List System Processes](/api/vm-agent/list-system-processes)** - `GET /processes/system` - List all processes

## Quick Start

If you're new to observability, start here:

1. **[Metrics](/core-concepts/observability/metrics)** - Monitor system metrics
2. **[Processes](/core-concepts/observability/processes)** - Monitor running processes
3. **[Monitoring](/core-concepts/observability/monitoring)** - Set up monitoring

## Related Topics

* **[Code Execution](/core-concepts/code-execution/background)** - Monitor background execution
* **[Sandboxes](/core-concepts/sandboxes/managing-state)** - Monitor sandbox state
* **[Process Management](/core-concepts/code-execution/process-management)** - Manage processes
* **[Cache Management](/core-concepts/cache/statistics)** - Monitor cache usage

## Next Steps

* Learn about [Metrics](/core-concepts/observability/metrics) for system monitoring
* Explore [Processes](/core-concepts/observability/processes) for process monitoring
* Review [Monitoring](/core-concepts/observability/monitoring) for comprehensive strategies
* Check out [Code Execution](/core-concepts/code-execution/background) for execution monitoring