Aller au contenu principal

De zéro à la première trace

C'est le chemin sacré. Une commande, aucun changement de code, une carte des services en direct.

1. Installer

# Flagship install — the chart is published to GHCR as an OCI artifact,
# eBPF auto-discovers your services. No repo to add.
helm install avuruobs oci://ghcr.io/avuruvision/charts/avuruobs \
--version <X.Y.Z> -n avuruobs --create-namespace

# Point apps at the gateway (OTLP):
# http://avuruobs-gateway:4318 (HTTP)
# http://avuruobs-gateway:4317 (gRPC)

# Open the UI:
kubectl -n avuruobs port-forward svc/avuruobs-ui 8080:80

Le chart Helm installe le DaemonSet sensor, le collecteur gateway, le plan de contrôle hub, l'ui et ClickHouse.

2. Ouvrir l'UI

kubectl -n avuruobs port-forward svc/avuruobs-hub 8080:80

Ouvrez http://localhost:8080. En une minute ou deux, la carte des services se remplit toute seule — le sensor trace chaque service HTTP/gRPC en zéro-code via OBI, donc il n'y a rien à instrumenter. (Les arêtes non instrumentées sont enrichies via la fonctionnalité network d'OBI.)

3. (Optionnel) Envoyer de l'OTLP

Vous avez déjà des SDK OpenTelemetry ? Pointez-les vers le gateway et vos spans atterrissent à côté de ceux découverts par eBPF :

export OTEL_EXPORTER_OTLP_ENDPOINT=http://avuruobs-gateway:4318
# gRPC plutôt ? utilisez http://avuruobs-gateway:4317

:::tip C'est tout Pas d'agents à déployer, pas de redéploiement applicatif. Si votre noyau dispose de BTF (Linux ≥ 5.8), vous obtenez l'image complète ; les noyaux plus anciens se dégradent proprement. :::

Vérifier

kubectl -n avuruobs get pods
# avuruobs-sensor-xxxxx Running
# avuruobs-gateway-xxxxx Running
# avuruobs-hub-xxxxx Running
# avuruobs-ui-xxxxx Running
# avuruobs-clickhouse-0 Running

Si chaque pod est Running et que la carte des services affiche des nœuds, c'est gagné.

Et après

  • Votre première trace — suivez une requête de bout en bout dans l'application de démo.
  • Concepts clés — ce que signifient vraiment un signal, le contexte et la propagation.