¿Qué es OpenTelemetry?

OpenTelemetry es un marco de observabilidad neutral creado especialmente para aplicaciones nativas de la nube. La instrumentación automática de OpenTelemetry proporciona una única API para recopilar información de telemetría, incluidos registros, trazas y métricas. Con el uso de estos datos extensos, los desarrolladores pueden depurar problemas de manera efectiva, identificar cuellos de botella de rendimiento y obtener una comprensión completa del comportamiento del programa. OpenTelemetry admite tanto la instrumentación automática como manual para una recopilación de datos de telemetría completa y flexible.

Crear y configurar 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...
}

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...
}

Empezando

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

Uso de OpenTelemetry con IronPDF

Abra el archivo Startup.cs de su aplicación ASP.NET Core para acceder al método ConfigureServices. Para configurar IronPDF, incluya el siguiente código.

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...
}

Este código asegura que se cree y utilice una instancia de HtmlToPdf por la aplicación solo configurando el servicio HtmlToPdf de IronPDF como un singleton.

Puede rastrear y observar los procesos de generación de PDF en sus aplicaciones .NET integrando OpenTelemetry.NET con IronPDF. Veamos el ejemplo de código en profundidad, revisando cada paso paso a paso:

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;
            }
        }
    }
}

En este ejemplo:

• Inyectamos el HtmlToPdf, ILogger y TracerProvider en el DemoController.
• El método Generate inicia una descarga de archivo, devolviendo un PDF creado dinámicamente con el contenido "Hello, IronPDF!".
• El método GeneratePdf utiliza el HtmlToPdf.RenderHtmlAsPdf para renderizar el PDF y produce los datos binarios del PDF.
• El código usa OpenTelemetry para rastrear el proceso de generación de PDF y registra los datos de trazado.

Salida de PDF generada a partir del código fuente anterior:

Pantalla de la traza generada desde la interfaz de Jaeger:

Conclusión

OpenTelemetry es un cambio de juego para la optimización del rendimiento de las aplicaciones .NET y el monitoreo de la salud. Proporciona a los desarrolladores una comprensión profunda de los entresijos de sus aplicaciones al ofrecer un método neutral y estandarizado para recopilar, analizar y exportar datos de telemetría (métricas, trazas y registros).

Al integrar OpenTelemetry.NET con IronPDF, los desarrolladores pueden mejorar los flujos de trabajo para crear PDF y obtener información sobre el rendimiento de sus aplicaciones. Al aprovechar la implementación de OpenTelemetry.NET para instrumentar manualmente los procesos de generación de PDF, los desarrolladores pueden rastrear caminos de ejecución, monitorear métricas de rendimiento e identificar áreas que requieren optimización. Además, la recopilación y el análisis de métricas de monitoreo centralizado son posibles al exportar datos de telemetría a plataformas de observabilidad, brindando a los desarrolladores la capacidad de preservar la salud de sus aplicaciones y proporcionar una experiencia de usuario impecable.

La integración de la implementación de OpenTelemetry.NET con IronPDF puede mejorar los flujos de trabajo de los desarrolladores para crear PDF y garantizar escalabilidad, rendimiento y confiabilidad en aplicaciones .NET. La integración de estas tecnologías ayuda a los desarrolladores a cumplir con las necesidades del desarrollo de software moderno y producir resultados sobresalientes, ya sea creando facturas, informes o documentación.

Cuando se compra como un paquete, IronPDF tiene un precio razonable e incluye una licencia de por vida. El paquete ofrece un gran valor a solo $799, que es una tarifa única para muchos sistemas. Ofrece a los titulares de licencias soporte de ingeniería en línea las 24 horas, los 7 días de la semana. Por favor visite el sitio web de Iron Software para obtener más detalles sobre el cargo. Explore los productos de Iron Software para obtener más información sobre las soluciones que ofrecen.