OpenTelemetry란?

OpenTelemetry는 클라우드 네이티브 앱을 위해 특별히 만들어진 벤더 중립 관찰성 프레임워크입니다. OpenTelemetry 자동 계측은 로그, 추적 및 메트릭을 포함한 텔레메트리 정보를 수집하기 위한 단일 API를 제공합니다. 이 광범위한 데이터를 사용하여 개발자는 문제를 효과적으로 디버그하고 성능 병목 현상을 파악하며 프로그램 동작을 완전하게 이해할 수 있습니다. OpenTelemetry는 종합적이고 유연한 텔레메트리 데이터 수집을 위해 자동 및 수동 계측을 모두 지원합니다.

OpenTelemetry 생성 및 구성

using OpenTelemetry.Trace;
using OpenTelemetry.Exporter.Jaeger;
using OpenTelemetry.Resources;

public void ConfigureServices(IServiceCollection services)
{
    // Configure OpenTelemetry
    services.AddOpenTelemetry().WithTracing(builder =>
    {
        // Configure Jaeger exporter. The 'serviceName' can be read from environment variables
        builder
            .SetResourceBuilder(
                ResourceBuilder.CreateDefault()
                    .AddService("YourServiceName"))
            .AddAspNetCoreInstrumentation()
            .AddJaegerExporter(opt =>
            {
                opt.AgentHost = "localhost"; // Jaeger agent host
                opt.AgentPort = 14250; // Jaeger agent port
            });
    });
    // Other service configurations...
}

using OpenTelemetry.Trace;
using OpenTelemetry.Exporter.Jaeger;
using OpenTelemetry.Resources;

public void ConfigureServices(IServiceCollection services)
{
    // Configure OpenTelemetry
    services.AddOpenTelemetry().WithTracing(builder =>
    {
        // Configure Jaeger exporter. The 'serviceName' can be read from environment variables
        builder
            .SetResourceBuilder(
                ResourceBuilder.CreateDefault()
                    .AddService("YourServiceName"))
            .AddAspNetCoreInstrumentation()
            .AddJaegerExporter(opt =>
            {
                opt.AgentHost = "localhost"; // Jaeger agent host
                opt.AgentPort = 14250; // Jaeger agent port
            });
    });
    // Other service configurations...
}

Imports OpenTelemetry.Trace
Imports OpenTelemetry.Exporter.Jaeger
Imports OpenTelemetry.Resources

Public Sub ConfigureServices(ByVal services As IServiceCollection)
	' Configure OpenTelemetry
	services.AddOpenTelemetry().WithTracing(Sub(builder)
		' Configure Jaeger exporter. The 'serviceName' can be read from environment variables
		builder.SetResourceBuilder(ResourceBuilder.CreateDefault().AddService("YourServiceName")).AddAspNetCoreInstrumentation().AddJaegerExporter(Sub(opt)
				opt.AgentHost = "localhost" ' Jaeger agent host
				opt.AgentPort = 14250 ' Jaeger agent port
		End Sub)
	End Sub)
	' Other service configurations...
End Sub

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // Add Prometheus metrics middleware if using Prometheus
    app.UseHttpMetrics();
    // Other middleware configurations...
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // Add Prometheus metrics middleware if using Prometheus
    app.UseHttpMetrics();
    // Other middleware configurations...
}

Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
	' Add Prometheus metrics middleware if using Prometheus
	app.UseHttpMetrics()
	' Other middleware configurations...
End Sub

시작하기

Install-Package OpenTelemetry
Install-Package OpenTelemetry.Instrumentation.AspNetCore
Install-Package OpenTelemetry.Exporter.Jaeger
Install-Package IronPdf

OpenTelemetry와 IronPDF 사용하기

ASP.NET Core 애플리케이션의 Startup.cs 파일을 열어 ConfigureServices 메소드에 액세스하세요. IronPDF를 설정하려면 다음 코드를 포함하세요.

using IronPdf;

