HYPHAby S33D
Documentation › Observe

Traces, OpenTelemetry, errors and RUM

HYPHA speaks OpenTelemetry. Your applications send their traces, directly or through the host's agent, and HYPHA derives services, latencies, errors and a dependency map.

Send OpenTelemetry data

HYPHA receives OTLP over HTTP, as protobuf or JSON:

SignalAddress
Traceshttps://hypha.s33d.fr/v1/traces
Metricshttps://hypha.s33d.fr/v1/metrics
Logshttps://hypha.s33d.fr/v1/logs

The ingestion key goes in the X-Hypha-Api-Key header, or Authorization: Bearer <key>.

Turn on the agent's relay: applications target the loopback, the agent adds the key and retries if the server is unreachable.

otlp:
  enabled: true
  listen: 127.0.0.1:4318
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_SERVICE_NAME=shop-api
export OTEL_RESOURCE_ATTRIBUTES=deployment.environment=prod,service.version=2.14.0

Directly

export OTEL_EXPORTER_OTLP_ENDPOINT=https://hypha.s33d.fr
export OTEL_EXPORTER_OTLP_HEADERS="X-Hypha-Api-Key=hph_your_key"

What HYPHA keeps

APM

Traces: from the service to the request · 33 s
What the video shows
  1. APM: services, their throughput, errors and latency.
  2. The shop-api service: operations and resources.
  3. A checkout trace as a waterfall: PostgreSQL, Redis and the stock service.
  4. The service map, drawn from the traces.

Monitor templates: HTTP 5xx errors of a service, p95 latency, new application error.

Error tracking

The Errors page groups similar errors into issues:

An issue's fingerprint takes into account the origin, the service, the type and the first five frames of the stack, without line numbers or values. Each issue shows its stack, its histogram and its latest occurrences with the matching trace or line. A resolved issue that comes back reopens and is marked "regressed". Buttons Resolve, Ignore and Explain.

RUM: real user monitoring

Create an application in the RUM page, then add its script to your pages:

<script src="https://hypha.s33d.fr/rum/hypha-rum.js" data-token="client_token" data-service="shop-web" defer></script>

Optional attributes: data-env, data-version, data-sample (share of sessions followed, 0 to 1), data-full-url (true to keep the full address, query included).

The dependency-free script collects page views and their load time, the LCP, CLS and INP web vitals, JavaScript errors and resources slower than one second. It sets no cookie: the session lives in the tab (sessionStorage) and expires after 30 minutes of inactivity. The RUM page shows views, sessions, errors, the 75th percentile of web vitals and the slowest pages.

The client token only opens the sending of RUM events: it can appear in a public page.

Updated: 19 November 2026