C# Academy · Aula

Exportando para back-ends

Envie telemetria para coletores e ferramentas OTLP.

Exportando para back-ends é uma aula grátis de C# Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de C# Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de C# Academy inclui 4 aulas no total.

Obtendo a telemetria

Gerar rastreamentos e métricas é apenas metade do trabalho; o senhor precisa exportá-los para um back-end que armazene, consulte e visualize os dados. O OpenTelemetry usa exportadores para isso.

Exportadores

Um exportador envia telemetria para um destino. Diferentes exportadores têm como alvo sistemas diferentes: o console (para desenvolvimento), OTLP (o protocolo padrão) e exportadores específicos de fornecedores.

O exportador do console

O exportador do console imprime a telemetria no terminal, sendo perfeito para verificar a instrumentação durante o desenvolvimento.

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

O que é OTLP

OTLP (OpenTelemetry Protocol) é o formato de transmissão independente de fornecedor para enviar telemetria. Exportar por meio de OTLP significa que o senhor pode enviar dados para qualquer back-end compatível com OTLP sem alterar o código da aplicação.

dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol

Configurando o exportador OTLP

Adicione AddOtlpExporter e aponte-o para o endereço do seu coletor ou back-end.

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

O coletor do OpenTelemetry

O coletor é um processo separado que recebe telemetria, a processa (agrupamento em lotes, filtragem e enriquecimento) e a encaminha para um ou mais back-ends. Ele desacopla sua aplicação de fornecedores específicos.

Por que usar um coletor

Enviar dados diretamente para um fornecedor vincula sua aplicação a ele. Um coletor permite trocar de fornecedor ou distribuir dados para vários back-ends, aplicar amostragem e mascaramento de forma centralizada e reduzir a carga sobre seus serviços.

Sistemas de back-end comuns

Os rastreamentos geralmente vão para Jaeger ou Tempo, as métricas para Prometheus e os painéis para Grafana. Os registros podem ser enviados para Loki ou para uma pilha ELK. Todos podem receber OTLP por meio do coletor.

Integrando tudo

Uma configuração típica define recurso, fontes, medidores e um exportador OTLP em um único bloco, fazendo com que rastreamentos e métricas fluam para o seu coletor.

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());

Exportando registros

O OpenTelemetry também exporta registros. Integre-o ao fluxo de registro para que os registros carreguem o mesmo contexto de rastreamento e cheguem ao seu back-end por meio de OTLP.

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

Agrupamento em lotes e confiabilidade

Os exportadores agrupam a telemetria em lotes para reduzir a sobrecarga e tentam novamente em caso de falha. Ajuste o tamanho dos lotes e os tempos limite de acordo com o seu volume e prefira o coletor para absorver picos, de modo que as linhas de execução da aplicação nunca fiquem bloqueadas durante a exportação.

Verificação rápida

Teste a exportação para back-ends.

Recapitulação

Os exportadores enviam telemetria para back-ends. O exportador do console auxilia no desenvolvimento; OTLP é o protocolo independente de fornecedor usado com AddOtlpExporter. Enviar OTLP para um coletor do OpenTelemetry desacopla sua aplicação, centraliza o agrupamento em lotes, a amostragem e o roteamento, e distribui os dados para back-ends como Jaeger, Prometheus e Grafana. Os registros são exportados da mesma forma, carregando o contexto de rastreamento.

Perguntas Frequentes

A aula “Exportando para back-ends” é grátis?

Sim — o texto completo de “Exportando para back-ends” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de C# Academy, atualize para CoddyKit PRO. O curso de C# Academy inclui 4 aulas no total.

O que vou aprender em “Exportando para back-ends”?

Envie telemetria para coletores e ferramentas OTLP. Você pratica C# Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar C# Academy?

Nenhuma experiência prévia é necessária. C# Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Exportando para back-ends”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de C# Academy?

Sim. Cada aula de C# Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para C# Academy