JF91.AppMetrics.InfluxDB2.Net7

لقد قمت بإنشاء هذه الحزمة حتى تتمكن بسهولة من دمج App.Metrics في ASP WEB API الخاص بك لإرسال المقاييس المجمعة إلى خادم InfluxDB2.

الإعداد بسيط للغاية، ما عليك سوى تثبيت حزمة Nuget وإضافة قسم التكوين إلى appsettings.json وإدخال الخدمات في برنامجك.cs.

يرجى اتباع التعليمات بعناية.

تثبيت نوجيت:

 dotnet add package JF91.AppMetricsInfluxDB2 --version 1.2.0

1 - أضف هذا القسم إلى appsettings.json الخاص بك وقم بتعديله حسب احتياجاتك:

 "MetricsOptions": {
    "DefaultContextLabel": "MyCustomContext",
    "Enabled": true
},
    "MetricsWebTrackingOptions": {
    "ApdexTrackingEnabled": true,
    "ApdexTSeconds": 0.1,
    "IgnoredHttpStatusCodes": [ 404 ],
    "IgnoredRoutesRegexPatterns": [],
    "OAuth2TrackingEnabled": true
},
    "MetricEndpointsOptions": {
    "MetricsEndpointEnabled": true,
    "MetricsTextEndpointEnabled": true,
    "PingEndpointEnabled": true,
    "EnvironmentInfoEndpointEnabled": true
},
    "MetricsReportingInfluxDb2Options": {
    "InfluxDb2": {
    "BaseUri": "http://127.0.0.1:8086",
    "Organization": "metrics",
    "Bucket": "metrics",
    "Token": "changeme"
},
    "HttpPolicy": {
    "BackoffPeriod": "0:0:30",
    "FailuresBeforeBackoff": 5,
    "Timeout": "0:0:40"
},
    "ReportInterval": "0:0:1"
}

2 - أضف متغير البيئة هذا إلى launchSettings.json الخاص بك:

 "APPLICATION_NAME": "MyKickassApi"

3 - أضف هذا قبل builder.Build() :

 builder.Services.AddMetricsServices();
builder.WebHost.AddInfluxDb2AppMetrics(builder.Configuration);

4 - أضف هذا بعد builder.Build() :

 app.UseRequestsCounterMiddleware();
app.UseRequestsDurationMiddleware();
app.UseResponsesSizeMiddleware();
app.UseResponsesApdexMiddleware();
app.UseMetricsAllMiddleware();
app.UseMetricsAllEndpoints();

5 - أضف هذا قبل app.Run() :

 app.UseHttpStatusCodesCounterMiddleware();

---

كيفية إضافة وسيطة مقاييس جديدة:

1 - إنشاء وسيط اعتراضي؛

2 - حقن IMetrics .

 public class MyNewMetricMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IMetrics _metrics;

    public MyNewMetricMiddleware(RequestDelegate next, IMetrics metrics)
    {
        _next = next;
        _metrics = metrics;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        try
        {
            await _next(context);

            var tags = new MetricTags
            (
                new[] { "Tag1-Key", "Tag2-Key" },
                new[] { "Tag1-Value, "Tag2-Value }
            );

            _metrics.Measure.Counter.Increment
            (
                new CounterOptions
                {
                    Name = "my-new-metric",
                    Context = "my-new-context",
                    MeasurementUnit = Unit.Calls,
                    Tags = tags
                }
            );
        }
        catch (Exception ex)
        {
        }
    }
}

3 - إضافة البرامج الوسيطة إلى مسار التطبيق:

 builder.UseMiddleware();

---

كيفية إضافة مقاييس جديدة في وحدة التحكم:

1 - إدخال IMetrics في وحدة التحكم:

 public WeatherForecastController(ILogger logger, IMetrics metrics)
{
    _logger = logger;
    _metrics = metrics;
}

2- استخدم IMetrics :

Get() { var tags = new MetricTags ( new[] { "Tag1-Key", "Tag2-Key" }, new[] { "Tag1-Value, "Tag2-Value } ); _metrics.Measure.Counter.Increment ( new CounterOptions { Name = "my-new-metric", Context = "my-new-context", MeasurementUnit = Unit.Calls, Tags = tags } ); return Enumerable.Range(1, 5).Select ( index => new WeatherForecast { Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)), TemperatureC = Random.Shared.Next(-20, 55), Summary = Summaries[Random.Shared.Next(Summaries.Length)] } ) .ToArray(); }" style=";text-align:right;direction:rtl">

 [HttpGet(Name = "GetWeatherForecast")]
public IEnumerable Get()
{
    var tags = new MetricTags
    (
        new[] { "Tag1-Key", "Tag2-Key" },
        new[] { "Tag1-Value, "Tag2-Value }
    );
    
    _metrics.Measure.Counter.Increment
    (
        new CounterOptions
        {
            Name = "my-new-metric",
            Context = "my-new-context",
            MeasurementUnit = Unit.Calls,
            Tags = tags
        }
    );

    return Enumerable.Range(1, 5).Select
        (
            index => new WeatherForecast
            {
                Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            }
        )
        .ToArray();
}