HYPHApar S33D
Documentation › Observer

Traces, OpenTelemetry, erreurs et RUM

HYPHA parle OpenTelemetry. Vos applications envoient leurs traces, directement ou par l'agent de l'hôte, et HYPHA en tire services, latences, erreurs et carte des dépendances.

Envoyer des données OpenTelemetry

HYPHA reçoit OTLP sur HTTP, en protobuf ou en JSON :

SignalAdresse
Traceshttps://hypha.s33d.fr/v1/traces
Métriqueshttps://hypha.s33d.fr/v1/metrics
Journauxhttps://hypha.s33d.fr/v1/logs

La clé d'ingestion passe dans l'en-tête X-Hypha-Api-Key, ou Authorization: Bearer <clé>.

Par l'agent (conseillé)

Activez le relais de l'agent : les applications visent la boucle locale, l'agent ajoute la clé et réessaie si le serveur est injoignable.

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=boutique-api
export OTEL_RESOURCE_ATTRIBUTES=deployment.environment=prod,service.version=2.14.0

En direct

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

Ce que HYPHA retient

APM

Traces : du service à la requête · 33 s
Ce que montre la vidéo
  1. APM : les services, leur débit, leurs erreurs et leur latence.
  2. Le service shop-api : opérations et ressources.
  3. Une trace de commande en cascade : PostgreSQL, Redis et le service de stock.
  4. La carte des services, tirée des traces.

Modèles de moniteurs : erreurs HTTP 5xx d'un service, latence p95, nouvelle erreur applicative.

Suivi des erreurs

La page Erreurs regroupe en problèmes les erreurs qui se ressemblent :

L'empreinte d'un problème tient compte de l'origine, du service, du type et des cinq premières trames de la pile, sans numéros de ligne ni valeurs. Chaque problème montre sa pile, son histogramme, ses dernières occurrences avec la trace ou la ligne correspondante. Un problème résolu qui revient repasse ouvert et est marqué « régressé ». Boutons Résoudre, Ignorer et Expliquer.

RUM : l'expérience réelle des visiteurs

Créez une application dans la page RUM, puis ajoutez son script à vos pages :

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

Attributs facultatifs : data-env, data-version, data-sample (part des sessions suivies, de 0 à 1), data-full-url (true pour garder l'adresse complète, paramètres compris).

Le script, sans dépendance, relève les vues et leur temps de chargement, les signaux web LCP, CLS et INP, les erreurs JavaScript et les ressources de plus d'une seconde. Il ne pose aucun cookie : la session tient dans l'onglet (sessionStorage) et expire après 30 minutes d'inactivité. La page RUM montre vues, sessions, erreurs, percentile 75 des signaux web et pages les plus lentes.

Le jeton client n'ouvre que l'envoi d'événements RUM : il peut figurer dans une page publique.

Mise à jour : 19 novembre 2026