Files
opensandbox-group--opensandbox/components/execd/docs/opentelemetry.md
T
wehub-resource-sync e0e362d700
SDK Tests / SDK CI (push) Blocked by required conditions
SDK Tests / changes (push) Successful in 2m29s
Real E2E Tests / changes (push) Successful in 2m29s
SDK Tests / Python SDK Tests (sandbox) (push) Waiting to run
SDK Tests / CLI Quality (push) Waiting to run
SDK Tests / CLI Tests (push) Waiting to run
SDK Tests / Python SDK Quality (code-interpreter) (push) Waiting to run
SDK Tests / Python SDK Quality (sandbox) (push) Waiting to run
SDK Tests / Python SDK Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Go SDK Quality And Tests (push) Waiting to run
Deploy Docs Pages / build (push) Has been cancelled
Deploy Docs Pages / deploy (push) Has been cancelled
Real E2E Tests / JavaScript E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Python E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Java E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / C# E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Go E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Real E2E CI (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:39:33 +08:00

1.8 KiB

OpenTelemetry Metrics (Current Execd Support)

This page lists the OpenTelemetry metrics currently implemented in execd.

Meter

  • opensandbox/execd

Metrics

Metric Type Unit Attributes Meaning
execd.http.request.duration Histogram ms http_method, http_route, http_status_code HTTP request latency.
execd.execution.duration Histogram ms operation, result Code/command execution duration.
execd.filesystem.operations.duration Histogram ms operation, result Filesystem operation duration.
execd.system.process.count Observable Gauge - - Current process count.
execd.system.cpu.usage Observable Gauge % - System CPU usage percent (gopsutil).
execd.system.memory.usage_bytes Observable Gauge By - System memory used bytes (gopsutil).
execd.system.network.io.bytes Observable Counter By direction (in/out) Cumulative network I/O bytes.
execd.system.network.connections.active Observable Gauge - protocol (tcp/udp) Current active network connections.

Shared Attributes

All execd metrics may include shared attributes:

  • sandbox_id from OPENSANDBOX_ID (when set)
  • extra key/value attributes from OPENSANDBOX_EXECD_METRICS_EXTRA_ATTRS (when set)

OTEL Endpoint Configuration

Metric export is enabled only when at least one OTLP endpoint is set.

  • OTEL_EXPORTER_OTLP_METRICS_ENDPOINT (preferred)
  • OTEL_EXPORTER_OTLP_ENDPOINT (fallback)

If both are unset, execd keeps metrics local (no OTLP export).

Minimal Example

export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://otel-collector:4318"

Optional Service Name

export OTEL_SERVICE_NAME="opensandbox-execd"