Метрики и телеметрия
Метрики и телеметрия
Заголовок раздела «Метрики и телеметрия»Запись метрик приложения с использованием счётчиков, датчиков и гистограмм.
Загрузка
Заголовок раздела «Загрузка»local metrics = require("metrics")Счётчики
Заголовок раздела «Счётчики»Инкремент счётчика
Заголовок раздела «Инкремент счётчика»metrics.counter_inc("requests_total", {method = "POST"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
Добавление к счётчику
Заголовок раздела «Добавление к счётчику»metrics.counter_add("bytes_total", 1024, {direction = "out"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
value | number | Добавляемое значение |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
Датчики (Gauges)
Заголовок раздела «Датчики (Gauges)»Установка датчика
Заголовок раздела «Установка датчика»metrics.gauge_set("queue_depth", 42, {queue = "emails"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
value | number | Текущее значение |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
Инкремент датчика
Заголовок раздела «Инкремент датчика»metrics.gauge_inc("connections", {pool = "db"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
Декремент датчика
Заголовок раздела «Декремент датчика»metrics.gauge_dec("connections", {pool = "db"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
Гистограммы
Заголовок раздела «Гистограммы»Запись наблюдения
Заголовок раздела «Запись наблюдения»metrics.histogram("duration_seconds", 0.123, {method = "GET"})| Параметр | Тип | Описание |
|---|---|---|
name | string | Имя метрики |
value | number | Наблюдаемое значение |
labels | table? | Пары ключ-значение меток |
Возвращает: boolean, error
| Условие | Kind | Повторяемо |
|---|---|---|
| Коллектор недоступен | errors.INTERNAL | нет |
См. Обработка ошибок для работы с ошибками.