TP : OpenTelemetry Operator et auto-instrumentation sur Kubernetes

Ce que vous allez apprendre dans ce TP

• Installer l'Operator
• Déclarer Collector et Instrumentation
• Instrumenter par annotation

Introduction #

Ce que vous allez apprendre dans cette section

• Installer l'Operator
• Déclarer Collector et Instrumentation
• Instrumenter par annotation

Contexte. L'équipe plateforme veut que toutes les applications du cluster produisent des traces sans que chaque équipe modifie ses images. Vous validez l'approche par l'Operator.

Prérequis : Docker, kubectl et kind  ·  Durée estimée : 50 min

Une application instrumentée sans modification d'image, dont les spans arrivent dans un Collector géré par l'Operator.

Mise en place #

Étapes guidées, avec leur correction.

1. 1. Préparer le cluster

   Pourquoi ? L'Operator utilise des webhooks d'admission dont les certificats sont gérés par cert-manager.

   Créez un cluster kind, installez cert-manager puis l'Operator, et attendez qu'ils soient disponibles.

2. 2. Déclarer un Collector

   Pourquoi ? Le Collector est décrit comme une ressource Kubernetes : l'Operator crée Deployment, Service et ConfigMap.

   Créez un namespace demo et une ressource OpenTelemetryCollector en mode deployment avec un receiver OTLP, k8sattributes et l'exportateur debug.

3. 3. Déclarer l'instrumentation

   Pourquoi ? La ressource Instrumentation centralise exportateur, propagateurs et échantillonnage pour tout un namespace.

   Créez une ressource Instrumentation qui envoie en OTLP/HTTP vers le Collector, avec les propagateurs tracecontext et baggage et un échantillonnage à 100 %.

4. 4. Instrumenter une application par annotation

   Pourquoi ? L'annotation suffit : l'Operator injecte l'agent Python au démarrage du pod, sans modifier l'image.

   Déployez une petite application Flask dans une image Python standard avec l'annotation instrumentation.opentelemetry.io/inject-python, puis observez l'init container et les variables OTEL_* injectés.

5. 5. Vérifier les spans

   Pourquoi ? L'exportateur debug affiche les spans reçus avec les attributs Kubernetes ajoutés par k8sattributes.

   Générez quelques requêtes avec un port-forward, puis cherchez dans les logs du Collector le span GET /, service.name et k8s.pod.name.

6. 6. Faire évoluer et nettoyer

   Pourquoi ? Modifier la ressource Instrumentation n'affecte que les pods recréés : il faut redémarrer les déploiements.

   Passez l'échantillonnage à 10 %, redémarrez le déploiement, vérifiez la nouvelle valeur de OTEL_TRACES_SAMPLER_ARG, puis supprimez le cluster.

Niveau de difficulté : ●●●○○ (3/5)