IRONSOFTWAREHOME
AKTUALNOŚCI DLA PROGRAMISTÓW

Opentelemetry C# (jak to działa dla programistów)

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Jacob Mellor
Updated: 21 kwietnia 2026

OpenTelemetry to zbiór narzędzi, API i SDK, które współpracują ze sobą, aby zbierać, przetwarzać i eksportować dane telemetryczne, takie jak ślady, metryki i logi z twoich aplikacji. Ten samouczek ma na celu pomoc początkującym w zrozumieniu, jak zintegrować OpenTelemetry w aplikacjach C# z wykorzystaniem metody rozszerzającej, koncentrując się na wbudowanym zbieraniu metryk dla skutecznego monitorowania aplikacji .NET. Nauczymy się również o bibliotece IronPDF do generowania PDF w C#.

Wprowadzenie do OpenTelemetry

Opentelemetry C# (Jak działa dla programistów): Rysunek 1 - OpenTelemetry

OpenTelemetry zapewnia jednolity sposób zbierania wszystkich rodzajów danych z twoich aplikacji. Dla deweloperów .NET, integracja OpenTelemetry oznacza, że można dokładniej monitorować swoje aplikacje, rozumieć ich działanie w czasie rzeczywistym i szybko identyfikować problemy. Biblioteka instrumentacji OpenTelemetry automatycznie umożliwia śledzenie i zbieranie metryk dla aplikacji .NET.

Dzięki metrykom zebranym przez framework OpenTelemetry, deweloperzy zyskują cenne informacje o środowisku wykonawczym .NET. Implementacja OpenTelemetry dla .NET wspiera środowisko wykonawcze .NET, w tym .NET Core i .NET Framework. Przestrzega protokołu OpenTelemetry dla standaryzowanego zbierania danych telemetrycznych.

Konfiguracja środowiska

Aby rozpocząć, musisz mieć zainstalowane SDK .NET na swoim komputerze. Jeśli używasz Visual Studio, to prawdopodobnie SDK .NET zostało zainstalowane wraz z nim. Możesz sprawdzić swoją obecną wersję SDK .NET, otwierając linię poleceń i uruchamiając:

dotnet --version

Następnie, utwórz nowy projekt sieciowy .NET, uruchamiając:

dotnet new web -o MyTelemetryApp
cd MyTelemetryApp
SHELL

To polecenie tworzy nowy projekt ASP.NET Core w katalogu o nazwie MyTelemetryApp.

Integracja OpenTelemetry

Dodawanie wymaganych pakietów

Najpierw dodaj niezbędne pakiety OpenTelemetry do swojego projektu. Otwórz swój terminal i przejdź do katalogu projektu. Następnie zainstaluj następujące pakiety za pomocą CLI Menedżera Pakietów NuGet:

dotnet add package OpenTelemetry -Version <version>
dotnet add package OpenTelemetry.Extensions.Hosting -Version <version>
dotnet add package OpenTelemetry.Instrumentation.AspNetCore -Version <version>
dotnet add package OpenTelemetry.Exporter.Console -Version <version>
SHELL

Zamień <version> na najnowszą wersję każdego pakietu.

Konfiguracja OpenTelemetry w aplikacji

Po dodaniu niezbędnych pakietów, musisz skonfigurować OpenTelemetry w swojej aplikacji. To obejmuje skonfigurowanie SDK OpenTelemetry i określenie, które dane telemetryczne zbierać. OpenTelemetry oferuje biblioteki instrumentacji do bezproblemowej integracji z aplikacjami .NET.

Otwórz plik Startup.cs w swoim projekcie i zmodyfikuj metodę ConfigureServices, aby uwzględniała OpenTelemetry, jak pokazano w poniższym fragmencie kodu:

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddOpenTelemetryTracing(builder =>
    {
        builder.AddAspNetCoreInstrumentation()
               .AddHttpClientInstrumentation()
               .AddConsoleExporter();
    });
}

Ten fragment kodu pokazuje, jak skonfigurować OpenTelemetry do zbierania danych telemetrycznych z aplikacji ASP.NET Core i wywołań klienta HTTP, a następnie eksportować te dane do konsoli. Metoda AddAspNetCoreInstrumentation automatycznie umożliwia instrumentację dla przychodzących żądań HTTP do aplikacji ASP.NET Core.

Zbieranie metryk

Aby zbierać metryki, musisz również skonfigurować API Metryk OpenTelemetry, skupiając się na metrykach zamiast na śledzeniu.

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddOpenTelemetryMetrics(builder =>
    {
        builder.AddAspNetCoreInstrumentation()
               .AddHttpClientInstrumentation()
               .AddConsoleExporter(options => options.Targets = ConsoleExporterOutputTargets.Console);
    });
}

Ta konfiguracja umożliwia zbieranie wbudowanych metryk z aplikacji ASP.NET Core i instrumentacji klienta HTTP, eksportując je do konsoli dla łatwego przeglądania.

Tworzenie własnych metryk

Chociaż OpenTelemetry automatycznie zbiera wiele użytecznych metryk, możesz chcieć zbierać własne metryki specyficzne dla twojej aplikacji. Wykorzystanie metody rozszerzającej dostarczonej przez bibliotekę instrumentacyjną nie tylko automatycznie zbiera telemetrykę, ale również daje deweloperom bardziej szczegółową kontrolę nad emitowanymi metrykami. Można to osiągnąć poprzez ręczną instrumentację swojego kodu do tworzenia i rejestrowania własnych metryk.

