.NET 幫助

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

發佈 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

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package App.Metrics.AspNetCore

VB C#

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

Public Sub ConfigureServices(ByVal services As IServiceCollection)
	services.AddMetrics() ' metric type
	services.AddMetricsTrackingMiddleware()
	services.AddMetricsEndpoints()
End Sub

VB C#

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

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

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

Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
	app.UseMetricsAllMiddleware()
End Sub

VB C#

此設定會自動開始捕捉關於進入您應用程式的 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));
    }
}

Public Class LoginTracker
	Private ReadOnly _metrics As IMetrics
	Public Sub New(ByVal metrics As IMetrics)
		_metrics = metrics
	End Sub
	Public Sub TrackLogin(ByVal userId As String)
		_metrics.Measure.Counter.Increment(MetricsRegistry.Logins, New MetricTags("UserId", userId))
	End Sub
End Class

VB C#

在此程式碼中，每次呼叫 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
    }
}

Public Sub ProcessData()
	Using _metrics.Measure.Timer.Time(MetricsRegistry.DatabaseQueryTimer)
		' Code to execute a database query
	End Using
End Sub

VB C#

此計時器記錄 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 Sub ConfigureServices(ByVal services As IServiceCollection)
	services.AddMetricsReportingHostedService()
	services.AddMetricsBuild(Sub(builder)
		builder.Report.ToInfluxDb(Sub(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)
		End Sub)
	End Sub)
End Sub

VB C#

追踪記憶體使用情況

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

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

Public Sub CheckSystemMemory()
	Dim freeMemory = GC.GetTotalMemory(False)
	_metrics.Measure.Gauge.SetValue(MetricsRegistry.FreeMemory, freeMemory)
End Sub

VB C#

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

在指定間隔處理指標

可以配置 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();
}

Public Sub ConfigureScheduledReporting(ByVal app As IApplicationBuilder)
	Dim metrics = app.ApplicationServices.GetService(Of IMetricsRoot)()
	Dim scheduler = New AppMetricsTaskScheduler(TimeSpan.FromSeconds(60), Async Sub()
			Await Task.WhenAll(metrics.ReportRunner.RunAllAsync()) ' await task
	End Sub)
	scheduler.Start()
End Sub

VB C#

此配置將每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");

Imports App.Metrics
Imports App.Metrics.Formatters.Prometheus
Imports IronPdf
Public Class MetricsToPdfConverter
	Private ReadOnly _metrics As IMetricsRoot
	Public Sub New(ByVal metrics As IMetricsRoot)
		_metrics = metrics
	End Sub
	Public Sub GeneratePdfReport(ByVal outputPath As String)
		' Step 1: Capture the metrics snapshot
		Dim metricsData = _metrics.Snapshot.Get()
		Dim formatter = New MetricsPrometheusTextOutputFormatter()
		Dim stream = New MemoryStream()
		formatter.WriteAsync(stream, metricsData).Wait()
		' Step 2: Convert the metrics snapshot to string format
		stream.Position = 0
		Dim reader = New StreamReader(stream)
		Dim metricsText = reader.ReadToEnd()
		' Step 3: Use IronPDF to convert the metrics text to a PDF document
		Dim renderer = New ChromePdfRenderer()
		Dim pdf = renderer.RenderHtmlAsPdf("<h1> Metrics Report </h1> <pre>" & metricsText & "</pre>")
		' Step 4: Save the PDF document
		pdf.SaveAs(outputPath)
	End Sub
End Class
' Usage
Private metrics = (New MetricsBuilder()).Build()
Private pdfConverter = New MetricsToPdfConverter(metrics)
pdfConverter.GeneratePdfReport("MonthlyPerformanceReport.pdf")

VB C#

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

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

結論

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

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

IronPDF 特別有利於希望在其應用程式中處理 PDF 文件的 C# 開發人員。它簡化了 PDF 文件的創建和操作，並提供了將 HTML 直接轉換為 PDF 的獨特功能。如果您正在考慮將 IronPDF 集成到您的專案中，他們提供一個IronPDF 免費試用提供起步方案，授權價格從 $749 起，提供經濟實惠的方式來增強您的文件處理能力。

< 上一頁
C# 解構函式 (開發者如何使用)

下一個 >
Mathnet.Numerics C#（它如何為開發人員運作）