.NET 幫助

Appmetrics C#（開發者使用指南）

Q: 如何將 AppMetrics 整合到 .NET 專案中？

您可以使用 NuGet 套件管理器透過以下命令將 AppMetrics 整合到您的 .NET 專案中： Install-Package App.Metrics.AspNetCore 。

更新:7月 28, 2025

AppMetrics C# 是專為簡化應用程式監控和效能分析而設計的強大工具。透過 AppMetrics 抽象，可簡化追蹤應用程式各方面所涉及的複雜性。無論您使用的是 .NET Core 或 .NET Framework，這個 .NET 函式庫都能讓您有效率地記錄公制類型。您可以擷取指標並運用 AppMetrics 支援的指標類型，以獲得全面的洞察力。

.NET 函式庫支援擷取指標，並允許您以指定的間隔刷新指標，確保及時收集資料。它也提供了延伸方法，提供可擴充的點以增強靈活性。作為跨平台的解決方案，AppMetrics 適用於多樣化的環境，並可確保一致的效能監控。

IronPDF：適用於 C# 開發人員的進階 PDF 函式庫是另一個 C# 開發人員必備的函式庫，尤其是在處理 PDF 文件時。它可以直接在 .NET Core 應用程式中建立、編輯和擷取 PDF 檔案。在您需要從應用程式產生 PDF 格式的報告、發票或任何其他文件的情況下，這可能會特別有用。

開始使用 AppMetrics

要將跨平台的 AppMetrics 整合到您的 .NET 專案中，您首先要安裝 AppMetrics 函式庫。您可以使用 .NET 的套件管理器 NuGet 套件來完成此工作。在您的專案中，在 NuGet Package Manager Console 執行下列指令：

Install-Package App.Metrics.AspNetCore

Appmetrics C# (How It Works For Developers)：圖 1 - AppMetrics

此指令會將所有必要的相依性加入您的專案，讓您可以開始設定 AppMetrics。

基本程式碼範例：監控 HTTP 請求

以下是如何在您的 .NET 應用程式中使用 AppMetrics 設定 HTTP 請求的基本監控。首先，在您的 Startup.cs 檔案中建立指標。在 ConfigureServices 方法中加入以下程式碼：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetrics(); // Add basic metrics services
    services.AddMetricsTrackingMiddleware(); // Enable middleware for tracking
    services.AddMetricsEndpoints(); // Add endpoints for metrics exposure
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetrics(); // Add basic metrics services
    services.AddMetricsTrackingMiddleware(); // Enable middleware for tracking
    services.AddMetricsEndpoints(); // Add endpoints for metrics exposure
}

$vbLabelText $csharpLabel

接下來，在同一檔案的 Configure 方法中，確保您新增 AppMetrics 中介軟體來處理監控：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseMetricsAllMiddleware(); // Register the middleware to capture all metrics
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseMetricsAllMiddleware(); // Register the middleware to capture all metrics
}

$vbLabelText $csharpLabel

此設定會自動開始擷取傳入至您應用程式的 HTTP 請求指標，例如請求次數、請求持續時間和錯誤率。

實現 AppMetrics 的功能

記錄自訂指標

若要建立並記錄自訂的指標或測量應用程式中的事物，AppMetrics 提供了靈活的方式來定義需追蹤的內容。以下是一個記錄簡單計數器以追蹤使用者登入的範例：

public class LoginTracker
{
    private readonly IMetrics _metrics;

    public LoginTracker(IMetrics metrics)
    {
        _metrics = metrics;
    }

    public void TrackLogin(string userId)
    {
        // Increment login counter for the specified user ID
        _metrics.Measure.Counter.Increment(MetricsRegistry.Logins, new MetricTags("UserId", userId));
    }
}

public class LoginTracker
{
    private readonly IMetrics _metrics;

    public LoginTracker(IMetrics metrics)
    {
        _metrics = metrics;
    }

    public void TrackLogin(string userId)
    {
        // Increment login counter for the specified user ID
        _metrics.Measure.Counter.Increment(MetricsRegistry.Logins, new MetricTags("UserId", userId));
    }
}

$vbLabelText $csharpLabel

在此程式碼中，每次呼叫 TrackLogin 時，指定使用者 ID 的登入計數器都會增加。

測量應用程式效能

AppMetrics 也可用於測量應用程式的效能。例如，您可以使用計時器追蹤特定方法的持續時間：

public void ProcessData()
{
    // Measure time taken by the database query process
    using (_metrics.Measure.Timer.Time(MetricsRegistry.DatabaseQueryTimer))
    {
        // Code to execute a database query goes here
    }
}

