1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. Appmetrics C#
.NET 幫助

Appmetrics C#（它如何為開發者工作）

Kannaopat Udonpant
坎納帕特·烏頓潘
2024年7月1日
分享:

AppMetrics C#是一個強大的工具，專為簡化應用程式監控和性能分析而設計。 透過應用程式度量抽象，它簡化了追蹤應用程式各個方面的複雜性。 無論您使用的是 .NET Core 還是 .NET Framework，這個 .NET 庫都能讓您有效地記錄度量類型。 您可以檢索指標並利用 App Metrics 支援的指標類型來獲得全面的見解。

該.NET庫支持檢索指標，並允許您在指定的時間間隔内刷新指標，以確保及時收集數據。 它還提供了一個擴充方法，提供延展性點以增強靈活性。 作為跨平台解決方案，AppMetrics 適合多種環境，並確保一致的性能監控。

IronPDF：C# 開發者的先進 PDF 庫是 C# 開發人員的另一個重要程式庫，尤其是在處理 PDF 檔案時。 它能夠在 .NET Core 應用程式中直接建立、編輯和提取 PDF 檔案。 這在需要從您的應用程式生成報告、發票或任何其他 PDF 格式文件的情況下特別有用。

開始使用 AppMetrics

要將跨平台應用程式指標整合到您的 .NET 專案中，首先需要安裝 AppMetrics 庫。 您可以使用 NuGet 套件，這是 .NET 的套件管理工具。 在您的專案中，在 NuGet 套件管理器主控台中執行以下命令：

Install-Package App.Metrics.AspNetCore
Install-Package App.Metrics.AspNetCore

Appmetrics C#（開發者如何使用）：圖 1 - AppMetrics

此命令將所有必要的依賴項添加到您的項目中，使您能夠開始配置 AppMetrics。

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

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

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetrics(); // metric type
    services.AddMetricsTrackingMiddleware();
    services.AddMetricsEndpoints();
}
public void ConfigureServices(IServiceCollection services)
{
    services.AddMetrics(); // metric type
    services.AddMetricsTrackingMiddleware();
    services.AddMetricsEndpoints();
}

接下來，在相同檔案的 Configure 方法中，確保添加 AppMetrics 中介軟體來處理監控：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseMetricsAllMiddleware();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseMetricsAllMiddleware();
}

此設定會自動開始捕捉關於進入您應用程式的 HTTP 請求的指標，例如請求數量、請求持續時間和錯誤率。

實現應用程序度量功能

記錄自定義指標

要在您的應用程式中創建和記錄自定義指標或測量，AppMetrics 提供了一種靈活的方式來定義需要跟蹤的內容。 以下是記錄一個簡單計數器以追蹤用戶登入的範例：

public class LoginTracker
{
    private readonly IMetrics _metrics;
    public LoginTracker(IMetrics metrics)
    {
        _metrics = metrics;
    }
    public void TrackLogin(string userId)
    {
        _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)
    {
        _metrics.Measure.Counter.Increment(MetricsRegistry.Logins, new MetricTags("UserId", userId));
    }
}

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

測量應用程式性能

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

public void ProcessData()
{
    using (_metrics.Measure.Timer.Time(MetricsRegistry.DatabaseQueryTimer))
    {
        // Code to execute a database query
    }
}
public void ProcessData()
{
    using (_metrics.Measure.Timer.Time(MetricsRegistry.DatabaseQueryTimer))
    {
        // Code to execute a database query
    }
}

此計時器記錄 ProcessData 方法執行所需的時間，提供有關資料庫查詢效能的見解。

將報告指標傳送至儀表板

要視覺化和監控各種指標類型，AppMetrics 可以將數據報告到不同的儀表板。 以下是您如何配置報告到 InfluxDB 儀表板的方法：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMetricsReportingHostedService();
    services.AddMetricsBuild(builder =>
    {
        builder.Report.ToInfluxDb(options =>
        {
            options.InfluxDb.BaseUri = new Uri("http://your-influxdb-server");
            options.InfluxDb.Database = "appmetricsdb";
            options.InfluxDb.UserName = "user";
            options.InfluxDb.Password = "password";
            options.HttpPolicy.BackoffPeriod = TimeSpan.FromSeconds(30);
            options.HttpPolicy.FailuresBeforeBackoff = 5;
            options.HttpPolicy.Timeout = TimeSpan.FromSeconds(10);
            options.FlushInterval = TimeSpan.FromSeconds(5);
        });
    });
}
public void ConfigureServices(IServiceCollection services)
{
    services.AddMetricsReportingHostedService();
    services.AddMetricsBuild(builder =>
    {
        builder.Report.ToInfluxDb(options =>
        {
            options.InfluxDb.BaseUri = new Uri("http://your-influxdb-server");
            options.InfluxDb.Database = "appmetricsdb";
            options.InfluxDb.UserName = "user";
            options.InfluxDb.Password = "password";
            options.HttpPolicy.BackoffPeriod = TimeSpan.FromSeconds(30);
            options.HttpPolicy.FailuresBeforeBackoff = 5;
            options.HttpPolicy.Timeout = TimeSpan.FromSeconds(10);
            options.FlushInterval = TimeSpan.FromSeconds(5);
        });
    });
}

