Was ist OpenTelemetry?

OpenTelemetry ist ein anbieterneutrales Beobachtungs-Framework, das speziell für Cloud-native Apps entwickelt wurde. Die automatische Instrumentierung von OpenTelemetry bietet eine einzige API für die Erfassung von Telemetriedaten, einschließlich Protokollen, Tracing und Metriken. Mit Hilfe dieser umfangreichen Daten können Entwickler Probleme effektiv debuggen, Leistungsengpässe identifizieren und ein vollständiges Verständnis des Programmverhaltens erlangen. OpenTelemetry unterstützt sowohl automatische als auch manuelle Instrumentierung für eine umfassende und flexible Sammlung von Telemetriedaten.

Erstellen und Konfigurieren von 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...
}

Einstieg

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

Verwendung von OpenTelemetry mit IronPDF

Öffnen Sie die Startup.cs-Datei Ihrer ASP.NET Core-Anwendung, um auf die ConfigureServices-Methode zuzugreifen. Um IronPDF einzurichten, fügen Sie den folgenden Code hinzu.

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

Dieser Code stellt sicher, dass eine Instanz von HtmlToPdf erstellt und von der Anwendung nur durch Konfiguration des HtmlToPdf-Dienstes von IronPDF als Singleton verwendet wird.

Sie können die PDF-Erzeugungsprozesse in Ihren .NET-Anwendungen verfolgen und beobachten, indem Sie OpenTelemetry.NET mit IronPDF integrieren. Lassen Sie uns das Codebeispiel im Detail untersuchen, indem wir jeden Schritt einzeln durchgehen:

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

In diesem Beispiel:

• Wir injizieren den HtmlToPdf, ILogger und TracerProvider in den DemoController.
• Die Generate-Methode startet einen Datei-Download und gibt ein dynamisch erstelltes PDF mit dem Inhalt "Hello, IronPDF!" zurück.
• Die GeneratePdf-Methode verwendet das HtmlToPdf.RenderHtmlAsPdf, um das PDF zu rendern, und gibt die Binärdaten des PDFs aus.
• Der Code verwendet OpenTelemetry, um den PDF-Erstellungsprozess zu verfolgen und die Tracedaten zu protokollieren.

Erzeugte PDF-Ausgabe aus dem obigen Quellcode:

Unten ist der Bildschirm des erzeugten Traces aus der Jaeger UI:

Abschluss

OpenTelemetry ist ein Game-Changer für die Optimierung der Leistung und das Gesundheitsmonitoring von .NET-Anwendungen. Es bietet Entwicklern ein umfassendes Verständnis der inneren Abläufe ihrer Anwendungen, indem es einen anbieterneutralen und standardisierten Ansatz zur Erfassung, Analyse und Export von Telemetriedaten (Metriken, Traces und Protokolle) anbietet.

Durch die Integration von OpenTelemetry.NET mit IronPDF können Entwickler Workflows zur Erstellung von PDFs verbessern und Einblicke in die Leistung ihrer Anwendungen gewinnen. Indem sie die Implementierung von OpenTelemetry.NET nutzen, um die PDF-Erzeugungsprozesse manuell zu instrumentieren, können Entwickler Ausführungspfade verfolgen, Leistungskennzahlen überwachen und Bereiche lokalisieren, die Optimierungen erfordern. Darüber hinaus ermöglicht die zentrale Erfassung und Analyse von Überwachungsmesswerten, Telemetriedaten an Beobachtungsplattformen zu exportieren, wodurch Entwickler die Gesundheit ihrer Anwendungen bewahren und eine einwandfreie Benutzererfahrung bieten können.

Die Integration von OpenTelemetry.NET-Implementierung und IronPDF kann die Workflows von Entwicklern zur Erstellung von PDFs verbessern und Skalierbarkeit, Leistung und Zuverlässigkeit in .NET-Anwendungen gewährleisten. Die Integration dieser Technologien unterstützt Entwickler dabei, die Anforderungen der modernen Softwareentwicklung zu erfüllen und herausragende Ergebnisse zu erzielen, sei es bei der Erstellung von Rechnungen, Berichten oder Dokumentationen.

Beim Kauf eines Pakets ist IronPDF zu einem fairen Preis erhältlich und enthält eine lebenslange Lizenz. Das Paket bietet ein hervorragendes Preis-Leistungs-Verhältnis für nur $799, was eine einmalige Gebühr für viele Systeme darstellt. Es bietet Lizenzinhabern rund um die Uhr Online-Ingenieurssupport. Bitte besuchen Sie die Iron Software-Website für weitere Informationen über die Gebühren. Entdecken Sie Iron Software's Produkte, um mehr über die von ihnen angebotenen Lösungen zu erfahren.