.NET 帮助

OpenTelemetry .NET(如何为开发者工作)

发布 2024年七月1日
分享:

介绍

创建动态、数据驱动、内容丰富的 PDF 文档是现代软件开发中许多领域的典型需求。 无论是创建账单、报告还是文档,企业都非常依赖于快速生成高质量 PDF 的能力。 然而,随着应用程序的复杂化和大型化,跟踪和理解 PDF 生产流程的有效性对于维护应用程序的健康和确保用户的愉悦度至关重要。

本文旨在讨论开发人员如何利用 IronPDF 和 OpenTelemetry.NET 的功能改进 PDF 生成操作,并提供有关应用程序性能的重要见解。 我们将探讨这两种技术的特点和优势,并展示它们如何协调合作,以优化 .NET 应用程序中 PDF 的创建和监控。

什么是 OpenTelemetry?

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

OpenTelemetry 的主要组件

  • API:为了检测应用程序并生成遥测数据,OpenTelemetry 规定了一套标准化的应用程序接口(API)。这就简化了检测程序,并保证了各种编程语言的一致性。
  • SDK:对于仪器应用程序,OpenTelemetry 提供针对特定语言的 SDK。 在 .NET SDK 的帮助下,开发人员可以轻松地将 OpenTelemetry 功能集成到他们的 .NET 项目中。
  • Exporters:这些部分负责将收集到的遥测数据传输到后台系统,以便对其进行存储和检查。 许多广泛使用的后端系统的出口商,如 Zipkin(追踪)普罗米修斯(度量)和 Jaeger(追踪)在翻译过程中,OpenTelemetry、.NET、Java、Python 或 Node js 将提供支持。
  • Automatic Instrumentation:这种方法简化了 .NET Core 应用程序的流程。 OpenTelemetry 库可以自动捕获网络应用程序或服务中常见操作的数据。这消除了手动代码修改,简化了集成过程。
  • 手动仪器:为了对数据收集进行细粒度控制,OpenTelemetry 为手动仪表提供了强大的 API。 通过这种方法,您可以捕捉到与您独特的应用程序逻辑相关的特定指标和跟踪。 对于 .NET Framework 应用程序或自动仪器无法满足您特定需求的场景,它尤其有用。

在 .NET 中使用 OpenTelemetry 的好处

将 OpenTelemetry 集成到您的 .NET 应用程序中具有以下几个优势:

  • 供应商中立:OpenTelemetry 通过与各种后端系统毫不费力地集成,为您的应用程序提供灵活性和面向未来的功能。 您的仪器代码无需更改即可切换后端系统。
  • 标准化方法:通过统一的应用程序接口(API),可以更轻松地对应用程序的各个领域进行仪表化。 开发人员可以使用相同的 API 来收集日志、跟踪和指标,从而使代码更易于阅读和维护。
  • 深入的性能分析:OpenTelemetry 提供丰富的数据(指标、跟踪和日志)用于综合性能分析。 通过这种包罗万象的视角,您可以找到需要优化的地方,并确定问题的根源。
  • 更好的故障排除:开发人员可以利用 OpenTelemetry 捕获的丰富跟踪数据,跟踪请求通过应用程序的路径,从而更轻松地发现并解决问题。
  • 提高可扩展性:您的应用程序的复杂性不会妨碍 OpenTelemetry 的扩展能力。 新的功能或服务可以在不需要修改大量代码的情况下随时使用。

创建和配置 OpenTelemetry

在 ASP.NET 应用程序中配置 OpenTelemetry

OpenTelemetry 需要在您的应用程序中进行配置; 对于 ASP.NET Core 应用程序,这通常是在您的 Startup.cs 文件的 ConfigureServices 方法中完成的。这是 Jaeger 输出程序配置的示例:

using OpenTelemetry.Trace;
using OpenTelemetry.Exporter.Jaeger;
using OpenTelemetry.Resources;

