OpenTelemetry Nedir?

OpenTelemetry, özellikle bulut yerel uygulamalar için oluşturulmuş tedarikçi bağımsız bir gözlemlenebilirlik çerçevesidir. OpenTelemetry otomatik enstrümentasyonu, loglar, izleme ve metrikler dahil olmak üzere telemetri bilgilerini toplamak için tek bir API sağlar. Bu kapsamlı verilerin kullanımıyla, geliştiriciler sorunları etkili bir şekilde hata ayıklayabilir, performans darboğazlarını tespit edebilir ve program davranışını tam olarak anlayabilir. OpenTelemetry, kapsamlı ve esnek telemetri veri toplama için hem otomatik hem de manuel enstrümentasyonu destekler.

OpenTelemetry'yi Yaratın ve Yapılandırın

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

OpenTelemetry'yi IronPDF ile Kullanma

ASP.NET Core uygulamanızın Startup.cs dosyasını açarak ConfigureServices yöntemine erişin. IronPDF'yi ayarlamak için sonraki 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'nin HtmlToPdf hizmetini singleton olarak yapılandırarak uygulama tarafından yalnızca bir HtmlToPdf örneğinin oluşturulmasını ve kullanılmasını sağlar.

IronPDF ile OpenTelemetry.NET entegrasyonunu kullanarak .NET uygulamalarınızda PDF oluşturma süreçlerini izleyebilir ve gözlemleyebilirsiniz. Kod örneğini derinlemesine inceleyelim, her adımı adım adım inceleyerek:

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:

• HtmlToPdf, ILogger, ve TracerProvider öğesini DemoController içerisine enjekte ediyoruz.
• Generate yöntemi bir dosya indirmesi başlatır ve "Hello, IronPDF!" içeriğine sahip dinamik olarak oluşturulmuş bir PDF döndürür.
• GeneratePdf yöntemi, PDF'yi render etmek için HtmlToPdf.RenderHtmlAsPdf kullanır ve PDF'nin ikili verilerini çıktı olarak verir.
• Kod, PDF oluşturma sürecini izlemek ve izleme verilerini kaydetmek için OpenTelemetry'yi kullanır.

Yukarıdaki kaynak koddan üretilen PDF çıktısı:

Aşağıda Jaeger kullanıcı arayüzünden oluşturulan iz ekranı bulunmaktadır:

Sonuç

OpenTelemetry, .NET uygulama performansı optimizasyonu ve sağlık takibi için bir oyunun kurallarını değiştiren bir araçtır. Tedarikçi-bağımsız ve standartlaştırılmış bir yöntem sunarak telemetri verilerini (metrikler, izler ve loglar) toplamak, analiz etmek ve ihraç etmek için geliştiricilere uygulamalarının iç işleyişini tam anlaması sağlar.

OpenTelemetry.NET ve IronPDF entegrasyonunu kullanarak, geliştiriciler PDF oluşturma iş akışlarını iyileştirebilir ve uygulamalarının performansı hakkında içgörüler elde edebilirler. OpenTelemetry.NET uygulamasını PDF oluşturma süreçlerini manuel olarak enstrümante etmek için kullanarak, geliştiriciler yürütme yollarını izleyebilir, performans metriklerini izleyebilir ve optimizasyon gerektiren bölgeleri belirleyebilir. Ayrıca, telemetri verilerini gözlemlenebilirlik platformlarına ihraç etmek merkezi izleme metriklerinin toplanmasını ve analizini mümkün kılar, geliştiricilere uygulamalarının sağlığını koruma ve kusursuz bir kullanıcı deneyimi sağlama yeteneği verir.

OpenTelemetry.NET uygulaması ve IronPDF entegrasyonu, geliştiricilerin PDF oluşturmaya yönelik iş akışlarını iyileştirebilir ve .NET uygulamalarında ölçeklenebilirlik, performans ve güvenilirliği garanti edebilir. Bu teknolojilerin entegrasyonu, geliştiricilerin modern yazılım geliştirme ihtiyaçlarını karşılamalarına ve olağanüstü sonuçlar üretmelerine yardımcı olur, ister faturalar, raporlar veya belgeler oluştursunlar.

Bir paket olarak satın alındığında, IronPDF uygun fiyatlı ve ömür boyu bir lisans içerir. Paket, birçok sistem için tek seferlik bir ücret olan sadece $999 ile büyük değer sunar. Lisans sahiplerine 7/24 çevrimiçi mühendislik desteği sunar. Ücret hakkında daha fazla bilgi için lütfen Iron Software web sitesini ziyaret edin. Iron Software'ın ürünlerini keşfederek sundukları çözümler hakkında daha fazla bilgi edinin.