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

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

開始方法

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

IronPDFとOpenTelemetryを使用する

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

このコードは、IronPDF の HtmlToPdf サービスをシングルトンとして構成することによってのみ、HtmlToPdf のインスタンスが作成され、アプリケーションによって使用されることを保証します。

IronPDFとOpenTelemetry.NETを統合することにより、.NETアプリケーションでPDF生成プロセスを追跡および観察できます。 以下で、コード例を各ステップを詳しく解説していきます。

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

この例では：

• ILogger、および TracerProvider を DemoController に挿入します。
• Generate メソッドはファイルのダウンロードを開始し、コンテンツ"Hello, IronPDF!"を含む動的に作成された PDF を返します。
• 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は非常にリーズナブルな価格で生涯ライセンスが含まれています。 このパッケージは、多くのシステムで 1 回限りの料金である $799 のみで、大きな価値を提供します。 ライセンス保有者には24時間365日オンラインのエンジニアリングサポートが提供されます。 Iron Softwareのウェブサイトを訪問して料金についての詳細を確認してください。 彼らが提供するソリューションについてもっと知るためにIron Softwareの製品を探求してください。