var meter = new Meter("MyCustomMetrics", "1.0");
var counter = meter.CreateCounter<int>("custom_request_count", description: "Counts custom requests");
app.Use((context, next) =>
{
    counter.Add(1, new KeyValuePair<string, object>("path", context.Request.Path));
    return next();
});

Ten fragment kodu pokazuje, jak stworzyć własną metrykę, która zlicza żądania do twojej aplikacji, oznaczając każdą metrykę ścieżką żądania. Dzięki wykorzystaniu metod rozszerzających dostarczonych przez OpenTelemetry, deweloperzy mogą sprawować bardziej szczegółową kontrolę nad procesem zbierania danych telemetrycznych.

Testowanie integracji

Uruchom swoją aplikację, używając linii poleceń lub Visual Studio. Wykonaj kilka żądań do aplikacji, albo nawigując do jej URL w przeglądarce internetowej, albo używając narzędzia takiego jak curl. Powinieneś zobaczyć dane telemetryczne, w tym ślady i metryki, drukowane do twojego wyjścia konsoli.

curl http://localhost:5000
SHELL

Wprowadzenie do IronPDF

Opentelemetry C# (Jak działa dla programistów): Rysunek 2 - IronPDF

IronPDF to potężna biblioteka dla deweloperów C#, umożliwiająca generowanie, manipulowanie i renderowanie dokumentów PDF bezpośrednio w aplikacjach .NET. Ta funkcjonalność jest szczególnie przydatna do generowania raportów, faktur czy jakichkolwiek wyjść opartych na dokumentach z aplikacji webowych za pomocą HTML, usług czy aplikacji desktopowych. Łącząc IronPDF z OpenTelemetry, deweloperzy mogą monitorować wydajność i niezawodność procesów generowania PDF w swoich aplikacjach, zapewniając płynne doświadczenie użytkownika.

IronPDF wyróżnia się w konwersji HTML do PDF, zapewniając precyzyjne zachowanie oryginalnych układów i stylów. Idealnie nadaje się do tworzenia plików PDF z treści internetowych, takich jak raporty, faktury i dokumentacja. Dzięki obsłudze plików HTML, adresów URL i surowych ciągów znaków HTML, IronPDF z łatwością tworzy wysokiej jakości dokumenty PDF.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Konfiguracja IronPDF

Najpierw musisz dodać IronPDF do swojego projektu .NET. Możesz to zrobić, używając Menedżera Pakietów NuGet. Otwórz swój terminal i przejdź do katalogu projektu. Następnie uruchom poniższe polecenie, aby zainstalować IronPDF:

dotnet add package IronPDF
SHELL

Generowanie PDF z IronPDF i monitorowanie z OpenTelemetry

Poniżej znajduje się przykład, jak wygenerować prosty dokument PDF i monitorować działanie za pomocą OpenTelemetry. Poniższy przykład zakłada, że już skonfigurowałeś OpenTelemetry w swojej aplikacji zgodnie z wcześniejszymi wskazówkami.

using IronPdf;
using OpenTelemetry.Trace;

public class PdfService
{
    private readonly Tracer _tracer;

    public PdfService(Tracer tracer)
    {
        _tracer = tracer;
    }

    public void GeneratePdf()
    {
        // Create a new activity for this operation
        using var activity = _tracer.StartActivity("Generate PDF");
        
        // Simulate adding some attributes related to the operation
        activity?.SetTag("pdf.size", "A4");
        activity?.SetTag("pdf.content", "Hello World");
        
        try
        {
            // Initialize the PDF generator
            var renderer = new ChromePdfRenderer();
            
            // Generate a PDF from HTML
            var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
            
            // Save the PDF to a file
            var outputPath = "output.pdf";
            pdf.SaveAs(outputPath);
            
            // Log success
            activity?.SetTag("pdf.status", "Success");
            activity?.SetTag("pdf.outputPath", outputPath);
        }
        catch (Exception ex)
        {
            // Log any exceptions that occur during PDF generation
            activity?.SetTag("pdf.status", "Error");
            activity?.SetTag("pdf.error", ex.Message);
            throw;
        }
    }
}

W tym przykładzie tworzymy nową klasę serwisową PdfService, która zawiera metodę GeneratePdf do generowania dokumentu PDF. Używamy klasy ChromePdfRenderer z IronPDF do renderowania HTML jako dokumentu PDF. Dzięki OpenTelemetry, rozpoczynamy nową aktywność nazwaną "Generate PDF", aby monitorować tę operację. Dodajemy niestandardowe tagi do aktywności, aby dostarczyć dodatkowy kontekst na temat procesu generowania PDF, takie jak wielkość PDF, typ zawartości i ścieżka wyjściowa. Złapamy również wszelkie wyjątki, aby odpowiednio zarejestrować błędy w ramach tej samej aktywności.

Wnioski

Opentelemetry C# (Jak działa dla programistów): Rysunek 3 - Licencjonowanie

Integracja OpenTelemetry w aplikacjach .NET pozwala na zbieranie cennych danych telemetrycznych, oferując wgląd w wydajność i zachowanie twoich aplikacji. Podążając za krokami opisanymi w tym samouczku, skonfigurowałeś podstawowe śledzenie i zbieranie metryk dla aplikacji webowej .NET. Eksperymentuj dalej, eksplorując bardziej zaawansowane funkcje OpenTelemetry, takie jak eksport danych telemetrycznych do zewnętrznych narzędzi monitorujących lub zbieranie logów obok śladów i metryk.

IronPDF oferuje bezpłatną wersję próbną IronPDF do produkcji w celu przetestowania pełnych możliwości. Licencje zaczynają się od zaledwie 399 USD.

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Dyrektor ds. technologii

Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.

...
Czytaj więcej

Powiązane artykuły

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta