Метрики и наблюдаемость · справочник Макарова М. Н.
8 глав
Как работает
Prometheus
Путь числа от приложения
до ответа на запрос
Модуль 2 справочника «Метрики и наблюдаемость». В первом модуле Prometheus использовался как готовая программа: приложение показывает числа, Prometheus их забирает, Grafana строит график. В этом модуле тот же путь разобран по шагам.
Главы идут в том порядке, в котором движутся данные. Сначала разобрано, что такое Prometheus. Затем target — адрес, по которому приложение показывает числа. Затем страница /metrics и правила её записи. Затем scrape — регулярный опрос этой страницы, и pull-модель — способ сбора, при котором обмен начинает сервер. Глава 2.6 — практика на своём компьютере, глава 2.7 — справка о формате YAML и ряде up, глава 2.8 — итоги модуля.
В каждом разделе термин вводится через сравнение из жизни и показывается на числах стенда. Выводы команд, тексты ошибок и снимки экрана получены на стенде модуля: Prometheus 3.5.0 в Docker, FastAPI 0.115, prometheus-client 0.26. Архив стенда можно скачать и повторить каждый опыт.
ПланГлавы модуля
В начале каждой главы указано, что в ней разобрано и на какие главы она опирается. В конце главы — вопросы «Проверьте себя» с разбором ответов и список источников. Grafana, оповещения и язык запросов PromQL разбираются в следующих модулях.
- 2.1Что такое PrometheusЗадача, метрика и лог, временной ряд, части системы, путь данных от приложения до PromQLчитать
- 2.2Target: куда обращаться за метрикамиАдрес, job и instance, служебные метки, localhost внутри контейнерачитать
- 2.3Endpoint /metrics и текстовый форматHELP, TYPE, имя, метки, значение; правила формата и проверка своих строкчитать
- 2.4Scrape: как Prometheus собирает значенияШаги одного опроса, interval и timeout, успешный и неуспешный scrape, ряд upчитать
- 2.5Pull-модель: запрос идёт от сервераPush и pull, кто начинает обмен, Pushgateway, выбор способа сборачитать
- 2.6Первый запуск: Prometheus и FastAPIСтенд в Docker Compose, Target health, UP, первый запрос, остановка приложенияпрактика
- 2.7Формат YAML и ряд upПравила записи prometheus.yml, частые ошибки с ответами promtool, что означает up и четыре запроса с нимсправка
- 2.8Итоги модуля: главное короткоПо разделу на главу: суть в нескольких фразах и пример со стенда, термины в одной таблицеповторение
ТестПроверочная работа по модулю
Тест · модуль 2 Как работает Prometheus: разбор ситуаций В каждом задании описана рабочая ситуация: что настроено, что видно на экране, что произошло. Нужно разложить ситуации по группам, найти строку с ошибкой, поставить причину к тексту ошибки, посчитать число. Открыть тест →Проверка кодов результата — страница для преподавателя
СтендМатериалы модуля
↓ Скачать стенд prometheus-start.zip ↓ Итоговый стенд prometheus-final.zip
Итоговый стенд — готовый результат главы 2.6: приложение с двумя метриками, настройки для каждого задания и файл PROHOD.md с девятью шагами прохода.