public void ProcessData()
{
    // Measure time taken by the database query process
    using (_metrics.Measure.Timer.Time(MetricsRegistry.DatabaseQueryTimer))
    {
        // Code to execute a database query goes here
    }
}

$vbLabelText $csharpLabel

此計時器會記錄 ProcessData 方法的執行時間，提供資料庫查詢效能的深入瞭解。

向儀表板報告指標

為了可視化和監控您的各種指標類型，AppMetrics 可以將資料報告到不同的儀表板。以下是如何配置報告到 InfluxDB 面板：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetricsReportingHostedService();
    services.AddMetrics(builder =>
    {
        builder.Report.ToInfluxDb(options =>
        {
            options.InfluxDb.BaseUri = new Uri("http://your-influxdb-server"); // Configure InfluxDB server URI
            options.InfluxDb.Database = "appmetricsdb"; // Specify the database name
            options.InfluxDb.UserName = "user"; // Set database username
            options.InfluxDb.Password = "password"; // Set database password
            options.HttpPolicy.BackoffPeriod = TimeSpan.FromSeconds(30); // Set backoff period
            options.HttpPolicy.FailuresBeforeBackoff = 5; // Set failure count before backoff
            options.HttpPolicy.Timeout = TimeSpan.FromSeconds(10); // Set HTTP timeout duration
            options.FlushInterval = TimeSpan.FromSeconds(5); // Set interval for reporting metrics
        });
    });
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetricsReportingHostedService();
    services.AddMetrics(builder =>
    {
        builder.Report.ToInfluxDb(options =>
        {
            options.InfluxDb.BaseUri = new Uri("http://your-influxdb-server"); // Configure InfluxDB server URI
            options.InfluxDb.Database = "appmetricsdb"; // Specify the database name
            options.InfluxDb.UserName = "user"; // Set database username
            options.InfluxDb.Password = "password"; // Set database password
            options.HttpPolicy.BackoffPeriod = TimeSpan.FromSeconds(30); // Set backoff period
            options.HttpPolicy.FailuresBeforeBackoff = 5; // Set failure count before backoff
            options.HttpPolicy.Timeout = TimeSpan.FromSeconds(10); // Set HTTP timeout duration
            options.FlushInterval = TimeSpan.FromSeconds(5); // Set interval for reporting metrics
        });
    });
}

$vbLabelText $csharpLabel

追蹤記憶體使用情況

監控系統記憶體使用情況對效能調整至關重要。以下是追蹤可用記憶體的方法：

public void CheckSystemMemory()
{
    var freeMemory = GC.GetTotalMemory(false); // Get total free memory
    _metrics.Measure.Gauge.SetValue(MetricsRegistry.FreeMemory, freeMemory); // Set gauge to measure free memory
}

public void CheckSystemMemory()
{
    var freeMemory = GC.GetTotalMemory(false); // Get total free memory
    _metrics.Measure.Gauge.SetValue(MetricsRegistry.FreeMemory, freeMemory); // Set gauge to measure free memory
}

$vbLabelText $csharpLabel

此測量器可測量應用程式可用的可用記憶體，協助您瞭解記憶體消耗模式。

以指定的間隔處理指標

AppMetrics 可設定為在指定時間間隔處理指標收集。這有助於維持效能，而不需過於頻繁地記錄資料：

public void ConfigureScheduledReporting(IApplicationBuilder app)
{
    var metrics = app.ApplicationServices.GetService<IMetricsRoot>(); // Retrieve the IMetricsRoot instance
    var scheduler = new AppMetricsTaskScheduler(
        TimeSpan.FromSeconds(60), // Set the interval for metrics collection
        async () =>
        {
            await Task.WhenAll(metrics.ReportRunner.RunAllAsync()); // Run all reports asynchronously
        });
    scheduler.Start(); // Start the scheduler
}

public void ConfigureScheduledReporting(IApplicationBuilder app)
{
    var metrics = app.ApplicationServices.GetService<IMetricsRoot>(); // Retrieve the IMetricsRoot instance
    var scheduler = new AppMetricsTaskScheduler(
        TimeSpan.FromSeconds(60), // Set the interval for metrics collection
        async () =>
        {
            await Task.WhenAll(metrics.ReportRunner.RunAllAsync()); // Run all reports asynchronously
        });
    scheduler.Start(); // Start the scheduler
}

$vbLabelText $csharpLabel

此組態將指標設定為每 60 秒報告一次，可確保一致的效能監控，而不會因持續的資料記錄而導致系統不堪負荷。

將 AppMetrics 與 IronPDF 整合。

在您的 C# 應用程式中使用度量和 PDF 生成功能時，將 AppMetrics C# 與 IronPDF 相結合可帶來極大裨益。此整合可讓您直接從指標資料產生 PDF 格式的報告，對於績效評核、客戶簡報，甚至內部稽核都很有用。

