OpenTelemetry Nedir?

OpenTelemetry, özellikle bulut yerel uygulamalar için oluşturulmuş satıcı-bağımsız bir gözlemlenebilirlik çerçevesidir. OpenTelemetry otomatik enstrümantasyon, günlükler, izleme ve metrikleri içerecek şekilde telemetri bilgilerini toplamak için tek bir API sunar. Bu geniş kapsamlı veriler sayesinde geliştiriciler, problemlerin etkin bir şekilde giderilmesini, performans darboğazlarının tespit edilmesini ve program davranışının kapsamlı bir şekilde anlaşılmasını sağlayabilirler. OpenTelemetry, kapsamlı ve esnek telemetri veri toplama için hem otomatik hem de manuel enstrümantasyonu destekler.

OpenTelemetry Kurulumu ve Yapılandırması

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

Başlarken

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

IronPDF ile OpenTelemetry Kullanımı

ASP.NET Core uygulamanızın Startup.cs dosyasını açarak ConfigureServices yöntemine erişin. IronPDF'yi ayarlamak için aşağıdaki kodu ekleyin.

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

Bu kod, IronPDF'in HtmlToPdf hizmetini singleton olarak yapılandırarak, HtmlToPdf örneğinin yalnızca uygulama tarafından oluşturulup kullanılmasını sağlar.

OpenTelemetry.NET'i IronPDF ile entegre ederek .NET uygulamalarınızdaki PDF oluşturma süreçlerini izleyebilir ve gözlemleyebilirsiniz. Kod örneğini adım adım inceleyelim:

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

Bu örnekte:

• DemoController içerisine HtmlToPdf, ILogger ve TracerProvider enjekte ediyoruz.
• Generate yöntemi bir dosya indirimi başlatır ve "Merhaba, IronPDF!" içeriğiyle dinamik olarak oluşturulmuş bir PDF döndürür.
• GeneratePdf yöntemi, PDF'yi oluşturmak için HtmlToPdf.RenderHtmlAsPdf kullanır ve PDF'nin ikili verilerini çıktılar.
• Kod, PDF oluşturma sürecini izlemek için OpenTelemetry'yi kullanır ve izleme verilerini kaydeder.

Yukarıdaki kaynak kodundan oluşturulan PDF çıktısı:

Aşağıda Jaeger UI'dan oluşturulan izleme ekranı:

Sonuç

OpenTelemetry, .NET uygulaması performans optimizasyonu ve sağlık izleme için bir oyun değiştiricidir. Geliştiricilere, telemetri verilerini (metrikler, izler ve günlükler) toplamak, analiz etmek ve dışa aktarmak için satıcıya bağımlı olmayan ve standart bir yöntem sunarak, uygulamalarının iç işleyişini detaylı bir şekilde anlamalarını sağlar.

OpenTelemetry.NET'i IronPDF ile entegre ederek, geliştiriciler PDF oluşturma iş akışlarını iyileştirebilir ve uygulamalarının performansı hakkında içgörüler elde edebilir. PDF oluşturma süreçlerini manuel olarak enstrümantalize etmek için OpenTelemetry.NET uygulamasından yararlanarak, geliştiriciler yürütme yollarını izleyebilir, performans metriklerini izleyebilir ve iyileştirme gerektiren bölgeleri belirleyebilir. Ayrıca, gözlemlenebilirlik platformlarına telemetri verilerini aktararak merkezi izleme metriklerinin toplanması ve analizi mümkün kılınır, geliştiricilere uygulamalarının sağlığını koruma ve kusursuz bir kullanıcı deneyimi sunma yeteneği verir.

OpenTelemetry.NET uygulaması ve IronPDF entegrasyonu, geliştiricilerin PDF oluşturma iş akışlarını geliştirebilir ve .NET uygulamalarında ölçeklenebilirlik, performans ve güvenilirlik garantisi sağlar. Bu teknolojilerin entegrasyonu, geliştiricilere modern yazılım geliştirme ihtiyaçlarını karşılama ve faturalar, raporlar veya dokümantasyon oluşturma gibi olağanüstü sonuçlar üretme konularında yardımcı olur.

IronPDF, bir paket olarak satın alındığında uygun fiyatlıdır ve ömür boyu lisans içerir. Bu paket, birçok sistem için tek seferlik bir ücret olan sadece $799 karşılığında harika bir değer sunar. Lisans sahiplerine günün her saati çevrimiçi mühendislik desteği sunar. Lütfen ücret hakkında daha fazla bilgi için Iron Software web sitesini ziyaret edin. Sundukları çözümler hakkında daha fazla bilgi edinmek için Iron Software ürünlerini keşfedin.