什么是OpenTelemetry？

OpenTelemetry是一种专门为云原生应用程序创建的无厂商中立的可观察性框架。OpenTelemetry自动化检测提供了一个用于收集遥测信息的统一API，包括日志、追踪和指标。 利用这些广泛的数据，开发人员可以有效地调试问题，找出性能瓶颈，并全面了解程序行为。 OpenTelemetry支持自动和手动检测，以便于全面和灵活的遥测数据收集。

创建和配置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...
}

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

开始

什么是 IronPDF？ 流行的.NET软件包[IronPDF](/)允许您在.NET程序中创建、编辑和渲染PDF文档。 用于处理PDF的功能众多，包括将HTML页面转换为PDF，从PDF中提取文本和图像，向现有PDF文档添加文本、图像和形状，以及从HTML内容、照片或原始数据生成PDF。 IronPDF的两个主要优点是易用性和简单性。 开发人员可以毫不费力地在他们的.NET项目中开始创建PDF，因为其直观的API和全面的文档。 IronPDF的效率和速度也是帮助开发人员快速高效地创建高质量PDF文档的额外特点。 IronPDF的一些好处： - 从HTML、图像和原始数据生成PDF - 从PDF文件提取文本和图像 - 在PDF文件中增加水印、页眉和页脚 - PDF文件用加密和密码保护 - 能够电子签名和填写表格 #### 安装 NuGet 包 OpenTelemetry的不同组件有多个NuGet包可用。 根据您的需要，您可以安装所需的软件包。 为了将遥测数据发送到可观察性后端（如Jaeger、Zipkin或Prometheus），您至少需要OpenTelemetry包、应用程序框架的检测包（如ASP.NET Core），以及一个导出器包。 还要确保您的项目中安装了IronPDF包。 要安装它，请使用NuGet软件包管理控制台： ```powershell Install-Package OpenTelemetry Install-Package OpenTelemetry.Instrumentation.AspNetCore Install-Package OpenTelemetry.Exporter.Jaeger Install-Package IronPdf ``` ## 将OpenTelemetry与IronPDF结合使用 打开您的ASP.NET Core应用程序的`Startup.cs`文件以访问`ConfigureServices`方法。 为了设置IronPDF，请包括以下代码。 ```csharp using IronPdf; public void ConfigureServices(IServiceCollection services) { // Configure IronPDF services.AddSingleton(); // Other service configurations... } ``` 此代码通过将IronPDF的`HtmlToPdf`服务配置为单例，确保由应用程序仅创建和使用一个`HtmlToPdf`实例。 通过将OpenTelemetry.NET与IronPDF集成，您可以在您的.NET应用程序中跟踪和观察PDF生成过程。 让我们深入研究代码示例，逐步分析每一步骤： ```csharp 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 _logger; private readonly Tracer _tracer; public DemoController(ILogger 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; } } } } ``` 在此示例中： - 我们将`HtmlToPdf`、`ILogger`和`TracerProvider`注入到`DemoController`中。 - `Generate`方法启动文件下载，返回动态创建的PDF，其中包含内容"Hello, IronPDF!"。 - `GeneratePdf`方法使用`HtmlToPdf.RenderHtmlAsPdf`渲染PDF并输出PDF的二进制数据。 - 代码使用OpenTelemetry追踪PDF生成过程并记录追踪数据。 从上述源码生成的PDF输出：  以下是Jaeger UI中生成的追踪屏幕：  ## 结论 OpenTelemetry是.NET应用程序性能优化和健康监控的游戏规则改变者。 它通过提供一种无厂商中立和标准化的方法来收集、分析和导出遥测数据（指标、追踪和日志），给开发人员提供了对其应用程序内部工作机制的全面了解。 通过将OpenTelemetry.NET与IronPDF集成，开发人员可以改进PDF创建工作流程，并获得应用程序性能的见解。 利用OpenTelemetry.NET实现手动检测PDF生成过程，开发人员可以跟踪执行路径，监控性能指标，并确定需要优化的区域。 此外，通过将遥测数据导出到可观察性平台，实现中心化监控指标的收集与分析，使得开发者能够保持应用程序的健康，并提供无缝的用户体验。 OpenTelemetry.NET实现与IronPDF的集成可以增强开发人员的PDF创建工作流程，并保证.NET应用程序的可扩展性、性能和可靠性。 这些技术的集成帮助开发人员满足现代软件开发的需求并提供卓越的结果，无论是创建发票、报告还是文档。 当作为一个软件包购买时，IronPDF价格合理，包括终身许可证。 该套餐提供了极高的价值，仅需$799的一次性费用即可应用于多个系统。 它提供持有许可证者全天候的在线工程支持。 请访问[Iron Software网站](https://ironsoftware.com/)了解更多关于费用的详细信息。 探索[Iron Software的产品](https://ironsoftware.com/)以了解他们提供的解决方案。