Ce que vous allez apprendre dans ce TP
- Brancher un logger existant sur OpenTelemetry
- Corréler logs et traces
- Collecter des fichiers avec filelog
Introduction #
Ce que vous allez apprendre dans cette section
- Brancher un logger existant sur OpenTelemetry
- Corréler logs et traces
- Collecter des fichiers avec filelog
Contexte. Les logs de facturation sont des fichiers texte que personne ne relie aux traces. Vous branchez le service moderne sur OpenTelemetry et récupérez les logs de l'application historique sans la modifier.
Prérequis : Docker et Python 3.10 ou plus ; la pile grafana/otel-lgtm (Collector, Tempo, Loki, Prometheus, Pyroscope et Grafana dans un seul conteneur) · Durée estimée : 45 min
Mise en place #
Étapes guidées, avec leur correction.
1. Démarrer la pile d'observabilité
Pourquoi ? Une seule image fournit un Collector OTLP et tous les backends : on se concentre sur le signal.
Lancezgrafana/otel-lgtm, créez un environnement Python et pointez les exportateurs vers le port OTLP/HTTP 4318.2. Brancher le module logging
Pourquoi ? Le LoggingHandler transforme chaque appel logging en LogRecord OpenTelemetry, avec le contexte de trace actif.
Écrivezfacturation.py: un LoggerProvider avec exportateur OTLP, un handler ajouté au logger racine, un TracerProvider, et des logs INFO et ERROR émis à l'intérieur de spans.3. Interroger et corréler dans Grafana
Pourquoi ? Le trace_id porté par chaque log permet de passer du log à la trace et inversement.
Dans Explore > Loki, affichez les erreurs du service, dépliez une ligne et repéreztrace_id,span_id, la sévérité et vos attributs. Ouvrez la trace liée, puis depuis un span Tempo affichez ses logs.4. Collecter les logs d'une application historique
Pourquoi ? Sans toucher au code, le receiver filelog lit les fichiers, parse le JSON, la sévérité et le contexte de trace.
Générez un fichier de logs JSON, puis lancez un Collector contrib sur le même réseau que la pile, avecfilelog,json_parser,trace_parseret un processeurresourcequi fixeservice.name.5. Réduire et masquer
Pourquoi ? Le Collector supprime le bruit et les données personnelles avant le stockage.
Ajoutez un processeurfilterqui supprime les logs INFO et untransformqui masque les adresses e-mail dans le corps, puis vérifiez dans Loki.
Niveau de difficulté : ●●●○○ (3/5)
Mon suivi
Connectez-vous pour suivre votre progression et prendre des notes. Se connecter
💬 Discussions récentes de la formation
- Quels attributs utiliser pour nommer mes spans HTTP (semconv) ?✓ résolu · 1 réponse(s)
- OpenTelemetry Collector : mes traces arrivent mais pas mes métriques✓ résolu · 2 réponse(s)
Poser une question sur cette leçon →Voir toutes les discussions de la formation
Articles recommandés
Les logs avec OpenTelemetry : modèle de données, appenders, corrélation et collecte
Maîtriser le signal log : modèle de données LogRecord, Logs Bridge API et appenders (Logback, Log...
Corréler traces, métriques, logs et profils avec OpenTelemetry
Relier les quatre signaux pour diagnostiquer vite : ressource commune, trace_id dans les logs, ex...
Collecter des logs vers Loki : Alloy, Promtail, Docker et OpenTelemetry
Envoyer des logs vers Loki : Grafana Alloy, Promtail, driver Docker, OTLP, bons labels, parsing e...
Ingérer des logs OpenTelemetry dans Elasticsearch
Collecter et structurer des logs avec le Collector OpenTelemetry (receiver filelog, opérateurs, p...
Envoyer la télémétrie à ClickStack : SDK OpenTelemetry, collecteurs, logs, Kubernetes et sessions navigateur
Alimenter ClickStack : clé d'ingestion, variables OpenTelemetry des SDK, relais par un collecteur...
Envoyer ses logs, métriques et traces vers OpenObserve
Les points de réception d'OpenObserve : JSON, bulk, OTLP avec le Collector OpenTelemetry, Prometh...
Projet fil rouge : les quatre signaux de l'OpenTelemetry Demo dans la stack Grafana
Un projet fil rouge qui traverse les formations d'observabilité : déployer l'OpenTelemetry Demo, ...
OpenTelemetry Collector : les Exporters (envoyer la télémétrie vers les backends)
Configurer les exporters du Collector OpenTelemetry : OTLP gRPC/HTTP, Prometheus, prometheusremot...
Envoyer des traces vers Tempo : instrumentation OpenTelemetry et Alloy
Produire et acheminer des traces vers Tempo : auto-instrumentation Python/Java/Node, SDK manuel, ...