La création de documents PDF dynamiques, basés sur des données et enrichis est une exigence typique dans de nombreux secteurs du développement logiciel moderne. Les entreprises dépendent fortement de leur capacité à générer rapidement des PDF de haute qualité, que ce soit pour créer des factures, des rapports ou de la documentation. Cependant, suivre et comprendre l'efficacité des processus de production de PDF devient essentiel pour préserver la santé des applications et garantir la satisfaction des utilisateurs à mesure qu'elles deviennent plus compliquées et à grande échelle.
Cet article vise à discuter de la manière dont les développeurs peuvent améliorer les opérations de génération de PDF et fournir des informations importantes sur les performances des applications en utilisant les fonctionnalités d'IronPDF et d'OpenTelemetry.NET. Nous explorerons les caractéristiques et les avantages des deux technologies et montrerons comment elles peuvent fonctionner ensemble harmonieusement pour optimiser la création et la surveillance des PDF dans les applications .NET.
OpenTelemetry est un cadre d'observabilité neutre vis-à-vis des fournisseurs, créé spécialement pour les applications cloud-native. L'instrumentation automatique d'OpenTelemetry fournit une API unique pour recueillir des informations de télémétrie, y compris des logs, des traces et des métriques. Grâce à ces données exhaustives, les développeurs peuvent résoudre efficacement les problèmes, identifier les goulots d'étranglement en matière de performances et obtenir une compréhension complète du comportement du programme. OpenTelemetry prend en charge à la fois l'instrumentation automatique et manuelle pour une collecte de données de télémétrie complète et flexible.
L'intégration d'OpenTelemetry dans vos applications .NET offre plusieurs avantages :
OpenTelemetry doit être configuré dans votre application ; pour les applications ASP.NET Core, cela se fait généralement dans la méthode ConfigureServices de votre fichier Startup.cs. Voici une illustration de la configuration d'un exportateur Jaeger :
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 SubRemplacez "YourServiceName" par le nom réel de votre service. Ajustez l'hôte et le port de l'agent Jaeger selon vos options de configuration Jaeger.
Vous devez inclure le middleware OpenTelemetry dans les applications ASP.NET Core pour obtenir l'instrumentation automatique des requêtes HTTP entrantes. Dans la méthode Configure de votre fichier Startup.cs, ajoutez le middleware :
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 SubAprès avoir tout configuré, OpenTelemetry commencera à suivre les requêtes HTTP entrantes et à envoyer automatiquement des informations de télémétrie au backend Jaeger configuré.
Vous pouvez vérifier les traces dans votre backend Jaeger pour confirmer qu'OpenTelemetry fonctionne correctement. Ouvrez l'interface utilisateur de Jaeger (généralement disponible à http://localhost:16686 pour l'interface utilisateur de Jaeger) et recherchez les traces associées à votre service.
OpenTelemetry n'est pas indispensable pour l'instrumentation de base, mais il s'intègre à d'autres systèmes d'exploitation de backend pour stocker et traiter les données de télémétrie. Les options populaires sont constituées des systèmes d'exploitation officiellement pris en charge :
Le populaire package .NET IronPDF vous permet de créer, modifier et rendre des documents PDF au sein de programmes .NET. Les fonctions de travail avec les PDF sont nombreuses et incluent la conversion de pages HTML en PDF, l'extraction de texte et d'images de fichiers PDF, l'ajout de texte, d'images et de formes aux documents PDF préexistants, et la production de PDF à partir de contenu HTML, de photos ou de données brutes.
Deux des principaux avantages d'IronPDF sont sa facilité d'utilisation et sa simplicité. Les développeurs peuvent commencer à créer des PDF dans leurs projets .NET sans effort grâce à son API intuitive et à sa documentation complète. L'efficacité et la rapidité d'IronPDF sont des caractéristiques supplémentaires qui aident les développeurs à créer des documents PDF de haute qualité rapidement et efficacement.
Quelques-uns des avantages d'IronPDF :
Plusieurs packages NuGet sont disponibles pour différents composants d'OpenTelemetry. Selon vos besoins, vous pouvez installer les packages requis. Pour envoyer des données de télémétrie à un backend d'observabilité (tel que Jaeger, Zipkin ou Prometheus), vous aurez au moins besoin du package OpenTelemetry, des packages d'instrumentation pour votre framework d'application (comme ASP.NET Core), et d'un package d'exporteur. Assurez-vous également que le package IronPDF est installé dans votre projet. Pour l'installer, utilisez la console du gestionnaire de packages NuGet :
Install-Package OpenTelemetry
Install-Package OpenTelemetry.Instrumentation.AspNetCore
Install-Package OpenTelemetry.Exporter.Jaeger
Install-Package IronPdfOuvrez le fichier Startup.cs de votre application ASP.NET Core pour accéder à la méthode ConfigureServices. Pour configurer IronPDF, incluez le code suivant.
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 SubCe code garantit qu'une instance de HtmlToPdf est créée et utilisée par l'application uniquement en configurant le service HtmlToPdf d'IronPDF en tant que singleton.
Vous pouvez suivre et observer les processus de génération de PDF dans vos applications .NET en intégrant OpenTelemetry.NET avec IronPDF. Examinons en profondeur l'exemple de code, en passant en revue chaque étape :
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 NamespaceDans cet exemple :
HtmlToPdf, ILogger et TracerProvider dans le DemoController.Generate démarre un téléchargement de fichier, retournant un PDF créé dynamiquement avec le contenu " Hello, IronPDF ! ".GeneratePdf utilise le HtmlToPdf.RenderHtmlAsPdf pour rendre le PDF et génère les données binaires du PDF.Sortie PDF générée à partir du code source ci-dessus :
Ci-dessous se trouve l'écran de la trace générée à partir de l'interface utilisateur de Jaeger :
OpenTelemetry est un outil révolutionnaire pour l'optimisation des performances et la surveillance de la santé des applications .NET. Il offre aux développeurs une compréhension approfondie du fonctionnement interne de leurs applications en fournissant une méthode neutre vis-à-vis des fournisseurs et standardisée pour la collecte, l'analyse et l'exportation des données de télémétrie (métriques, traces et logs).
En intégrant OpenTelemetry.NET avec IronPDF, les développeurs peuvent améliorer les flux de travail de création de PDF et obtenir des informations sur les performances de leurs applications. En tirant parti de l'implémentation OpenTelemetry.NET pour instrumenter manuellement les processus de génération de PDF, les développeurs peuvent suivre les chemins d'exécution, surveiller les métriques de performance et identifier les zones nécessitant une optimisation. De plus, la collecte et l'analyse centralisées des métriques de surveillance sont rendues possibles en exportant les données de télémétrie vers des plateformes d'observabilité, permettant aux développeurs de préserver la santé de leurs applications et d'offrir une expérience utilisateur sans faille.
L'intégration de l'implémentation OpenTelemetry.NET et de l'IronPDF peut améliorer les flux de travail des développeurs pour la création de PDF et garantir la scalabilité, les performances et la fiabilité dans les applications .NET. L'intégration de ces technologies aide les développeurs à répondre aux besoins du développement logiciel moderne et à produire des résultats exceptionnels, que ce soit pour créer des factures, des rapports ou de la documentation.
Lorsqu'IronPDF est acheté en tant que package, il est proposé à un prix raisonnable et comprend une licence à vie. Le package offre une grande valeur à seulement $999, qui est un coût unique pour de nombreux systèmes. Il offre un support technique en ligne en continu aux titulaires de licence. Veuillez visiter le site Web Iron Software pour plus de détails sur les frais. Explorez les produits d'Iron Software pour en savoir plus sur les solutions qu'ils proposent.
Jacob Mellor est directeur de la technologie chez Iron Software et un ingénieur visionnaire pionnier de la technologie C# PDF. En tant que développeur à l'origine de la base de code centrale d'Iron Software, il a façonné l'architecture des produits de l'entreprise depuis sa création, la transformant aux côtés du PDG Cameron Rimington en une entreprise de plus de 50 personnes au service de la NASA, de Tesla et d'agences gouvernementales mondiales.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
