C# Academy · 강의

백엔드로 내보내기

텔레메트리를 OTLP 수집기와 도구로 전송합니다.

백엔드로 내보내기은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

텔레메트리 내보내기

트레이스와 메트릭을 생성하는 것은 작업의 절반에 불과합니다. 데이터를 저장하고 조회하며 시각화하는 백엔드로 이를 내보내야 합니다. OpenTelemetry는 이를 위해 내보내기 도구를 사용합니다.

내보내기 도구

내보내기 도구는 텔레메트리를 대상 시스템으로 전송합니다. 대상 시스템에 따라 사용하는 내보내기 도구가 다릅니다. 콘솔은 개발용이고, OTLP는 표준 프로토콜이며, 공급업체별 내보내기 도구도 있습니다.

콘솔 내보내기 도구

콘솔 내보내기 도구는 텔레메트리를 터미널에 출력하므로 개발 중 계측이 제대로 작동하는지 확인하는 데 적합합니다.

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

OTLP란 무엇인가요

OTLP(OpenTelemetry 프로토콜)는 텔레메트리를 전송하기 위한 공급업체 중립적 전송 형식입니다. OTLP를 통해 내보내면 애플리케이션 코드를 변경하지 않고도 모든 OTLP 호환 백엔드로 데이터를 보낼 수 있습니다.

dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol

OTLP 내보내기 도구 구성하기

AddOtlpExporter를 추가하고 수집기 또는 백엔드 엔드포인트를 가리키도록 설정하십시오.

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

OpenTelemetry 수집기

수집기는 텔레메트리를 수신하고 처리한 다음(일괄 처리, 필터링, 보강) 하나 이상의 백엔드로 전달하는 별도의 프로세스입니다. 수집기를 사용하면 애플리케이션이 특정 공급업체와 분리됩니다.

수집기를 사용하는 이유

공급업체로 직접 전송하면 애플리케이션이 해당 공급업체에 종속됩니다. 수집기를 사용하면 여러 백엔드로 전환하거나 동시에 전송할 수 있고, 샘플링과 민감 정보 제거를 중앙에서 적용하며, 서비스의 부하를 줄일 수 있습니다.

일반적인 백엔드

트레이스는 주로 예거나 템포로 보내고, 메트릭은 프로메테우스로 보내며, 대시보드는 그라파나로 구성합니다. 로그는 로키나 ELK 스택으로 보낼 수 있습니다. 모두 수집기를 통해 OTLP를 수신할 수 있습니다.

모두 연결하기

일반적인 설정에서는 하나의 블록에서 리소스, 소스, 미터, OTLP 내보내기 도구를 구성하여 트레이스와 메트릭이 수집기로 전송되도록 합니다.

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

로그 내보내기

OpenTelemetry는 로그도 내보냅니다. 로그 기록 처리 흐름에 연결하면 로그 레코드가 동일한 트레이스 컨텍스트를 전달하고 OTLP를 통해 백엔드에 도달하도록 할 수 있습니다.

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

일괄 처리와 안정성

내보내기 도구는 오버헤드를 줄이기 위해 텔레메트리를 일괄 처리하고, 실패하면 다시 시도합니다. 처리량에 맞게 일괄 처리 크기와 제한 시간을 조정하고, 애플리케이션 스레드가 내보내기로 인해 절대 차단되지 않도록 수집기가 급증한 부하를 흡수하게 하십시오.

간단한 확인

백엔드로 내보내는 작업을 확인해 보세요.

복습

내보내기 도구는 텔레메트리를 백엔드로 전송합니다. 콘솔 내보내기 도구는 개발을 돕고, OTLP는 AddOtlpExporter와 함께 사용하는 공급업체 중립적 프로토콜입니다. OTLP를 OpenTelemetry 수집기로 보내면 애플리케이션이 특정 공급업체와 분리되고, 일괄 처리·샘플링·라우팅을 중앙에서 관리할 수 있으며, 예거·프로메테우스·그라파나와 같은 백엔드로 데이터를 분배할 수 있습니다. 로그도 트레이스 컨텍스트를 전달하며 같은 방식으로 내보낼 수 있습니다.

자주 묻는 질문

“백엔드로 내보내기” 강의는 무료인가요?

네 — “백엔드로 내보내기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“백엔드로 내보내기”에서 뭘 배우나요?

텔레메트리를 OTLP 수집기와 도구로 전송합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C# Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“백엔드로 내보내기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← C# Academy(으)로 돌아가기