public void ConfigureServices(IServiceCollection services)
{
    // Configure IronPDF
    services.AddSingleton<HtmlToPdf>();
    // Other service configurations...
}

using IronPdf;

public void ConfigureServices(IServiceCollection services)
{
    // Configure IronPDF
    services.AddSingleton<HtmlToPdf>();
    // Other service configurations...
}

Imports IronPdf

Public Sub ConfigureServices(ByVal services As IServiceCollection)
	' Configure IronPDF
	services.AddSingleton(Of HtmlToPdf)()
	' Other service configurations...
End Sub

이 코드는 IronPDF의 HtmlToPdf 서비스를 싱글톤으로 구성하여 애플리케이션이 HtmlToPdf 인스턴스를 생성하고 사용하도록 보장합니다.

OpenTelemetry.NET을 IronPDF와 통합하여 .NET 애플리케이션에서 PDF 생성 프로세스를 추적 및 관찰할 수 있습니다. 각 단계를 단계별로 설명하며 코드 예제를 자세히 살펴보겠습니다:

using Microsoft.AspNetCore.Mvc;
using OpenTelemetry.Trace;
using System.Diagnostics;
using Microsoft.Extensions.Logging;
using IronPdf;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<DemoController> _logger;
        private readonly Tracer _tracer;

        public DemoController(ILogger<DemoController> logger, HtmlToPdf htmlToPdf, TracerProvider tracerProvider)
        {
            _tracer = tracerProvider.GetTracer("Demo");
            _htmlToPdf = htmlToPdf;
            _logger = logger;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            // Define the PDF file name
            string fileName = "Sample.pdf";

            // Generate PDF from HTML content
            _logger.LogInformation("Generating PDF...");
            var pdfBytes = GeneratePdf("Hello, IronPDF!");

            // Return the PDF as a file result
            return new FileContentResult(pdfBytes, "application/pdf")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            // Start a tracing activity for PDF generation
            using (var activity = _tracer.StartActiveSpan("PDF Generation"))
            {
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);

                // Log PDF generation
                _logger.LogInformation("PDF generated successfully.");

                return pdfDocument.BinaryData;
            }
        }
    }
}

using Microsoft.AspNetCore.Mvc;
using OpenTelemetry.Trace;
using System.Diagnostics;
using Microsoft.Extensions.Logging;
using IronPdf;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<DemoController> _logger;
        private readonly Tracer _tracer;

        public DemoController(ILogger<DemoController> logger, HtmlToPdf htmlToPdf, TracerProvider tracerProvider)
        {
            _tracer = tracerProvider.GetTracer("Demo");
            _htmlToPdf = htmlToPdf;
            _logger = logger;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            // Define the PDF file name
            string fileName = "Sample.pdf";

            // Generate PDF from HTML content
            _logger.LogInformation("Generating PDF...");
            var pdfBytes = GeneratePdf("Hello, IronPDF!");

            // Return the PDF as a file result
            return new FileContentResult(pdfBytes, "application/pdf")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            // Start a tracing activity for PDF generation
            using (var activity = _tracer.StartActiveSpan("PDF Generation"))
            {
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);

                // Log PDF generation
                _logger.LogInformation("PDF generated successfully.");

                return pdfDocument.BinaryData;
            }
        }
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports OpenTelemetry.Trace
Imports System.Diagnostics
Imports Microsoft.Extensions.Logging
Imports IronPdf

