Monitor and troubleshoot

Open a sandbox in the console to see its activity, system logs, and resource use. You can retrieve the same information through the SDK.

from lithosbox import LithosBox

box = LithosBox()
sandbox = box.sandboxes.get("YOUR_SANDBOX_ID")

Review sandbox activity

for event in sandbox.events(limit=20):
    print(event["at"], event["kind"], event.get("detail", ""))

Events describe actions such as creation, sleep, snapshots, and archive. They are returned newest first. Keep the sandbox ID when reporting an issue so its timeline can be found even after deletion.

Read system and application logs

Use system logs to investigate startup or an unresponsive environment:

print(sandbox.logs(tail_bytes=65536))

These logs contain boot output and system messages. They do not replace the output of your SDK commands. For a command, read result.stdout and result.stderr; for a background application, redirect its output to a file and read that file with sandbox.files.read(). You can read system logs while a sandbox is paused or sleeping without waking it. Archived sandboxes do not have live system logs. Each call reads up to 256 KiB.

Inspect resource use

Get recent CPU, memory, and network samples:

recent = sandbox.metrics()
for sample in recent["samples"]:
    print(sample["at_unix"], sample["cpu_ms"], sample["mem_mb"])

Recent samples cover approximately two hours at 30-second intervals. Use history for a longer period or for an archived sandbox:

history = sandbox.metrics(hours=24)
for point in history["points"]:
    if point.get("measured") is False:
        continue
    print(point)

History uses minute intervals and supports up to 15 days. You can also pass start and end as RFC3339 timestamps. A point with measured=false means a measurement is missing; it does not mean resource use was zero. History and events remain queryable after deletion within their retention periods. Keep an existing sandbox handle to query them after deleting it, or use the HTTP history endpoint with the saved ID. Fetching a deleted sandbox with box.sandboxes.get() returns NotFoundError.

Review organization usage and audit records

usage = box.usage()
audit = box.audit(limit=20)
for record in audit["records"]:
    print(record["at"], record["action"], record["outcome"])
box.close()

Use Console → Usage to compare resource use over time and Audit to review changes made by members and API keys. Audit records identify the action, resource, outcome, and request ID. For an issue you cannot resolve, follow the support checklist.

Getting Started

Reference

Guides

Concepts

Monitor and troubleshoot

Review sandbox activity

Read system and application logs

Inspect resource use

Review organization usage and audit records

​Review sandbox activity

​Read system and application logs

​Inspect resource use

​Review organization usage and audit records

Review sandbox activity

Read system and application logs

Inspect resource use

Review organization usage and audit records