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.