Namespace DemoWebApplication.Controllers
	<ApiController>
	<Route("[controller]")>
	Public Class DemoController
		Inherits ControllerBase

		Private ReadOnly _htmlToPdf As HtmlToPdf
		Private ReadOnly _logger As ILogger(Of DemoController)
		Private ReadOnly _tracer As Tracer

		Public Sub New(ByVal logger As ILogger(Of DemoController), ByVal htmlToPdf As HtmlToPdf, ByVal tracerProvider As TracerProvider)
			_tracer = tracerProvider.GetTracer("Demo")
			_htmlToPdf = htmlToPdf
			_logger = logger
		End Sub

		<HttpGet>
		Public Function Generate() As FileContentResult
			' Define the PDF file name
			Dim fileName As String = "Sample.pdf"

			' Generate PDF from HTML content
			_logger.LogInformation("Generating PDF...")
			Dim pdfBytes = GeneratePdf("Hello, IronPDF!")

			' Return the PDF as a file result
			Return New FileContentResult(pdfBytes, "application/pdf") With {.FileDownloadName = fileName}
		End Function

		Private Function GeneratePdf(ByVal htmlContent As String) As Byte()
			' Start a tracing activity for PDF generation
			Using activity = _tracer.StartActiveSpan("PDF Generation")
				Dim pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent)

				' Log PDF generation
				_logger.LogInformation("PDF generated successfully.")

				Return pdfDocument.BinaryData
			End Using
		End Function
	End Class
End Namespace

이 예시에서는 다음과 같습니다.

• 우리는 HtmlToPdf, ILogger, TracerProvider을(를) DemoController에 주입합니다.
• Generate 메소드는 파일 다운로드를 시작하며, 'Hello, IronPDF!'라는 내용을 가진 동적으로 생성된 PDF를 반환합니다.
• GeneratePdf 메소드는 HtmlToPdf.RenderHtmlAsPdf을 사용하여 PDF를 렌더링하고 PDF의 바이너리 데이터를 출력합니다. 코드는 PDF 생성 프로세스를 추적하고 OpenTelemetry를 사용하여 추적 데이터를 기록합니다.

위의 소스 코드에서 생성된 PDF 출력:

다음은 Jaeger UI에서 생성된 추적 화면입니다:

결론

OpenTelemetry는 .NET 애플리케이션 성능 최적화와 상태 모니터링의 게임 체인저입니다. 이는 텔레메트리 데이터(메트릭, 추적, 로그)를 수집, 분석 및 내보내기 위한 공급업체 중립적이고 표준화된 방법을 제공하여 개발자가 애플리케이션 내부 운용에 대한 철저한 이해를 제공합니다.

OpenTelemetry.NET을 IronPDF와 통합하여 개발자는 PDF 생성 워크플로를 개선하고 애플리케이션 성능에 대한 통찰력을 얻을 수 있습니다. 개발자는 OpenTelemetry.NET 구현을 활용하여 PDF 생성 프로세스를 수동으로 계측하고, 실행 경로를 추적하고, 성능 매트릭을 모니터링하며, 최적화가 필요한 영역을 식별할 수 있습니다. 또한, 텔레메트리 데이터를 관측 가능성 플랫폼으로 내보내면 중앙 집중식 모니터링 메트릭 수집 및 분석이 가능하여 개발자가 애플리케이션의 상태를 유지하고 완벽한 사용자 경험을 제공할 수 있도록 합니다.

OpenTelemetry.NET 구현과 IronPDF의 통합은 개발자의 PDF 생성 워크플로를 강화하고 .NET 애플리케이션에서 확장성, 성능 및 신뢰성을 보장할 수 있습니다. 이 기술의 통합은 현대 소프트웨어 개발의 요구를 충족하고 뛰어난 결과를 얻는 데 도움을 줍니다. 인보이스, 보고서, 문서 생성 등 어떤 것이라도 가능하게 합니다.

정보로 구매할 때, IronPDF는 저렴한 가격에 제공되며 영구 라이선스를 포함합니다. 이 패키지는 단지 $799로 여러 시스템에 대한 일회성 요금으로 큰 가치를 제공합니다. 이는 라이선스 소유자가 24시간 온라인 엔지니어링 지원을 받을 수 있습니다. 비용에 대한 자세한 내용은 Iron Software 웹사이트를 참조하십시오. Iron Software의 제품을 탐색하여 그들이 제공하는 솔루션에 대해 자세히 알아보십시오.