IronPDF 簡介

IronPDF 是一個全面的函式庫，可讓開發人員使用 C# 來建立、閱讀和編輯 PDF 文件。 IronPDF 的與眾不同之處在於它能夠使用 IronPDF 將 HTML 轉換為 PDF，因此對於網頁型報表的產生特別有價值。此功能可確保保留報告的視覺層面，提供從網頁到印刷形式的高度保真度。

將 IronPDF 與 AppMetrics C&num 合併的使用案例;。

考慮一種情況，您需要向利益相關者提供應用程式的每月效能報告。這些報告包括回應時間、錯誤率、使用者會話等指標。透過開放原始碼的 AppMetrics C#，您可以無縫擷取這些指標。將此功能與 IronPDF 合併後，您就可以在格式整齊的 PDF 文件中自動生成並發佈這些指標。

使用個案的程式碼範例

以下是一個完整的實作範例。本範例假設您已在專案中設定 IronPDF 和 AppMetrics C#。

using App.Metrics;
using App.Metrics.Formatters.Prometheus;
using IronPdf;
public class MetricsToPdfConverter
{
    private readonly IMetricsRoot _metrics;

    public MetricsToPdfConverter(IMetricsRoot metrics)
    {
        _metrics = metrics;
    }

    public void GeneratePdfReport(string outputPath)
    {
        // Step 1: Capture the metrics snapshot
        var metricsData = _metrics.Snapshot.Get();
        var formatter = new MetricsPrometheusTextOutputFormatter();
        using var stream = new MemoryStream();
        formatter.WriteAsync(stream, metricsData).Wait();

        // Step 2: Convert the metrics snapshot to string format
        stream.Position = 0;
        var reader = new StreamReader(stream);
        var metricsText = reader.ReadToEnd();

        // Step 3: Use IronPDF to convert the metrics text to a PDF document
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1> Metrics Report </h1> <pre>" + metricsText + "</pre>");

        // Step 4: Save the PDF document
        pdf.SaveAs(outputPath);
    }
}

// Usage
var metrics = new MetricsBuilder().Build();
var pdfConverter = new MetricsToPdfConverter(metrics);
pdfConverter.GeneratePdfReport("MonthlyPerformanceReport.pdf");

using App.Metrics;
using App.Metrics.Formatters.Prometheus;
using IronPdf;
public class MetricsToPdfConverter
{
    private readonly IMetricsRoot _metrics;

    public MetricsToPdfConverter(IMetricsRoot metrics)
    {
        _metrics = metrics;
    }

    public void GeneratePdfReport(string outputPath)
    {
        // Step 1: Capture the metrics snapshot
        var metricsData = _metrics.Snapshot.Get();
        var formatter = new MetricsPrometheusTextOutputFormatter();
        using var stream = new MemoryStream();
        formatter.WriteAsync(stream, metricsData).Wait();

        // Step 2: Convert the metrics snapshot to string format
        stream.Position = 0;
        var reader = new StreamReader(stream);
        var metricsText = reader.ReadToEnd();

        // Step 3: Use IronPDF to convert the metrics text to a PDF document
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1> Metrics Report </h1> <pre>" + metricsText + "</pre>");

        // Step 4: Save the PDF document
        pdf.SaveAs(outputPath);
    }
}

// Usage
var metrics = new MetricsBuilder().Build();
var pdfConverter = new MetricsToPdfConverter(metrics);
pdfConverter.GeneratePdfReport("MonthlyPerformanceReport.pdf");

$vbLabelText $csharpLabel

Appmetrics C# (How It Works For Developers)：圖 2 - PDF 報告輸出

此一整合不僅可自動化報告產生的流程，還可確保報告易於閱讀且格式專業，非常適合任何利害關係人會議或存檔之用。

結論

Appmetrics C# (How It Works For Developers)：圖 3 - 授權

總而言之，在您的 .NET 專案中結合 AppMetrics C# 與 IronPDF，可為監控應用程式效能和產生高品質 PDF 報告提供強大的解決方案。此整合可讓您從使用 AppMetrics 擷取詳細的效能資料，無縫轉換為使用 IronPDF 以清晰、專業的格式呈現。

IronPDF 特別適合希望在應用程式中處理 PDF 檔案的 C# 開發人員。它簡化了 PDF 文件的建立和操作，並提供將 HTML 直接轉換為 PDF 的獨特功能。如果您正在考慮將 IronPdf 整合到您的專案中，他們提供免費的 IronPDF 試用版讓您開始使用，而且授權費從 $liteLicense 開始，提供了一種具有成本效益的方式來增強您的文件處理能力。

常見問題解答

