Сбор метрик
Записывайте счётчики, измерители и гистограммы.
«Сбор метрик» — бесплатный урок C# Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения C# Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс C# Academy содержит 4 уроков всего.
Зачем нужны метрики
Метрики — это числовые измерения, агрегированные во времени. Они лежат в основе панелей мониторинга и оповещений: частота запросов, количество ошибок, задержка, глубина очереди. В отличие от журналов, при большом объёме данных они остаются недорогими, поскольку агрегируются.
API Meter
.NET создаёт метрики через System.Diagnostics.Metrics. Вы создаёте Meter, а затем используете его для создания инструментов, например счётчиков и гистограмм.
using System.Diagnostics.Metrics;
private static readonly Meter Meter = new("Checkout.Orders");Счётчики
Счётчик — это значение, которое только увеличивается; он отлично подходит для подсчёта таких событий, как размещение заказов или ошибки. Для его увеличения вызывайте Add.
private static readonly Counter<long> OrdersPlaced =
Meter.CreateCounter<long>("orders.placed");
OrdersPlaced.Add(1);Измерения счётчика
Добавляйте к счётчику теги, чтобы разделять его значения по измерениям, например по статусу или региону, а затем агрегировать и фильтровать их в серверной системе.
OrdersPlaced.Add(1,
new KeyValuePair<string, object>("status", "completed"),
new KeyValuePair<string, object>("region", "eu"));Гистограммы
Гистограмма записывает распределение значений и особенно подходит для задержки или размеров полезной нагрузки. Серверные системы вычисляют процентили (p50, p95, p99) по записанным выборкам.
private static readonly Histogram<double> OrderDuration =
Meter.CreateHistogram<double>("order.duration", "ms");
OrderDuration.Record(elapsedMs);UpDownCounters
UpDownCounter может увеличиваться или уменьшаться, поэтому подходит для таких значений, как количество активных подключений или элементов, находящихся в очереди.
private static readonly UpDownCounter<long> ActiveOrders =
Meter.CreateUpDownCounter<long>("orders.active");
ActiveOrders.Add(1); // started
ActiveOrders.Add(-1); // finishedНаблюдаемые инструменты
Наблюдаемые инструменты считываются по запросу через обратный вызов. Они подходят для измерителей, таких как текущий объём памяти или размер кэша, которые получают выборкой, а не увеличивают.
Meter.CreateObservableGauge("cache.size",
() => _cache.Count);Регистрация измерителя
Как и при трассировке, OpenTelemetry собирает только зарегистрированные измерители. Используйте AddMeter с именем измерителя.
builder.Services.AddOpenTelemetry()
.WithMetrics(metrics => metrics
.AddMeter("Checkout.Orders"));Встроенные метрики
Пакеты инструментирования предоставляют готовые метрики для ASP.NET Core (длительность запросов, количество активных запросов) и среды выполнения (сборка мусора, пул потоков), обеспечивая мгновенное представление о работе системы.
metrics
.AddAspNetCoreInstrumentation()
.AddRuntimeInstrumentation();Выбор подходящего инструмента
Выбирайте инструмент по характеру значения: монотонный счётчик (Counter), значение, которое увеличивается и уменьшается (UpDownCounter), распределение (Histogram) или текущее значение, получаемое выборкой (Observable Gauge). Правильный выбор упрощает создание панелей мониторинга и оповещений.
Контролируйте кардинальность
Каждая уникальная комбинация тегов создаёт отдельный временной ряд. Теги с высокой кардинальностью (например, идентификатор пользователя) могут резко увеличить объём хранилища и затраты. Используйте ограниченные измерения с низкой кардинальностью, например статус или регион.
Быстрая проверка
Проверьте сбор метрик.
Повторение
Метрики недорого агрегируют числовые измерения. API Meter создаёт инструменты: Counter (монотонный), UpDownCounter (увеличивается и уменьшается), Histogram (распределения для вычисления процентилей) и наблюдаемые измерители Observable (получаемые выборкой). Теги добавляют измерения, но следите за кардинальностью. Регистрируйте измерители с помощью AddMeter и добавляйте встроенное инструментирование ASP.NET Core и среды выполнения для мгновенного представления о работе системы.
Изучай C# с ИИ-репетитором — бесплатно
Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.
- Курсы
- 93
- Уроки
- 346
Часто задаваемые вопросы
Урок «Сбор метрик» бесплатный?
Да — полный текст урока «Сбор метрик» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс C# Academy, подпишись на CoddyKit PRO. Курс C# Academy содержит 4 уроков всего.
Чему я научусь в уроке «Сбор метрик»?
Записывайте счётчики, измерители и гистограммы. Ты практикуешь C# Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать C# Academy?
Предыдущий опыт не требуется. C# Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Сбор метрик»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке C# Academy?
Да. Каждый урок C# Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.