追踪記憶體使用情況

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

public void CheckSystemMemory()
{
    var freeMemory = GC.GetTotalMemory(false);
    _metrics.Measure.Gauge.SetValue(MetricsRegistry.FreeMemory, freeMemory);
}
public void CheckSystemMemory()
{
    var freeMemory = GC.GetTotalMemory(false);
    _metrics.Measure.Gauge.SetValue(MetricsRegistry.FreeMemory, freeMemory);
}

這個儀表測量應用程式可用的空閒記憶體，幫助您了解記憶體消耗模式。

在指定間隔處理指標

可以配置 AppMetrics 在指定的時間間隔內進行指標收集。 這有助於在不過於頻繁記錄數據的情況下維持性能：

public void ConfigureScheduledReporting(IApplicationBuilder app)
{
    var metrics = app.ApplicationServices.GetService<IMetricsRoot>();
    var scheduler = new AppMetricsTaskScheduler(
        TimeSpan.FromSeconds(60),
        async () =>
        {
            await Task.WhenAll(metrics.ReportRunner.RunAllAsync()); // await task
        });
    scheduler.Start();
}
public void ConfigureScheduledReporting(IApplicationBuilder app)
{
    var metrics = app.ApplicationServices.GetService<IMetricsRoot>();
    var scheduler = new AppMetricsTaskScheduler(
        TimeSpan.FromSeconds(60),
        async () =>
        {
            await Task.WhenAll(metrics.ReportRunner.RunAllAsync()); // await task
        });
    scheduler.Start();
}

此配置將每60秒報告一次指標，在確保一致性能監控的同時，不會因為持續的數據記錄而使系統不堪重負。

將 AppMetrics 與 IronPDF 整合

在您的 C# 應用程式中使用度量和 PDF 生成時，結合 AppMetrics C# 和 IronPDF 可以非常有益。 此集成功能允許您直接從度量數據生成 PDF 格式的報告，這對於績效評估、客戶演示或內部審計非常有用。

IronPDF 介紹

IronPDF 是一個全面的程式庫，允許開發人員使用 C# 創建、讀取和編輯 PDF 文件。 IronPDF 的獨特之處在於其能力能夠使用 IronPDF 將 HTML 轉換為 PDF，使其對於基於網頁的報告生成特別有價值。 此功能確保報告的視覺效果得以保留，從網頁到印刷形式提供高度的逼真度。

將 IronPDF 與 AppMetrics C# 合併的使用案例

考慮一個情景，您需要向利益相關者提供應用程式的每月性能報告。 這些報告包括響應時間、錯誤率、用戶會話等指標。 使用開源的 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");

Appmetrics C#（它如何對開發人員起作用）：圖 2 - PDF 報告輸出

此整合不僅自動化生成報告的過程，還確保報告易於閱讀且具專業格式，適合任何利害關係人會議或存檔用途。

結論

Appmetrics C#(開發者如何運作): 圖3 - 許可證

總而言之，在您的 .NET 專案中將 AppMetrics C# 與 IronPDF 結合使用，可以提供一個強大的解決方案，既能監控應用程式效能，又能生成高品質的 PDF 報告。 此整合允許您從使用 AppMetrics 捕獲詳細的效能數據，無縫過渡到使用 IronPDF 以清晰、專業的格式呈現。

IronPDF 特別有利於希望在其應用程式中處理 PDF 文件的 C# 開發人員。 它簡化了 PDF 文件的創建和操作，並提供了將 HTML 直接轉換為 PDF 的獨特功能。 如果您正在考慮將 IronPDF 集成到您的專案中，他們提供一個IronPDF 免費試用開始使用，許可證從$749起提供，是提升文件處理能力的具有成本效益的方法。

Kannaopat Udonpant
坎納帕特·烏頓潘
  立即與工程團隊聊天
軟體工程師
在成為軟體工程師之前，Kannapat 在日本北海道大學完成了環境資源博士學位。在攻讀學位期間，Kannapat 也成為了車輛機器人實驗室的成員，該實驗室隸屬於生物生產工程學系。2022 年，他利用自己的 C# 技能，加入了 Iron Software 的工程團隊，專注於 IronPDF 的開發。Kannapat 珍視這份工作，因為他可以直接向負責撰寫大部分 IronPDF 程式碼的開發人員學習。除了同儕學習外，Kannapat 還享受在 Iron Software 工作的社交方面。當他不在撰寫程式碼或文件時，Kannapat 通常會在 PS5 上玩遊戲或重看《最後生還者》。
< 上一頁
C# 解構函式 (開發者如何使用)
下一個 >
Mathnet.Numerics C#（它如何為開發人員運作）
從NuGet 免費用於開發

安裝與 NuGet nuget.org/packages/IronPdf

PM > Install-Package IronPdf

報告問題

準備開始了嗎？ 版本： 2025.3 剛剛發布

免費開始
NuGet 下載 DLL 下載 Windows 安裝程式 開始免費試用
查看許可證 >
Textlogo Iron Suite related to Appmetrics C#（它如何為開發者工作）

IronPDF 是 IRON 的一部分套件

10 .NET API 產品適用於您的辦公文檔

以兩件產品的價格獲得十件產品   開始免費試用