什麼是 AppMetrics C#？它能為開發者帶來哪些好處？

AppMetrics C# 是一款專為應用程式監控和效能分析而設計的工具，可讓開發人員在 .NET Core 和 .NET Framework 中高效地追蹤和檢索各種應用程式指標。

如何將 AppMetrics 整合到 .NET 專案中？

您可以使用 NuGet 套件管理器透過以下命令將 AppMetrics 整合到您的 .NET 專案中： Install-Package App.Metrics.AspNetCore 。

IronPDF 在利用 AppMetrics 資料產生報告的過程中扮演什麼角色？

IronPDF 可以將 AppMetrics 資料中的 HTML 格式指標資料轉換為高品質的 PDF，從而產生全面的 PDF 報告，非常適合用於績效評估和簡報。

如何使用 AppMetrics 追蹤自訂指標？

AppMetrics 可讓您定義和追蹤自訂指標，例如使用者活動或特定交易時間，從而實現根據您的應用程式需求量身定制的詳細效能分析。

有哪些可視化 AppMetrics 資料的選項？

AppMetrics 支援向各種儀表板（如 InfluxDB）產生報告，使開發人員能夠有效地視覺化和監控指標資料。

開發者如何使用 AppMetrics 優化應用程式效能？

開發者可以使用 AppMetrics 來監控記憶體使用情況並處理計劃指標，從而優化效能，確保高效的資源管理和應用程式的回應能力。

使用 IronPDF 產生 PDF 報告有哪些好處？

使用 IronPDF 從 AppMetrics 資料產生 PDF 報告的優勢在於可以建立專業且易於閱讀的文檔，從而增強與利害關係人的溝通。

IronPDF 有免費試用版嗎？

是的，IronPDF 提供免費試用，讓開發者在購買前可以探索其 PDF 生成功能。

雅各·梅勒

現在就和工程團隊聊天吧

首席技術長

Jacob Mellor 是 Iron Software 的首席技術官，也是一位富有遠見的工程師，率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者，他自公司成立之初便參與塑造了其產品架構，並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年，他在倫敦創辦了自己的第一家軟體公司；2005 年，他創建了自己的第一個 .NET 元件。此後，他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次，其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長，Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代技術領導者。

C# 解構函數（開發者如何理解其運作方式）

Mathnet.Numerics C#（開發者使�...

客戶亮點：

開發者對焦：

網路研討會：

Appmetrics C#（開發者使用指南）

開始使用 AppMetrics

基本程式碼範例：監控 HTTP 請求

實現 AppMetrics 的功能

記錄自訂指標

測量應用程式效能

向儀表板報告指標

追蹤記憶體使用情況

以指定的間隔處理指標

將 AppMetrics 與 IronPDF 整合。

IronPDF 簡介

將 IronPDF 與 AppMetrics C&num 合併的使用案例;。

使用個案的程式碼範例

結論

常見問題解答

什麼是 AppMetrics C#？它能為開發者帶來哪些好處？

如何將 AppMetrics 整合到 .NET 專案中？

IronPDF 在利用 AppMetrics 資料產生報告的過程中扮演什麼角色？

如何使用 AppMetrics 追蹤自訂指標？

有哪些可視化 AppMetrics 資料的選項？

開發者如何使用 AppMetrics 優化應用程式效能？

使用 IronPDF 產生 PDF 報告有哪些好處？

IronPDF 有免費試用版嗎？

Appmetrics C#（開發者使用指南）

開始使用 AppMetrics

基本程式碼範例：監控 HTTP 請求

實現 AppMetrics 的功能

記錄自訂指標

測量應用程式效能

向儀表板報告指標

追蹤記憶體使用情況

以指定的間隔處理指標

將 AppMetrics 與 IronPDF 整合。

IronPDF 簡介

將 IronPDF 與 AppMetrics C&num 合併的使用案例;。

使用個案的程式碼範例

結論

常見問題解答

什麼是 AppMetrics C#？它能為開發者帶來哪些好處？

如何將 AppMetrics 整合到 .NET 專案中？

IronPDF 在利用 AppMetrics 資料產生報告的過程中扮演什麼角色？

如何使用 AppMetrics 追蹤自訂指標？

有哪些可視化 AppMetrics 資料的選項？

開發者如何使用 AppMetrics 優化應用程式效能？

使用 IronPDF 產生 PDF 報告有哪些好處？

IronPDF 有免費試用版嗎？

相關文章

連結 CLI 的簡潔性和 .NET：將 Curl DotNet 與 IronPDF 結合使用

C# 隨機數產生器

C# 字串相等運算子（開發者使用方法）

下一步：開始30天免費試用

下一步：開始30天免費試用

深受全球數百萬工程師信賴