Déployer OpenTelemetry Collector dans Kubernetes

Le chart ne peut pas être installé sans mode. Un Deployment convient à une passerelle OTLP partagée ; un DaemonSet est mieux adapté à la collecte locale par nœud.

1. Valider que les applications envoient leurs traces vers une passerelle et que la collecte par nœud n'est pas requise.
2. Réserver le namespace de recette ; vérifier les politiques réseau et les quotas.
3. Choisir une version de chart via helm search repo avant de la figer.

kubectl create namespace otel-system
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
helm repo update
helm search repo open-telemetry/opentelemetry-collector --versions

Un fichier values.yaml versionné rend la configuration relisible et évite les valeurs par défaut non désirées.

1. Créer values.yaml avec le mode deployment, le receiver OTLP et une unique pipeline traces.
2. Désactiver les receivers et pipelines non utilisés de l'exemple.
3. Conserver debug uniquement en recette ; choisir un exporteur OTLP sécurisé pour la production.

mode: deployment
replicaCount: 1
image:
  repository: otel/opentelemetry-collector-k8s
config:
  receivers:
    jaeger: null
    prometheus: null
    zipkin: null
  service:
    pipelines:
      traces:
        receivers: [otlp]
        processors: [memory_limiter, batch]
        exporters: [debug]
      metrics: null
      logs: null
ports:
  jaeger-compact:
    enabled: false
  jaeger-thrift:
    enabled: false
  jaeger-grpc:
    enabled: false
  zipkin:
    enabled: false

La version du chart et les valeurs sont deux paramètres de reproductibilité distincts.

1. Remplacer CHART_VERSION_VALIDEE par la version sélectionnée à l'étape précédente.
2. Faire afficher les manifests avant tout déploiement et contrôler le Service/les ports.
3. Installer la release dans otel-system, puis vérifier Deployment et événements.

helm template otel-gateway open-telemetry/opentelemetry-collector --version CHART_VERSION_VALIDEE -n otel-system -f values.yaml
helm upgrade --install otel-gateway open-telemetry/opentelemetry-collector --version CHART_VERSION_VALIDEE -n otel-system -f values.yaml
kubectl get deployments,pods,svc -n otel-system

Un pod READY ne garantit ni réception ni export de traces.

1. Identifier le vrai nom de Service avec kubectl get svc (il varie selon release/chart).
2. Dans un terminal, rediriger temporairement le port 4317 du Service sélectionné.
3. Dans un autre terminal, émettre cinq traces ; lire les journaux du Collector et repérer leurs spans.

kubectl get svc -n otel-system
# Terminal 1 : remplacer SERVICE_OTLP par le nom réellement affiché
kubectl port-forward -n otel-system service/SERVICE_OTLP 4317:4317
# Terminal 2 : telemetrygen doit être installé
telemetrygen traces --otlp-endpoint localhost:4317 --otlp-insecure --traces 5
kubectl logs -n otel-system -l app.kubernetes.io/instance=otel-gateway --tail=100

Le passage en RUN exige sécurité, observabilité du pipeline et procédure de rollback.

1. Vérifier ressources CPU/mémoire, RBAC, NetworkPolicy, TLS, secrets, limitations de débit et backpressure.
2. Remplacer debug par un exporteur vers un backend autorisé ; retester sous charge.
3. Consulter l'historique Helm et documenter le retour arrière en cas d'échec.

helm history otel-gateway -n otel-system
# En cas de retour arrière validé : remplacer REVISION_PRECEDENTE
helm rollback otel-gateway REVISION_PRECEDENTE -n otel-system
kubectl rollout status deployment/otel-gateway-opentelemetry-collector -n otel-system