C# Academy · Aula

Os três pilares da observabilidade

Entenda rastreamentos, métricas e registros.

Os três pilares da observabilidade é uma aula grátis de C# Academy no CoddyKit. Esta é a aula 1 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.

O que é observabilidade

Observabilidade é a capacidade de compreender o estado interno de um sistema a partir dos dados que ele emite. Para um serviço em execução, ela responde: ele está saudável, por que está lento e o que falhou? Ela se apoia em três pilares: rastreamentos, métricas e registros.

O que é OpenTelemetry

OpenTelemetry (OTel) é um padrão independente de fornecedor e um conjunto de bibliotecas para gerar e exportar telemetria. Com uma única instrumentação, você pode enviar dados para vários sistemas de destino, como Jaeger, Prometheus ou Grafana.

dotnet add package OpenTelemetry.Extensions.Hosting

Pilar um: registros

Registros são registros, com marcação de horário, de eventos distintos ("usuário 42 iniciou sessão", "pagamento falhou"). Eles fornecem contexto detalhado e legível para pessoas, mas podem ser ruidosos e difíceis de agregar isoladamente.

logger.LogInformation("Order {OrderId} placed by {UserId}", orderId, userId);

Pilar dois: métricas

Métricas são medições numéricas agregadas ao longo do tempo (contagem de solicitações, taxa de erros, percentis de latência, uso de CPU). Elas são baratas de armazenar e ideais para painéis e alertas.

Pilar três: rastreamentos

Rastreamentos acompanham uma única solicitação à medida que ela percorre seus serviços, dividindo-a em intervalos cronometrados. Eles revelam onde o tempo é gasto e qual dependência causou uma lentidão.

Como os pilares se complementam

As métricas informam que algo está errado (a taxa de erros aumentou). Os rastreamentos informam onde (o serviço de pagamentos). Os registros informam por quê (uma referência nula para um pedido específico). Juntos, formam uma história completa de depuração.

A correlação é fundamental

O verdadeiro poder vem da correlação. Um identificador de rastreamento compartilhado, gravado nos registros e nos intervalos, permite passar de um alerta de métrica para o rastreamento exato e seus registros de uma única solicitação com falha.

Sinais no OpenTelemetry

O OTel chama esses pilares de sinais. O .NET os mapeia para primitivas conhecidas: os rastreamentos usam Activity/ActivitySource, as métricas usam Meter e os registros usam ILogger.

Adicionando OpenTelemetry a um host

Ative os sinais com AddOpenTelemetry() e configure rastreamento e métricas. Abordaremos cada um em detalhes nas lições seguintes.

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => { })
    .WithMetrics(metrics => { });

Atributos do recurso

Um recurso descreve a entidade que produz telemetria (nome do serviço, versão, ambiente). Defini-lo de forma consistente permite que os back-ends agrupem e filtrem seus dados corretamente.

builder.Services.AddOpenTelemetry()
    .ConfigureResource(r => r.AddService(
        serviceName: "checkout-api",
        serviceVersion: "1.4.0"));

Instrumentação automática versus manual

O OpenTelemetry oferece instrumentação automática para ASP.NET Core, HttpClient e outros componentes, além de instrumentação manual, na qual o senhor adiciona seus próprios intervalos e métricas para obter informações específicas do negócio.

Verificação rápida

Teste os três pilares.

Recapitulação

A observabilidade se apoia em três pilares: registros (eventos, o porquê), métricas (números agregados, o quê) e rastreamentos (intervalos por solicitação, onde). O OpenTelemetry é o padrão independente de fornecedor que emite os três como sinais, mapeados no .NET para Activity, Meter e ILogger. A correlação por meio de IDs de rastreamento e de um recurso bem configurado os conecta.

Perguntas Frequentes

A aula “Os três pilares da observabilidade” é grátis?

Sim — o texto completo de “Os três pilares da observabilidade” é 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 “Os três pilares da observabilidade”?

Entenda rastreamentos, métricas e registros. 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 1 de 4.

Quanto tempo leva a aula “Os três pilares da observabilidade”?

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