C# Academy · Leçon

Exporter vers des systèmes principaux

Envoyez les données de télémétrie à des collecteurs et outils OTLP.

Exporter vers des systèmes principaux est une leçon C# Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage C# Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours C# Academy comprend 4 leçons au total.

Exporter la télémétrie

Générer des traces et des métriques ne représente que la moitié du travail ; vous devez les exporter vers un système de destination qui stocke, interroge et visualise les données. OpenTelemetry utilise pour cela des exportateurs.

Exportateurs

Un exportateur envoie la télémétrie vers une destination. Les différents exportateurs ciblent différents systèmes : la console (pour le développement), OTLP (le protocole standard) et les exportateurs propres à certains fournisseurs.

L’exportateur vers la console

L’exportateur vers la console affiche la télémétrie dans le terminal, ce qui est idéal pour vérifier l’instrumentation pendant le développement.

builder.Services.AddOpenTelemetry()
    .WithTracing(t => t.AddConsoleExporter())
    .WithMetrics(m => m.AddConsoleExporter());

Qu’est-ce qu’OTLP ?

OTLP (protocole OpenTelemetry) est le format filaire indépendant des fournisseurs utilisé pour transporter la télémétrie. L’exportation via OTLP vous permet d’envoyer les données vers n’importe quel système de destination compatible avec OTLP sans modifier le code de l’application.

dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol

Configurer l’exportateur OTLP

Ajoutez AddOtlpExporter et indiquez le point de terminaison de votre collecteur ou de votre système de destination.

builder.Services.AddOpenTelemetry()
    .WithTracing(t => t.AddOtlpExporter(o =>
    {
        o.Endpoint = new Uri("http://localhost:4317");
    }))
    .WithMetrics(m => m.AddOtlpExporter());

Le collecteur OpenTelemetry

Le collecteur est un processus distinct qui reçoit la télémétrie, la traite (regroupement par lots, filtrage, enrichissement), puis la transmet à un ou plusieurs systèmes de destination. Il dissocie votre application des fournisseurs particuliers.

Pourquoi utiliser un collecteur ?

Envoyer les données directement à un fournisseur lie votre application à celui-ci. Un collecteur vous permet de changer de fournisseur ou de distribuer les données vers plusieurs systèmes de destination, d’appliquer centralement l’échantillonnage et le masquage, et de réduire la charge sur vos services.

Systèmes de destination courants

Les traces sont souvent envoyées vers Jaeger ou Tempo, les métriques vers Prometheus et les tableaux de bord vers Grafana. Les journaux peuvent être transmis à Loki ou à une pile ELK. Tous peuvent recevoir des données OTLP par l’intermédiaire du collecteur.

Tout relier

Une configuration classique configure dans un même bloc une ressource, des sources, des instruments de mesure et un exportateur OTLP, ce qui permet à vos traces et à vos métriques de parvenir à votre collecteur.

builder.Services.AddOpenTelemetry()
    .ConfigureResource(r => r.AddService("checkout-api"))
    .WithTracing(t => t
        .AddAspNetCoreInstrumentation()
        .AddSource("Checkout.Orders")
        .AddOtlpExporter())
    .WithMetrics(m => m
        .AddAspNetCoreInstrumentation()
        .AddMeter("Checkout.Orders")
        .AddOtlpExporter());

Exporter les journaux

OpenTelemetry exporte également les journaux. Intégrez-le à la chaîne de journalisation afin que les enregistrements de journal portent le même contexte de trace et atteignent votre système de destination via OTLP.

builder.Logging.AddOpenTelemetry(o =>
{
    o.AddOtlpExporter();
});

Regroupement par lots et fiabilité

Les exportateurs regroupent la télémétrie par lots afin de réduire la surcharge et réessaient l’envoi en cas d’échec. Ajustez la taille des lots et les délais d’expiration en fonction de votre volume, et privilégiez le collecteur pour absorber les pics afin que les fils d’exécution de l’application ne soient jamais bloqués par l’exportation.

Vérification rapide

Testez l’exportation vers les systèmes de destination.

Récapitulatif

Les exportateurs transmettent la télémétrie aux systèmes de destination. L’exportateur vers la console facilite le développement ; OTLP est le protocole indépendant des fournisseurs utilisé avec AddOtlpExporter. Envoyer des données OTLP à un collecteur OpenTelemetry dissocie votre application, centralise le regroupement par lots, l’échantillonnage et le routage, puis distribue les données vers des systèmes de destination comme Jaeger, Prometheus et Grafana. Les journaux sont exportés de la même manière et transportent le contexte de trace.

Questions Fréquemment Posées

La leçon « Exporter vers des systèmes principaux » est-elle gratuite ?

Oui — le texte complet de « Exporter vers des systèmes principaux » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours C# Academy, passe à CoddyKit PRO. Le cours C# Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Exporter vers des systèmes principaux » ?

Envoyez les données de télémétrie à des collecteurs et outils OTLP. Tu pratiques C# Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer C# Academy ?

Aucune expérience préalable n'est requise. C# Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Exporter vers des systèmes principaux » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon C# Academy ?

Oui. Chaque leçon C# Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à C# Academy