From a0c27e83ee59f30e054e4cfe3a646e4db8d1df02 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 01:09:18 +0000 Subject: [PATCH] docs(website): sync dev docs from d1e8f44a062aa959d6ce1e6c842ebcb36e42a718 --- fern/.docs-snapshots.yml | 6 +++--- fern/pages-dev/how-it-works/gateways/configuration.mdx | 4 ++++ 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/fern/.docs-snapshots.yml b/fern/.docs-snapshots.yml index 20f2435fb..3acca306e 100644 --- a/fern/.docs-snapshots.yml +++ b/fern/.docs-snapshots.yml @@ -1,8 +1,8 @@ snapshots: dev: - source-ref: 8579dfb30194ea204c5e8e63fcba04a360e3d845 - source-sha: 8579dfb30194ea204c5e8e63fcba04a360e3d845 - version: 0.1.3.dev95 + source-ref: d1e8f44a062aa959d6ce1e6c842ebcb36e42a718 + source-sha: d1e8f44a062aa959d6ce1e6c842ebcb36e42a718 + version: 0.1.3.dev97 latest: source-ref: 6648bd0c290efbc41ba131ee9831ee45cd431f94 source-sha: 6648bd0c290efbc41ba131ee9831ee45cd431f94 diff --git a/fern/pages-dev/how-it-works/gateways/configuration.mdx b/fern/pages-dev/how-it-works/gateways/configuration.mdx index c44101150..a2b72381a 100644 --- a/fern/pages-dev/how-it-works/gateways/configuration.mdx +++ b/fern/pages-dev/how-it-works/gateways/configuration.mdx @@ -375,6 +375,10 @@ Only OpenTelemetry traces are exported. Inbound gRPC and HTTP requests produce s The gateway forwards the OTLP configuration, configured gateway name, configured compute driver, and W3C trace context to managed external drivers. Built-in drivers also export their spans to the same collector through dedicated in-process providers. Driver spans retain the gateway trace context, use a distinct service name such as `openshell-driver-docker` or `openshell-driver-podman`, and carry the same `openshell.gateway.name` and `openshell.gateway.compute_driver` resource attributes as gateway spans. Compute-driver client and server spans use the same fully qualified protobuf operation name, such as `openshell.compute.v1.ComputeDriver/CreateSandbox`, in both the span name and `rpc.method`. The service name and span kind distinguish each side. Backend-prefixed child spans identify implementation work. A streaming watch records a terminal status when observed; consumer teardown without a terminal status leaves the span status unset. Operator-run external drivers own their own telemetry configuration. +Sandbox supervisors export spans to the same collector, so the endpoint must also be reachable from sandboxes. + +Spans for routine or high-volume operations use DEBUG level, and the default INFO level does not export them. Set the gateway or sandbox log level to `debug` to include them. + For Helm deployments, set `server.otlp.endpoint` to render this table. The optional `server.otlp.serviceName` value overrides the gateway service name; driver service names remain fixed.