Как начать собирать метрики в Konso

Шаг 1. Установите NuGet-пакет

Если Konso.Client ещё не установлен — добавьте пакет в проект: dotnet add package Konso.Client [скриншот: терминал с успешной установкой пакета Konso.Client]

Шаг 2. Добавьте API токен в конфигурацию

В appsettings.json добавьте секцию Konso (или используйте уже существующую, если логи уже подключены): { "Konso": { "ApiKey": "ВАШ_API_ТОКЕН" } } Для production используйте переменные окружения: export Konso__ApiKey="ВАШ_API_ТОКЕН" [скриншот: appsettings.json с секцией Konso]

Шаг 3. Зарегистрируйте сервис метрик

В Program.cs добавьте регистрацию Konso Metrics: var builder = WebApplication.CreateBuilder(args); builder.Services.AddKonsoMetrics(options => { options.ApiKey = builder.Configuration["Konso:ApiKey"]; }); var app = builder.Build(); [скриншот: Program.cs с добавленной строкой builder.Services.AddKonsoMetrics] После этого IKonsoMetrics доступен для внедрения через DI в любом классе приложения.

Шаг 4. Внедрите клиент и отправьте первую метрику

Внедрите IKonsoMetrics в конструктор нужного класса и вызовите TrackAsync: public class PaymentService { private readonly IKonsoMetrics _metrics; public PaymentService(IKonsoMetrics metrics) { _metrics = metrics; } public async Task ProcessPayment(decimal amount) { var sw = Stopwatch.StartNew(); // ... логика оплаты ... sw.Stop(); // Время выполнения в миллисекундах await _metrics.TrackAsync("payment.duration_ms", sw.ElapsedMilliseconds); // Счётчик успешных оплат await _metrics.TrackAsync("payment.success_count", 1); // Сумма оплаты await _metrics.TrackAsync("payment.amount", (double)amount); } } [скриншот: код сервиса с IKonsoMetrics и вызовами TrackAsync]

Шаг 5. Откройте раздел Метрики в Konso

Перейдите в Konso → ваш проект → раздел Метрики. После первого вызова TrackAsync метрика появится в списке доступных. [скриншот: раздел Метрики в Konso со списком метрик и графиком payment.duration_ms] Выберите метрику и временной диапазон — Konso автоматически построит график с агрегацией по выбранному периоду.

Шаг 6. Выберите агрегацию и временное окно

Для каждой метрики доступны агрегации: avg, sum, min, max, count. Выберите нужную в зависимости от типа метрики: • payment.duration_ms → avg (среднее время) или p99 (перцентиль) • payment.success_count → sum (общее количество за период) • payment.amount → sum (суммарный оборот) или avg (средний чек) [скриншот: интерфейс выбора агрегации и временного окна для метрики в Konso] График обновится в соответствии с выбранными настройками.

Шаг 7. Настройте алерт по метрике

Создайте алерт, чтобы получать уведомления при выходе метрики за пороговые значения. Перейдите в раздел Алерты → Создать алерт. Выберите: • Метрику: payment.duration_ms • Условие: avg > 2000 (среднее время ответа больше 2 секунд) • Временное окно: последние 5 минут • Канал уведомления: Telegram или Email [скриншот: форма создания алерта с настройками для метрики payment.duration_ms] Теперь вы получите уведомление, как только latency выйдет за допустимые пределы.