public void ConfigureServices(IServiceCollection services)
{
    // Configure OpenTelemetry
    builder.Services.AddOpenTelemetry().WithTracing(options =>
    {
        // Configure Jaeger exporter
        // serviceName we can read from environment variables
        options
            .SetResourceBuilder(
                ResourceBuilder.CreateDefault()
                    .AddService(serviceName))
            .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
    builder.Services.AddOpenTelemetry().WithTracing(options =>
    {
        // Configure Jaeger exporter
        // serviceName we can read from environment variables
        options
            .SetResourceBuilder(
                ResourceBuilder.CreateDefault()
                    .AddService(serviceName))
            .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
	builder.Services.AddOpenTelemetry().WithTracing(Sub(options)
		' Configure Jaeger exporter
		' serviceName we can read from environment variables
		options.SetResourceBuilder(ResourceBuilder.CreateDefault().AddService(serviceName)).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
VB   C#

用您的服务名称代替 serviceName。 根据 Jaeger 配置选项,更改 Jaeger 代理主机和端口。

添加 OpenTelemetry 中间件

您必须在 ASP.NET Core 应用程序中包含 OpenTelemetry 中间件,以获得对传入 HTTP 请求的自动监测。 在您的 Startup.cs 文件的 Configure 方法中,添加中间件:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // Add OpenTelemetry middleware if we are using Prometheus
    app.UseHttpMetrics();
    // Other middleware configurations...
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // Add OpenTelemetry middleware if we are using Prometheus
    app.UseHttpMetrics();
    // Other middleware configurations...
}
Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
	' Add OpenTelemetry middleware if we are using Prometheus
	app.UseHttpMetrics()
	' Other middleware configurations...
End Sub
VB   C#

开始跟踪

设置好一切后,OpenTelemetry 将开始跟踪传入的 HTTP 请求,并自行向配置好的 Jaeger 后端发送遥测信息。

验证和监控

您可以检查 Jaeger 后端的痕迹,以确认 OpenTelemetry 运行正常。 打开 Jaeger 用户界面(Jaeger UI 通常可在 http://localhost:16686 获取)并查找与您的服务相关的痕迹。

选择后台系统(可选)

OpenTelemetry 并非基本仪器的必备工具,但它可与其他后端操作系统集成,以存储和处理遥测数据。 热门选项包括官方支持的操作系统:

  • 积家(追踪)
  • 普罗米修斯(度量)
  • Zipkin(追踪)

入门

什么是IronPDF?

流行的 .NET 软件包IronPDF您可以在 .NET 程序中创建、编辑和渲染 PDF 文档。 使用 PDF 的功能很多,包括:将 HTML 页面转换为 PDF; 从 PDF 中提取文本和图像; 在已有的 PDF 文档中添加文本、图像和形状; 以及根据 HTML 内容、照片或原始数据制作 PDF。

IronPdf 的两大优势是易用和简单。 由于.NET 具有直观的 API 和全面的文档,开发人员可以毫不费力地开始在其 .NET 项目中创建 PDF。 IronPdf 的效率和速度是帮助开发人员快速高效地创建高质量 PDF 文档的附加特性。

IronPDF 的部分优势:

  • 根据 HTML、图片和原始数据制作 PDF 文件
  • 从 PDF 文件中提取文本和图片
  • 在 PDF 文件中加入水印、页眉和页脚
  • PDF 文件受加密和密码保护
  • 电子签名和填写表格的能力

安装 NuGet 软件包

多个 NuGet 包可用于 OpenTelemetry 的不同组件。 根据您的需要,您可以安装所需的软件包。 向可观测性后端发送遥测数据(如 Jaeger、Zipkin 或 Prometheus)因此,您至少需要 OpenTelemetry 软件包和应用程序框架的仪器软件包。(如 ASP.NET Core)此外,还需提供一个.NET、Java、Python 或 Node.js 工具包和一个输出程序包。 此外,请确保在您的项目中安装了 IronPDF 软件包。 要安装它,请使用 NuGet 软件包管理器控制台:

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,请包含后续代码。

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
VB   C#

只有将 IronPDF 的 HtmlToPdf 服务配置为单例,该代码才能确保应用程序创建并使用 HtmlToPdf 实例。

通过将 OpenTelemetry.NET 与 IronPDF 集成,您可以跟踪和观察 .NET 应用程序中的 PDF 生成过程。 让我们深入研究一下代码示例,一步一步地检查每一个步骤:

using Microsoft.AspNetCore.Mvc;
using OpenTelemetry.Trace;
using System.Diagnostics;
using System.Net;
using System.Net.Http.Headers;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<WeatherForecastController> _logger;
        private readonly Tracer _tracer;

        public WeatherForecastController(ILogger<WeatherForecastController> logger, HtmlToPdf htmlToPdf, TracerProvider tracerProvider)
        {
            _tracer = tracerProvider.GetTracer("Demo");
            _htmlToPdf = htmlToPdf;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            string fileName = "Sample.pdf";
            var stream = GeneratePdf("Hello IronPDF");
            return new FileContentResult(stream, "application/octet-stream")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            using (var activity = _tracer.StartActiveSpan("PDF Generation"))
            {
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);
                var pdfBytes = pdfDocument.BinaryData;
                return pdfBytes;
            }
        }
    }
}
using Microsoft.AspNetCore.Mvc;
using OpenTelemetry.Trace;
using System.Diagnostics;
using System.Net;
using System.Net.Http.Headers;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<WeatherForecastController> _logger;
        private readonly Tracer _tracer;

        public WeatherForecastController(ILogger<WeatherForecastController> logger, HtmlToPdf htmlToPdf, TracerProvider tracerProvider)
        {
            _tracer = tracerProvider.GetTracer("Demo");
            _htmlToPdf = htmlToPdf;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            string fileName = "Sample.pdf";
            var stream = GeneratePdf("Hello IronPDF");
            return new FileContentResult(stream, "application/octet-stream")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            using (var activity = _tracer.StartActiveSpan("PDF Generation"))
            {
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);
                var pdfBytes = pdfDocument.BinaryData;
                return pdfBytes;
            }
        }
    }
}
Imports Microsoft.AspNetCore.Mvc
Imports OpenTelemetry.Trace
Imports System.Diagnostics
Imports System.Net
Imports System.Net.Http.Headers

