Documentation
¶
Overview ¶
cloud is the unified Hanzo Cloud binary per HIP-0106.
One binary. Many subsystems. Deployment configuration determines which subsystems mount at startup. Same artifact powers api.hanzo.ai, api.osage.cloud, api.lux.cloud, api.zoo.cloud, and every other white-label resold cloud surface.
The serve body lives in cloud.Serve (one place, shared with the `hanzo` subcommand dispatcher); main() is just its full-surface entrypoint. The subsystem set is defined once in the subsystems bundle.
OTel telemetry bootstrap — installs the global tracer provider that ships this service's spans to the shared o11y backend (SigNoz) over OTLP. This is the ONE way a Hanzo Go daemon emits OpenTelemetry: one call, one service.name, so the console's per-product Monitoring tab (which filters by service.name) lights up for this product.
Posture mirrors the ai module (ai/object/telemetry.go): opt-in via OTEL_EXPORTER_OTLP_ENDPOINT, non-fatal, and a clean no-op when the endpoint is unset — SAFE to ship before the collector is live. The OTLP HTTP exporter self-configures from the standard OTEL_EXPORTER_OTLP_* env (endpoint, headers, per-scheme TLS, timeout) — never hard-coded; New() does not dial and the batch span processor exports in the background, so boot never blocks on the collector.
Source Files