Namespace DemoWebApplication.Controllers
	<ApiController>
	<Route("[controller]")>
	Public Class DemoController
		Inherits ControllerBase

		Private ReadOnly _htmlToPdf As HtmlToPdf
		Private ReadOnly _logger As ILogger(Of WeatherForecastController)
		Private ReadOnly _tracer As Tracer

		Private Function WeatherForecastController(ByVal logger As ILogger(Of WeatherForecastController), ByVal htmlToPdf As HtmlToPdf, ByVal tracerProvider As TracerProvider) As Public
			_tracer = tracerProvider.GetTracer("Demo")
			_htmlToPdf = htmlToPdf
		End Function

		<HttpGet>
		Public Function Generate() As FileContentResult
			Dim fileName As String = "Sample.pdf"
			Dim stream = GeneratePdf("Hello IronPDF")
			Return New FileContentResult(stream, "application/octet-stream") With {.FileDownloadName = fileName}
		End Function

		Private Function GeneratePdf(ByVal htmlContent As String) As Byte()
			Using activity = _tracer.StartActiveSpan("PDF Generation")
				Dim pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent)
				Dim pdfBytes = pdfDocument.BinaryData
				Return pdfBytes
			End Using
		End Function
	End Class
End Namespace
VB   C#

要为应用程序生成跟踪器实例,我们需要注入 TracerProvider 服务。 通过 "生成 "方法创建了一个名为 "PDF 生成 "的 OpenTelemetry 活动,以象征正在进行的工作。 我们模仿活动中的一些工作(代入自己的逻辑). 我们建立了一个名为 "work_duration_ms "的直方图指标来监控工作的毫秒持续时间。 我们在指标中添加了一个数据点,将其标记为 "演示",值为 "PDF 生成",并记录了持续时间(在这种情况下为 1000 毫秒). 标签为分析提供了额外的语境。

根据上述源代码生成 PDF 输出:

OpenTelemetry .NET(如何为开发人员工作):图 1 - 上述代码利用 IronPDF 和 OpenTelemetry 生成的输出结果

以下是 Jaeger UI 生成的跟踪屏幕:

OpenTelemetry .NET(如何为开发人员工作):图 2 - 从 Jaeger UI 生成的输出轨迹

结论

OpenTelemetry 是.NET 应用程序性能优化和健康状况监控的变革者。 它通过提供一种供应商中立的标准化方法来收集、分析和导出遥测数据,让开发人员透彻了解其应用程序的内部工作原理。(指标、跟踪和日志).

通过将 OpenTelemetry.NET 与 IronPDF 集成,开发人员可以改进创建 PDF 的工作流程,并深入了解应用程序的性能。 通过利用 OpenTelemetry.NET 实现手动检测 PDF 生成过程,开发人员可以跟踪执行路径、监控性能指标并精确定位需要优化的区域。 此外,通过将遥测数据导出到可观测性平台,可实现集中监控指标的收集和分析,从而使开发人员有能力维护其应用程序的健康并提供完美的用户体验。

OpenTelemetry.NET 实现与 IronPDF 的集成可以增强开发人员创建 PDF 的工作流程,并保证 .NET 应用程序的可扩展性、性能和可靠性。 这些技术的集成可以帮助开发人员满足现代软件开发的需求,无论是创建发票、报告还是文档,都能产生出色的结果。

如果以套餐形式购买,IronPDF 价格公道,并包含终身许可证。 该翻译包价值不菲,只需 749 美元,对许多系统而言都是一次性收费。 它为许可证持有者提供全天候在线工程支持。 请访问Iron 软件网站了解有关收费的更多详情。 探索Iron Software 的产品以进一步了解他们提供的解决方案。

< 前一页
DotNetOpenAuth .NET Core(开发人员工作原理)
下一步 >
Autofac .NET 6(它是如何为开发人员工作的)

准备开始了吗? 版本: 2024.12 刚刚发布

免费NuGet下载 总下载量: 11,781,565 查看许可证 >